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

注意

AEM 6.4 の拡張サポートは終了し、このドキュメントは更新されなくなりました。詳細は、技術サポート期間. サポートされているバージョンを見つけるここ.

インタラクティブ通信で使用する条件フラグメントの作成と編集 — 条件は、インタラクティブ通信の構築に使用する 4 種類のドキュメントフラグメントの 1 つです。残りの 3 つは、テキスト、リスト、レイアウトフラグメントです。

概要

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

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

クレジットカード明細に、顧客のクレジットカードの種類に基づいて、クレジットカードの年間料金とクレジットカードの画像を表示します。
保険料支払期限のリマインダーで、顧客の州の税金に基づく税金の計算を表示します。

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

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

条件を作成

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

条件の作成ページが表示されます。
「アセットを追加」をタップします。

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

メモ

新規に作成したアセットと FDM ベースのアセット（作成する条件と同じ FDM を使用して作成）のみが、アセットを選択ページに表示されます。
条件に含めるアセットを選択するには、該当するアセットをタップし、次にをタップします完了.

条件を作成ページが表示され、追加したアセットが一覧表示されます。

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

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

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

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

[D]プレビューを表示.条件の作成と編集ページでアセットのプレビューを表示する場合は、このアイコンをタップします。

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

条件の実行時の動作を指定するには、次のオプションを選択します。
- 複数の結果評価が無効\複数の結果評価が有効:このオプションが有効な場合（「複数の結果評価が有効」と表示される場合）、すべてのルールが評価され、結果はすべての真のルールの合計になります。「複数の結果評価を無効化」オプションを選択すると、True と判断された最初のルールだけが評価され、そのルールが条件の出力になります。
- 改ページ：条件内のアセットごとに改ページする場合は、このオプション（）を選択します。このオプションを選択せずに（）、条件が次のページにオーバーフローする場合は、条件内のアセットごとに改ページすることなく条件全体が次のページに移動します。
タップ ルールを作成 ：必要に応じて、アセットの表示と非表示を切り替えるルールを追加します。ルールで変数を使用するには、変数の作成. 詳しくは、条件にルールを追加するを参照してください。

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

メモ

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

条件が作成されます。これで、インタラクティブ通信の作成時に、条件を構築ブロックとして使用する作業に進むことができます。

メモ

新しい条件や編集した条件を保存するには、条件に追加された各アセットに対して少なくとも 1 つのルールが必要です。

条件の編集

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

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

条件内のルールの作成

条件でルールエディターを使用して、次の条件に基づいてアセットの表示と非表示を切り替えるルールを作成できます プリセット条件. これらの条件は、次の条件に基づいて構築できます。

文字列
数値
数式
日付
関連付けられたフォームデータモデルのプロパティ
任意変数作成した可能性のある

条件にルールを作成

条件の作成または編集を行う際に、関連するアセットのルールエディターアイコンをタップします。

ルール作成ダイアログが表示されます。ルールエディタでは、文字列、数値、数式、日付に加えて、次のようなルールの文を作成することもできます。
- 関連付けられたフォームデータモデルのプロパティ
- 任意変数作成した可能性がある
評価するオプションを選択します。

メモ

Collection プロパティを使用して、アセットを表示するためのルールを作成することはできません。
「次の値と等しい」、「次の値を含む」、「次の値で始まる」など、ルールを評価するための適切な演算子を選択します。
評価式、文字列、データモデルプロパティ、変数、または日付を挿入します。

ポリシータイプが「標準」の場合にアセットを表示するためのルール
- ルールの作成時または編集時にサイズ変更アイコン（）をタップすると、ルールの作成／ルールの編集ダイアログを拡張することができます。ダイアログを拡張して全画面表示にすると、ルールを構成する変数を作成できるようになります。サイズ変更アイコンをもう一度タップすると、通常のルールの作成ダイアログに戻ります。
- 1 つのルールで複数の条件を作成することもできます。
「完了」をタップします。

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

条件での変数の作成と使用

条件内でルールの作成や編集を行う際に、サイズ変更アイコン（ icon_resize ）をタップして、ルールの作成またはルールの編集ダイアログを拡張することができます。拡張されたフルウィンドウダイアログでは、次の操作を実行できます。

ルール内で変数を作成および使用する
フォームデータモデルのプロパティと変数をルール内にドラッグ＆ドロップする

もう一度「サイズ変更」をタップして、「ルールを作成\ルールを編集」ダイアログに戻ります。

変数の作成

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

拡張されたダイアログが全画面モードで表示されます。
左側のペインで、「変数」をタップします。

変数ペインが表示されます。
「作成」をタップします。

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

作成された変数が変数ペインに表示されます。
ルール内に変数を挿入するには、ルール内の任意のオプションのプレースホルダーにその変数をドラッグ＆ドロップします。
ルールが正しく設定されていることを確認して「完了」をタップします。

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