データディクショナリ data-dictionary

選択 Forms > データ辞書.

「データディクショナリを作成」をタップします。

プロパティ画面で以下を追加します。

• タイトル：（オプション）データディクショナリのタイトルを入力します。タイトルは一意である必要はなく、特殊文字や英語以外の文字を含めることもできます。レターやその他のドキュメントフラグメントは、サムネールやアセットプロパティなど、タイトル（使用可能な場合）と共に参照されます。 データディクショナリは、タイトルではなく名前で参照されます。

• 名前： データディクショナリの一意の名前。 「名前」フィールドに入力できるのは、英語の文字、数字、ハイフンのみです。 「名前」フィールドは「タイトル」フィールドに基づいて自動的に入力され、「タイトル」フィールドに入力された特殊文字、スペース、数字および英語以外の文字はハイフンに置き換えられます。 「タイトル」フィールドの値は「名前」フィールドに自動的にコピーされますが、値を編集することもできます。

• 説明：（オプション）データディクショナリの説明。

• タグ：（オプション）カスタムタグを作成するには、テキストフィールドに値を入力して Enter を押します。タグのテキストフィールドの下にタグが表示されます。 このテキストを保存すると、新しく追加されたタグも作成されます。

• 拡張プロパティ：（オプション）「フィールドの追加」をタップして、データディクショナリのメタデータ属性を指定します。[ プロパティ名 ] 列に一意のプロパティ名を入力します。 「値」列に、プロパティに関連付ける値を入力します。

（オプション）データディクショナリの XSD スキーマ定義をアップロードするには、データディクショナリの構造ウィンドウの「XML スキーマのアップロード」をタップします。XSD ファイルを参照して選択し、「開く」をタップします。アップロードされた XML スキーマに基づいてデータ辞書が作成されます。 データディクショナリ内の要素の表示名や説明を調整する必要があります。 これを行うには、要素の名前をタップして選択し、右側のペインのフィールドで説明、表示名、およびその他の詳細を編集します。

計算済み DD 要素について詳しくは、「計算済みデータディクショナリ要素」を参照してください。

「次へ」をタップします。

プロパティを追加画面で、データディクショナリに要素を追加します。 また、データディクショナリの基本構造を取得するためにスキーマをアップロードした場合は、要素を追加または削除し、その詳細を編集できます。

要素の右側にある 3 つのドットをタップし、データディクショナリの構造に要素を追加できます。

「複合要素」、「コレクション要素」、または「プリミティブ要素」を選択します。

• 複合 DDE には、他の DDE が含まれます。この DDE は、プリミティブ、複合、コレクションのいずれかのタイプにすることができます。 例として、郵便番号、国、都道府県、市町村、地名、番地で構成される住所が挙げられます。
• プリミティブ DDE は、文字列、数値、日付、ブール値などの要素であり、都市名などの情報を保持します。
• コレクションは、類似した単純 DDE または複合 DDE のリストです。 例えば、複数の場所を持つ顧客や、請求先と配送先の住所が異なる顧客などです。

次に、データディクショナリの作成に関するルールを示します。

• 複合タイプのみが、データディクショナリ内のトップレベル DDE として使用できます。
• 名前、参照名および要素タイプは、データディクショナリと DDE において必須のフィールドです。
• 参照名は一意である必要があります。
• 親 DDE（複合）には、同じ名前の 2 つの子を指定できません。
• 列挙型には、プリミティブな String 型のみが含まれます。

複合要素、コレクション要素、プリミティブ要素について、およびデータディクショナリ要素の操作について詳しくは、データディクショナリ要素の XML スキーマへのマッピングを参照してください。

データディクショナリにおける検証について詳しくは、データディクショナリエディターの検証を参照してください。

（オプション）要素を選択後に、「詳細設定」タブでプロパティ（属性）を追加できます。「フィールドの追加」をタップして、DD 要素のプロパティを拡張することもできます。

（オプション）要素の右側の 3 つのドットをタップして「削除」を選択すると、要素を削除できます。

（オプション）データディクショナリの構造ウィンドウ、フィールドと変数のリストパネルで要素を選択します。 要素に関連付けられた必要な属性を変更または追加します。

「保存」をタップします。

データディクショナリを編集するには、次のいずれかの操作を行います。

• データディクショナリの上にマウスポインターを置いて、「編集」をタップします。
• データディクショナリを選択し、ヘッダーの「編集」をタップします。
• データディクショナリの上にマウスポインターを置いて、「選択」をタップします。 次に、ヘッダーの「編集」をタップします。

または、データディクショナリをタップして表示します。

データディクショナリで、単純な要素をタップして選択します。 複合要素とコレクション要素には参照がありません。

要素の基本プロパティ、詳細プロパティと共に「貸したコンテンツ」も表示されます。

「貸したコンテンツ」をタップします。

「貸したコンテンツ」タブが表示されます。テキスト、条件、レター、およびインタラクティブ通信。 これらの見出しのそれぞれには、選択した要素への参照数も表示されます。

要素を参照するアセットの名前を確認するには、見出しをタップします。

貸したコンテンツや他の要素を表示するには、その要素をタップします。

要素を参照するアセットを表示するには、名前をタップします。アセット、レター、またはインタラクティブ通信がブラウザーに表示されます。

データディクショナリページで「選択」をタップします。

テストデータをダウンロードするデータディクショナリをタップし、「サンプル XML データのダウンロード」をタップします。

警告メッセージで「OK」をタップします。XML ファイルがダウンロードされます。

XML ファイルを Notepad または別の XML エディターで開きます。 XML ファイルは、データディクショナリと要素内のプレースホルダー文字列と同じ構造を持っています。 レターをテストするデータで、プレースホルダー文字列を置き換えます。

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<Company>
<Name>string</Name>
<Type>string</Type>
<HeadOfficeAddress>
<Street>string</Street>
<City>string</City>
<State>string</State>
<Zip>string</Zip>
</HeadOfficeAddress>
<SalesOfficeAddress>
<Street>string</Street>
<City>string</City>
<State>string</State>
<Zip>string</Zip>
</SalesOfficeAddress>
<HeadCount>1.0</HeadCount>
<CEO>
<PersonName>
<FirstName>string</FirstName>
<MiddleName>string</MiddleName>
<LastName>string</LastName>
</PersonName>
<DOB>string</DOB>
<CurrAddress>
<Street>string</Street>
<City>string</City>
<State>string</State>
<Zip>string</Zip>
</CurrAddress>
<DOJ>14-04-1973</DOJ>
<Phone>1.0</Phone>
</CEO>
</Company>

データエントリの作成後は、テストデータを含むレターをプレビューする際にこの XML ファイルを使用できます。

このテストデータを DD で追加できます（「DD」を選択し、「テストデータをアップロード」をタップして、この xml ファイルをアップロードします）。

その後、レターを通常（カスタムではなく）プレビューする場合、この XML データはレターで使用されます。 「カスタム」をタップして、この XML をアップロードすることもできます。

データディクショナリページで「選択」をタップし、目的のデータディクショナリをタップして選択します。

「サンプル XML データのダウンロード」を選択します。

警告メッセージで「OK」をタップします。

Correspondence Management は、選択されたデータディクショナリの構造に基づいて XML ファイルを作成し、<data-dictionary-name>-SampleData の名称でコンピューターにダウンロードします。これにより、このファイルを XML エディターまたはテキストエディターで編集することで、レターの作成の際にデータエントリを作成することができるようになります。

データディクショナリページで「選択」をタップし、目的のデータディクショナリをタップして選択します。

「ローカリゼーションデータのダウンロード」をタップします。

警告メッセージで「OK」をタップします。Correspondence Management が DataDictionary-<DDname>.zip のという名前の zip ファイルをお使いのコンピューターにダウンロードします。

Zip ファイルには.properties ファイルが含まれています。 このファイルは、ダウンロードしたデータディクショナリを定義します。 プロパティファイルの内容は次のようになります。

#Wed May 20 16:06:23 BST 2015
DataDictionary.EmployeeDD.description=
DataDictionary.EmployeeDD.displayName=EmployeeDataDictionary
DataDictionaryElement.name.description=
DataDictionaryElement.name.displayName=name
DataDictionaryElement.person.description=
DataDictionaryElement.person.displayName=person

プロパティファイルの構造は、説明とデータディクショナリの表示名、およびデータディクショナリ内の各データディクショナリ要素に対して 1 行ずつを定義します。 さらに、プロパティファイルでは、各データディクショナリ要素に設定された列挙値の 1 行を定義します。 データディクショナリと同様に、対応するプロパティファイルに複数のデータディクショナリ要素の定義を含めることができます。 また、このファイルには、1 つ以上の列挙値セットの定義を含めることができます。

別のロケールの.properties ファイルを更新するには、ファイルの表示名と説明の値を更新します。 ローカライズする各言語用に、さらにファイルのインスタンスを作成します。 サポートする言語はフランス語、ドイツ語、日本語、英語のみです。

更新したプロパティファイルを、それぞれ次の名前で保存します。

_fr_FR.properties French

_de_DE.properties German

_ja_JA.properties Japanese

_en_EN.properties English

.properties ファイル（または複数のロケール用のファイル）を 1 つの .zip ファイルにアーカイブします。

データディクショナリページで、詳細／ローカリゼーションデータのアップロード ​を選択し、ローカライズ済みのプロパティファイルを含む zip ファイルを選択します。

ローカリゼーションの変更を表示するには、ブラウザーのロケールを変更します。