インタラクティブ通信内のテキスト texts-in-interactive-communications
インタラクティブ通信で使用するテキストドキュメントフラグメントの作成と編集 — テキストは、インタラクティブ通信の構築に使用する 4 種類のドキュメントフラグメントの 1 つです。 残りの 3 つは、条件、リスト、レイアウトフラグメントです。
概要 overview
テキストドキュメントフラグメントは、1 つ以上のテキスト段落で構成されます。 段落は静的または動的にすることができます。動的な段落には、フォームデータモデルのプロパティと変数を含めることができます。ルールを適用し、テキストドキュメントフラグメント内でそのルールを繰り返すこともできます。例えば、あいさつ文に記載する顧客の名前をフォームデータモデル（FDM）のプロパティとして指定し、実行時にその名前の値を動的に設定することができます。この値を変更すると、エージェント UI で同じインタラクティブ通信を使用して、異なる顧客に対してインタラクティブ通信を設定することができます。
インタラクティブ通信内のテキストドキュメントフラグメントでは、以下に示す動的データがサポートされています。
- データモデルオブジェクト：データプロパティでは、バックエンドのデータソースが使用されます。
- ルールベースのコンテンツ：ルールに基づいて表示と非表示が切り替わる、テキスト内の特定のコンテンツ。ルールは、フォームデータモデルのプロパティに基づいて適用することも、フォームデータモデルの変数に基づいて適用することもできます。
- 変数：テキストドキュメントフラグメントでは、バックエンドのデータソースに変数が連結されることはありません。インタラクティブ通信を後処理用に送信する際に、エージェントが変数の値を設定または選択します（または、エージェントが変数をデータソースに連結します）。
- 繰り返し構造：クレジットカードの取引明細など、インタラクティブ通信を生成するたびに件数が変化する動的な情報を、インタラクティブ通信に含めることができます。繰り返し構造を使用すると、このような動的な情報の書式設定と構造化を行うことができます。詳しくは、「インライン条件と繰り返し」を参照してください。
テキストの作成 createtext
-
選択
Forms> ドキュメントフラグメント. -
選択
Create> テキスト. -
次の情報を指定します。
- タイトル：（任意）テキストドキュメントフラグメントのタイトルを入力します。タイトルは一意である必要はなく、特殊文字や英字以外の文字を含めることもできます。タイトルを指定している場合、サムネイルやプロパティなどでは、タイトルによってテキストが参照されます。
- 名前：テキストの名前を入力します。フォルダー内の他のテキストと重複しない名前を入力する必要があります。どのような状態であっても、1 つのフォルダー内に、同じ名前を持つ 2 つのドキュメントフラグメント（テキスト、条件、リスト）を保管することはできません。「名前」フィールドに入力できるのは、英語の文字、数字、ハイフンのみです。 「名前」フィールドは、「タイトル」フィールドに基づいて自動的に入力されます。 「タイトル」フィールドに入力した特殊文字、スペース、および英数字以外の文字はハイフンに置き換えられます。「タイトル」フィールドの値は「名前」フィールドに自動的にコピーされますが、値を編集することもできます。
- 説明:テキストの説明を入力します。
- フォームデータモデル:必要に応じて、「フォームデータモデル」ラジオボタンを選択し、フォームデータモデルに基づいてテキストを作成します。 「フォームデータモデル」ラジオボタンを選択すると、 フォームデータモデル* フィールドが表示されます。 フォームデータモデルを参照して選択します。 インタラクティブ通信のテキストと条件を作成する際は、インタラクティブ通信で使用するデータモデルと同じデータモデルを使用する必要があります。 フォームデータモデルについて詳しくは、「データ統合」を参照してください。
- タグ:必要に応じて、カスタムタグを作成するには、テキストフィールドに値を入力し、Enter キーを押します。 このテキストを保存すると、新しく追加されたタグが作成されます。
-
「次へ」をタップします。
「テキストを作成」ページが表示されます。 フォームデータモデルベースのテキストを作成する場合は、フォームデータモデルのプロパティが左側のウィンドウに表示されます。
-
テキストを入力し、以下のオプションを使用して、フォームデータモデルのプロパティと変数について書式設定と条件設定を行い、それらのプロパティと変数をテキストに挿入します。
-
「保存」をタップします。
テキストが作成されます。 これで、インタラクティブ通信を作成する際に、テキストを構築ブロックとして使用する作業に進むことができます。
テキストの編集 edittext
次の手順を使用して、既存のテキストドキュメントフラグメントを編集できます。 インタラクティブ通信エディターを使用して、テキストドキュメントフラグメントを編集することもできます。
- 選択
Forms> ドキュメントフラグメント. - テキストドキュメントフラグメントに移動して選択します。
- 「編集」をタップします。
- 必要な変更を行います。テキストのオプションについて詳しくは、テキストの作成を参照してください。
- 「保存」をタップしてから、「閉じる」をタップします。
フォームデータモデルのプロパティを使用したテキストドキュメントフラグメントのパーソナライズ formdatamodel
フォームデータモデルのプロパティを挿入することで、テキストドキュメントフラグメントをパーソナライズできます。 フォームデータモデルのプロパティをテキスト内に挿入すると、インタラクティブ通信のプレビューを表示する際に、関連するデータソースから受信者固有のデータを取得して設定できるようになります。フォームデータモデルについて詳しくは、AEM Forms のデータ統合を参照してください。
テキストの作成時にフォームデータモデルを指定すると、そのフォームデータモデルのプロパティが、テキストエディターの左側のウィンドウに表示されます。指定されるフォームデータモデルは、テキストドキュメントフラグメントと、それが含まれているインタラクティブ通信とで、同じである必要があります。
-
FDM プロパティをテキストに挿入するには、プロパティを挿入する位置にカーソルを置き、
[A]プロパティをタップして左側のウィンドウに表示し、[B]選択項目を追加. プロパティをダブルタップするだけでも、「[C]」のカーソルの位置に挿入できます。フォームデータモデルのプロパティが、茶色の背景色でハイライト表示されます。 -
エージェント UI で FDM プロパティの値を編集できるようにするには、次の手順を実行します。 インタラクティブ通信の準備と送信 エージェント UI を使用して、
[D]そのプロパティのロックアイコンを使用し、ロックが解除状態になっていることを確認します。 デフォルト状態では、プロパティはロックされているので、エージェントはエージェント UI でプロパティを編集できません。
また、フォームデータモデルのプロパティを使用して、コンテンツの一部を表示または非表示にするためのルールを作成することもできます。 詳しくは、 テキスト内にルールを作成.
テキストドキュメントフラグメント内での変数の作成と使用 variables
変数は、インタラクティブ通信の作成時に連結できるプレースホルダーです。 変数は、フォームデータモデルのプロパティまたはテキストフラグメントに連結できます。 また、エージェントが入力する変数を残しておくこともできます。
次の場合に、フォームデータモデルのプロパティの代わりに変数を使用できます。
- テキストドキュメントフラグメントは、複数のインタラクティブ通信で使用する必要があります。この場合、インタラクティブ通信ごとにバインディングを異ならせる必要があります。
- テキストドキュメントフラグメントの作成時に、フォームデータモデルが存在しません。 変数を挿入し、後でインタラクティブ通信の作成時にフォームデータモデルのプロパティにバインドすることができます。
- テキストドキュメントフラグメントからテキストを連結し、取得する必要があります。 変数を含まない変数にバインドできるのは、そのテキストドキュメントフラグメントだけです。
テキストドキュメントフラグメントの作成または編集時に、変数を作成および挿入できます。 作成した変数は、エージェント UI の「データ」タブに表示されます。 エージェント UI を使用してインタラクティブ通信の準備と送信を行う際に、エージェントが変数の値を指定します。
変数の作成 create-variables
-
左側のウィンドウで、「変数」をタップします。
変数ウィンドウが表示されます。
-
「作成」をタップします。
「変数の作成」ペインが表示されます。
-
以下の情報を入力して、「作成」をタップします。
- 名前*:変数の名前。
- 説明：必要に応じて、変数に関する説明を入力します。
- タイプ*:変数のタイプを選択します。文字列、数値、ブール値、日付のいずれかです。
- 特定の値のみ許可：文字列タイプまたは数値タイプの変数の場合、このオプションを選択すると、エージェント UI のプレースホルダーの特定の値セットから、エージェントによって値が選択されます。この値セットを指定するには、このオプションを選択し、値 フィールドで、目的の値をコンマで区切って指定します。
-
「作成」をタップします。
変数が作成され、変数ウィンドウに表示されます。
-
テキスト内に変数を挿入するには、適切な位置にカーソルを置き、変数を選択して、「選択項目を追加」をタップします。
変数が明るい青の背景色でハイライト表示され、フォームデータモデルのプロパティが茶色の背景色でハイライト表示されます。
-
「保存」をタップします。
テキスト内にルールを作成 rules
テキスト内でルールエディターを使用して、テキストやコンテンツの文字列を プリセット条件. これらの条件は、次の条件に基づいて構築できます。
- 文字列
- 数値
- 数式
- 日付
- 関連付けられたフォームデータモデルのプロパティ
- テキスト内で作成した変数
テキスト内にルールを作成 create-rules-in-text
-
テキストを作成または編集する際に、ルールを使用して条件を設定するテキスト文字列、段落またはコンテンツを選択します。
-
「ルールを作成」をタップします。
ルール作成ダイアログが表示されます。ルールエディタでは、文字列、数値、数式、日付に加えて、次のようなルールの文を作成することもできます。
- 関連付けられたフォームデータモデルのプロパティ
- 作成済みの任意の変数
評価するオプションを選択します。
note note NOTE テキストの条件設定と表示をおこなうためのルールを作成する場合、コレクションプロパティは使用できません。 -
「次の値と等しい」、「次の値を含む」、「次の値で始まる」など、ルールを評価するための適切な演算子を選択します。
-
評価式、値、データモデルプロパティ、または変数を挿入します。
フォームデータモデルのソースデータに基づき、受信者が米国に居住している場合に、選択されたテキストを表示するためのルール
- ルールの作成時または編集時に
- 1 つのルールで複数の条件を作成することもできます。
- 既にルールが適用されているコンテンツの一部に対して、別のルールを作成して適用することもできます。
- ルールの作成時または編集時に
-
「完了」をタップします。
ルールが適用されます。 ルールが適用されるテキストまたはコンテンツが緑色でハイライト表示されます。 ハイライトの左ハンドルの上にマウスポインターを置くと、適用されたルールが表示されます。
適用したルールの左側に表示されるハンドルをクリックすると、そのルールの編集や削除をおこなうためのオプションが表示されます。
テキストの書式設定 formatting
テキストを作成または編集する際、選択した編集の種類に応じて、ツールバーが変わります。段落、整列またはリスト：
ツールバーのタイプを選択します。段落、整列またはリスト
フォント編集ツールバー
整列ツールバー
リストツールバー
テキストの一部をハイライト表示/強調 highlight
編集可能なドキュメントフラグメント内のテキストの一部をハイライト表示または強調表示するには、テキストを選択して「ハイライトの色」をタップします。
基本色パレットに表示されている基本色 [A] を直接タップすることも、スライダー [B] を使用して「選択」をタップし、その色の適切な網掛けを選択することもできます。
オプションで、「詳細」タブに移動して、適切な色相、明るさ、彩度 [C] を選択して正確な色を作成し、次に「選択」[D] をタップして、テキストをハイライト表示するための色を適用することもできます。
書式設定されたテキストの貼り付け paste
Microsoft® Word やHTMLのページなど、別のアプリケーションで使用されているテキストの段落を再利用するには、そのテキストをコピーしてテキストエディターに貼り付けます。 コピーしたテキストの書式は、テキストエディターでも保持されます。
編集可能なテキストドキュメントフラグメント内の 1 つ以上のテキスト段落をコピーして貼り付けることができます。 例えば、次のような、許容可能な居住証明書の箇条書きリストを含むMicrosoft® Word ドキュメントがあるとします。
Microsoft® Word ドキュメントから編集可能なテキストドキュメントフラグメントに、テキストを直接コピーして貼り付けることができます。 箇条書きリスト、フォント、テキストの色などの書式は、テキストドキュメントフラグメントでも保持されます。
テキストに特殊文字を挿入します special
必要に応じて、ドキュメントフラグメントに特殊文字を挿入します。例えば、特殊文字パレットを使用して、以下の特殊文字を挿入することができます。
- 通貨記号（€、￥、£ など）
- 数学記号（∑、√、∂、^ など）
- 句読記号（‟、” など）
テキストエディターでは、210 個の特殊文字がサポートされます。管理者は、カスタマイズすることで特殊文字を増やしたり、カスタムの特殊文字を追加したりすることができます。
テキストの検索と置換 search-features
大量のテキストが含まれているテキストドキュメントフラグメントで作業を行う場合、特定のテキスト文字列を検索しなければならないことがあります。また、特定のテキスト文字列を別の文字列と置換する必要がある場合もあります。
「検索と置換」機能を使用すると、テキストドキュメントフラグメント内の任意の文字列を検索（および置換）できます。 この機能には、強力な正規表現検索も含まれています。
-
テキストドキュメントフラグメントを編集用に開きます。
-
「検索と置換」をタップします。
-
検索するテキストを「検索」テキストボックスに入力し、置換後のテキストを「置換」テキストボックスに入力して「置換」をタップします。
-
検索したテキストが見つかった場合、そのテキストは置き換えたテキストに置き換えられます。
- 検索テキストの別のインスタンスが見つかった場合は、そのインスタンスがテキストドキュメントフラグメント内でハイライト表示されます。 次をタップした場合： 置換 3 つ目のインスタンスが見つかった場合は、ハイライト表示されたインスタンスが置き換えられ、カーソルが前に移動します。
- 別のインスタンスが見つからない場合は、検索と置換ダイアログに次のメッセージが表示されます。モジュールの終わりに達しました。
「すべて置換」をタップして、一度にすべての一致を置き換えることもできます。
「検索と置換」機能には、強力な正規表現検索機能が組み込まれています。正規表現を使用して検索を実行するには、「正規表現」を選択して「検索」または「置換」をタップします。