インタラクティブ通信内のテキスト

概要

テキストドキュメントフラグメントは、1 つ以上のテキスト段落で構成されています。段落は静的または動的にすることができます。動的な段落には、フォームデータモデルのプロパティと変数を含めることができます。また、ルールを適用し、テキストドキュメントフラグメント内で繰り返すこともできます。 例えば、あいさつ文の顧客名は、フォーム・データ・モデル(FDM)のプロパティで、実行時に値が使用可能になります。 これらの値を変更すると、エージェントUIを使用して、異なる顧客向けの対話型通信を作成する際に、同じ対話型通信を使用できます。

Interactive Communicationのテキストドキュメントフラグメントは、次の種類の動的データをサポートします。

• データモデルオブジェクト:dataプロパティはバックエンドデータソースを使用します。
• ルールベースのコンテンツ：ルールに基づいて表示と非表示が切り替わる、テキスト内の特定のコンテンツ。また、フォームデータモデルのプロパティと変数に基づくルールを作成することもできます。
• 変数：テキストドキュメントフラグメントでは、バックエンドのデータソースに変数が連結されることはありません。エージェントは、後処理への送信用にインタラクティブ通信を準備する際に、変数の値を入力または選択するか、変数をデータソースに連結します。
• 繰り返し:クレジット・カード明細の取引など、インタラクティブ通信に動的な情報を持つ場合があります。このトランザクションの発生回数は、生成された各インタラクティブ通信と共に変化し続ける可能性があります。繰り返し構造を使用すると、このような動的な情報の書式設定と構造化を行うことができます。詳しくは、「インライン条件と繰り返し」を参照してください。

テキストの作成

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

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

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

   • タイトル:（オプション）テキストドキュメントフラグメントのタイトルを入力します。タイトルは一意である必要はなく、特殊文字や英語以外の文字を含めることもできます。テキストは、そのタイトル（利用可能な場合）によって、サムネールやプロパティとして参照されます。

   • 名前:フォルダー内のテキストの一意の名前。どのような状態であっても、1 つのフォルダー内に、同じ名前を持つ 2 つのドキュメントフラグメント（テキスト、条件、リスト）を保管することはできません。「名前」フィールドでは、英数字およびハイフンのみ使用できます。「名前」フィールドは、タイトルフィールドに基づいて自動的に入力されます。「タイトル」フィールドに入力した特殊文字、スペース、数字および英数字以外の文字は、ハイフンに置き換えられます。 「タイトル」フィールドの値は「名前」フィールドに自動的にコピーされますが、値を編集することもできます。

   • 説明：テキストの説明を入力します。

   • フォームデータモデル：（任意）フォームデータモデルに基づいてテキストを作成する場合は、「フォームデータモデル」ラジオボタンを選択します。「Form Data Model」ラジオボタンを選択すると、「Form Data Model」フィールドが表示されます。 フォームデータモデルを参照して選択します。インタラクティブ通信用のテキストを作成する場合は、そのインタラクティブ通信で使用するものと同じデータモデルを使用する必要があります。フォームデータモデルについて詳しくは、データ統合を参照してください。

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

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

   テキストの作成ページが表示されます。フォームデータモデルのベースのテキストを作成することを選択した場合は、左側のペインにフォームデータモデルのプロパティが表示されます。

5. テキストを入力し、以下のオプションを使用して、フォームデータモデルのプロパティと変数について書式設定と条件設定を行い、それらのプロパティと変数をテキストに挿入します。

   • フォームデータモデル

   • 変数

   • ルールエディター

   • 書式設定オプション

     • 書式設定されたテキストを他のアプリケーションからコピーして貼り付け

     • テキストの一部をハイライト表示

   • 繰り返し

   • 特殊文字

   • テキストの検索と置換

   • ショートカットキー

   メモ

   テキストエディターで@記号を使用して、フォームデータモデルの要素、データディクショナリの要素および変数を追加できます。 テキストエディターで先頭に@が付いた文字列を入力すると、すべてのデータモデル要素、データディクショナリ要素および変数が検索され、検索された文字列を含む要素または変数が表示されます。 検索結果間を移動して、要素または変数を選択できます。 一致する結果がない場合は、一致する結果が見つかりません​というメッセージが表示されます。

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

   これで、テキストが作成されました。このテキストを使用して、インタラクティブ通信を作成することができます。

テキストの編集

以下の手順により、既存のテキストドキュメントフラグメントを編集することができます。また、Interactive Communication Editor内からテキストドキュメントフラグメントを編集することもできます。

1. 「フォーム／ドキュメントフラグメント」を選択します。
2. 目的のテキストドキュメントフラグメントに移動して選択します。
3. 「編集」をタップします。
4. 必要な変更を行います。テキスト内のオプションについて詳しくは、テキストの作成を参照してください。
5. 「保存」をタップし、「閉じる」をタップします。

フォームデータモデルのプロパティを使用してテキストドキュメントフラグメントをカスタマイズする

フォームデータモデルのプロパティを挿入することにより、テキストドキュメントフラグメントをカスタマイズすることができます。フォームデータモデルのプロパティをテキストに挿入すると、インタラクティブコミュニケーションをプレビューしながら、関連するデータソースから受信者固有のデータを取得し、データを埋め込むことができます。 フォームデータモデルについて詳しくは、「AEM Formsデータ統合」を参照してください。

テキストの作成時にフォームデータモデルを指定した場合は、フォームデータモデルのプロパティがテキストエディターの左ペインに表示されます。 テキストドキュメントフラグメントと、そのフラグメントを含むインタラクティブ通信について、指定したフォームデータモデルが同じである必要があります。

• フォームデータモデルのプロパティをテキストに挿入するには、プロパティを挿入する位置にカーソルを置き、左側のウィンドウで​[A]​プロパティをタップして選択し、[B]追加選択済み​をタップします。 また、プロパティを重複タップするだけで、[C]​カーソル位置に挿入できます。 フォームデータモデルのプロパティは、茶色の背景色でハイライト表示されます。

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

• エージェントUIでPrepare and send Interactive Communicationの実行中に、エージェントがエージェントUIでフォームデータモデルのプロパティの値を編集できるようにするには、そのプロパティの​[D]​ロックアイコンをタップし、ロック解除状態にします。 プロパティのデフォルトの状態はロックされ、エージェントはエージェントUIでプロパティを編集できません。

フォームデータモデルのプロパティを使用して、特定のコンテンツの表示と非表示を切り替えるためのルールを作成することもできます。詳しくは、「テキスト内でルールを作成する」を参照してください。

テキストドキュメントフラグメント内で変数を作成して使用する

変数とは、インタラクティブ通信の作成時に連結できるプレースホルダーのことです。変数は、フォームデータモデルのプロパティに連結することも、テキストフラグメントに連結することもできます。エージェントを使用して、変数の値を設定することもできます。

以下の場合は、フォームデータモデルのプロパティの代わりに、変数を使用することができます。

• 複数のインタラクティブ通信で同じテキストドキュメントフラグメントを使用し、異なるインタラクティブ通信に変数を連結する必要がある場合。
• 作成したテキストドキュメントフラグメントに、フォームデータモデルが含まれていない場合。変数を挿入し、インタラクティブ通信を作成する際に、その変数をフォームデータモデルのプロパティに連結することができます。
• テキストドキュメントフラグメントからテキストを取得して連結する必要がある場合。既に変数が含まれているテキストドキュメントフラグメントを別の変数に連結することはできません。

テキストドキュメントフラグメントの作成時または編集時に、変数を作成して挿入することができます。作成した変数は、エージェント UI の「データ」タブに表示されます。エージェントは、エージェントUIを使用して対話型通信を準備し送信する際に、変数の値を指定します。

変数の作成

1. 左側のウィンドウで、変数​をタップします。

   変数ペインが表示されます。

   

2. 「作成」をタップします。

   変数作成ペインが表示されます。

3. 次の情報を入力し、「作成」をタップします。

   • 名前 :変数の名前。
   • 説明 :必要に応じて、変数の説明を入力します。
   • タイプ :変数のタイプを選択します。文字列、数値、ブール値または日付。
   • 特定の値のみ許可：文字列タイプまたは数値タイプの変数の場合、このオプションを選択すると、エージェント UI のプレースホルダーの特定の値セットから、エージェントによって値が選択されます。値のセットを指定するには、このオプションを選択し、値​フィールドで許可する値をコンマで区切って指定します。

4. 「作成」をタップします。

   作成された変数が変数ペインに表示されます。

5. テキストに変数を挿入するには、適切な場所にカーソルを置き、変数を選択して、「追加選択」をタップします。

   

   変数が明るい青の背景色でハイライト表示され、フォームデータモデルのプロパティが茶色の背景色でハイライト表示されます。

   または、テキストエディターで@記号を使用して、変数を検索して追加できます。 変数を挿入する場所にカーソルを置きます。 @の後に検索文字列を入力します。 検索操作は、フォームデータモデルのすべてのプロパティと、ドキュメントフラグメントで使用可能な変数に対して実行されます。 検索文字列を含むプロパティと変数が取得され、ドロップダウンリストとして表示されます。 検索結果を順に表示し、カーソル位置に挿入する変数をクリックします。 検索結果を非表示にするには、Escキーを押します。

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

テキスト内でルールを作成する

テキスト内でルールエディターを使用して、事前に定義された条件​に基づいてコンテンツやテキストの文字列の表示と非表示を切り替えるためのルールを作成することができます。事前に定義された条件は、以下のデータに基づいて設定することができます。

• 文字列
• 数値
• 数式
• 日付
• 関連するフォームデータモデルのプロパティ
• テキスト内に作成された任意の変数

テキスト内でルールを作成する

1. テキストの作成時または編集時に、ルールを使用して条件を設定するテキスト内の文字列、段落、またはコンテンツを選択します。

   

2. 「ルールを作成」をタップします。

   ルール作成ダイアログが表示されます。文字列、数値、数式、日付のほかに、以下のデータをルールエディターで使用して、ルールのステートメントを作成することができます。

   • 関連するフォームデータモデルのプロパティ
   • 作成済みの任意の変数

   評価するオプションを選択します。

   

   メモ

   コレクションプロパティは、テキストを条件付きで表示するルールの作成に対してはサポートされていません。

3. 「次の値と等しい」、「次の値を含む」、「次の値で始まる」など、ルールを評価するための適切な演算子を選択します。

   

4. 評価式、値、データモデルプロパティ、または変数を挿入します。

   

   フォームデータモデルのソースデータに基づき、受信者が米国に居住している場合に、選択されたテキストを表示するためのルール

   • ルールを作成または編集中に、 （サイズ変更）をタップして、ルールを作成/ルールを編集ダイアログを展開することもできます。 ダイアログを拡張して全画面表示にすると、フォームデータモデルのプロパティと変数をドラッグアンドドロップして、変数を作成できるようになります。「サイズ変更」を再度タップして、ルールを作成ダイアログに戻ります。
   • 1 つのルールで複数の条件を作成することもできます。
   • 既にルールが適用されているコンテンツの一部に対して、別のルールを作成して適用することもできます。

5. 「完了」をタップします。

   これで、ルールが適用されました。ルールが適用されたテキストまたはコンテンツは、緑色でハイライト表示されます。ハイライト表示されているテキストやコンテンツの左側に表示されているハンドルにカーソルを置くと、適用されているルールが表示されます。

   

   適用されているルールの左側に表示されているハンドルをクリックすると、そのルールの編集や削除を行うためのオプションが表示されます。

テキストの書式設定

テキストの作成や編集を行う場合、選択する編集のタイプ（「段落」、「整列」、「リスト」）に応じて、表示されるツールバーが異なります。

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

フォント編集ツールバー

整列ツールバー

リストツールバー

テキストの一部をハイライト表示または強調表示する

編集可能なドキュメントフラグメント内のテキストの一部をハイライト表示するには、目的のテキストを選択して「ハイライト表示の色」をタップします。

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

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

書式設定されたテキストの貼り付け

別のアプリケーション（Microsoft® Word や HTML ページなど）で使用されているテキスト内の 1 つ以上の段落を再利用するには、目的のテキストをコピーしてテキストエディター内に貼り付けます。コピーされたテキストの書式設定は、テキストエディタでも保持されます。

編集可能なテキストドキュメントフラグメント内のテキストの 1 つ以上の段落をコピーして貼り付けることができます。例えば、次のような居住証明書の箇条書きリストが含まれている Microsoft® Word ドキュメントがあるとします。

この場合、Microsoft® Word ドキュメント内のテキストをコピーして、編集可能なテキストドキュメントフラグメントに直接貼り付けることができます。箇条書きリスト、フォント、テキストの色などの書式は、テキストドキュメントフラグメント内に保存されます。

テキスト内に特殊文字を挿入する

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

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

テキストエディターでは、210 個の特殊文字がサポートされます。管理者は、カスタマイズ](/docs/experience-manager-65/forms/using/custom-special-characters.html?lang=ja)によって、追加/カスタムの特殊文字のサポートを追加できます。[

テキストの検索と置換

大量のテキストを含むテキストドキュメントフラグメントを処理する場合は、特定のテキスト文字列を検索する必要があります。 また、特定のテキスト文字列を別の文字列に置き換える必要がある場合もあります。

「検索と置換」機能により、テキストドキュメントフラグメント内の任意のテキスト文字列を検索して置き換えることができます。この機能には、強力な正規表現検索も含まれています。

1. 編集用にテキストドキュメントフラグメントを開きます。

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

3. 検索するテキストを「検索」テキストボックスに入力し、そのテキストを置き換えるテキストを「置換」テキストボックスに入力して「置換」をタップします。

4. 検索テキストが見つかると、そのテキストが置換テキストに変更されます。

   • 複数の検索テキストが見つかった場合は、テキストドキュメントフラグメント内でそれらのテキストがハイライト表示されます。「置換」をもう一度タップすると、そのテキストが置換され、カーソルが次の検索テキストに移動します。
   • 検索テキストがそれ以上見つからない場合は、「モジュールの最後に達しました」というメッセージが検索と置換ダイアログに表示されます。

   「すべて置換」をタップして、見つかった検索テキストをすべてまとめて置換することもできます。

   「検索と置換」機能には、強力な正規表現検索機能が組み込まれています。検索でregexを使用するには、「正規表現」を選択し、「検索」または「置換」をタップします。