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

フォーム／データディクショナリ ​を選択します。

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

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

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

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

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

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

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

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

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

「次へ」を選択します。

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

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

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

• 複合 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 ファイルを選択します。

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