查看 Application Integration 支援的連接器。

變數

變數是整合元素，可保存資料並在整合作業的任務、觸發條件和邊緣之間傳輸資料。

• 變數可在設計階段靜態定義，或在執行階段動態傳遞至整合服務。
• 變數可以參照整合中的其他變數。
• 變數可供所有工作全域存取，或僅供特定工作本機存取。

變數類型

Application Integration 支援四種變數：

• 整合變數：追蹤整個整合執行過程中的資料。
• 工作變數：追蹤單一工作期間的資料。
• 設定變數：儲存整合的設定資料。
• 系統變數：儲存整合的設定資料。

整合變數

整合變數與程式設計語言中使用的變數類似。在整合作業執行期間，可以讀取及寫入變數中的資料。

整合變數可用於下列用途：

• 做為整合作業的輸入內容 (輸入變數)。
• 以整合作業的輸出內容 (輸出變數) 形式傳回。
• 用於在執行整合作業期間保留暫時狀態。
注意：上述變數角色可以同時存在。任何指定變數都可以是輸入變數、輸出變數、兩者皆是或兩者皆非。

變數的值不一定要在整合中靜態定義。您可以透過觸發條件，將變數值傳遞至整合服務。不過，如果變數是在整合中靜態定義，且相同變數是透過觸發程序動態提供，動態值指派作業就會覆寫靜態指派作業。

支援的資料類型

整合變數支援下列資料類型：

• 字串和字串陣列
• 整數和整數陣列
• Double 和 Double 陣列
• 布林值和布林值陣列
• JSON

工作變數

工作變數是工作的預先定義自動產生變數。如果工作有輸出內容，所有這類輸出內容都會顯示在工作變數中。您無法刪除或編輯工作變數。 舉例來說，如果是「呼叫 REST 端點」工作，回應主體會儲存在 responseBody 變數中。

設定變數

預先發布版

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

設定變數可讓您將整合作業的設定外部化。您可以使用設定變數，根據開發環境 (QA、預先發布或實際工作環境) 設定整合的各個層面，例如連接器詳細資料、驗證詳細資料或網址端點。將整合項目上傳至新環境前，您不必手動更新整合項目。發布整合時，您可以使用 Application Integration 輸入設定變數的值。

如要查看及編輯整合中定義的設定變數，請按一下「變數」窗格中的「變數_新增」 整合設定變數。如要瞭解如何建立及使用設定變數，請參閱「為整合項目建構 CICD」教學課程。

系統變數

建立整合項目時，系統會自動產生系統變數。您可以在整合工作中使用這些變數，並用於錯誤處理。整合項目包含下列系統產生的變數：

• ErrorInfo：執行失敗時，您可以使用 ErrorInfo 變數存取錯誤詳細資料：

  {
    "ErrorInfo": {
    "message": String,
    "code": Number
    }
  }
  

  目前，您可以建立名為 ErrorMessage 的整合變數，存取錯誤訊息。不過，我們建議您使用系統產生的 ErrorInfo.message 變數存取錯誤訊息。

• ExecutionMode：根據觸發條件的執行模式。有效值為 SYNC 和 ASYNC。
• ExecutionId：整合的執行 ID。
• IntegrationName：整合名稱。
• Region：整合的區域。
• ProjectId：包含整合項目的專案 ID。

查看變數

您可以使用「變數」窗格，在整合服務中建立、編輯、查看、複製及刪除變數。「Variables」窗格也會顯示整合中變數參照的總數。

如要查看「變數」窗格，請按一下設計工具導覽列中的 (切換面板)。

下圖顯示「變數」窗格的範例版面配置：

查看及編輯設定變數

預先發布版

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

如要查看整合中定義的設定變數，請按一下「變數」窗格中的 variable_add 「整合設定變數」。系統隨即會顯示「設定變數」窗格，其中會列出整合中定義的所有設定變數。只要按一下「Value」欄位，即可編輯設定變數的值。

下圖顯示「設定變數」窗格的版面配置範例：

建立變數

如要建立變數，請執行下列步驟：

1. 在整合服務編輯器的導覽列中，按一下 (切換面板) 叫出「變數」窗格。
2. 點選「+建立」。
3. 在「建立變數」窗格中執行下列操作：
   1. 名稱：輸入變數名稱。
   2. 變數類型：選擇變數類型。

   資料類型	說明
   無	整合中的本機變數。
   整合的設定變數	整合中的設定變數。
   整合輸入	執行期間，系統會將變數做為輸入內容提供給執行的觸發條件。
   整合輸出內容	執行完畢時，變數的最終值應輸出至整合的呼叫端。
   整合的輸入和輸出	執行時，系統會將變數做為輸入內容提供給執行的觸發程序，而最終值會輸出至整合的呼叫端。

   3. 資料類型：選擇變數的資料類型。您可以透過變數名稱旁的圖示，識別變數的資料類型。

      資料類型	範例
      字串	Alex
      整數	30
      Double	30.5
      Boolean	true
      JSON	{ "employee":{"name":"Alex", "age":30, "city":"Mountain View"} }
      字串陣列	Alex, Kai, Raha
      整數陣列	30, 25, 22
      雙陣列	30.5, 25.34, 22.134
      布林陣列	true, false, false

      如要瞭解支援的資料類型，請參閱「支援的資料類型」。

   4. 預設值：輸入變數的預設值。此為選填欄位。
   5. 結構定義：選取變數的 JSON 結構定義。
      • 從 JSON 酬載示例推斷：從 JSON 酬載示例產生 JSON 結構定義。系統會在產生結構定義後捨棄酬載示例，只儲存產生的結構定義。
      • 輸入 JSON 結構定義：手動輸入整個 JSON 結構定義。
      • 從預設值推斷：使用提供的預設值產生 JSON 結構定義。
      • 無：沒有 JSON 結構定義。
      注意：這個欄位只會顯示 JSON 資料型別變數。
   6. 在記錄檔中遮蓋變數 (預覽版)：選取這個選項，即可在整合執行記錄檔中遮蓋變數。如要為變數啟用遮蓋功能，您必須為整合作業和地區啟用遮蓋變數。如要瞭解如何為整合服務和區域啟用遮蓋功能，請參閱「編輯整合服務」和「編輯區域」。

      如要瞭解如何遮蓋資料，請參閱「遮蓋記錄中的機密資料」。

4. 點選「建立」。

在整合中使用的變數

執行整合作業時，系統會將執行階段資料當做變數傳遞，這些變數是為整合作業或工作宣告。執行作業開始後，輸入資料會轉換為名為「事件」的記憶體內物件。

建立 Event 物件後，系統會使用整合定義建構工作記憶體內圖表。 系統會根據您的設定，將傳入的變數值傳遞至工作。整合流程執行時，工作會讀取資料並寫回 Event 物件，供後續工作使用，或做為整合流程的輸出資料。

變數參照

整合中的工作、觸發條件和邊緣會使用變數參照讀取及寫入變數。 變數參照的格式為 $paramKey$，其中 paramKey 是變數名稱。舉例來說，邊緣條件可能如下所示：

NOT ($isNameUnique$ = false OR $numAccounts$ > 1)

在本例中，isNameUnique 是 boolean 資料類型的變數，numAccounts 則是 integer 資料類型的參數。

配額與限制

如要瞭解配額和限制，請參閱配額和限制。

後續步驟

• 瞭解如何為整合項目建構 CI/CD。
• 瞭解如何遮蓋記錄中的機密資料。
• 新增並設定「資料對應」工作