轉換變數和輸出

為了簡化在鏈結內使用命令輸入，您可以為變數或命令輸出套用轉換。您可以為一個命列輸入套用多個轉換，例如進一步轉換其資料，或其轉換的輸出。

轉換

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

注意：當您將 JSON 輸出當成其他指令的屬性時，您可以從輸出中選取特定元素，而非其完整 JSON 字串。若您選取了元素而非完整字串，請從 JSON 轉換套用「取值」(Get Value) 以轉換其資料類型。

將文本解析為 JSON

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

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

   注意：若也要從 JSON 中擷取元素，請從 JSON 中選取「取值」(Get Value)，再按一下「新增」(Add) add 以套用其他轉換。

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

更新字串的大寫

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

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

   注意：若要轉換字串，請選取要套用的其他轉換，然後按一下「新增」(Add) add。

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

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

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

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

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

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

分割字串

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

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

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

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

取代字串中的值

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   注意：若要變更時間戳記格式，請選取解析日期/時間 (Parse Date/Time)，再按一下「新增」(Add) add 以套用其他轉換。

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

排序清單項目

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

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

   注意：若要從清單中挑選字串元素，請選取「從清單中挑選元素」(Pick from List)，再按一下「新增」(Add) add 以套用其他轉換。

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

從清單中挑選元素

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

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

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

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

從 JSON 中取得值

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

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

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

     注意：僅當 JSON 包含多個對象時，才輸入索引。

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

   注意：若要轉換id輸出的轉換，例如格式化日期字串，或排序清單，請選取要套用的其他轉換，然後按一下「新增」(Add) add。

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