ドキュメントフラグメント

ドキュメントフラグメント

ドキュメントフラグメントは再利用可能な通信のパーツ／コンポーネントで、これらを使用してレター／通信を構成できます。ドキュメントフラグメントは、次のいずれかの種類になります。

• テキスト：テキストアセットは、1 つまたは複数の段落で構成される 1 つのコンテンツです。段落は静的または動的にすることができます。
• リスト：リストは、テキスト、リスト、条件、画像を含む、一連のドキュメントフラグメントです。リスト要素の順番は固定または編集可能にできます。レターを作成する際は、リスト要素の一部またはすべてを使用して、再利用可能な要素のパターンを複製することができます。
• 条件：条件を使用すると、提示されたデータに基づいて通信の作成時に含めるコンテンツを定義できます。制御変数を使用して条件を記述します。制御変数にはデータディクショナリ要素またはプレースホルダーがあります。
• レイアウトフラグメント：レイアウトフラグメントは、1 つ以上のレター内で使用できるレイアウトです。繰り返し可能なパターン（特に動的テーブル）を作成するには、レイアウトフラグメントを使用します。レイアウトには、「アドレス」や「参照番号」などの一般的なフォームフィールドを含めることができます。また、ターゲット領域を示す空のサブフォームを含めることもできます。レイアウト（XDP）は Designer で作成され、その後 AEM Forms にアップロードされます。

テキスト

テキストアセットは、1 つまたは複数の段落で構成される 1 つのコンテンツです。段落は静的または動的にすることができます。動的段落にはデータ要素への参照が含まれます。データ要素の値は実行時に設定されます。例えば、レターのあいさつ文に含める顧客名を動的データ要素にし、実行時に値が設定されるようにできます。この値を変更すると、同じレターテンプレートを使用して異なる顧客向けにレターを生成できます。

Correspondence Management Solution は、動的データアイテム（可変データ）に対して 2 種類の要素をサポートしています。

• データディクショナリ要素：これらの要素はデータディクショナリに連結され、指定されたデータソースから値が取得されます。データディクショナリ変数は、保護するかどうかを指定できます。通信の作成時に、保護されていないデータディクショナリ変数のデフォルト値は変更できますが、保護されている変数は変更できません。
• プレースホルダー：バックエンドデータソースに連結されない変数です。ユーザーは通信の作成時に値を入力する必要があります。プレースホルダーはデフォルトで保護されていません。

テキストの作成

1. 「フォーム／ドキュメントフラグメント」を選択します。

2. 作成/テキスト​をタップします。または、テキストアセットを選択し、「編集」をタップします。

3. テキストの次の情報を指定します。

   • タイトル：（オプション） テキストアセットのタイトルを入力します。タイトルは一意である必要はなく、特殊文字や英語以外の文字を含めることもできます。テキストは、そのタイトルによって（利用可能な場合）、サムネールやアセットのプロパティとして参照されます。
   • 名前：​テキストアセットの一意の名前。状態にかかわらず、複数のアセット（テキスト、条件、リスト）の名前を同じにすることはできません。「名前」フィールドでは、英数字およびハイフンのみ使用できます。「名前」フィールドは、タイトルフィールドに基づいて自動的に入力されます。「タイトル」フィールドに入力した特殊文字、スペース、数字および英数字以外の文字は、ハイフンに置き換えられます。 「タイトル」フィールドの値は「名前」フィールドに自動的にコピーされますが、値を編集することもできます。
   • 説明：アセットの説明を入力します。
   • データディクショナリ：（オプション）マッピングが行われるデータディクショナリを選択します。この属性を使用して、テキストアセットでデータディクショナリ要素への参照を追加できます。
   • タグ：（オプション）テキストフィールドにカスタムタグの値を入力し、Enter キーを押します。タグのテキストフィールドの下にカスタムタグが表示されます。このテキストを保存すると、新しく追加したタグも作成されます。

4. 「次へ」をタップします。Correspondence Managementにエディターページが表示され、テキストの段落やデータ要素をテキストに追加できます。

   ブラウザーのデフォルトのスペルチェッカーにより、テキストエディターのスペルチェックが行われます。スペルチェックや文法チェックを管理するにはブラウザーのスペルチェッカーの設定を編集するか、スペルチェックや文法チェックのためのブラウザーのプラグインまたはアドオンをインストールします。

   また、テキストエディタで様々なキーボードショートカットを使用して、テキストの管理、編集、書式設定を行うこともできます。 Correspondence Managementのキーボードショートカットのテキストエディターについて詳しくは、

5. テキストエディターが開きます。テキストを入力します。ページの最上部にあるツールバーを使用して、テキストの書式設定や、条件、リンク、改ページの挿入を行います。

   

   • リンク：テキストにハイパーリンクを挿入します。
   • 繰り返し:繰り返し：区切り文字を使用して、データディクショナリでコレクション要素を印刷します。
   • 条件：タップして条件を挿入します。条件に基づいてテキストを挿入します。条件が true の場合はレターにテキストが表示されます。そうでない場合は表示されません。
   • 追加説明:テキスト追加への注釈。これは作成者に表示されるメタデータで、作成したレターには含まれません。
   • 改ページ：テキストモジュールの改ページ属性を false に設定した場合、テキストモジュールはページ間で区切られません。

   テキストエディタが開きます。テキストを入力します。 段落、整列、リストなど、編集のタイプによってツールバーが変わります。

   

   ツールバーのタイプの選択：段落、整列、またはリスト

   

   段落ツールバー
   ツールバー整列ツールバー

   

   リストツールバー（クリックすると拡大画像が開きます）

6. 別のアプリケーション（MS Word や HTML ページなど）から複数の段落のテキストを再利用するには、テキストをコピーしてテキストエディタに貼り付けます。コピーされたテキストの書式設定は、テキストエディタでも保持されます。

   編集可能なテキストモジュールでは、1 つ以上のテキスト段落をコピーして貼り付けることができます。たとえば、次のような居住証明書の箇条書きリストを含む MS Word 文書があるとします。

   

   編集可能なテキストモジュールでは、MS Word 文書からテキストを直接コピーして貼り付けることができます。箇条書きリスト、フォント、テキストの色などの書式は、テキストモジュールでも保持されます。

   

   メモ

   ただし、貼り付けられたテキストの書式設定にはいくつかの制約があります。

7. 必要に応じて、ドキュメントフラグメントに特殊文字を挿入します。例えば、特殊文字パレットを使用して、以下の特殊文字を挿入することができます。

   • 通貨記号（€、¥、£など）
   • 数学記号（∑、√、∂、^など）
   • や‟"などの句読点記号

   

   Correspondence Managementhas では、210 種類の特殊文字に初期状態から対応しています。管理者は、カスタマイズ](/docs/experience-manager-65/forms/using/custom-special-characters.html?lang=ja)によって、追加/カスタムの特殊文字のサポートを追加できます。[

8. 編集可能なインラインモジュールのテキストの一部をハイライト表示または強調するには、テキストを選択して「ハイライト表示の色」をタップします。

   

   基本色パレットに表示されている基本色**[A]**を直接タップするか、スライダ**[B]**を使用して色の適切な濃さを選択した後で「選択」をタップします。

   必要に応じて、「詳細」タブに移動し、適切な色相、明るさ、彩度**[C]**を選択して正確な色を作成し、「**[D]**を選択」をタップして色を適用してテキストをハイライトすることもできます。

   

9. データディクショナリ要素とプレースホルダー要素をデータパネルからテキストにドラッグ＆ドロップします。

   宛先：

   • テキスト内の追加データディクショナリ要素を選択し、リストからデータ要素を選択して、「挿入()」をタップします。 「保護」を選択した場合、データディクショナリ要素は読み取り専用になり、レターエディターに表示されますが、通信を作成ユーザーインターフェイスまたは Correspondence Creator には表示されません。
   • テキストにプレースホルダー要素を追加するには、データ要素パネルで「新規作成」をタップし、新しいデータ要素の詳細を入力します。次に、「作成」をタップし、新しい要素をリストに追加します。新しいプレースホルダーは、データディクショナリ要素と同じ方法でテキストに挿入できます。プレースホルダーを編集するには、プレースホルダーを選択し、「編集」をタップします。

   

   データディクショナリのサンプルデータファイルで指定されたプレースホルダー要素

   

   サンプルデータファイルで指定したデータディクショナリ変数によって入力された、CCR ビュー内のプレースホルダー要素値

   @記号を使用して、データディクショナリとプレースホルダー要素を検索し、テキストエディターに追加することもできます。 要素を挿入する位置にカーソルを置きます。 @の後に検索文字列を入力します。 テキストエディターは、テキストドキュメントフラグメントで使用可能なすべてのデータディクショナリ要素とプレースホルダ要素に対して検索操作を実行します。 検索操作は、検索文字列を含む要素を取得し、ドロップダウンリストとして表示します。 検索結果を順に表示し、カーソル位置に挿入する要素をクリックします。 検索結果を非表示にするには、Escキーを押します。

10. インライン条件と繰り返しを使用して、文脈に応じて変化する適切に構造化されたレターにすることができます。インライン条件と繰り返しについて詳しくは、インライン条件とレターでの繰り返しを参照してください。

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

テキストにハイパーリンクを挿入

次の手順を実行して、テキストアセット内にハイパーリンクを作成します。

1. テキストエディターでテキストまたはデータモデルオブジェクトを選択します。

2. 「リンク」をタップします。 「代替テキスト」フィールドをタップして、既存のデータモデルオブジェクトの名前またはテキストを削除します。

3. URLを指定し、「」をタップします。

テキストの検索と置換

大量のテキストを含むテキスト要素で作業する場合は、特定のテキスト文字列を検索する必要があります。 また、特定のテキスト文字列を別の文字列に置き換える必要がある場合もあります。

「検索と置換」機能はテキスト要素内にある任意の文字列の検索（および置換）を可能にします。この機能には、強力な正規表現検索も含まれています。

テキストモジュールでテキストを検索するには

1. テキストエディターでテキストモジュールを開きます。

2. 「検索と置換」をタップします。

3. 検索するテキストを「検索」テキストボックスに入力して、「検索」を押します。テキストモジュールで検索テキストがハイライトされます。

4. テキストの次のインスタンスを検索するには、もう一度「検索」を押します。

   「検索」ボタンを押し続けると、検索はページの下に続きます。テキストの最後のインスタンスが見つかった後、Reached end of module​というメッセージは、検索結果がこれ以上見つからないことを示します。

   ただし、テキストモジュールで検索テキストのインスタンスが見つからない場合は、「一致が見つかりませんでした」というメッセージが表示されます。

5. 「検索」を再び押すと、検索はページの一番上から続きます。

検索オプション

大文字と小文字 を区別：検索は、大文字と小文字が同じ結果のみを返します。

単語全体：単語全体を 検索すると、単語全体のみが返されます。

Reg ex：正規式を使用して 検索します。例えば、次の正規表現はテキストモジュール内の電子メールアドレスを検索します。

[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,4}

テキストモジュールでテキストを検索および置換するには

1. テキストエディターでテキストモジュールを開きます。

2. 「検索と置換」をタップします。

3. 「検索」テキストボックスに検索するテキスト、および見つかったテキストと置換するためのテキストを入力し、「置換」を押します。

4. 検索テキストが見つかると、テキストは置換テキストと置換されます。

   • 検索テキストの他のインスタンスが見つかった場合、そのインスタンスはテキストモジュールでハイライトされます。再び「置換」を押すと、ハイライトされたインスタンスは置換され、3 つ目のインスタンスが見つかった場合は、カーソルは先に進みます。
   • 他のインスタンスが見つからない場合、カーソルは最後に置換されたインスタンスで止まります。

5. 「検索」を再び押すと、検索はページの一番上から続きます。

   「すべて置換」オプションを使用して、テキストモジュール内のすべてのインスタンスを置換します。「」を入力すると、置換の数が「検索と置換」ダイアログにメッセージとして表示されます。

テキストモジュールについてのベストプラクティス、ヒントおよびテクニック

• 重複を回避するために、一貫性のある命名規則を使用します。

• テキストモジュールで適切なデータディクショナリの連結を使用します。

• テキストアセットを変更するときにテキストエディターを使用する場合、次のルールが適用されます。

  • 変数の追加：​可
  • 変数の削除：​可
  • プロパティの更新：​可
  • データディクショナリの変更：​データディクショナリ要素が使用されなくなるまでは可。更新については、データディクショナリを変更できません。

リスト

リストは、テキスト、（その他の）リスト、条件、画像を含む、一連のドキュメントフラグメントです。リスト要素の順番は固定または編集可能にできます。レターを作成する際は、リスト要素の一部またはすべてを使用して、再利用可能な要素のパターンを複製することができます。基本的に、リストは、他のターゲット内にネストできるターゲットとして動作します。

リストの実装

リストの実装は次の 2 つの手順から構成されます。

1. 名前、説明、データディクショナリなどのコアプロパティの定義。
2. リストの一部になるコンテンツのセクションの設定。次にリストのロック順やライブラリアクセスなどのプロパティの設定。

リストの作成

リストは、レターテンプレートで単一のユニットとして使用できる、関連するコンテンツのグループです。任意の種類のコンテンツをリストに追加できます。リストは入れ子にすることもできます。リストモジュールは次のように指定できます。

• 順序指定済み：Correspondence Creator の実行時に順序を変更できません。
• ライブラリアクセス：モジュールをリストに追加できます。このフラグはライブラリアクセスを有効にするかどうかを指定します。有効にする（開く）と、レターをプレビューしながら、モジュールをリストに追加できます。
• リストを作成するときに、次のようなタイプを指定できます。
• なし：追加のスタイルフォーマットはリストに適用されません。
• 箇条書き記号：シンプルな箇条書きでリストがフォーマットされます。
• 番号：標準（1、2、…）、大文字のローマ字（I、II、…）および小文字のローマ字（i、ii、…）から選択できる番号付きリスト。
• アルファベット：小文字（a、b、…）および大文字（A、B、…）から選択できるアルファベットのリスト。
• カスタム：番号およびアルファベットのタイプや、プレフィックスおよびサフィックスの値を希望に応じて作成できます。

1. 「フォーム／ドキュメントフラグメント」を選択します。

2. 作成/リスト​を選択します。

3. リストの次の情報を指定します。

   • タイトル（オプション）：​リストのタイトルを入力します。タイトルは一意である必要はなく、特殊文字や英語以外の文字を含めることもできます。リストは、そのタイトルによって（利用可能な場合）、サムネールやアセットのプロパティとして参照されます。
   • 名前： リストの一意の名前。状態にかかわらず、複数のアセット（テキスト、条件、リスト）の名前を同じにすることはできません。「名前」フィールドでは、英数字およびハイフンのみ使用できます。「名前」フィールドは、タイトルフィールドの値が自動的に入力されます。「タイトル」フィールドに入力した特殊文字、スペース、数字および英数字以外の文字は、ハイフンに置き換えられます。 「タイトル」フィールドの値は「名前」フィールドに自動的にコピーされますが、値を編集することもできます。
   • 説明（オプション）:アセットの説明を入力します。
   • データディクショナリ（オプション）:必要に応じて、接続するデータディクショナリを選択します。リストと同じデータディクショナリを使用するアセット、またはデータディクショナリが割り当てられていないアセットのみをリストに追加できます。データディクショナリをリストに割り当てると、レターテンプレートを作成するときに、適切なリストが見つけやすくなります。
   • タグ（オプション）:適用するタグを選択します。新しいタグ名を入力して作成することもできます。（「保存」をタップすると、新しいタグが作成されます）。

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

5. 「追加アセット」をタップします。

6. リストにアセットを追加するには、アセットを選択ページでアセットを選択し、「完了」をタップします。

   

7. アセットがリスト項目ページに追加されます。リスト内のアセットの順序を変更するには、矢印アイコン()を長押しして、ドラッグ&ドロップします。 ユーザーが通信を作成ユーザーインターフェイスでレターテンプレートを開くと、ここで定義した順にコンテンツがアセンブルされます。

   

8. CCR ユーザーインターフェイスでのリストの動作を指定するには、次のオプションを選択します。

   • ライブラリアクセス：ライブラリにアクセスしてアセットを追加するには、「ライブラリアクセス」をタップします。「ライブラリアクセス」を有効にすると、要求処理担当者はリストにコンテンツを追加できます。有効にしない場合、要求処理担当者はリスト用に定義したコンテンツのみに使用を制限されます。

   • 順序をロック：要求処理担当者が順序を変更できないようにリストのアセット順をロックするには、「順序をロック」をクリックします。このオプションを選択しない場合、要求処理担当者はリスト項目の順序を変更できます。

   • 箇条書き記号を追加：モジュールに箇条書きスタイルまたは段落番号スタイルを適用するには、このオプションを使用します。事前設計されたリストスタイルまたはカスタムのリストスタイルのどちらかを使用できます。各リスト項目の前後に表示するテキストを指定することもできます。

   • 改ページ:リストのコンテンツ間に改ページを追加するには、このオプション( )を選択します。このオプションを選択しない場合()、リストのコンテンツが次のページにオーバーフローすると、リスト間のページが区切られずに、リスト全体が次のページに移動します。

   • 割り当て設定：リストに追加できるアセットの最小数と最大数を指定するには、このオプションを使用します。

9. リスト内にある各アセットの実行時の動作を指定するには、次のオプションを選択します。

   • 編集可能：​このオプションを選択すると、通信を作成ユーザーインターフェイスでコンテンツを編集できます。(このオプションは、リストモジュールと画像モジュールでは使用できません)。
   • 必須：​このオプションを選択すると、通信を作成ユーザーインターフェイスでコンテンツが必須となります。
   • 選択済み：​このオプションを選択すると、通信を作成ユーザーインターフェイスでコンテンツが事前に選択されます。
   • スタイルをスキップ：​このオプションを選択すると、通信を作成ユーザーインターフェイスでコンテンツの箇条書きと段落番号がスキップされます。（このオプションは画像モジュールには使用できません。また、モジュールに適用できるのは「スタイルをスキップ」、「複合」、「無視リストスタイル」のいずれか 1 つのオプションのみになります。モジュールに「箇条書き記号を追加」を選択した場合、これらのオプションのいずれか 1 つを使用できます。）
   • インデント：​リストの一部として選択した各モジュール / コンテンツのインデントレベルを変更できます。インデントはレベル単位で指定します（ゼロから始まります）。各インデントレベルは、36ポイントのパディングに対応します。
   • 複合：​選択すると、複合段落番号が、外側の（親）リストのスタイルとそのリストのスタイルの組み合わせとして適用されます。この入れ子リストの複合段落番号は、この入れ子リストが外側のリストで表示される順序に基づきます。
   • 無視リストスタイル：「複合段落番号」オプションをオフにすると、「リストスタイルを無視する」オプションが有効になります。このオプションを選択すると、入れ子リストのスタイルは無視され、段落番号は外側のリストから継続されます。そのため、入れ子リストのモジュールは、外側のリストの一部として扱われ、入れ子リストで指定したすべてのスタイルが無視されます。入れ子リストに対して「リストスタイルを無視する」オプションをオフにすると、入れ子リストに含まれるモジュールには、独自の段落番号スタイルが設定されます。
   • 次を保持：​リストに含まれるアセットの改ページを設定します。リストの 1 つのアセットの「次を保持」プロパティを「オン」に設定すると、そのアセットと次のアセットは同じページになります。これは、選択されたアセットと次のアセットのコンテンツはページ間で区切られないことを意味します。

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

ベストプラクティス、ヒントおよびテクニック

• 重複を回避するために、一貫性のある命名規則を使用します。

• 適切なデータディクショナリの連結を使用します。

• リストを変更するときにリストエディターを使用する場合、次のルールが適用されます。

  • プロパティの更新：可
  • データディクショナリの変更：​データディクショナリを使用するアイテムが関連付けられなくなるまでは可。更新については、データディクショナリを変更できません。

条件

条件を使用すると、提示されたデータに基づいて通信／レターの作成時に含めるコンテンツを定義できます。制御変数を使用して条件を記述します。条件を追加するときに、制御変数の値に基づいてアセットを含めることもできます。

選択したオプションに基づき、true と判断された最初の式のみまたはすべての条件が、現在の条件変数に基づいて評価されます。通信の作成（CCR）でのレターへの入力時、条件は「ホワイトボックス」のように機能します。条件の結果がリストになる場合、リストのすべての必須アイテムと事前に選択されたアイテムが出力されます。これらのアイテム自体が条件やリストになる場合、その結果のコンテンツも、テキストと画像のコンテンツのフラットリストとしてトップダウン式の深さ優先順で出力されます。条件結果のタイプは任意です（テキスト、リスト、条件、画像）。

条件の実装

条件エディターでは式ビルダーのユーザーインターフェイスも提供され、複数のプレースホルダーとデータディクショナリ要素を使用した式の作成がサポートされています。この式には、共通のオペランドとローカル関数およびグローバル関数が使用できます。式はそれぞれコンテンツと関連付けることができます。オプションとして、true の評価がない場合はデフォルトのセクションにすることができます。各式を定義された順番に評価し、最初に true を返した式が選択され、その式に関連付けられたコンテンツがその条件モジュールによって返されます。

例えば、レターの条項を顧客が住んでいる州によって異なり、データディクショナリに「state」という要素が含まれている場合は、次のような条件を追加できます。 • state = NY, select T&C_NY text paragraph • state = NC, select T&C_NC text paragraph

条件エディターを使用すると、デフォルト条件を指定できます。制御変数の値がいずれの条件とも一致しない場合、デフォルト条件に関連付けられたコンテンツが使用されます。前述の例の後に、次の条件の行を追加できます。
• Default, select T&C_Rest

条件の作成

1. 「フォーム／ドキュメントフラグメント」を選択します。

2. 「作成／条件」を選択します。

3. リストの次の情報を指定します。

   • タイトル（オプション）：条件のタイトルを 入力します。タイトルは一意である必要はなく、特殊文字や英語以外の文字を含めることもできます。条件は、そのタイトルによって（利用可能な場合）、サムネールやアセットのプロパティとして参照されます。
   • 名前： 条件の一意の名前。状態にかかわらず、複数のアセット（テキスト、条件、リスト）の名前を同じにすることはできません。「名前」フィールドでは、英数字およびハイフンのみ使用できます。「名前」フィールドは、タイトルフィールドに基づいて自動的に入力されます。「タイトル」フィールドに入力した特殊文字、スペース、数字および英数字以外の文字は、ハイフンに置き換えられます。 「タイトル」フィールドの値は「名前」フィールドに自動的にコピーされますが、値を編集することもできます。
   • 説明（オプション）条件の説明を 入力します。
   • データディクショナリ（オプション）:必要に応じて、接続するデータディクショナリを選択します。条件と同じデータディクショナリを使用するアセット、またはデータディクショナリが割り当てられていないアセットのみをリストに追加できます。データディクショナリをリストに割り当てると、レターテンプレートを作成するときに、適切な条件が見つけやすくなります。
   • タグ（オプション）:必要に応じて、適用するタグを選択します。新しいタグ名を入力して作成することもできます。（「保存」をタップすると、新しいタグが作成されます）。

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

5. 「追加アセット」をタップします。

6. アセットを条件に追加するには、アセットを選択ページでアセットを選択し、「完了」をタップします。 アセットが式ウィンドウに追加されます。

7. 条件の実行時の動作を指定するには、次のオプションを選択します。

   • 複数の結果評価を無効化 / 複数の結果評価を有効化：このオプションを有効にする（「複数の結果評価を有効化」を表示する）と、すべての条件が評価され、結果としてすべての true 条件の概要が表示されます。このオプションを無効にする（「複数の結果評価を無効化」を表示する）と、true と判断された最初の条件のみが評価され、その条件が出力されます。
   • 改ページ:条件のモジュール間に改ページを追加するには、このオプション( )を選択します。このオプションを選択しない場合()、条件が次のページにオーバーフローすると、条件間のページは区切らずに、条件全体が次のページに移動します。

8. 条件内のアセットの順序を変更するには、矢印アイコン()を長押しして、ドラッグ&ドロップします。 ユーザーが通信を作成ユーザーインターフェイスでレターテンプレートを開くと、ここで定義した順にコンテンツがアセンブルされます。

9. 「削除」をタップして、行を削除します。 デフォルトの行で「削除」をタップすると、アセット情報のみがクリアされます。

10. 「コピー」をタップして、行を重複します。

11. 「編集」をタップして、アセットを変更するか、式を編集します。

    さらに、以下の点も変更されています。

    • アセットを更新するには、アセット列の下にあるフォルダーアイコンをタップします。
    • 式ビルダーを開いて式を挿入するには、式列の下にあるフォルダーアイコンをタップします。式ビルダーについて詳しくは、「式ビルダー」を参照してください。

ベストプラクティス、ヒントおよびテクニック

• 検索を容易にし、重複を回避するため、一貫性のある命名規則を使用します。

• 条件はケース文のように動作するので、条件の順序は重要です。最初の一致が返されます。

• 適切なデータディクショナリの連結を使用します。

• 条件を編集するときに条件エディターを使用する場合、次のルールが適用されます。

  • 変数の追加：​可
  • 変数の削除：​可
  • プロパティの更新：​可
  • データディクショナリの変更：​データディクショナリ要素が使用されなくなるまでは可。

レイアウトフラグメント

レイアウトフラグメントは Designer で作成された XDP に基づいています。レイアウトフラグメントを作成するには、XDPを作成し、AEM Formsにアップロードする必要があります。

1 つ以上のレイアウトフラグメントによってレターのパーツを形成し、これらのパーツのグラフィカルレイアウトを定義できます。レイアウトフラグメントには、「アドレス」、「参照番号」、ターゲット領域を指定する空のサブフォームなど、一般的なフォームフィールドを含めることができます。また、レイアウトフラグメントを使用してテーブルを作成し、テーブルをレターに挿入できます。

一般的には、再利用可能なレイアウトパターンをレターで見つけて、これらのパターンを使用してレイアウトフラグメントを作成します。例えば、複数のレターで同じ順に表示される挨拶、住所、レターの件名を使用します。または、複数のレターで使用されている行数と列数が同じテーブルなどを使用します。

レイアウトフラグメントは既存の XDP に基づいて作成できます。レイアウトフラグメントはフィールドとターゲット領域を使用するか、1 つ以上のテーブルを使用して作成できます。レイアウト内のテーブルは静的または動的にすることができます。XDP は Designer で作成され、AEM Forms にアップロードされます。XDP はレイアウトフラグメントまたはレターの構造を形成できます。レイアウトデザインについての詳細。

ターゲット領域に連結されているフラグメントを使用することで、作成時にレターを変更できます。異なるサイズのレイアウトフラグメントを作成し、適切なフラグメントをターゲット領域に連結できます。レイアウトフラグメントでは、次のように一部のテーブルプロパティをカスタマイズすることもできます。

1. 行数と列数を追加できます。
2. 追加した行と列にヘッダーおよびフッターのテキストを指定できます。
3. テーブル列の幅の比率を指定できます。実行時に、指定した比率と空きスペースに基づいてテーブル列がサイズ変更されます。幅の比率の合計は 100 になる必要があります。そうでない場合は適用できません。
4. テーブルがプレースホルダー（空白のセルを 1 つだけ含む）の場合、新しい列のタイプ（ターゲット領域またはフィールド）を指定できます。
5. ヘッダー行およびフッター行を非表示にできます。

この手順を実行する前に、Designer を使用して XFA フラグメントを作成します。フラグメントには、フィールドとターゲット領域の構成するためのテーブルを含めることができます。Designer では、静的と動的の 2 つのタイプのテーブルを作成できます。静的テーブルの行数は固定されています。静的テーブルには、ターゲット領域とフィールドを含めることができます。これらのターゲット領域とフィールドを、繰り返し DDE に連結することはできません。動的テーブルにも 1 つの行を含めることができます。動的テーブルの行数は、テーブルセルに連結されるデータによって決まります。動的テーブルには、フィールドのみを含めることができます。DDE は、繰り返しでも繰り返しなしでも連結できます。

テーブルをデザインする際は、次のポイントを考慮します。

1. レイアウトフラグメントの作成時に、テーブルをカスタマイズできます。ただし、カスタマイズのオプションはテーブルの親サブフォームがフローの場合のみ有効です。
2. 動的テーブルの場合、フィールド、繰り返し可能な行およびテーブルではすべて「名前による」の連結を使用し、データが正しくマージされるようにします。
3. 動的テーブルの場合、テーブルフィールドに連結される繰り返し DDE がすべて同じ階層の一部となるようにします。繰り返しなしの DDE については、このような制限がありません。
4. レイアウトフラグメントを親ターゲット領域にマージするとき、テーブルが空きスペースに合わせてサイズ変更されますが、サイズ変更はレイアウトフラグメントが最上位のサブフォーム内に直接設定されているターゲット領域またはフィールドを含まない場合のみ行われます。テーブル内のターゲット領域およびフィールドは許可されます。
5. プレースホルダーテーブルを作成できます。プレースホルダーテーブルには、空白のセルが 1 つだけあります。

• プレースホルダーテーブルの場合、フラグメントの作成時に次のプロパティをカスタマイズできます。

  • 行数
  • 列数
  • 各列のヘッダーおよびフッター
  • 各列のタイプ（ターゲット領域またはフィールド）
  • 各列の幅の比率

• プレースホルダー以外のテーブルでは、次のプロパティをカスタマイズできます。

  • 行数
  • 列数
  • 追加する列のヘッダーおよびフッター
  • 各列の幅の比率

レターではフラグメントをネストできます。これはフラグメント内にフラグメントを追加できることを意味します。Correspondence Managementソリューションは、レター内で最大4レベルのネストをサポートします。レター->フラグメント->フラグメント->フラグメント->フラグメント

レイアウトフラグメントで静的および動的テーブルを使用する例について詳しくは、サンプルファイルを使用した例を参照してください。レター内での静的および動的テーブルの使用。

レイアウトフラグメントの作成

1. 「作成／レイアウトフラグメント」を選択します。

2. Correspondence Management に利用可能な XDP が表示されます。レイアウトフラグメントのベースにするXDPを選択し、「次へ」をタップします。

3. レイアウトの次の情報を指定します。

   • タイトル（オプション）：​レイアウトフラグメントのタイトルを入力します。タイトルは一意である必要はなく、特殊文字や英語以外の文字を含めることもできます。レイアウトフラグメントは、そのタイトルによって（利用可能な場合）、サムネールやアセットのプロパティとして参照されます。
   • 名前：レ イアウトフラグメントの一意の名前。状態にかかわらず、複数のアセット（テキスト、条件、リスト）の名前を同じにすることはできません。「名前」フィールドでは、英数字およびハイフンのみ使用できます。「名前」フィールドは、タイトルフィールドに基づいて自動的に入力されます。「タイトル」フィールドに入力した特殊文字、スペース、数字および英数字以外の文字は、ハイフンに置き換えられます。 「タイトル」フィールドの値は「名前」フィールドに自動的にコピーされますが、値を編集することもできます。この名前は、アセットを管理ユーザーインターフェイスのリストに表示されます。
   • 説明（オプション）:アセットを管理ユーザーインターフェイスのリストに表示される説明です。
   • タグ（オプション）:オプションで、条件に適用するタグを選択します。新しいタグ名を入力して作成することもできます。

4. 「テーブル」タブをタップし、レイアウトの次の情報を指定します。

   • 設定:設定するテーブルを選択します。ドロップダウン内のテーブル名のサフィックスは、テーブルが静的な場合は「Static」、テーブルが動的な場合は「Dynamic」です。静的テーブルの行数は固定されています。静的テーブルには、ターゲット領域とフィールドを含めることができます。これらのターゲット領域とフィールドを、繰り返し DDE に連結することはできません。動的テーブルの行数は、テーブルセルに連結されるデータによって決まります。

   • 行：レイアウトの行数を選択します。元の行数以上に設定する必要があります。

   • 列：レイアウトの列数を選択します。元の列数以上に設定する必要があります。

   列ごとに、次の内容を設定する必要があります。

   • ヘッダー：ヘッダーとして表示するテキスト
   • フッター：フッターとして表示するテキスト
   • タイプ：追加する列のタイプ。フィールドまたはターゲット領域を設定します。「タイプ」は静的プレースホルダーテーブルで有効です。「タイプ」は列のレベルで指定でき、セルのレベルでは指定できません。拡張された列のセルはすべて同じタイプになります。動的テーブルの場合、すべての列がフィールドタイプになります。プレースホルダー以外のテーブルの場合、追加する列のタイプは指定できません。この場合、拡張された列で追加されたセルのタイプは、その行の最後の列のタイプと同じになり、追加された行のセルのタイプは、その列の最後のセルのタイプと同じになります。
   • 幅の比率：テーブル列の幅の比率。

   レイアウトフラグメントで静的および動的テーブルを使用する例について詳しくは、サンプルファイルを使用した例を参照してください。レター内での静的および動的テーブルの使用。

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

Correspondence Management への XDP のアップロード

Correspondence Management に XDP をアップロードする／読み込む手順については、「AEM Forms におけるアセットの読み込みと書き出し」を参照してください。

ベストプラクティス、ヒントおよびテクニック

デフォルトのサブフォームの連結の設定

Designer でターゲット領域を作成する場合、すべての新しいサブフォームのデフォルトの連結を簡単に「なし」に設定できます。

デフォルトの連結を設定するには、次の手順を実行します。

1. Designerで、ツール/オプション/データ連結/サブフォームの連結​をタップします。

2. 「新規サブフォーム」リストの「デフォルトの連結」で、「データ連結なし」を選択します。

「挿入／サブフォーム」コマンドを使用するか、オブジェクトパレットからドラッグ＆ドロップして挿入したサブフォームは、デフォルトで「なし」の連結があります。つまり、すべての新しいサブフォームはデフォルトで、コンテンツを追加するか、連結設定を変更するか、サフィックスが「_int」の名前をサブフォームに付けるという操作をしない限り、ターゲット領域になります。

リハビリテーション法第 508 条への準拠

通信を作成ユーザーインターフェイスで作成したレターを、今後のワークフローで入力に使用する場合、レイアウトの際には、米国リハビリテーション法第 508 条に関連する次の推奨事項に従います。そうしないと、レター PDF は単に表示用になり、これらの推奨事項を無視することになる可能性があります。

• レイアウト内のすべてのターゲット領域のサブフォームとすべてのフィールドには、タブ順を指定します。
• キャプションがあるフィールドは、デフォルトで 508 準拠です。フィールドの /field/assist/speak@priority 属性はデフォルトで「custom」に設定されています。つまり、カスタムのスクリーンリーダーテキストを提供しない限り、フィールドのキャプションがスクリーンリーダーによって読み取られます。
• キャプションがないフィールドにはツールチップを指定し、スクリーンリーダーがツールチップを読み取るように指定します。これには、

/field/assist/speak@priority="toolTip" でツールヒントテキストを指定し /field/assist/toolTipます。

Designer および Asset Configuration Manager での日付形式

Designer でレイアウトをデザインするとき、日付フィールドの形式が、Correspondence Management 設定プロパティの日付の表示形式で指定した日付形式と一致していることを確認します。詳しくは、Designer ヘルプの「フィールド値の形式設定とパターンの使用」を参照してください。

日付の範囲のキャプチャ

startDate ～ endDate など、日付の組み合わせを処理する場合、単一のサブフォームを使用して、完成したレターの配置が正しいことを確認し、フィールドの数を最小限に抑えます。

フォームレベルの連結の設定

レイアウトに、単一の XML 要素にマッピングされるフィールドとターゲット領域が多数ある場合、フォームレベルの連結を使用し、各要素に個別のノードを作成します。Correspondence Management でデータをマッピングするときに、フォームレベルで連結されるフィールドは無視されます。

マスターページでサブフォームのターゲット領域は使用不可

マスターページのサブフォームのターゲット領域は、アセットを管理ユーザーインターフェイスで表示されません。また、データをマッピングできません。

ターゲット領域に適した位置とタイプの選択

レイアウトをデザインする場合、サブフォームの選択には注意が必要です。レイアウトに含まれるサブフォームが単一の場合、フロータイプにすることができます。サブフォームにフィールドを配置した後に、別のサブフォームでラップできます。その結果、ラップされたサブフォームもフローするようになり、レイアウトが乱れません。

マスターページへのフィールドの配置

マスターページにフィールドを配置する場合は、次の点に注意する必要があります。

• マスターフィールドの連結を「グローバルデータによる」に設定します。
• フィールドをマスターページの PageArea のルート直下には配置しません。
• フィールドを名前の付いたサブフォームに含めて、名前の付いたサブフォームの連結が「名前による」に設定されていることを確認します。

レイアウトフラグメントを使用したテーブルの作成

レターテンプレートの多くにテーブルが含まれます。テーブルには静的テーブルがあります。例えば契約条件のテーブルでは、行ごとに 1 つずつ条件が示され、個別の列に各パーツが表示されます。動的テーブルもあります。例えばアカウント情報のテーブルには、顧客の名前、アカウント ID、取引番号および取引金額などの情報が含まれます。

• 静的テーブル：契約条件のテーブルなど、行によって列の数が異なるテーブルを作成する場合があります。このようなテーブルでは、各行に 1 つずつ条件が表示され、条件ごとに異なるサブパーツが含まれます。各パーツは、個別の列に表示されます。
• 動的テーブル：レイアウトフラグメントには、動的テーブルのフィールドをコレクション DDE に連結させる機能があります。レター生成時に、コレクション DDE のサイズに従ってテーブル行が生成されます。

DD には Nominee_details コレクション要素があります。このコレクション要素には 1 つの複合要素と、Nominee_name、Nominee_address、Nominee_gender という 3 つのプリミティブ要素があります。動的 XDP にも同じヘッダーがあります。このため、上記の DD フィールドを使用して、動的 XDP フィールドをマッピングできます。

サンプルファイルを用いた例：レター内での静的および動的テーブルの使用

この例では、動的および静的テーブルを 1 つずつ作成し、動的テーブルを DDE に連結して、これらの 2 つのテーブルを含むレターを作成する方法を示します。この例を使用すると、ファイルを最初から作成するか、手順を実行するために用意されている入力ファイルを使用できます。

1. 図に示すように、例で使用するデータディクショナリ（DD）を作成します。

   次に、DD を選択してサンプルデータを書き出します。提供される XML ファイルには従業員データと、Nominee_details の 3 つのインスタンスが含まれています（デフォルトでは 3 つのインスタンスがダウンロードされますが、必要に応じて追加または削除できます）。値を更新し、テストデータを DD に読み込みます。CMP ファイルはパッケージになっていて、DD が含まれています。DD を Correspondence Management に読み込みます。

   データディクショナリとテストデータの使用について詳しくは、「データディクショナリ」を参照してください。

   

   ファイルを入手

2. Designer で、2 つの XDP（レイアウトフラグメント）、つまり動的テーブルと静的テーブルを 1 つずつ作成します。両方のレイアウトに対して次の操作を実行します。

   • サ追加ブフォームをテーブル列に追加します。 テーブルの親サブフォームのレイアウトをフローに変更し、テーブル内のサブフォームの連結を削除してください。
   • テ追加ーブルのセルのサブフォームです。 テーブルの親サブフォームのレイアウトをフローに変更し、テーブル内のサブフォームの連結を削除してください。

   または、この手順を実行するために用意されている静的および動的 XDP を使用します。

   レイアウトフラグメントの使用について詳しくは、「レイアウトフラグメント」を参照してください。レイアウトのデザインについて詳しくは、「Designer ヘルプ」を参照してください。

   ファイルを入手

   ファイルを入手

3. XDP を AEM Forms にアップロードします。

4. 動的 XDP に基づいてレイアウトフラグメントを作成します。プロパティの「テーブル」タブに、テーブルが動的であることが示されます（「設定対象フィールド」）。行数（1）および列数（3）は、XDP／レイアウトフラグメントから派生します。

   このレイアウトのフィールドは読み込んだ DD に後で連結されます。また、レターでは、行数がテストデータファイル（DD に付属している XML データファイル）のレコード数に基づいて動的に作成されます。

   

   クリックすると拡大画像が開きます

5. 静的 XDP に基づいてレイアウトフラグメントを作成します。プロパティの「テーブル」タブにテーブルが静的であることが示されます（「設定対象フィールド」）。行数（1）および列数（3）は、XDP／レイアウトフラグメントから派生します。

   ここで列数と行数を変更できます。画面での選択内容に応じて、静的テーブルの行数と列数は、後でこのレイアウトを使用して作成されるレターで固定されます。
   

6. 両方のレイアウトフラグメントを使用してレターを作成します。動的 XDP をレターに挿入する際、フィールドの連結をデータディクショナリのコレクション要素に設定します。

   レターおよびレターテンプレートの作成について詳しくは、「レターの作成」を参照してください。

7. レターを保存してプレビューします。レターをプレビューすると、データディクショナリの値がレターに表示されます。動的テーブルには、行が 3 つあります。テストデータには 3 つのレコードがあり、それぞれ行ごとに含まれていたためです。

   静的テーブルには、レイアウトフラグメントの作成中に指定した数だけ行と列があります。

   

   動的テーブルには、テストデータファイル内のレコード数に基づいて 3 つの行が表示されます。これは、レイアウトをレターに追加する際に、動的テーブルのフィールドとデータディクショナリのコレクション要素間に連結を作成したためです。名前、住所、性別の値は、使用したテストデータファイルによって入力されます。

   

ドキュメントフラグメントのコピーを作成する

フラグメントをコピーして貼り付けることで、既存のドキュメントフラグメントに類似したプロパティとコンテンツを持つドキュメントフラグメントをすばやく作成できます。

1. ドキュメントフラグメントのリストから、ドキュメントフラグメントを 1 つ以上選択します。UI に「コピー」アイコンが表示されます。
2. 「コピー」をタップします。UI に「貼り付け」アイコンが表示されます。レターを貼り付ける前に、フォルダー内に移動することもできます。複数のフォルダーに同じ名前のアセットを保管することができます。フォルダーについて詳しくは、フォルダーとアセットの整理を参照してください。
3. 「貼り付け」をタップします。貼り付けダイアログが表示されます。複数のドキュメントフラグメントをコピーして同じ場所に貼り付けると、それらのレターの新しいコピーに対して名前とタイトルが自動的に割り当てられますが、その名前とタイトルは編集することができます。
4. 必要に応じて、ドキュメントフラグメントのコピーを保存するタイトルと名前を編集します。
5. 「貼り付け」をタップします。ドキュメントフラグメントのコピーが作成されます。