您位於此處：
在 Omnistudio 資料對應器中使用公式
若要將資料新增至「資料對應器」的輸出,請定義 公式。多種類型的「資料對應器」(「解壓縮」、「轉換」和「載入」) 支援公式。當您定義公式時,您會將其輸出對應至輸出 JSON (用於提取和轉換) 或 Salesforce 物件欄位 (用於載入)。
如需在公式中可使用之運算子和函數的詳細資料,請參閱 Omnistudio 公式和函數。
備註
如果變數名稱包含空格或非英數字元,請以雙引號括住變數名稱,並在公式中以 var: 為前方。例如,如果 JSON 節點名稱為 Primary Guardian,請在公式中將其指定為 var:"Primary Guardian"。
如果自訂欄位的名稱包含特殊字元,有時您無法在公式中參照該欄位。
在 Omnistudio 標準執行階段中,針對「資料對應器」輸入不正確的查詢公式會傳回空值,但不會顯示錯誤記錄。如果您從查詢中得到空值回應,請更新查詢。
- 在「資料對應器介面」頁面中,移至「公式」 索引標籤。
- 按一下「新增公式」。將空白公式新增至清單。
-
在「公式」 欄位中,指定所需的邏輯。例如,若要決定客戶購買項目的總價格,請輸入公式,例如:
SUM(Products:Price)您也可以在公式中使用關係標記法來參照父系物件中的欄位。請參閱關係標記法與多個解壓縮步驟。
- 在「公式結果路徑」欄位中,指定要儲存公式結果的 JSON 節點。
-
將結果對應至最終輸出。
- 針對資料對應器,請在「輸出」 索引標籤上,將公式結果對應至輸出結構。使用冒號 (:) 分隔對應中輸入和輸出路徑中的層級。
- 針對「轉換資料對應器」,在「轉換」 索引標籤上,將公式結果對應至輸出結構。使用冒號 (:) 分隔對應中輸入和輸出路徑中的層級。
- 針對「載入資料對應工具」,針對您要更新的每個 sObject,在「欄位」 索引標籤上,將公式結果對應至您要更新的欄位。
- 載入:針對您要更新的每個 sObject,移至其「欄位」 索引標籤,並將公式結果對應至您要更新的特定欄位。
使用公式建立 Omnistudio 資料對應器範例
下列範例接受價格清單,並使用公式計算總價格。
若要建立此「資料對應器轉換」,請執行下列步驟:
- 前往「Omnistudio 資料對應工具設計師」索引標籤,然後按一下「新增」。隨即顯示「建立」對話方塊。
-
指定「資料對應器」的名稱,並設定其設定如下:
- 介面類型:轉換
- 輸入類型:JSON
- 輸出類型:JSON
- 按一下「儲存」。隨即顯示「資料對應器介面」頁面。
- 前往「公式」索引標籤,然後按一下「新增公式」。
- 在「公式」 欄位中,輸入 SUM(Products:Price)。
- 在「公式結果路徑」 欄位中,輸入 TotalPrice。
-
在「轉換」索引標籤上,展開「輸入 JSON」窗格並將此 JSON 結構貼到其中:
{ "CustomerName": "Bob Smith", "Products": [ { "Name": "iPhone", "Price": 600 }, { "Name": "iPhone Case", "Price": 30 }, { "Name": "Ear Buds", "Price": 200 } ] } -
展開「預期 JSON 輸出」 窗格,並將此 JSON 結構貼到其中:
{ "CustomerName": "Bob Smith", "TotalPrice": 830, "Products": [ { "Name": "iPhone", "Price": 600 }, { "Name": "iPhone Case", "Price": 30 }, { "Name": "Ear Buds", "Price": 200 } ] } - 按一下「快速比對」。在「快速比對」視窗中,按一下「自動比對」,然後按一下「儲存」。
-
在「預覽」索引標籤上,按一下「執行」。
如果您已正確建立範例,則「回應」窗格中的 JSON 結構符合「預期 JSON 輸出」,但最上層節點的順序除外。
-
在「輸入」窗格中,變更一或多個價格,然後再次按一下「執行」。
請注意
TotalPrice值如何變更。
此文章是否解決您的問題？
請讓我們知道，以便我們改進！
