上傳及下載整合功能

您可以將整合項目下載為 JSON 檔案,並儲存在本機系統。因此,整個整合項目會以檔案形式提供,您可直接在其他整合專案中上傳檔案,不必進行任何修改。上傳整合項目會在上傳檔案的專案中,建立整合項目的新版本。

將整個整合項目儲存為檔案格式,可享有下列優點:
  • 您可以輕鬆地將整合項目從一個專案複製到另一個專案。
  • 您可以透過程式輔助方式更新整合檔案,進行重複性變更,例如重新命名工作或動態修改變數名稱。

下載整合項目

如要下載整合項目,請選取下列其中一個選項:

控制台

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

    前往 Application Integration

  2. 按一下左側導覽選單中的「整合」,開啟「整合」頁面。
  3. 選取現有的整合服務。系統會在整合編輯器中開啟整合服務。
  4. 按一下「版本」下拉式選單,然後選取要下載的版本。
  5. 在設計工具工具列中,按一下「動作」選單 ,然後選取「下載」

    INTEGRATION_NAME.json 檔案會自動儲存到網路瀏覽器的預設下載資料夾。

API

如要下載整合項目,請對下列 API 發出 GET 要求: GET https://integrations.googleapis.com/v1/projects/*/locations/*/integrations/*/versions/*:download
https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION:download

以下範例說明如何下載特定版本的整合:

curl -v -s \
-H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" \
-H "X-GFE-SSL: yes" \
-X GET "https://integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/test-integration/versions/0e90d453-5fcf-4aae-b164-2e8344d1ac11:download"

詳情請參閱「projects.locations.integrations.versions.download」。

上傳整合項目

上傳整合項目時,系統會在檔案上傳的專案中建立新的整合版本。舉例來說,如果您有名為 IP-Test 的整合項目 (版本 5),並在 IP-Test 中上傳整合檔案,系統就會為該整合項目建立新版本 (版本 6)。

如果沒有現成可上傳檔案的整合服務,請先建立新的整合服務,然後再上傳檔案。在這種情況下,您建立的新整合項目會是版本 1,而上傳的整合項目會是版本 2。

如要上傳現有的整合服務,請選取下列其中一個選項:

控制台

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

    前往 Application Integration

  2. 按一下左側導覽選單中的「整合」,開啟「整合」頁面。
  3. 選取現有的整合,或按一下「建立整合」來建立新的整合。

    如要建立新的整合項目:

    1. 在「建立整合」對話方塊中輸入名稱和說明。
    2. 選取整合作業的區域。
    3. 點選「建立」

    系統會在整合編輯器中開啟整合服務。

  4. 在設計工具工具列中,按一下 (「動作」選單),然後選取「上傳」
  5. 在檔案瀏覽器對話方塊中,選取要上傳的檔案,然後按一下「開啟」

    系統會使用上傳的檔案建立新的整合版本。

API

如要上傳整合項目,請對下列 API 發出 POST 要求:
  https://integrations.googleapis.com/v1/projects/$YOUR_GOOGLE_PROJECT_ID/locations/$PROJECT_LOCATION/integrations $INTEGRATION_NAME/versions/$INTEGRATION_VERSION}:upload
  

以下範例說明如何上傳整合項目:

  curl -v -s -H "Content-Type: application/json"  -H "Authorization: Bearer $TOKEN"  \
  -X POST -d '{"content": 
    "{\"name\":\"projects/450954726404/locations/us-east1/integrations/test-workflow/versions/0e90d453-5fcf-4aae-b164-2e8344d1ac11\",
    \"origin\":\"UI\",
    \"snapshotNumber\":\"3\",
    \"updateTime\":\"2022-01-06T04:26:58.137Z\",
    \"lockHolder\":\"abc@test.com\",
    \"createTime\":\"2022-01-06T04:26:42.734Z\",
    \"lastModifierEmail\":\"abc@test.com\",
    \"state\":\"DRAFT\",
    \"triggerConfigs\":[{\"label\":\"API Trigger\",\"startTasks\":[{\"taskId\":\"1\"}],
    \"properties\":{\"Trigger name\":\"rj-test-workflow_API_1\"},\"triggerType\":\"API\",\"triggerNumber\":\"1\",\"triggerId\":\"api_trigger/rj-test-workflow_API_1\"}],\"taskConfigs\":[{\"task\":\"EmailTask\",\"taskId\":\"1\",\"taskExecutionStrategy\":\"WHEN_ALL_SUCCEED\",\"displayName\":\"Send Email\"}]}"}' 
    \https://integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/test-integration/versions:upload
  

詳情請參閱「projects.locations.integrations.versions.upload」。

後續步驟