ドキュメントフラグメントは、レターや通信を構成できる、通信の再利用可能なパーツやコンポーネントです。 ドキュメントフラグメントには、次の種類があります。
テキストアセットは、1 つ以上の段落で構成されるコンテンツです。 段落は静的または動的にすることができます。動的段落には、データ要素への参照が含まれます。データ要素の値は実行時に提供されます。 例えば、レターのあいさつ文の顧客名は動的なデータ要素で、実行時に値が使用可能になります。 これらの値を変更すると、同じレターテンプレートを使用して、異なる顧客のレターを生成できます。
Correspondence Management Solution は、動的データ項目(可変データ)に対して 2 種類のサポートを行います。
Correspondence Management テンプレートでは、プレースホルダーを作成する際に一意の名前を作成するように強制されません。 テキストと条件など、同じ名前のプレースホルダを 2 つ作成し、その両方をレターテンプレートで使用する場合、最後に挿入したプレースホルダの値が両方のプレースホルダに使用されます。 2 つのプレースホルダの名前が同じ場合、そのタイプが比較されます。 型が異なる場合、型は String になります。 ただし、モジュール内では、同じ名前のプレースホルダを複数作成することはできません。
「フォーム/ドキュメントフラグメント」を選択します。
タップ 作成 > テキスト。 または、テキストアセットを選択して、 編集.
テキストの次の情報を指定します。
次へをタップします。テキストの段落やデータ要素をテキストに追加できるエディターページが、Correspondence Management によって表示されます。
ブラウザーのデフォルトのスペルチェッカーは、テキストエディターでスペルチェックを行います。 スペルチェックや文法チェックを管理するには、ブラウザのスペルチェッカー設定を編集するか、またはスペルチェックや文法チェックを行うためのブラウザプラグインやアドオンをインストールします。
また、テキストエディターでは、様々なキーボードショートカットを使用して、テキストの管理、編集や書式設定を行うこともできます。テキストエディターキーボードショートカットについて詳しくは、「Correspondence Management キーボードショートカット」を参照してください。
テキストエディターが開くので、テキストを入力します。ページの最上部にあるツールバーを使用して、テキストの書式設定や、条件、リンク、改ページの挿入を行います。
図: ツールバー
テキストエディターが開きます。テキストを入力します。段落、整列、リストなど、編集のタイプによってツールバーが変わります。
図: ツールバーのタイプを選択します。段落、整列またはリスト
図: 段落ツールバー
図: 整列ツールバー
図: リストツールバー
MS Word やHTMLページなど、別のアプリケーションに存在するテキストの段落を 1 つ以上再利用するには、テキストをコピーしてテキストエディターに貼り付けます。 コピーしたテキストの書式は、テキストエディターでも保持されます。
編集可能なテキストモジュールでは、1 つ以上のテキスト段落をコピーして貼り付けることができます。 例えば、次のような許容可能な居住証明書の箇条書きリストを含む MS Word ドキュメントがあるとします。
MS Word ドキュメントから編集可能なテキストモジュールに、テキストを直接コピーして貼り付けることができます。 箇条書きリスト、フォント、テキストの色などの書式は、テキストモジュールでも保持されます。
ただし、貼り付けられたテキストの書式設定にはいくつかの制約があります。
必要に応じて、ドキュメントフラグメントに特殊文字を挿入します。例えば、特殊文字パレットを使用して、以下の特殊文字を挿入することができます。
Correspondence Managementhas では、210 種類の特殊文字に初期状態から対応しています。管理者は、カスタマイズすることで特殊文字を増やしたり、カスタムの特殊文字を追加したりすることができます。
編集可能なインラインモジュールのテキストの一部をハイライト表示または強調するには、テキストを選択して「ハイライト表示の色」をタップします。
基本色パレットに表示されている基本色 [A]
を直接タップすることも、スライダー [B]
を使用して、その色の適切な網掛けを選択した後で選択をタップすることもできます。
オプションで、「詳細」タブに移動して、適切な色相、明度、彩度 [C]
を選択して正確な色を作成し、「選択 [D]
」をタップして、その色を適用してテキストをハイライト表示することもできます。
データディクショナリ要素とプレースホルダー要素をデータパネルからテキストにドラッグ&ドロップします。
To:
図: データディクショナリのサンプルデータファイルで指定されたプレースホルダー要素
図: サンプルデータファイルで指定されたデータディクショナリ変数から入力された、CCR ビューのプレースホルダー要素値
インライン条件と繰り返しを使用して、文脈性の高い、構成力のあるレターにすることができます。インライン条件と繰り返しについて詳しくは、レターのインライン条件と繰り返しを参照してください。
保存をタップします。
大量のテキストを含むテキスト要素で作業する際、特定のテキスト文字列を検索する必要があります。また、特定のテキスト文字列を別の文字列と置換する必要がある場合もあります。
検索と置換機能を使用すると、テキスト要素内の任意の文字列を検索(および置換)できます。 この機能には、強力な正規表現検索も含まれています。
テキストエディターでテキストモジュールを開きます。
「検索と置換」をタップします。
検索するテキストを「検索」テキスト・ボックスに入力し、「検索」を押します。 テキストモジュールで検索テキストがハイライト表示されます。
テキストの次のインスタンスを検索するには、再び「検索」を押します。
「検索」ボタンを押し続けると、ページの下方に検索が継続されます。テキストの最後のインスタンスが見つかった後に表示される「モジュールの最後に達しました」のメッセージは、検索結果がそれ以上見つからないことを示します。
ただし、テキストモジュールで検索テキストのインスタンスが見つからない場合は、一致が見つかりませんでしたというメッセージが表示されます。
「検索」を再び押すと、検索はページの一番上から続行されます。
大文字/小文字の一致:検索は、大文字/小文字が一致する結果のみを返します。
単語全体:単語全体が一致する結果のみを返します。
注意: 「検索」テキストボックスに特殊文字を入力すると、「単語全体」オプションは無効になります。
Reg ex:正規表現を使用して検索します。例えば、次の正規表現はテキストモジュール内のメールアドレスを検索します。
[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,4}
テキストエディターでテキストモジュールを開きます。
「検索と置換」をタップします。
検索するテキストを「検索」テキストボックスに入力し、検索するテキストを置換するテキストを入力して、「置換」を押します。
検索テキストが見つかった場合、そのテキストは「置換」テキストに置き換えられます。
「検索」を再び押すと、検索はページの一番上から続行されます。
「すべてを置換」オプションを使用して、テキストモジュール内のテキストのインスタンスをすべて置き換えます。 us`` を行うと、「検索と置換」ダイアログで置換の数がメッセージとして表示されます。
重複を避けるために、一貫した命名規則を使用します。
テキストモジュールで適切なデータディクショナリの連結を使用します。
テキストアセットを変更する際にテキストエディターを使用する場合、次の規則が適用されます。
リストは、テキスト、(その他の)リスト、条件、画像を含む、ドキュメントフラグメントのグループです。 リスト要素の順序は、固定または編集可能にすることができます。 レターを作成する際に、一部またはすべてのリスト要素を使用して、再利用可能な要素のパターンを複製できます。 リストは基本的に、他のターゲット内でネスト可能なターゲットとして動作します。
リストの実装は、次の 2 つの手順で構成されます。
リストは、レターテンプレートで単一の単位として使用できる関連コンテンツのグループです。 リストには、任意の種類のコンテンツを追加できます。 リストはネストすることもできます。 リストモジュールは、次のように指定できます。
「フォーム/ドキュメントフラグメント」を選択します。
「作成/リスト」を選択します。
リストの次の情報を指定します。
「次へ」をタップします。
「アセットを追加」をタップします。
リストにアセットを追加するには、アセット選択ページでアセットを選択して「完了」をタップします。
アセットがリスト項目ページに追加されます。
リスト内のアセットの順序を変更するには、矢印アイコン()を長押しして、ドラッグ&ドロップします。ユーザーが通信を作成ユーザーインターフェイスでレターテンプレートを開くと、ここで定義した順にコンテンツがアセンブリされます。
次のオプションを選択して、CCR ユーザーインターフェイスでのリストの動作を指定できます。
リスト内の各アセットの実行時の動作を指定するには、次のオプションを選択します。
「保存」をタップします。
重複を避けるために、一貫した命名規則を使用します。
適切なデータディクショナリの連結を使用する
リストエディターを使用してリストを変更する場合、次の規則が適用されます。
条件を使用すると、指定されたデータに基づいて、通信/レターの作成時に含めるコンテンツを定義できます。 条件については、制御変数で説明します。 条件を追加するときに、制御変数の値に基づいてアセットを含めることもできます。
選択したオプションに基づいて、true と判断された最初の式のみ、現在の条件変数に基づいて評価されるか、すべての条件が評価されます。 通信を作成 (CCR) でレターに入力する際、条件は「ホワイトボックス」として動作します。 条件がリストになると、リストのすべての必須項目と事前選択項目が出力されます。 これらの項目のいずれかが条件またはリスト自体である場合、結果のコンテンツも、テキストおよび画像コンテンツのフラットリストとして、トップダウンの深さ優先順で出力されます。 条件の結果は、任意のタイプ(テキスト、リスト、条件、画像)です。
条件エディターには、 式ビルダー 複数のプレースホルダーとデータディクショナリ要素の両方を使用した式の作成をサポートするユーザーインターフェイス。 このような式では、一般的なオペランドとローカル/グローバル関数を使用できます。 各式は、一部のコンテンツに関連付けることができ、必要に応じて、true と評価される式がない場合にデフォルトのセクションを含めることができます。 すべての式は、定義された順序で評価され、最初に true を返す式が選択され、その条件モジュールによって関連するコンテンツが返されます。
例えば、レターの利用条件のテキストが顧客の州によって異なり、データディクショナリに「state」と呼ばれる要素が含まれている場合、条件を次のように追加できます。
・ state = NY、T&C_NY テキスト段落を選択
・ state = NC、T&C_NC テキスト段落を選択
条件エディターを使用して、デフォルトの条件を指定できます。 制御変数の値がどの条件とも一致しない場合は、デフォルト条件に関連付けられたコンテンツが使用されます。 前述の例の後に、次の条件の行を追加できます。
• Default, select T&C_Rest
「フォーム/ドキュメントフラグメント」を選択します。
「作成/条件」を選択します。
リストの次の情報を指定します。
「次へ」をタップします。
「アセットを追加」をタップします。
アセットを条件に追加するには、アセットを選択ページでアセットを選択し、「完了」をタップします。アセットが式ウィンドウに追加されます。
条件の実行時の動作を指定するには、次のオプションを選択します。
条件内のアセットの順序を変更するには、矢印アイコン()を長押しして、ドラッグ&ドロップします。ユーザーが通信の作成ユーザーインターフェイスでレターテンプレートを開くと、ここで定義した順にコンテンツがアセンブルされます。
行を削除するには、「削除」をタップします。デフォルトの行で「削除」をタップすると、アセット情報のみがクリアされます。
「コピー」をタップし、行を複製します。
「編集」をタップし、アセットを変更するか、式を編集します。
詳細情報:
検索を容易にし、重複を避けるために、一貫性のある命名規則を使用します。
条件はケースステートメントと同じように動作するので、条件の順序は重要です。 最初の一致が返されます。
適切なデータディクショナリの連結を使用する
条件エディターを使用して条件を編集する場合、次のルールが適用されます。
レイアウトフラグメントは、Designer で作成された XDP に基づいています。 レイアウトフラグメントを作成するには、XDP を作成し、それを AEM Forms にアップロードする必要があります。
1 つ以上のレイアウトフラグメントは、レターの一部を形成し、それらのパーツのグラフィカルなレイアウトを定義できます。 レイアウトフラグメントには、「住所」や「参照番号」などの一般的なフォームフィールドや、ターゲット領域を表す空のサブフォームを含めることができます。 また、レイアウトフラグメントを使用してテーブルを作成し、テーブルをレターに挿入できます。
一般的な使用例は、再利用可能なレイアウトパターンをレター内に配置し、それらのレイアウトパターン用のレイアウトフラグメントを作成する場合です。 例えば、複数の文字が同じ順序で出現する、レターの敬称、住所、件名の部分です。 または、複数のレターで使用されている行数と列数が同じテーブルなどを使用します。
既存の XDP に基づいてレイアウトフラグメントを作成できます。 レイアウトフラグメントは、フィールドとターゲット領域、または 1 つ以上のテーブルで構成できます。 レイアウト内のテーブルは、静的または動的に設定できます。 XDP は Designer で作成され、 AEM Formsにアップロード済み. XDP は、レイアウトフラグメントまたはレターの構造を形成できます。 詳しくは、レイアウトデザインを参照してください。
ターゲット領域にバインドされたフラグメントを使用すると、作成時にレターを変更できます。 異なるサイズのレイアウトフラグメントを作成し、適切なフラグメントをターゲット領域に連結できます。 レイアウトフラグメントを使用すると、次のようなテーブルプロパティの一部をカスタマイズすることもできます。
この手順を実行する前に、Designer を使用して XFA フラグメントを作成します。 フラグメントには、フィールドやターゲット領域を整理するためのテーブルを含めることができます。 Designer では、次の 2 種類のテーブルを作成できます。静的および動的。 静的テーブルには、固定数の行が含まれます。 静的テーブルには、ターゲット領域とフィールドを含めることができます。 これらのターゲット領域およびフィールドを繰り返し DDE にバインドすることはできません。 動的テーブルには、1 つの行を含めることもできます。 テーブルのセルに連結されるデータによって、動的テーブルの行数が決まります。 動的テーブルには、フィールドのみを含めることができます。 DDE は、繰り返しまたは繰り返しなしで指定できます。
テーブルを設計する際は、次の点に注意してください。
プレースホルダーテーブルの場合、フラグメントの作成時に次のプロパティをカスタマイズできます。
プレースホルダー以外のテーブルの場合は、次のプロパティをカスタマイズできます。
レター内でフラグメントをネストできます。 これは、フラグメント内にフラグメントを追加できることを意味します。 Correspondence Management ソリューションは最大 4 レベルのネストをレター内でサポートします。レター>フラグメント>フラグメント>フラグメント>フラグメント
レイアウトフラグメントで静的および動的テーブルを使用する例について詳しくは、サンプルファイルの使用例:レター内での静的および動的テーブルの使用を参照してください。
「作成/レイアウトフラグメント」を選択します。
Correspondence Management に利用可能な XDP が表示されます。レイアウトフラグメントのベースとする XDP を選択し、「次へ」をタップします。
レイアウトの次の情報を指定します。
「テーブル」タブをタップし、レイアウトの次の情報を指定します。
列ごとに、次の詳細が必要です。
レイアウトフラグメントで静的および動的テーブルを使用する例について詳しくは、サンプルファイルの使用例:レター内での静的および動的テーブルの使用を参照してください。
「保存」をタップします。
Correspondence Management に XDP をアップロード/読み込む手順については、 AEM Formsへのアセットの読み込みと書き出し.
Designer でターゲット領域を作成する場合、新しいすべてのサブフォームのデフォルトの連結を「なし」に設定すると便利です。
デフォルトの連結を設定するには:
Designer で、ツール/オプション/データ連結/サブフォームの連結をタップします。
「新規サブフォームのデフォルト連結」リストで、 データ連結がありません.
これにより、挿入/サブフォームコマンドを使用するか、オブジェクトパレットからドラッグ&ドロップして挿入したサブフォームは、デフォルトで「なし」の連結を持つようになります。 つまり、デフォルトでは、コンテンツを追加したり、連結設定を変更したり、サブフォームに「_int」サフィックスを付けたりしない限り、新しいサブフォームはすべてターゲット領域になります。
通信を作成ユーザーインターフェイスで作成した完成したレターが、後のワークフローでの入力に使用される場合。 レイアウトを作成する際は、 Section 508 に関する次の推奨事項に従います。 そうしないと、レターPDFは表示用になり、次の推奨事項を無視することができます。
/field/assist/speak@priority="toolTip"
を設定し、/field/assist/toolTip
でツールヒントのテキストを指定します。
Designer でレイアウトをデザインする際は、日付フィールドの形式が、 Correspondence Management 設定プロパティ. 詳しくは、Designer ヘルプの「フィールド値の書式設定とパターンの使用」を参照してください。
startDate ~ endDate など、日付の組み合わせを処理する場合は、1 つのサブフォームを使用して、完成したレターの配置が正しいことを確認し、フィールドの数を最小限に抑えます。
レイアウトに、単一の XML 要素にマッピングされる多数のフィールドとターゲット領域が含まれる場合、フォームレベルの連結を使用し、要素ごとに個別のノードを作成します。 Correspondence Management でデータをマッピングする際、フォームレベルで連結されたフィールドは無視されます。
マスターページのサブフォームのターゲット領域は、アセットを管理ユーザーインターフェイスに表示されず、データをマッピングできません。
レイアウトをデザインする際は、サブフォームを選択する際に注意が必要です。 レイアウトに 1 つのサブフォームが含まれる場合、フロータイプにすることができます。 サブフォーム内にフィールドを配置した後は、別のサブフォームに含めて、ラップされたサブフォームもフローに配置し、レイアウトを乱さないようにすることができます。
マスターページにフィールドを配置する場合は、次の点に注意してください。
多くのレターテンプレートにはテーブルが含まれています。 テーブルは静的にすることができます。例えば、用語と条件のテーブルでは、各行が 1 つの条件を表し、各部分が別々の列に表示されます。 テーブルには、顧客名、アカウント ID、トランザクション番号、トランザクション金額などの情報を含む、動的なアカウント情報なども含まれます。
DD には Nominee_details コレクション要素があります。このコレクション要素には 1 つの複合要素と、Nominee_name、Nominee_address、Nominee_gender という 3 つのプリミティブ要素があります。
動的 XDP にも同じヘッダーがあります。このため、上記の DD フィールドを使用して、動的 XDP フィールドをマッピングできます。
この例では、動的テーブルと静的テーブルを作成し、動的テーブルを DDE に連結して、これら 2 つのテーブルを含むレターを作成する方法を示します。 この例を使用する際は、最初からファイルを作成するか、手順で指定した入力ファイルを使用できます。
図に示すように、例で使用するデータディクショナリ (DD) を作成します。
次に、「DD」を選択し、サンプルデータを書き出します。 取得する XML ファイルには、Employee データと Nominee_details 用の 3 つのインスタンスが含まれています(デフォルトでは、3 つのインスタンスがダウンロードされます)。 必要に応じて、を追加または削除できます )。 値を更新し、DD にテストデータを読み込みます。 CMP ファイルはパッケージで、DD が含まれています。 DD を Correspondence Management に読み込みます。
データディクショナリとテストデータの使用について詳しくは、 データ辞書.
Designer で、2 つの XDP(レイアウトフラグメント)を作成します。動的テーブルと静的テーブル。 両方のレイアウトで、次の操作を行います。
または、この手順を実行するために用意されている静的および動的 XDP を使用します。
レイアウトフラグメントの使用について詳しくは、レイアウトフラグメントを参照してください。
レイアウトのデザインについて詳しくは、Designer ヘルプを参照してください。
XDP を AEM Forms にアップロードします。
動的 XDP に基づいてレイアウトフラグメントを作成します。 プロパティの「テーブル」タブに、テーブルが動的であることが表示されます(「設定対象」フィールド)。 行数 (1) と列数 (3) は、XDP/レイアウトフラグメントから派生します。
このレイアウトのフィールドは読み込んだ DD に後で連結されます。また、レターでは、行数がテストデータファイル(DD に付属している XML データファイル)のレコード数に基づいて動的に作成されます。
静的 XDP に基づいてレイアウトフラグメントを作成します。 プロパティの「テーブル」タブに、テーブルが静的であることが表示されます(「設定対象」フィールド)。 行数 (1) と列数 (3) は、XDP/レイアウトフラグメントから派生します。
ここで列と行の数を変更できます。 この画面で選択した内容に応じて、静的テーブルの行と列の数は、このレイアウトで作成されるレター内で固定されます。
クリックして拡大
両方のレイアウトフラグメントを使用してレターを作成します。 動的 XDP をレターに挿入する際に、フィールドの連結をデータディクショナリのコレクション要素に設定します。
レターおよびレターテンプレートの作成について詳しくは、 レターを作成.
レターを保存し、プレビューします。 レターをプレビューすると、データディクショナリの値がレターに表示されます。 動的テーブルには、3 つの行があります。 これは、テストデータにこれらの行の 3 つのレコードが含まれているからです。
静的テーブルには、レイアウトフラグメントの作成中に指定した数だけ行と列があります。
動的テーブルの場合、3 つの行はテストデータファイルのレコード数に応じて表示されます。 これは、レイアウトをレターに追加する際に、動的テーブルのフィールドとデータディクショナリのコレクション要素の間に連結を作成したためです。 「名前」、「住所」、「性別」の値は、使用したテストデータファイルから入力されます。
既存のドキュメントフラグメントと類似したプロパティとコンテンツを持つドキュメントフラグメントをすばやく作成するには、そのドキュメントフラグメントをコピーして貼り付けます。