インタラクティブ通信内の条件

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

概要

条件は、インタラクティブ通信に含めることができるドキュメントフラグメントです。他のドキュメントフラグメントには、テキストフラグメント、リストフラグメント、レイアウトフラグメントがあります。条件を使用すると、指定されたデータとルールに基づいてインタラクティブ通信に含める 1 つ以上のコンテキストアセットを定義できます。

例えば、次のような問題です。

• 顧客が使用しているクレジットカードの種類に基づいて、そのクレジットカードの年会費と画像を取引明細書に表示する。
• 顧客が居住している国の税制に基づいて、保険料支払期日の通知に税額の計算結果を表示する。

条件内のアセットは、適用されるルールと、そのルールに渡される値に基づいてレンダリングされます。条件のルールは、次のタイプのデータの値を確認できます。

• 関連するフォームデータモデルのプロパティ
• 条件内で作成する変数
• 文字列
• 数値
• 数式
• 日付

条件の作成

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

2. 選択 作成 > 条件.

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

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

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

   条件の作成ページが表示されます。

   

5. タップ アセットを追加.

   アセットの選択ページが表示されます。このページには、条件内に追加できるテキスト、リスト、条件、画像が表示されます。

   メモ

   アセットの選択ページには、新しく作成されたアセットと FDM ベースのアセット（作成する条件と同じ FDM を使用して作成されたアセット）だけが表示されます。

6. 条件に含めるアセットをタップして選択し、「完了」をタップします。

   条件の作成ページが表示されます。このページには、作成されたアセットが一覧表示されます。

   

   以下のオプションを使用して、条件内のアセットを管理することができます。

   

   [A]変更を拒否します。 条件内のアセットとルールに加えた変更を拒否するには、このアイコンをタップします。

   [B]変更を受け入れます。 条件のアセットとルールに加えた変更を受け入れるには、このアイコンをタップします。

   [C]アセットを複製します。​適用対象のルール（存在する場合）と共に条件内のアセットのコピーを作成する場合は、このアイコンをタップします。その後、複製されたアセットで、ルールとアセットの編集を行うことができます。特定のコンテキストに基づいて代替のアセットを表示するための類似のルールを作成する場合は、アセットを複製すると便利です。

   [D]プレビューを表示. このアイコンをタップすると、条件を作成/編集ページ内にアセットのプレビューが表示されます。

   [E]並べ替え. 条件内でアセットを並べ替えるには、このアイコンを長押ししてアセットをドラッグ&ドロップします。

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

   • 複数の結果評価を無効化 / 複数の結果評価を有効化：「複数の結果評価を有効化」オプションを選択すると、すべての条件が評価され、その結果として、すべての true ルールの要約が表示されます。「複数の結果評価を無効化」オプションを選択すると、true と判断された最初のルールだけが評価され、そのルールが条件の出力になります。
   • 改ページ:このオプション ( ) をクリックして、条件のアセット間に改ページを追加します。 このオプションが選択されていない場合 ( ) を指定した場合、条件が印刷出力の次のページにオーバーフローすると、条件全体が次のページに移動し、条件内のアセット間で区切られるのではなく、条件全体が次のページに移動します。

7. 「ルールを作成」をタップして、アセットの表示と非表示を切り替えるためのルールを必要に応じて追加します。ルール内で変数を使用する方法については、「変数の作成」を参照してください。詳しくは、 条件へのルールの追加.

   作成されたルールが、条件作成画面の「ルール」列に表示されます。

   

   メモ

   既にルールが設定されている条件（または繰り返しが適用されている条件）にアセットを挿入することができます。

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

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

   メモ

   新しい条件や編集後の条件を保存するには、条件内に追加する各アセットについて、1 つ以上のルールを設定する必要があります。

条件の編集

以下の手順により、条件を編集することができます。ポップアップメニューで「フラグメントを編集」を選択して、インタラクティブ通信内から条件の編集を選択することもできます。

1. 「フォーム／ドキュメントフラグメント」を選択します。
2. 目的の条件に移動して、その条件を選択します。
3. 「編集」をタップします。
4. 条件内で、必要な変更を行います。条件で変更できる情報について詳しくは、 条件を作成.
5. タップ 保存 次に、 閉じる.

条件内でルールを作成する

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

• 文字列
• 数値
• 数式
• 日付
• 関連するフォームデータモデルのプロパティ
• 作成済みの任意の変数

条件内でルールを作成する

1. 条件の作成時または編集時に、 （ルールエディター）関連するアセットのアイコン。

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

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

   

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

   メモ

   Collection プロパティを使用して、アセットを表示するためのルールを作成することはできません。

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

3. 評価式、文字列、データモデルプロパティ、変数、または日付を挿入します。

   

   ポリシータイプが「標準」の場合にアセットを表示するためのルール

   • ルールを作成または編集する際に、 （サイズ変更）をクリックして、[ ルールを作成/ルールを編集 ] ダイアログを展開します。 ダイアログを拡張して全画面表示にすると、ルールを構成する変数を作成できるようになります。もう一度「サイズ変更」をタップすると、通常のルール作成ダイアログに戻ります。
   • 1 つのルールで複数の条件を作成することもできます。

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

   これで、ルールがアセットに適用されます。

条件内で変数を作成して使用する

条件内でルールを作成または編集しているときに、 （サイズ変更）をクリックして、[ ルールを作成\ルールを編集 ] ダイアログを展開します。 ダイアログを拡張して全画面表示にすると、以下の操作を実行できるようになります。

• ルール内で変数を作成して使用する
• フォームデータモデルのプロパティと変数をルールにドラッグ&ドロップ

サイズ変更アイコンをもう一度タップすると、通常のサイズのダイアログに戻ります。

変数の作成

1. 条件内でルールを作成または編集しているときに、 （サイズ変更）をクリックして、[ ルールを作成/ルールを編集 ] ダイアログを展開します。

   拡張されたダイアログが全画面モードで表示されます。

   

2. 左側のウィンドウで、 変数.

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

   

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

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

4. 次の情報を入力し、 作成:

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

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

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

6. ルール内に変数を挿入するには、ルール内の任意のオプションのプレースホルダーにその変数をドラッグアンドドロップします。

7. 有効なルールを作成したら、 完了.

   必要に応じて、条件内でさらに変更を行い、その変更内容を保存します。