詳細情報:
複数の抽出ステップを使用する場合 (管理パッケージ)
管理パッケージランタイムの場合、必要な抽出ステップ数は、抽出元のオブジェクト種別の関連によって異なります。3 つの基本的なシナリオ (単一、リレーション表記を使用する単一、複数) があります。
この情報は、OmniStudio for Managed Packages 用です。標準ランタイムの OmniStudio については、OmniStudio ヘルプを参照してください。
-
1 つのオブジェクト種別 (ケースなど) からデータを抽出する場合、必要な抽出ステップは 1 つのみです。
-
主オブジェクトと 1 つ以上の親オブジェクトからデータを抽出する場合も、抽出ステップは 1 つのみです。たとえば、各ケースの取引先データを含むケースを抽出します。「Relationship Notation versus Multiple Extract Steps (Managed Package) (リレーション表記と複数の抽出ステップの比較 (管理パッケージ))」を参照してください。
-
主オブジェクトと 1 つ以上の子オブジェクトからデータを抽出するには、オブジェクト種別ごとに少なくとも 2 つの抽出ステップが必要です。たとえば、取引先とその取引先に関連付けられたすべてのケースを抽出します。
たとえば、ケース番号でケースを検索するには、抽出ステップで CaseNumber = Number などの検索条件を使用できます。
オブジェクトは、抽出ステップで指定した順序で照会されます。これは、以前に参照したオブジェクトのデータを使用して後続のオブジェクトを絞り込む必要がある場合の 3 番目のシナリオで重要です。
たとえば、特定の取引先に関連付けられたすべてのケースを検索するには、最初の抽出ステップで Id = Id などの基本的な検索条件を使用して取引先を参照し、2 番目の抽出ステップで AccountId = Acct:Id などの検索条件を使用してケースを参照します。(AccountId はケース項目、Acct:Id は取引先の ID 項目への参照)。
![取引先オブジェクトの抽出出力パスは Acct で、検索条件は Id = Id です。Case オブジェクトには [Extract Output Path of Case (ケースの抽出出力パス)] があり、AccountId = Acct:Id という検索条件があります。](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-262-0-0-production-jajp/d11fb654-08cc-42c6-87d2-311f438d8d6f/omnistudio_for_managed_packages/images/accountcases.png)
このデータは抽出ステップ JSON に読み込まれ、右側の [抽出ステップ JSON] ペインには、このタブで指定した出力パスで定義された最上位階層が表示されます。
デフォルトでは、値が null の場合、出力 JSON の項目のノードは作成されません。項目が null であるかどうかに関係なく、ノードが作成されていることを確認するには、[オプション] タブに移動し、[すべての Null 入力の対象を上書き] をオンにします。
