Loading
設定整合程序的值動作

設定整合程序的值動作

「設定值」動作使用文字值、合併欄位或公式,在整合程序的資料 JSON 中設定值。

備註
備註

「設定值」公式中兩個百分比 (%) 符號之間的任何文字都會視為 合併欄位。若要表示文字百分比 (%) 符號,請使用 $Vlocity.Percent 環境變數

「設定值」動作不支援自訂標籤。

內容

內容

描述

元素值地圖:元素名稱

要設定值的 JSON 節點。

元素值地圖:值

要指派給 JSON 節點的值。選項:

  • 從上一個步驟合併欄位 (%elementName%)

  • 文字表示值

  • 已串連值

  • 公式與函數的結果

  • 結合選項的運算式:「個案狀態:%caseStatus%」

範例

如需以下範例,請考慮此範例輸入 JSON。

{
    "Name": {
        "FirstName": "John",
        "LastName": "Smith"
    },
    "Finances": {
        "GrossIncome": "100000",
        "Expenses": "60000"
    }
}

重新命名輸入資料中的節點

若要縮短和簡化輸入 JSON 節點,請設定「元素值對應」,如下所示。

元素名稱

名字

%Name:FirstName%

姓氏

%Name:LastName%

GrossIncome

%Finances:GrossIncome%

費用

%Finances:Expenses%

設定文字表示值

若要設定文字值,這對測試或指定未變更資料很實用,請設定「元素值對應」,如下所示。

元素名稱

位置

舊金山

代碼

2345

串連文字值和合併欄位

若要將文字字串與合併欄位串連,請設定「元素值對應」,如下所示。

元素名稱

LocationCode

代碼為 %LocationData:Code%

%LocationData:Code% 合併欄位會從先前的元件 (LocationData) 提取資料。

定義陣列

若要設定陣列,請按一下「編輯為 JSON」,然後編輯如下所示的 ElementValueMap 節點。

"elementValueMap": {
   "Departments": [
      "Sales",
      "Development",
      "Support",
      "Training"
   ]
},

使用公式執行簡單計算

若要執行計算,請在「元素值地圖」中使用運算子,例如以下範例。

元素名稱

AfterTaxIncome

=%Inputs:GrossIncome% * 0.7

設定 CalculateNet 的「元素值對應」如下:

元素名稱

NetIncome

=%AfterTax:AfterTaxIncome% - %Inputs:Expenses%

串連兩個合併欄位

若要串連兩個合併欄位,請設定「元素值對應」,如下所示。

元素名稱

全名

=%Inputs:FirstName% + " " + %Inputs:LastName%

請注意用於分隔名字和姓氏的文字表示空格。

使用函數並取得陣列值

此範例使用 IF 函數。它也會使用 listnode|listnumber 標記法來取得陣列值。

元素名稱

部門

=IF(%Inputs:FirstName% = "John",%DeptArray:Departments|2%,%DeptArray:Departments|3%)

此元件會將「部門開發」值指派給名稱為 John 的任何人,並將「部門支援」值指派給非名稱為 John 的任何人。請注意,第二個等於符號前後有空格,以區分它與函數。

備註
備註 依預設,如果 IF 函數輸出為大型數字,則會轉換為科學標記法。如果大型數字是識別碼而非數學運算元,若要防止此轉換,請在 TOSTRING 函數中包含 IF 函數。

執行複雜日期計算

此範例使用四個巢狀日期函數來傳回當月的第一天。

元素名稱

FirstOfThisMonth

=ADDDAY(EOM(ADDMONTH(TODAY(),-1)),1)

建立輸出資料結構

此範例針對轉換的資料建立 JSON 結構。若要設定結構,請按一下「編輯為 JSON」,然後編輯如此範例 JSON 的 ElementValueMap 節點。

"elementValueMap": {
    "Output": {
        "FullName": "%ConcatName:FullName%",
        "Department": "%RetrieveDept:Department%",
        "AfterTaxIncome": "%AfterTax:AfterTaxIncome%",
        "NetIncome": "%CalculateNet:NetIncome%",
        "Location": "%LocationData:Location%",
        "LocationCode": "%TextWithCode:LocationCode%",
        "FirstOfThisMonth": "%CalcFirstOfThisMonth:FirstOfThisMonth%"
    }
},
 
正在載入
Salesforce Help | Article