詳細情報:
OmniStudio データマッパー抽出出力 (管理パッケージ)
管理パッケージランタイムの場合、抽出ステップ JSON のデータを出力 JSON に対応付けるには、[出力] タブに移動します。null 値、属性、翻訳、項目レベルの権限、キャッシュ、リスト変換を処理することもできます。
この情報は、OmniStudio for Managed Packages 用です。標準ランタイムの OmniStudio については、OmniStudio ヘルプを参照してください。
-
[+] をクリックします。空の対応付けがリストに追加されます。
-
[抽出 JSON パス] 項目で、抽出ステップの JSON から取得元項目を選択します。
-
[出力 JSON パス] 項目で、目的の出力パスを指定します。
[現在の JSON 出力] ペインには、出力の対応付けで指定されている構造が表示されます。
ベストプラクティス: 可能な場合は、データソースである Salesforce オブジェクトの [抽出] タブで [抽出出力パス] に名前を付けます。[抽出 JSON パス] 項目値の最初のノードを定義します。
[JSON パスを抽出] 項目でリレーション表記を使用することで、一部の使用事例でデータマッパーのパフォーマンスを改善できます。「Relationship Notation versus Multiple Extract Steps (Managed Package) (リレーション表記と複数の抽出ステップの比較 (管理パッケージ))」を参照してください。
数式を使用して出力データを追加することもできます。詳細は、「Use Formulas in OmniStudio Data Mappers (Managed Package) (OmniStudio データマッパー (管理パッケージ) での数式の使用)」および「関数リファレンス (管理パッケージ)」を参照してください。
出力マップのクイック一致
一括照合するには、[クイック一致] ボタンをクリックします。[クイック一致] ダイアログでは、次のように項目を対応付けることができます。
-
ドラッグアンドドロップ: ソース sObject 項目を左列から中央列の対象出力項目にドラッグします。その逆も同様です。ソース sObject 項目がない出力の場合、出力の対応付けを [一致対応付け] 列にドラッグします。
-
ペア: 入力項目と出力項目を選択して、[ペア] をクリックします。
-
自動照合: [自動照合] をクリックします。名前が一致する項目は自動的に照合されます。
対応付けは、右側の [一致対応付け] 列に表示されます。
Salesforce から読み取った後に値を再定義するには、[マップ値を変換] セクションに移動し、入力値と出力値を指定するキー/値のペアを追加します。たとえば、TRUE の入力値を Y の出力値に変換するには (yes の場合)、KEY = TRUE と VALUE = Y を指定します。
多数の項目の対応付けを容易にするには、コール元の OmniScript または Integration Procedure から [予想される JSON 出力] ペインにデータ JSON を貼り付けます。これにより、[出力 JSON パス] 項目のパスのリストが入力されます。
null 値
項目が null の場合に出力する値を指定するには、[デフォルト値] プロパティを設定します。デフォルトのデータ型を上書きするには、出力データ型を指定します。データの損失を防止するには、互換性のあるデータ型を選択します。
たとえば、テキスト値に常に数値データが含まれている場合、出力種別は数値で問題ありません。英字が含まれている可能性がある場合は、テキスト出力データ型を選択する必要があります。
デフォルトでは、値が null の場合、出力 JSON の項目のノードは作成されません。項目が null であるかどうかに関係なく、ノードが作成されていることを確認するには、[オプション] タブに移動し、[すべての Null 入力の対象を上書き] をオンにします。
データマッパー抽出でレコードが取得されない場合、返される内容はリリースによって異なります。
-
Summer '18 以前のリリースでは、
nullが返されます。 -
Fall '18 以降のリリースでは、空の JSON、
{}が返されます。
オブジェクト属性
オブジェクト属性を対応付けるには、先頭に @ を付けたコード (名前ではない) を使用して属性を指定します。(デフォルトでは、属性コードには属性の作成時に GUID 値が割り当てられ、コードを編集して人間が判読可能な値を指定できます)。@ を使用して属性を取得するには、[設定] > [カスタム設定] > [Vlocity 機能] の EnableV2AttributeModel 設定を true に設定する必要があります。含まれていない場合は、Knowledge Article「DataRaptor does not retrieve Vlocity attributes」を参照してください。
たとえば、取引先が Gold Star 取引先としてタグ付けされているかどうかを確認するには、データマッパー抽出を使用して Gold Star 属性を参照します。
結果:
{
"Id": "0016100001Ey84KAAR",
"GoldStarAccount": "On"
} デフォルトでは、On-Off 種別の属性の値は Off の場合、出力は返されません。ただし、「デフォルト値」プロパティーを Off に設定して、どちらかの値を返します。
属性に別の出力値が必要な場合は、[マップ値を変換] オプションを使用できます。たとえば、On-Off 型の属性の場合、On を true に、Off を false に対応付けるキー/値ペアを追加できます。
項目の JSON データ
一部の項目には JSON データが含まれます。このデータを対応付けるには、[抽出 JSON パス] で標準表記を使用します。次に例を示します。
Object:JsonField__c:JsonNode:ChildJsonNode翻訳
翻訳済み商品データを取得するようにデータマッパーを設定するには、[オプション] タブに移動して [翻訳を使用] をオンにします。
このオプションを有効にすると、データマッパーはユーザーのロケールの文字列翻訳を返します。ロケールで文字列翻訳が定義されていない場合、ベース言語で定義された商品データが返されます。たとえば、ベース商品データが英語で入力され、フランス語の文字列翻訳が定義されていない場合、フランス語ロケールのユーザーには英語の商品データが表示されます。商品項目の文字列翻訳を指定するには、Vlocity 商品コンソールに移動します。商品コンソールでの商品の作成
権限、キャッシュ、その他のオプション
[オプション] タブで追加の省略可能な設定を行うことができます。
-
Check Field Level Security: データマッパーを実行する前に、フィールドに対するユーザーのアクセス権限をチェックします。この設定を有効にすると、組織キャッシュは無効になりますが、セッションキャッシュは無効になりません。
-
Overwrite Target For All Null Inputs (すべての Null 入力の上書き対象): 項目が null かどうかに関係なく、出力ノードが作成されます。
-
Use Translations (翻訳を使用): 翻訳済み商品データを取得するようにデータマッパーを設定します。
-
Time To Live In Minutes: データキャッシュが有効になっている場合、キャッシュにデータを保持する期間を決定します。最小値は 5 です。
-
Salesforce Platform キャッシュタイプ: データキャッシュを有効にします。ユーザーとそのログインセッションに関連するデータの場合は [セッションキャッシュ]、その他のすべてのデータタイプの場合は [組織キャッシュ] に設定します。「Cache for OmniStudio Data Mappers (Managed Package)」を参照してください。
リストマップ
出力のリストにデータをマッピングするには、listname|# 構文を使用します。
listname は出力ノードのキーを指定し、# は出力が存在するリスト内の位置を指定します。パイプ (|) 記号の区切り文字をメモします。次の例は、入力ノードのフラットセットを出力リストにマッピングする方法を示しています。
入力 JSON |
マッピング |
出力 JSON |
|---|---|---|
|
|
|
データマッパーのリストについての詳細は、「List Input for Omnistudio Data Mappers (Managed Package)」を参照してください。
