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

ここでは、インタラクティブ通信で使用するテキストドキュメントフラグメントの作成方法と編集方法について説明します。インタラクティブ通信の作成では 4 種類のドキュメントフラグメントが使用されますが、テキストフラグメントはそのうちの 1 つです。他の 3 つは、条件フラグメント、リストフラグメント、レイアウトフラグメントです。

概要

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

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

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

テキストの作成

  1. Select Forms > Document Fragments.

  2. Create / テキスト」を選択します。

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

    • タイトル:(オプション)テキストドキュメントフラグメントのタイトルを入力します。 タイトルは一意である必要はなく、特殊文字や英語以外の文字を含めることもできます。テキストは、そのタイトル(利用可能な場合)によって、サムネールやプロパティとして参照されます。
    • 名前:フォルダー内のテキストの一意の名前。 どのような状態であっても、1 つのフォルダー内に、同じ名前を持つ 2 つのドキュメントフラグメント(テキスト、条件、リスト)を保管することはできません。「名前」フィールドでは、英数字およびハイフンのみ使用できます。「名前」フィールドは、タイトルフィールドに基づいて自動的に入力されます。「タイトル」フィールドに入力した特殊文字、スペース、数字および英数字以外の文字は、ハイフンに置き換えられます。 「タイトル」フィールドの値は「名前」フィールドに自動的にコピーされますが、値を編集することもできます。
    • 説明:テキストの説明を入力します。
    • フォームデータモデル:(任意)フォームデータモデルに基づいてテキストを作成する場合は、「フォームデータモデル」ラジオボタンを選択します。「フォームデータモデル」ラジオボタンを選択すると、「フォームデータモデル」*フィールドが表示されます。フォームデータモデルを参照して選択します。インタラクティブ通信用のテキストを作成する場合は、そのインタラクティブ通信で使用するものと同じデータモデルを使用する必要があります。For more information on Form Data Model, see Data Integration.
    • タグ:(オプション)テキストフィールドにカスタムタグの値を入力し、Enter キーを押します。このテキストを保存すると、新しく追加されたタグが作成されます。
  4. 次へ」をタップします。

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

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

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

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

テキストの編集

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

  1. Select Forms > Document Fragments.
  2. 目的のテキストドキュメントフラグメントに移動して選択します。
  3. 編集」をタップします。
  4. 必要な変更を行います。For more information on options in text, see Create text.
  5. Tap Save and then tap Close.

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

フォームデータモデルのプロパティを挿入することにより、テキストドキュメントフラグメントをカスタマイズすることができます。フォームデータモデルのプロパティをテキストに挿入すると、インタラクティブコミュニケーションをプレビューしながら、関連するデータソースから受信者固有のデータを取得し、データを埋め込むことができます。 For more information on form data model, see AEM Forms Data Integration.

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

insertfdmelementtext

  • To insert an FDM property into text, place the cursor where you want to insert the property, then select the [A] property in the left pane by tapping on it, and tap [B] Add Selected. You can also just double-tap the property to insert it at the [C] cursor position. フォームデータモデルのプロパティは、茶色の背景色でハイライト表示されます。

  • To allow the agents to edit an FDM property's value in the agent UI while Prepare and send Interactive Communication using the Agent UI, tap the [D] lock icon for that property and ensure it is in an unlocked state. プロパティのデフォルトの状態はロックされ、エージェントはエージェントUIでプロパティを編集できません。

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

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

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

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

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

テキストドキュメントフラグメントの作成時または編集時に、変数を作成して挿入することができます。作成した変数は、エージェント UI の「データ」タブに表示されます。The agent specifies the values for the variables while Prepare and send Interactive Communication using the Agent UI.

変数の作成

  1. In the left pane, tap Variables.

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

    variablepane

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

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

  3. Enter the following information and tap Create:

    • 名前*:変数の名前を入力します。
    • 説明:必要に応じて、変数の説明を入力します。
    • タイプ*:変数のタイプを選択します。文字列、数値、ブール値または日付。
    • 特定の値のみ許可:文字列タイプまたは数値タイプの変数の場合、このオプションを選択すると、エージェント UI のプレースホルダーの特定の値セットから、エージェントによって値が選択されます。To specify the set of values, select this option and then specify comma-separated values that are allowed in the Values field.
  4. 作成」をタップします。

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

  5. To insert a variable in the text, place the cursor at the appropriate place, select the variable, and tap Add Selected.

    variableinserted

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

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

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

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

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

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

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

    selectcontentapplyrule

  2. Tap Create Rule.

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

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

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

    ruleeditor

    ruleeditorfdm

    メモ

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

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

    ruleeditorfdm-1

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

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

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

    • While creating or editing a rule, you can also tap icon_resize (Resize) to expand the Create Rule/Edit Rule dialog. ダイアログを拡張して全画面表示にすると、フォームデータモデルのプロパティと変数をドラッグアンドドロップして、変数を作成できるようになります。「サイズ変更」を再度タップして、ルールを作成ダイアログに戻ります。
    • 1 つのルールで複数の条件を作成することもできます。
    • 既にルールが適用されているコンテンツの一部に対して、別のルールを作成して適用することもできます。
  5. 完了」をタップします。

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

    appliedruletext

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

テキストの書式設定

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

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

フォント編集ツールバー

フォント編集ツールバー

整列ツールバー

整列ツールバー

リストツールバー

リストツールバー

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

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

textbackgroundcolorapplied-1

You can either directly tap a basic color [A] present in the Basic Colors palette or tap Select after using the slider [B] to choose the appropriate shade of the color.

Optionally, you can also go to the Advanced tab to select the appropriate Hue, Lightness, and Saturation [C] to create the precise color and then tap Select [D] to apply the color to highlight the text.

textbackgroundcolor-2

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

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

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

pastetextmsword-2

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

pastetexteditablemodule-1

メモ

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

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

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

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

specialcharacters-2

テキストエディターでは、210 個の特殊文字がサポートされます。The admin can add support for more/custom special characters by customization.

テキストの検索と置換

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

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

  1. Open a text document fragment for editing.

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

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

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

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

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

    「検索と置換」機能には、強力な正規表現検索機能が組み込まれています。To use regex in your search, select Reg ex and then tap Find or Replace.

このページ