轉換變數和輸出

為了方便在鏈結中作為命令輸入使用，您可以將轉換套用至變數或命令輸出。可以將多個轉換套用於命令輸入，例如進一步轉換其資料或其轉換的輸出。

轉換

轉換	資料類型	說明
將文字解析為 JSON	文字字串標題	將字串轉換為 JSON
解析數字	文字字串標題	將數字字串轉換為數字
小寫	文字字串標題	將字串轉換為小寫字母
大寫	文字字串標題	將字串轉換為大寫字母
首字母大寫	文字字串標題	將整個字串首字母大寫
標題化	文字字串標題	將字串中的每個字首字母大寫
修剪	文字字串標題	移除字串開頭與結尾的空格
修剪前綴	文字字串標題	移除字串開頭的空格
修剪後綴	文字字串標題	移除字串結尾的空格
填補左側	文字字串標題	在字串左側新增空格，以延長至特定長度
填補右側	文字字串標題	在字串右側新增空格，以延長至特定長度
取代	文字字串標題	根據完全相符或規則運算式取代字串值
分割	文字字串標題	根據分隔值分割字串
加	數字#	為數字加上一個值
減	數字#	從數字中減去一個值
乘	數字#	將數字乘以一個值
除	數字#	將數字除以一個值
四捨五入	數字#	將數字四捨五入到指定的小數位
解析日期/時間	文字字串標題或日期或時間戳記  date_range	將日期或時間戳記轉換為特定的格式和時區
日期計數	日期或時間戳記  date_range	在時間戳記上，或從時間戳記增加或減少天數、月份、年份、小時或分鐘
日期和時間格式	日期或時間戳記  date_range	格式化日期或時間戳記
排序	清單  list	升序或降序排序清單項目
從清單中挑選	清單  list	從清單中取得個別元素
從 JSON 中取得值	JSON  code	從適當的 JSON 字串中將個別源素轉換成字串、清單或 JSON

附註：使用 JSON 輸出作為另一個命令的屬性時，您可以從輸出中選擇特定元素，而不是其完整的 JSON 字串。如果選擇元素而不是完整字串，請套用「從 JSON 取得值轉換」以轉換其資料類型。

將文字解析為 JSON

若要將文字變數或輸出轉換為 JSON，請套用「將文字解析為 JSON」：

1. 在鏈結中，選取要有轉換輸入的命令節點，然後按一下「編輯」(Edit) create。
2. 在命令屬性下，按一下變數或輸出結果以轉換。
3. 選取將文字解析為 JSON，再按一下「新增」(Add)  add。

   附註：若也要從 JSON 中擷取元素，請從 JSON 中選取「取值」，再按一下「新增」  add 以套用其他轉換。

4. 按一下「接受」(Accept)。

更新字串的大寫

要將文字變數或輸出轉換為全部大寫或小寫，請套用「大寫」或「小寫」轉換：

1. 在鏈結中選取有轉換輸入的命令，然後在「命令屬性」(Command Properties) 下按一下要轉換的變數或輸出。
2. 選取要套用的轉換：
   • 若要大寫字串各字母的首字，請選取「標題化」(Titleize)。
   • 若要將字串的各字母全部大寫，請選取「大寫」(Uppercase) 或大寫 (Capitalize)。
   • 若要將字串的字母全部小寫，請選取小寫 (Lowercase)。

   附註：若要轉換字串，請選取要套用的其他轉換，然後按一下「新增」  add。

3. 按一下「接受」(Accept)。

在字串上新增或移除開頭或結尾空格

若要新增或移除文字字串變數或輸出開頭或結尾的空格，請套用「增補」或「修剪」轉換：

1. 在鏈結中選取有轉換輸入的命令，然後在「命令屬性」(Command Properties) 下按一下要轉換的變數或輸出。
2. 選取要套用的轉換，請按一下「新增」(Add) add：
   • 若要在字串的開頭新增空格，請選取左邊增補，或是輸入字串的總長度。
   • 若要在字串的結尾新增空格，請選取右邊增補，或是輸入字串的總長度。
   • 若要移除字串開頭的空格，請選取「修剪前綴」。
   • 若要移除字串結尾的空格，請選取「修剪後綴」。
   • 若要同時移除字串開頭與結尾的空格，請選取「修剪」。

   附註：若要轉換字串輸出，請選取要套用的其他轉換，然後按一下「新增」add。

3. 選擇「接受」(Accept)。

分割字串

若要根據分隔值分割文字字串變數或輸出，請套用「分割」轉換：

1. 在鏈結中選取有轉換輸入的命令，然後在「命令屬性」(Command Properties) 下按一下要轉換的變數或輸出。
2. 請選取「分割」(Split) 然後按一下「新增」(Add) add。
3. 針對分隔，請輸入用來分割字串的文字值。

   附註：若要轉換字串輸出，請選取要套用的其他轉換，然後按一下「新增」add。

4. 選擇「接受」(Accept)。

取代字串中的值

若要以其他值取代文字變數或輸出的值，請套用「取代」轉換：

1. 在鏈結中選取有轉換輸入的命令，然後在「命令屬性」(Command Properties) 下按一下要轉換的變數或輸出。
2. 請選取「取代」(Replace) 然後按一下「新增」(Add)  add。
3. 在「尋找」(Find) 中輸入要取代字串的條件值為完全匹配或規則運算式。
4. 在「取代」(Replacement) 中輸入要取代與「尋找」(Find) 條件完全匹配之文字的值。
5. 在「匹配類型」(Match Type) 中選取是否要將「尋找」(Find) 條件設定為完全匹配或規則運算式 (RegEx)。

   附註：若要轉換字串輸出，請選取要套用的其他轉換，然後按一下「新增」add。

6. 按一下「接受」(Accept)。

加、減、乘、除或四捨五入數字

要對數值執行數學運算，請應用「加」、「減」、「乘」、「除」或「四捨五入」轉換。

提示：要對數值字串值執行數學運算，請先套用解析數字轉換。

• 若為「加」或「減」轉換，請輸入要增加或減少的數字。
• 若為「乘」或「除」轉換，請輸入要乘或除的數字。
• 若為「四捨五入」轉換，請輸入要四捨五入至多少小數位。

將日期或時間戳記解析為字串

要將日期或時間標記變數或輸出轉換為特定格式和時區，請套用「解析日期/時間」轉換：

1. 在鏈結中選取有轉換輸入的命令，然後在「命令屬性」(Command Properties) 下按一下要轉換的變數或輸出。
2. 選取將解析日期/時間，再按一下「新增」(Add) add。
3. 請選擇要使用國際標準化組織 (ISO) 或自訂的日期或時間戳記格式。
4. 輸入如何使用 strftime 格式和分隔符 (如 、、、、: 或 /) 來格式化日期或時間值。例如，%m-%d-%Y 表示 01-30-2020，%H:%M 表示 21:08。
5. 若要變更日期或時間戳記的時區，請選擇輸入和輸出值的時區。

   附註：若要轉換字串輸出，請選取要套用的其他轉換，然後按一下「新增」add。

6. 按一下「接受」(Accept)。

增加/減少日期或時間戳記

若要增加或減少距離特定日期或時間戳記變數或輸出的間隔值，請套用「增加/減少日期和時間」轉換：

1. 在鏈結中選取有轉換輸入的命令，然後在「命令屬性」(Command Properties) 下按一下要轉換的變數或輸出。
2. 選取增加/減少日期和時間，再按一下「新增」(Add) add。
3. 請選擇要使用國際標準化組織 (ISO) 或自訂格式。
4. 針對「操作」(Operation)，請選擇是否增加或減少時間戳記。
5. 請輸入要為時間戳記漸增或漸減的值，例如 1 天。

   附註：若要變更時間戳記格式，請選取解析日期/時間，再按一下「新增」  add 以套用其他轉換。

6. 按一下「接受」(Accept)。

排序清單項目

若要升序或降序排序清單變數中的項目，請套用「排序清單」轉換：

1. 在鏈結中選取有轉換輸入的命令，然後在「命令屬性」(Command Properties) 下按一下要轉換的變數或輸出。
2. 請選取「排序清單」(Sort List) 然後按一下「新增」(Add)  add。
3. 請選取要升序或降序排序清單。

   附註：若要從清單中挑選字串元素，請選取「從清單中挑選元素」，再按一下「新增」  add 以套用其他轉換。

4. 按一下「接受」(Accept)。

從清單中挑選元素

若要從清單變數或輸出擷取個別元素，請套用「從清單中挑選元素」轉換：

1. 在鏈結中選取有轉換輸入的命令，然後在「命令屬性」(Command Properties) 下按一下要轉換的變數或輸出。
2. 請選取「從清單中挑選」(Pick from List) 然後按一下「新增」(Add)  add。
3. 針對「值」(Value) 輸入要選擇的元素的索引編號。第一個元素為 0，最後一個為 -1。

   附註：若要轉換字串元素，請選取要套用的其他轉換，然後按一下「新增」add。

4. 按一下「接受」(Accept)。

從 JSON 中取得值

若要將單個元素從 JSON 變數或輸出轉換為字串、清單或 JSON，請套用「從 JSON 取得值」轉換。使用轉換時，JSON 中清單中的元素使用從零開始的索引，其中第一個值的索引為 0。

附註：若要判斷轉換解析的元素索引和名稱，請按一下「監控」  flight_takeoff，然後檢視命令的 JSON 輸出。

1. 在鏈結中選取有轉換輸入的命令，然後在「命令屬性」(Command Properties) 下按一下要轉換的變數或輸出。
2. 選取「從 JSON 取得值」，然後按一下「新增」(Add)  add. 
   
3. 選擇是將元素輸出為文字字符串標題、清單 list，或是 JSON 代碼。
4. 對於值，輸入：
   • 如果 JSON 包含多個物件，則從 0 開始從中提取物件的索引。例如，對於第二個物件，輸入 1。

     附註：僅當 JSON 包含多個物件時，才輸入索引。

   • 要選擇的元素的名稱，例如id。

   附註：要從轉換轉換輸出 (例如設定日期字串格式或對清單進行排序)，請選取要套用的其他轉換，然後按一下「新增」  add。

5. 按一下「接受」(Accept)。