詳細情報:
FlexCard への Flexcard の埋め込み
FlexCard を別の FlexCard に子として埋め込むことで、FlexCard 間でデータを共有します。子の FlexCard にはデータソースを含めることも、親が子のデータソースを独自のデータソースで上書きすることもできます。親は、子のコンテキスト ID として使用するレコード ID など、特定のデータを子に渡すこともできます。
- アプリケーションランチャーで、[Flexcards] を見つけて選択します。
- FlexCard を展開し、バージョンを選択します。
- 必要に応じて、FlexCard を無効化して FlexCard を編集します。
-
Flexcard 要素を要素パネルからキャンバスにドラッグします。
[設定] で FlexCard の OmniScript サポートを有効にした場合は、この設定も有効になっている子 FlexCard のみを選択します。
-
FlexCard が階層データを持つ子 FlexCard であり、繰り返し FlexCard 自体に追加する場合は、[再帰的] を選択します。
再帰的な子 FlexCard に条件を適用すると、OmniStudio はその条件をすべての再帰的な繰り返しレコードに適用します。1 つのレコード条件で false が返される場合、ネストされたレコードは表示されません。
プレビュー時または実行時に、子 Flexcard は、JSON コードの各レベルで使用可能な同じ子データ項目 (データノードとも呼ばれる) を、そのデータ項目がなくなるか空になるまで渡します。その結果、Flexcard には親オブジェクトの子および孫が表示されます。
-
子 Flexcard のデータソースを使用する代わりに親 Flexcard のデータソースからオブジェクトを渡すには、データノードを選択します。
-
{records}: すべてのデータを渡します。
-
{records[#]}: 指定されたレコードのデータを渡します。たとえば、
{records[0]}は最初のレコード、{records[1]}は 2 番目のレコードというように続きます。 -
{record}: 設定オプションで [レコードの繰り返し] を選択解除した場合などに、現在のレコードのデータを渡します。
-
{record.FieldName}: レコード オブジェクトを渡します。たとえば、オブジェクトまたは配列に追加データがある場合は
{record.Product}を使用します。 -
{record.attributes}: 現在のレコードのすべての属性を送信します。
-
再帰 Flexcard の場合、繰り返し子ノードを入力して、特定のデータセット内のオブジェクトを子 Flexcard から自身に渡します。
子カードが親データに依存している場合、親 Flexcard のデータが変更されると、子 Flexcard が再表示されます。
-
-
特定の属性を渡すには、属性名と値を入力します (
AccountIdや{Id}など)。 -
子 Flexcard の [設定] の [データソース] で、差し込み項目またはプレーンテキスト (SOQL クエリの
{Parent.AccountId}など) を使用して属性を参照します。
子 FlexCard から親 FlexCard へのデータの渡し
FlexCard を別の FlexCard に組み込んだら、子のカスタムイベントアクションの入力パラメーターを使用して、子の FlexCard から親にデータを渡します。次に、子 Flexcard のイベントに応じて親 Flexcard のデータ項目を更新するようにイベントリスナーを設定します。
- 子 FlexCard を開きます。
- 要素パネルから [アクション] 要素をキャンバスにドラッグします。
- プロパティパネルから、[アクション] セクションを展開します。
- [Event] アクション種別と [Custom] イベント種別を選択します。
-
「
updatecity」などのイベント名を入力します。 -
コンテキストデータを渡します。
- 入力パラメーターを追加します。
-
[Key] に、親からコールする名前を入力します (「
cityname」など)。 -
[値] に、
New Yorkなどのプレーンテキストとして、または{City}などの子のデータソースからの差し込み項目として渡す値を入力します。
- 子 FlexCard を有効化します。
- 親 FlexCard を開きます。
-
[設定] から、イベントリスナーを追加します。
-
子 FlexCard のカスタムイベントと同じイベント名を入力します (「
updatecity」など)。 -
[
Action] セクションを展開します。 -
[
Card] アクション種別と [値の設定] 種別を選択します。 - [キー] に、更新するデータ項目を入力します。
-
[値] に、
action.paramコンテキスト変数を使用して、子 FlexCard から渡される入力パラメータの名前を入力します。たとえば、入力パラメーターのキーがcitynameの場合、「{action.cityname}」と入力します。 - 変更内容を保存します。
-
子 FlexCard のカスタムイベントと同じイベント名を入力します (「
プレビューで、子 FlexCard のアクションをクリックして親のデータ項目を更新します。
取引先およびケース情報の表示
データテーブルを使用して、親 Flexcard に取引先情報を、子 FlexCard にケース情報を表示する。
- 子の Flexcard で、[設定] オプションの [レコードの繰り返し] をオフにして、Flexcard に 1 つのテーブルが表示されるようにします。
- 子 FlexCard にデータテーブルを追加し、ケース情報を取得するようにデータソースを設定します。
- 子 FlexCard を有効化します。
-
親 Flexcard で、取引先情報と、取引先に関連するすべてのケースから情報を取得するようにデータソースを設定します。
[ { "PrimaryContactEmail": "sean@edge.com", "Revenue": 139000000, "Website": "http://edgecomm.com", "Phone": "(512) 757-6000", "Name": "Edge Communications", "Id": "0013g00000AeI9fAAF", "Cases": [ { "Type": "Mechanical", "CaseId": "5003g000007WQHRAA4", "Created": "2020-11-23T20:51:20.000Z", "Priority": "High", "Status": "Escalated", "Subject": "The watchamacallit is too high" }, { "Type": "Structural", "CaseId": "5003g000007WQHQAA4", "Created": "2020-11-23T20:50:32.000Z", "Priority": "Medium", "Status": "New", "Subject": "The doodat wasn't properly set up", "CaseId": "5003g000007WQHQAA4" } ] } ] - 子 Flexcard を親 Flexcard に追加します。
-
[データノード] に「
{records[0].Cases}」と入力します。
OmniStudio は子データソースを無視し、親 Flexcard のデータを子 Flexcard データテーブルに入力します。
取引先責任者 ID をコンテキスト ID として子 Flexcard に渡す
親 Flexcard には取引先情報が表示され、子 Flexcard には取引先の主取引先責任者情報が表示されます。
- 子 FlexCard でデータソースを取得するには、次の SQL クエリを入力します。
- 子 FlexCard を有効化します。
- 親 FlexCard で、主取引先責任者 ID を含む取引先情報を取得するようにデータソースを設定します。
-
属性として contactId、値として
{namespace__PrimaryContactId__c}を入力して、主取引先責任者 ID を子 Flexcard に渡します。
再帰 Flexcard のデータノード
再帰 FlexCard には、商品内の商品をリストする商品データ項目を含む階層 JSON データがあります。
[
{
"Id": "5123",
"Name": "Exit Communications",
"Account Number": "QHT123456789",
"Phone": "415-987-6543",
"Website": "http://www.exitcomm.org",
"Contact": "Melrose Oduke",
"Contact Phone": "415-333-1234",
"Products": [
{
"Id": "1",
"Name": "Product1",
"Products": [
{
"Id": "1_1",
"Name": "Product1_1"
},
{
"Id": "1_2",
"Name": "Product1_2",
"Products": [
{
"Id": "2",
"Name": "Product2",
"Products": [
{
"Id": "2_1",
"Name": "Product2_1"
},
{
"Id": "2_1_2",
"Name": "Product2_1_2"
}
]
}
]
}
]
}
]
}
]
- 子 FlexCard を FlexCard 内に一度埋め込み、商品データ項目を FlexCard 自身に渡すようにします。
-
[データノード] に「
{record.Products}」と入力します。
