Loading
PHPの脆弱性に関する監視状況について 続きを読む
弊社ヘルプサイトの Agentforce でケース作成フォームが表示されない場合の対応方法続きを読む
メールアドレスがデフォルトのログイン方式となります 続きを読む
FlexCard への Flexcard の埋め込み

FlexCard への Flexcard の埋め込み

FlexCard を別の FlexCard に子として埋め込むことで、FlexCard 間でデータを共有します。子の FlexCard にはデータソースを含めることも、親が子のデータソースを独自のデータソースで上書きすることもできます。親は、子のコンテキスト ID として使用するレコード ID など、特定のデータを子に渡すこともできます。

  1. アプリケーションランチャーで、[Flexcards] を見つけて選択します。
  2. FlexCard を展開し、バージョンを選択します。
  3. 必要に応じて、FlexCard を無効化して FlexCard を編集します。
  4. Flexcard 要素を要素パネルからキャンバスにドラッグします。

    [設定] で FlexCard の OmniScript サポートを有効にした場合は、この設定も有効になっている子 FlexCard のみを選択します。

  5. FlexCard が階層データを持つ子 FlexCard であり、繰り返し FlexCard 自体に追加する場合は、[再帰的] を選択します。

    再帰的な子 FlexCard に条件を適用すると、OmniStudio はその条件をすべての再帰的な繰り返しレコードに適用します。1 つのレコード条件で false が返される場合、ネストされたレコードは表示されません。

    プレビュー時または実行時に、子 Flexcard は、JSON コードの各レベルで使用可能な同じ子データ項目 (データノードとも呼ばれる) を、そのデータ項目がなくなるか空になるまで渡します。その結果、Flexcard には親オブジェクトの子および孫が表示されます。

  6. 子 Flexcard のデータソースを使用する代わりに親 Flexcard のデータソースからオブジェクトを渡すには、データノードを選択します。
    • {records}: すべてのデータを渡します。

    • {records[#]}: 指定されたレコードのデータを渡します。たとえば、{records[0]} は最初のレコード、{records[1]} は 2 番目のレコードというように続きます。

    • {record}: 設定オプションで [レコードの繰り返し] を選択解除した場合などに、現在のレコードのデータを渡します。

    • {record.FieldName}: レコード オブジェクトを渡します。たとえば、オブジェクトまたは配列に追加データがある場合は {record.Product} を使用します。

    • {record.attributes}: 現在のレコードのすべての属性を送信します。

    • 再帰 Flexcard の場合、繰り返し子ノードを入力して、特定のデータセット内のオブジェクトを子 Flexcard から自身に渡します。

    子カードが親データに依存している場合、親 Flexcard のデータが変更されると、子 Flexcard が再表示されます。

    メモ
    メモ

    子 Flexcard に入力する項目が親 Flexcard のデータソースで使用できることを確認します。たとえば、子の Flexcard にケースオブジェクトの [状況] 項目と [優先度] 項目のデータが表示されている場合、親データソースの項目が同じである必要があります。

  7. 特定の属性を渡すには、属性名と値を入力します (AccountId や {Id} など)。
    メモ
    メモ

    [値] 項目では、プレーンテキストとサポートされる差し込み項目の組み合わせを含む連結文字列がサポートされます。たとえば、ブレッドクラムパスを渡すには、「{Parent.parentPath}>{Parent.type}>{Name}」と入力します。

  8. 子 Flexcard の [設定] の [データソース] で、差し込み項目またはプレーンテキスト (SOQL クエリの {Parent.AccountId} など) を使用して属性を参照します。

子 FlexCard から親 FlexCard へのデータの渡し

FlexCard を別の FlexCard に組み込んだら、子のカスタムイベントアクションの入力パラメーターを使用して、子の FlexCard から親にデータを渡します。次に、子 Flexcard のイベントに応じて親 Flexcard のデータ項目を更新するようにイベントリスナーを設定します。

  1. 子 FlexCard を開きます。
  2. 要素パネルから [アクション] 要素をキャンバスにドラッグします。
  3. プロパティパネルから、[アクション] セクションを展開します。
  4. [Event] アクション種別と [Custom] イベント種別を選択します。
  5. 「updatecity」などのイベント名を入力します。
  6. コンテキストデータを渡します。
    1. 入力パラメーターを追加します。
    2. [Key] に、親からコールする名前を入力します (「cityname」など)。
    3. [値] に、New York などのプレーンテキストとして、または {City} などの子のデータソースからの差し込み項目として渡す値を入力します。
  7. 子 FlexCard を有効化します。
  8. 親 FlexCard を開きます。
  9. [設定] から、イベントリスナーを追加します。
    1. 子 FlexCard のカスタムイベントと同じイベント名を入力します (「updatecity」など)。
    2. [Action] セクションを展開します。
    3. [Card] アクション種別と [値の設定] 種別を選択します。
    4. [キー] に、更新するデータ項目を入力します。
    5. [値] に、action.param コンテキスト変数を使用して、子 FlexCard から渡される入力パラメータの名前を入力します。たとえば、入力パラメーターのキーが cityname の場合、「{action.cityname}」と入力します。
    6. 変更内容を保存します。

プレビューで、子 FlexCard のアクションをクリックして親のデータ項目を更新します。

取引先およびケース情報の表示

データテーブルを使用して、親 Flexcard に取引先情報を、子 FlexCard にケース情報を表示する。

  1. 子の Flexcard で、[設定] オプションの [レコードの繰り返し] をオフにして、Flexcard に 1 つのテーブルが表示されるようにします。
  2. 子 FlexCard にデータテーブルを追加し、ケース情報を取得するようにデータソースを設定します。
  3. 子 FlexCard を有効化します。
  4. 親 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"
    	    }
    	]
        }
    ]
  5. 子 Flexcard を親 Flexcard に追加します。
  6. [データノード] に「{records[0].Cases}」と入力します。

OmniStudio は子データソースを無視し、親 Flexcard のデータを子 Flexcard データテーブルに入力します。

取引先責任者 ID をコンテキスト ID として子 Flexcard に渡す

親 Flexcard には取引先情報が表示され、子 Flexcard には取引先の主取引先責任者情報が表示されます。

  1. 子 FlexCard でデータソースを取得するには、次の SQL クエリを入力します。
    Select Id,Name,Email,Phone,MailingStreet,MailingCity,MailingState,MailingPostalCode,MailingCountry 
    from Contact where Id = '{Parent.contactId}'
  2. 子 FlexCard を有効化します。
  3. 親 FlexCard で、主取引先責任者 ID を含む取引先情報を取得するようにデータソースを設定します。
  4. 属性として 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"
                           }
                        ]
                     }
                  ]
               }
            ]
         }
      ]
   }
]
商品、そのサブ商品、およびサブ商品を表示する
  1. 子 FlexCard を FlexCard 内に一度埋め込み、商品データ項目を FlexCard 自身に渡すようにします。
  2. [データノード] に「{record.Products}」と入力します。
 
読み込み中
Salesforce Help | Article