さまざまな条件付き入力を使用して Omniscript JSON を準備する

学習の目的

この単元を完了すると、次のことができるようになります。

• 管理パッケージ用 Omnistudio のさまざまな条件付き入力に基づいてデータを保存する方法を説明する。
  
• Data Mapper Load の入力に使用する Omniscript JSON を準備する。
  

さまざまな条件付き入力に基づいてデータを保存する

「分岐のある Omniscript」モジュールで作成したような、ユーザー入力に基づくガイド付きインタラクションがあるとします。Omniscript の例では、ユーザーが既存の主取引先責任者のデータを更新することや、主取引先責任者を別の取引先責任者に変更すること、新しい取引先責任者を作成して主取引先責任者に割り当てることができます。つまり、データが 3 つの方法で更新される可能性があるということです。こうしたオプションを分岐といいます。 

• 分岐 1: 既存の主取引先責任者のメールアドレスや電話番号を更新する。
  
• 分岐 2: 主取引先責任者の名前を変更し、更新された取引先責任者のメールアドレスや電話番号を変更する。
  
• 分岐 3: 新しい取引先責任者の名前、メールアドレス、電話番号を入力して、主取引先責任者に指定する。
  

エンドユーザーがどのオプションを選択した場合でも、更新されたデータが確実に保存されるようにするにはどうすればよいでしょうか?

「管理パッケージ用 Omnistudio の Omnistudio Data Mapper」モジュールでは、Omniscript で更新された情報が Data Mapper Load によって元の Salesforce に戻されて保存されることを学びました。つまり、変更されたデータでレコードを更新すると同時に新規レコードが作成されます。ただし、この場合は 3 つの Data Mapper Load を構築する必要があります。 

なぜでしょうか?

• Omniscript の分岐ごとに、データを保存する Data Mapper Load が必要です。どの Data Mapper Load を実行するかを判断する Integration Procedure も構築しなければなりません。
  
• Data Mapper Load を構築する 3 つの分岐のすべてに完全な Data JSON (JavaScript オブジェクト表記) が必要です。
  

Data Mapper Load の入力に使用する Omniscript JSON を準備する

[Preview (プレビュー)] を使用して Omniscript を実行すると、インタラクションに必要なデータが入力された Data JSON が作成されます。この Omniscript JSON は、Omniscript の [Action Debugger (アクションデバッガー)] にある [Request Data (要求データ)] ペインに示されます。これが Data Mapper Load の入力データとして使用する Omniscript JSON です。 

Omniscript を実行して条件結果が表示された場合、そのいずれかの結果の JSON にのみデータが追加されます。Data Mapper Load を構築するためには、3 つの結果のすべてに完全な Data JSON が必要なため、Omniscript の手順を実行して、それぞれの条件入力で JSON にデータを追加します。

では、Update Account Primary Contact Omniscript でこの手順を実行してみましょう。 

1. [Preview (プレビュー)] タブで、AccountId を ContextId として入力し、[Update Primary Contact (主取引先責任者を更新)] を選択してから、[Next (次へ)] を選択する必要があります。
   
2. Omniscript の [Action Debugger (アクションデバッガー)] (1) で、[IPSavePriContactDetails] (2) を拡張し、[Request Data (要求データ)] ペイン (3) のデータをすべてコピーします。
   

BlkChangePriContact データと BlkCreatePriContact データのどちらもテキストボックスが Null 値になっています。この点は後ほど説明します。

Omniscript の他の 2 つのオプションもプロセスは同じですが、[Request Data (要求データ)] ペインのすべての JSON はコピーしません。その代わりに、BlkChangePriContact データと BlkCreatePriContact データの Null 値を置換するために必要な JSON のみをコピーします。

主取引先責任者の変更オプションの JSON を表示するため、テキストボックスで BlkChangePriContact データを選択してコピーします。画像の強調表示された部分に示すとおり、4 つのブラケットが含まれていることを確認します。

主取引先責任者の新規作成オプションの JSON を表示するため、テキストボックスで BlkChangePriContact データを選択してコピーします。画像の強調表示された部分に示すとおり、2 つのブラケットが含まれていることを確認します。

主取引先責任者の作成オプションの JSON に戻り、BlkChangePriContact データと BlkCreatePriContact データの Null 値を、主取引先責任者の変更オプションや新しい主取引先責任者の作成オプションでコピーした JSON と置換します。 

これで、3 つの新しい Data Mapper Load を構築するための完全な JSON パスが作成されました。Data Mapper Load を構築する前に、Omniscript に接続するための Integration Procedure を準備します。次の単元ではこの点を取り上げます。

リソース

• Trailhead: 分岐のある Omniscript
• Salesforce ヘルプ: Omnistudio Data Mapper Load の概要 (管理パッケージ用 Omnistudio)