查看 Application Integration 支援的連接器。

資料轉換器工作

預先發布版

這項產品或功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。 正式發布前的產品和功能是按照「原樣」提供，支援範圍可能有限。 詳情請參閱推出階段說明。

資料轉換器工作提供「圖表」和「指令碼」兩種模式，可轉換資料。在「圖表」模式中，您可以使用稱為「資料轉換器」編輯器的視覺化對應畫布，在整合作業中執行資料指派和對應。此外，您也可以使用支援的轉換方式，將資料轉換為有意義的變數和格式，以便在整合流程的其他任務或觸發條件中存取資料。在「指令碼」模式中，您可以編寫、編輯及評估自訂 Jsonnet 範本，以便在整合作業中執行資料對應。

如要瞭解 Application Integration 中的資料對應，請參閱「資料對應總覽」。

設定資料轉換器工作

如要在整合作業中新增「資料轉換器」工作，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「Application Integration」頁面。

   前往「Application Integration」

2. 在導覽選單中，按一下「整合」。

   系統隨即會顯示「整合」頁面，列出 Google Cloud 專案中可用的所有整合功能。

3. 選取現有整合，或按一下「建立整合」建立新整合。

   如要建立新的整合項目：

   1. 在「建立整合」窗格中輸入名稱和說明。
   2. 選取整合作業的區域。
      注意：「區域」下拉式選單只會列出 Google Cloud 專案中佈建的區域。如要佈建新區域，請按一下「啟用區域」。詳情請參閱「啟用新區域」。
   3. 選取整合的服務帳戶。如要變更或更新整合的服務帳戶詳細資料，請隨時前往整合工具列的「整合摘要」窗格。
      注意：只有在您為所選區域啟用整合控管功能時，系統才會顯示選取服務帳戶的選項。
   4. 按一下「建立」，新建立的整合服務會在整合服務編輯器中開啟。

4. 在整合編輯器的導覽列中，按一下「Tasks」(工作)，即可查看可用工作和連結器的清單。
5. 在整合服務編輯器中，按一下並放置「資料轉換器」元素。
6. 按一下「資料轉換器」元素，即可查看任務設定窗格。
7. 按一下「開啟 Data Transformer 編輯器」。在「資料轉換器 (預覽版) 工作編輯器」頁面中，選取下列其中一個選項：
• 根據預設，系統會開啟「圖表」模式。圖表模式提供以控制台為基礎的體驗，可選取輸入和輸出變數，並在資料轉換編輯器中執行轉換。

  在「圖表」模式中，您可以透過視覺化方式，在輸入和輸出變數之間執行資料對應。

• 如要透過編寫、編輯及評估自訂 Jsonnet 範本，在整合中執行資料轉換，請按一下「指令碼」，前往指令碼模式。如有複雜的資料轉換需求，且想運用 Jsonnet 函式，可以使用「指令碼」模式。

  系統會顯示「資料轉換器編輯器」，並預設提供已註解的 Jsonnet 範本範例。編寫 Jsonnet 程式碼，完成後關閉編輯器。系統會自動儲存所有變更。

如需新增對應的詳細步驟，請參閱「新增對應」。

新增對應

如要新增對應，可以使用「圖表」模式或「指令碼」模式。

使用圖表模式

圖表模式提供以控制台為基礎的體驗，可選取輸入和輸出變數，並在資料轉換編輯器中執行轉換。如要使用「圖表」模式新增對應，請按照下列步驟操作：

1. 在「Data Transformer」工作設定窗格中，按一下「Open Data Transformer Editor」。

   根據預設，系統會開啟「圖表」模式。

   

2. 如要新增對應的輸入變數，請按一下「+ 新增輸入」。系統會顯示「Choose Input Variable or Value」(選擇輸入變數或值) 對話方塊。系統預設會選取「變數」分頁。
   輸入：資料轉換輸入內容的來源。來源可以是常值、基本函式或輸入變數，並搭配對應函式。

   

   然後執行下列操作：

   1. 從「選取變數」清單中，選取輸入變數。如要建立新變數，請按一下「+ 新增變數」。
   2. 按一下「提交」。

   如要新增常數，請按一下「常數」分頁標籤 (選用)。

   與變數不同，常數無法在整合流程的其他任務或觸發條件中存取，只能在建立常數的資料轉換任務中使用。舉例來說，您可以使用常數新增分隔符，或將常數值對應至變數。

   

   然後執行下列操作：

   1. 在「常數 ID」欄位中輸入常數名稱。
   2. 在「資料類型」清單中，選取下列其中一種資料類型：
      • 字串
      • 布林
      • 數字
   3. 在「輸入常數值」欄位中輸入值。
   4. 按一下「提交」。
3. 如要新增輸出變數以進行對應，請按一下「+ 新增輸出」，然後選取輸出變數或建立新變數。

   

4. 設定對應：
   1. 從「輸入」部分的「變數」清單中，將變數或其子欄位對應至「輸出」部分的「變數」清單中的變數或其子欄位。

      

   2. 如要新增轉換函式，請將滑鼠游標懸停在對應行上，然後按一下 新增資料轉換函式。畫面上會顯示「轉換」按鈕。

      或者，您也可以按一下 「新增轉換」，新增轉換函式。

      然後執行下列操作：

      1. 如要新增轉換，請按一下「轉換」按鈕。「轉換」面板隨即顯示。

         

         然後執行下列操作：

         1. 按一下「+ Add Operation」。系統會隨即顯示「Add Operation」對話方塊。

            

         2. 在「搜尋作業」欄位中，輸入要新增的作業。或者，您也可以從作業清單中選取作業。

            如要新增自訂運算，請選取「函式運算式」，然後輸入函式運算式。如要複製變數，請按一下「變數」清單中的 ，然後貼到運算式編輯器中。

            

         3. 按一下 [完成]。
      2. 視作業而定，填寫必要的詳細資料。您也可以在轉換中新增多項作業。如要在後續作業中選擇前一個作業的結果，請選取「Previous Operation Result」變數，如下圖所示：

         

      3. 如要移除作業，請按一下作業旁的「刪除」。
   3. 您也可以選擇將多個輸入變數對應至轉換函式。不過，轉換函式的每個輸出變數只能新增一個對應。
   4. 如要移除輸入和輸出變數，請依序點選 >「刪除」。
   5. (選用) 如要刪除對應資料列或轉換，請選取對應項目並按下 Delete 鍵。
   6. 對應完成後，請關閉「資料對應編輯器」。系統會自動儲存所有變更。

   範例：將舊的錯誤單系統對應至新的單系統

   假設您想將舊版錯誤單系統遷移至新的單據系統，您可以選取「圖表」選項，將舊系統的欄位對應至新系統，如下圖所示：

   

   如要為其中一個欄位新增常數值，請按一下「新增輸入」，然後新增常數。您可以將「輸入」部分中新加入的常數，對應至「輸出」部分中的欄位。

   

   如要為無法直接對應的欄位新增轉換，請按一下「轉換」，然後按一下「+ 新增作業」新增轉換作業：

   

   轉換完成後，您就可以執行整合作業，將舊的票務系統對應至新系統。

   使用指令碼模式

   您可以使用資料轉換器指令碼編輯器存取整合作業變數、執行變數指派，以及在整合作業中新增或修改變數。Data Transformer 指令碼編輯器提供下列功能，可提升指令碼編寫體驗：

   • 語法/程式碼醒目顯示、縮排和行號，方便您閱讀程式碼及辨識結構。
   • 小導覽圖：顯示指令碼程式碼的概略總覽，並協助快速導覽。
   • 按一下即可複製選項，將指令碼程式碼複製到剪貼簿。

   如要開啟編輯器，請前往「Data Transformer Script」(資料轉換器指令碼) 任務設定窗格，然後按一下「Open Data Transformer Script Editor」(開啟資料轉換器指令碼編輯器)。

   根據預設，資料轉換器指令碼編輯器會匯入 functions，這是預先定義的自訂程式庫，內含一組 Jsonnet 函式，用於 Application Integration 中的資料對應。如要瞭解可用的自訂函式，請參閱「資料轉換器函式」。

   下圖顯示 Data Transformer 指令碼編輯器的範例版面配置：

   

   存取整合作業變數

   如要從 Data Transformer Script 編輯器讀取現有整合變數，請使用預先定義的 functions 程式庫中的 extVar 函式。

   注意：Jsonnet 不允許在 ID 名稱中使用連字號 (-)。例如變數名稱或函式名稱。如要在變數名稱中使用連字號 (-)，變數必須以雙引號宣告，如下例所示。

   範例：使用 Data Transformer 指令碼編輯器讀取及更新現有的整合變數。

   Jsonnet 指令碼

   local f = import "functions"; // Import predefined Data Transformer function library
   
   local str1 = f.extVar("inputVar1"); // Access integration input variable "Inputstr1" with value "Hello"
   local str2 = f.extVar("inputVar2"); // Access integration input variable "Inputstr2" with value "World"
   {
     OutputVar: str1 + " " + str2 + "!", // Write to Jsonnet output variable "OutputVar"
     "output-str-var": str1 + " Integration " + str2 + "!", // Write to Jsonnet output variable "output-str-var"
   }

   輸出

   

   Jsonnet 用法參考資料

   Jsonnet 是純粹的功能性語言，程式是由運算式組成。如要瞭解如何形成這些運算式，請參閱「Jsonnet 運算式」。

   錯誤處理策略

   工作錯誤處理策略會指定工作因暫時性錯誤而失敗時，系統應採取的動作。如要瞭解如何使用錯誤處理策略，以及不同類型的錯誤處理策略，請參閱「錯誤處理策略」。

   配額與限制

   如要瞭解 Data Transformer 工作適用的用量限制，請參閱「 用量限制」。

   後續步驟

   • 瞭解以下內容：
     • 所有工作和觸發條件。
     • 資料轉換函式 (預先發布版)
     • 測試及發布整合功能。
     • 處理錯誤。
     • 整合執行記錄。