查看 Application Integration 支援的連接器。

資料對應

企業資料可能位於不同的來源和格式，因此難以整合至統一的資料模型或資料管道。資料對應是指從多個來源擷取及標準化資料的程序，目的是在目的地建立資料與相關目標資料欄位之間的關係。在整合中使用資料對應的範例包括：

• 從 JSON 等複雜資料結構中擷取欄位。
• 將資料來源對應至目標結構定義。
• 套用轉換函式來轉換資料。
• 產生輸出值，並將這些值儲存/使用做為整合變數。

您可以使用 Application Integration 中的任務執行資料對應：

• 資料轉換器工作 (預先發布版)
• 資料對應工作

資料轉換器工作

「資料轉換器」工作是 Application Integration 中提供的模板引擎式資料對應功能。這項工具會使用 Google 的 Jsonnet 設定語言建立及編輯 Jsonnet 範本，定義整合作業中指定來源和目標整合變數的對應關係。資料轉換器工作也提供視覺化對應畫布 (圖表模式)，可在整合作業中執行資料指派和對應作業。

圖表模式

圖表模式提供視覺化畫布，其中包含下列整合元素：

• 輸入內容：顯示資料轉換作業的輸入變數。來源可以是變數或常數。如要指派輸入變數，您可以選取現有變數或建立新變數。只要按一下輸入元素，然後將線條拖曳至相關輸出變數，即可將這些變數對應至相關輸出變數。
• 輸出內容：顯示資料轉換的輸出變數。目標變數可用於後續輸入列的對應。如要指派輸出變數，您可以選取現有變數或建立新變數。
• Canvas。這個畫布可用於視覺化對應輸入和輸出變數。

如要進一步瞭解應用程式整合中的變數，請參閱「在應用程式整合中使用變數」。

下圖顯示資料轉換器圖表模式的範例版面配置：

轉換作業

您可以使用預先定義的轉換作業，在整合作業中轉換及標準化對應資料。轉換作業可以有一個或多個輸入參數，每個參數可儲存常值或變數。您可以為單一輸入來源使用多個對應函式，形成對應轉換運算式。

輸入來源的最終資料類型取決於對應資料對應輸入列中定義的轉換運算式傳回類型。

指令碼模式

您可以使用資料轉換器指令碼編輯器和支援的資料轉換器函式，編寫自訂資料對應邏輯、執行變數指派，以及新增或修改整合變數。

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

如要瞭解如何新增及設定資料轉換器工作，請參閱「資料轉換器工作」。

資料對應工作

資料對應工作是 Application Integration 中的無程式碼/低程式碼功能，提供視覺化對應畫布 (資料對應編輯器)，可在整合作業中執行資料指派和對應作業。此外，您也可以使用支援的對應函式，進一步將資料轉換為有意義的變數/格式，以便在整合流程中的其他工作或觸發事件中存取資料。

您可以使用資料對應工作執行下列操作：

• 使用資料對應編輯器，為單一或巢狀變數視覺化及定義變數對應。
• 將變數從一種資料類型轉換為另一種資料類型。資料對應工作可讓您套用多個對應函式 (包括巢狀函式)，以便轉換變數資料。

如要瞭解如何新增及設定資料對應工作，請參閱資料對應工作。

資料對應編輯器和版面配置

資料對應編輯器提供視覺化畫布，其中包含下列整合元素：

• 「Variables」窗格：顯示整合項目可用的不同類型變數：
  • 輸入內容：整合作業的輸入變數。
  • 輸出內容。整合作業的輸出變數。
  • 本機變數。整合範圍內的變數。

  如果沒有列出任何變數，請按一下「新增 +」來設定新變數。

  按一下 chevron_right (展開)，展開每個變數，查看該變數的可用子欄位。 如要在可用變數清單中搜尋任何變數或其子欄位，請按一下 search「搜尋變數」。

  如要進一步瞭解應用程式整合中的變數，請參閱「變數」。

• 輸入資料欄：顯示輸入對應資料列，其中包含資料對應輸入來源。來源可以是常值、基本函式或輸入變數，並搭配對應函式。按一下輸入對應列中的「變數或值」，即可新增來源。
• 輸出資料欄：顯示輸出對應資料列，其中包含相應輸入對應資料列的相關目標變數。目標變數可用於後續輸入列的對應。如要指派輸出變數，您可以建立新變數，或直接從「變數」欄拖曳現有的輸出變數。

下圖為資料對應編輯器的範例版面配置：

對應函式

「資料對應」工作提供各種預先定義的對應函式，可轉換及標準化整合作業中的對應資料。對應函式可包含一或多個輸入參數，其中每個參數可進一步儲存常值、變數或已套用對應函式的基礎函式。您可以為單一輸入來源使用多個對應函式，形成對應轉換運算式。

輸入來源的最終資料類型取決於對應資料對應輸入列中定義的轉換運算式傳回類型。如果輸入來源的傳回類型與對應輸出對應目標變數的傳回類型不符，資料對應編輯器會在對應資料對應輸入列下方顯示驗證錯誤 error 。

轉換運算式

轉換運算式是幾個對應函式的組合，這些函式會以系列或巢狀結構鏈結在一起。您可以使用資料對應編輯器，輕鬆在定義的轉換運算式中插入、修改或移除函式或函式參數。如果定義的轉換運算式無效，資料對應編輯器會在導致運算式錯誤的函式或函式參數旁邊顯示驗證錯誤 error 。如要查看完整的錯誤訊息，請將游標懸停在驗證錯誤 error 圖示上。

下圖顯示在資料對應編輯器中，有驗證錯誤的對應範例：

如要進一步瞭解如何在資料對應工作中設定對應項目，請參閱「新增對應項目」。

如要瞭解 Application Integration 支援的預先定義對應函式，請參閱「支援的資料類型和對應函式」。

對應順序

資料對應編輯器中指定的對應項目會依序從上到下執行。舉例來說，在前述圖片中，Num1 會對應至第一列的 Num1ToInt，讓 Num1ToInt 可用於後續列的對應。

配額與限制

如要進一步瞭解配額和限制，請參閱「配額與限制」。

後續步驟

• 新增並設定資料轉換器任務 (預先發布版)
• 瞭解 Data Transformer 函式 (預先發布版)
• 新增並設定資料對應工作