共用方式為


將 ISE 工作處理序匯出至標準邏輯應用程式

在單一租用戶 Azure Logic Apps 中執行的標準邏輯應用程式工作流程提供許多新功能和改善功能。 例如,您會取得計算隔離、虛擬網路整合和私人端點,以及 App Services 環境裝載、使用 Visual Studio Code 進行本機開發和偵錯、使用無狀態工作流程的低延遲等等。

如果想要標準工作流程的優點,但您的工作流程是在整合服務環境 (ISE) 中執行,您現在可以將 ISE 更換為單一租用戶 Azure Logic Apps。 這種切換適用於大多數需要隔離和網路整合等部分 ISE 功能的案例,有助於降低作業成本。

您現在可以將邏輯應用程式工作流程從 ISE 匯出至標準邏輯應用程式。 使用 Visual Studio Code 和最新的 Azure Logic Apps (標準) 延伸模組,將邏輯應用程式當成具狀態的工作流程,匯出至標準邏輯應用程式專案。 然後,您可以在本機更新、測試及偵錯工作流程,以使其準備好進行重新部署。 您準備好後,就可以直接從 Visual Studio Code 部署或透過您自己的 DevOps 程序部署。

注意

匯出功能不會移轉您的工作流程。 但此工具會複寫成品,例如工作流程定義、連線、整合帳戶成品等等。 您的來源邏輯應用程式資源、工作流程、觸發程序記錄、執行記錄和其他資料都保持不變。

您可以控制匯出程序與移轉旅程。 您可以測試及驗證匯出的工作流程,是否達到目的地環境的滿意度。 您可以選擇何時停用或刪除來源邏輯應用程式。

本文會提供匯出程序的資訊,並示範如何將邏輯應用程式工作流程從 ISE 匯出至 Visual Studio Code 的本機標準邏輯應用程式專案。

已知問題與限制

  • 匯出工具不會匯出任何基礎結構資訊,例如整合帳戶設定。

  • 匯出工具可以使用具有並行設定的觸發程序來匯出邏輯應用程式工作流程。 不過,單一租用戶 Azure Logic Apps 會忽略這些設定。

  • 如果您想要在相同的標準邏輯應用程式專案中匯出邏輯應用程式,則邏輯應用程式必須存在於相同的區域中。

  • 依預設,不會從來源邏輯應用程式工作流程複製連線認證。 您必須在匯出後重新驗證這些連線,才能執行邏輯應用程式工作流程。

  • 根據預設,如果 Azure 連接器有內建連接器版本,則匯出工具會自動將 Azure 連接器轉換成內建連接器。 沒有退出此行為的選項。

  • 如果連線識別碼的格式不正確,則會擲回錯誤。 匯出工作流程之前,請確定連接器的連接識別碼符合下列格式:

    subscriptionId/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Logic/integrationServiceEnvironments/{integration-service-environment-name}/managedApis/{managed-api-name}

可匯出的作業類型

作業 JSON 類型
觸發程序 內建HttpHttpWebhookRecurrencemanual (要求)

受控ApiConnection ApiConnectionNotificationApiConnectionWebhook
動作 內建AppendToArrayVariableAppendToStringVariableComposeDecrementVariableForeachHttpHttpWebhookIfIncrementVariableInitializeVariableJavaScriptCodeJoinParseJsonResponseScopeSelectSetVariableSwitchTableTerminateUntilWait

- 受控ApiConnectionApiConnectionWebhook

必要條件

  • 要部署到同一個訂用帳戶和 Azure 地區 (例如美國東部 2) 的一或多個邏輯應用程式。

  • 對目前在其中部署邏輯應用程式的訂用帳戶的 Azure 讀取者訂用帳戶層級存取權。

  • 若已選取 [部署受控連接器] 選項,則為 Azure 參與者資源群組層級存取權。

  • 檢閱並符合如何使用 Azure Logic Apps (標準) 延伸模組設定 Visual Studio Code 的需求。

注意

請務必為 Visual Studio Code 的 Azure Logic Apps (標準) 延伸模組安裝 2.0.16 版或更高版本。 某些轉換案例需要最新的工作流程設計工具,從這個版本開始可供使用。

將要匯出的邏輯應用程式分組

使用 Azure Logic Apps (標準) 延伸模組,您可以將多個 ISE 裝載的邏輯應用程式工作流程結合成單一標準邏輯應用程式專案。 在單一租用戶 Azure Logic Apps 中,一個標準邏輯應用程式資源可以有多個工作流程。 使用這種方法可以預先驗證工作流程,以便在選取要匯出的邏輯應用程式時,不會遺漏任何相依性。

當您選取要匯出的邏輯應用程式時,請考慮下列建議:

  • 將工作流程共用相同資源的邏輯應用程式分組,例如整合帳戶成品、對應和結構描述,或透過程序鏈使用資源。

  • 如需每個邏輯應用程式的組織和工作流程數目,請檢閱最佳做法和建議

將 ISE 工作流程匯出至本機專案

選取要匯出的邏輯應用程式

  1. 在 Visual Studio Code 中登入 Azure (如果您尚未登入的話)。

  2. 在 Visual Studio Code 活動列上,選取 [Azure] 以開啟 [Azure] 視窗 (Shift + Alt + A)。

    顯示已選取 Azure 圖示之 Visual Studio Code 活動列的螢幕擷取畫面。

  3. 在 [工作區] 區段工具列上,從 [Azure Logic Apps] 功能表中選取 [匯出邏輯應用程式]

    顯示已選取 [Azure] 視窗、[工作區] 區段工具列和 [匯出邏輯應用程式] 的螢幕擷取畫面。

  4. 在 [匯出] 索引標籤開啟後,選取您的 Azure 訂閱和 ISE 執行個體,然後選取 [下一步]

    顯示 [匯出] 索引標籤的螢幕擷取畫面,其中已選取 Azure 訂用帳戶和 ISE 執行個體。

  5. 選取要匯出的邏輯應用程式。 每個選取的邏輯應用程式都會出現在側邊的 [選取的邏輯應用程式] 清單中。 完成時,選取下一步

    提示

    您也可以搜尋邏輯應用程式,並篩選資源群組。

    顯示 [選取要匯出的邏輯應用程式] 區段的螢幕擷取畫面,其中選取了要匯出的邏輯應用程式。

    匯出工具會開始驗證您選取的邏輯應用程式是否符合匯出資格。

檢閱匯出驗證結果

  1. 完成匯出驗證後,請展開每個邏輯應用程式的項目,以檢閱結果。

    • 有錯誤的邏輯應用程式不符合匯出的資格。 您必須從匯出清單中移除這些邏輯應用程式,直到在來源修正這些邏輯應用程式為止。 若要從清單中移除邏輯應用程式,請選取 [上一步]。

      例如,SourceLogicApp2 有錯誤,在修正前將無法匯出:

      顯示 [檢閱匯出狀態] 區段及含錯誤的邏輯應用程式工作流程驗證狀態的螢幕擷取畫面。

    • 無論有無警告,通過驗證的邏輯應用程式仍符合匯出資格。 若要繼續,請選取 [匯出] (如果所有應用程式都驗證成功的話),或者選取 [匯出並顯示警告] (如果應用程式有警告的話)。

      例如,SourceLogicApp3 有警告,但您仍然可以繼續匯出:

      顯示 [檢閱匯出狀態] 區段及含警告的邏輯應用程式工作流程驗證狀態的螢幕擷取畫面。

    下表提供每個驗證圖示和狀態的詳細資訊:

    驗證圖示 驗證狀態
    成功圖示 項目已通過驗證,所以可以繼續匯出,沒有需要解決的問題。
    失敗圖示 項目驗證失敗,所以無法繼續匯出。

    失敗項目的驗證項目會自動展開顯示,並提供驗證失敗的資訊。
    警告圖示 項目通過驗證但顯示警告,使用必要的匯出後解決方案仍可繼續匯出。

    具有警告的項目驗證項目會自動展開顯示,並提供警告和必要匯出後補救的資訊。
  2. 在 [完成匯出] 區段出現之後,針對 [匯出位置],瀏覽並選取本機資料夾供新的標準邏輯應用程式專案使用。

    顯示 [完成匯出] 區段及 [匯出位置] 屬性 (其中選取了本機匯出專案資料夾) 的螢幕擷取畫面。

  3. 如果您的工作流程有您想要部署的「受控] 連線 (建議只用於非生產環境),請選取 [部署受控連線] (會顯示 Azure 訂用帳戶中的現有資源群組)。 選取您要部署受控連線的資源群組。

    顯示 [完成匯出] 區段的螢幕擷取畫面,其中含已選取的本機匯出資料夾,並選取了 [部署受控連線] 及 [目標資源群組]。

  4. 在 [匯出步驟之後] 底下,檢閱任何必要的匯出後步驟,例如:

    顯示 [匯出步驟之後] 區段及必要的匯出後步驟 (如有) 的螢幕擷取畫面。

  5. 根據您的情況,選取 [匯出並完成] 或 [匯出並顯示警告並完成]。

    匯出工具會將專案下載到您選取的資料夾位置,在 Visual Studio Code 中展開專案,並在您選取該選項時部署任何受控連線。

    顯示含匯出進度的 [匯出狀態] 區段的螢幕擷取畫面。

  6. 完成此程序之後,Visual Studio Code 會開啟新的工作區。 您現在可以安全關閉 [匯出] 視窗。

  7. 從標準邏輯應用程式專案中,開啟並檢閱 README.md 檔案,以取得必要的匯出後步驟。

    顯示開啟了含 README.md 檔案的新標準邏輯應用程式專案的螢幕擷取畫面。

匯出後步驟

補救步驟

某些匯出的邏輯應用程式工作流程需要匯出後補救步驟,才能在標準平台上執行。

  1. 從標準邏輯應用程式專案中,開啟 README.md 檔案,然後檢閱已匯出工作流程的補救步驟。 匯出工具會產生包含所有必要匯出後步驟的 README.md 檔案。

  2. 在您對來源邏輯應用程式工作流程進行任何變更之前,請務必測試新的標準邏輯應用程式資源和工作流程。

整合帳戶動作和設定

如果匯出相依於整合帳戶的動作,您即必須使用包含必要成品之整合帳戶的參考連結,手動設定標準邏輯應用程式。 如需詳細資訊,請檢閱將整合帳戶連結至標準邏輯應用程式

如果您有從 ISE 內部建立的標準企業整合帳戶,您可以將該企業整合帳戶匯出至現有的進階企業整合帳戶

Batch 動作和設定

若您匯出使用 Batch 動作及在企業整合帳戶中儲存多重設定的操作,則必須在匯出後以正確值手動設定 Batch 動作。 如需詳細資訊,請參閱在 Azure Logic Apps 中傳送、接收及批次處理訊息

專案資料夾結構

完成匯出程序之後,您的標準邏輯應用程式專案會包含新的資料夾和檔案,以及一般標準邏輯應用程式專案的大部分其他資料夾和檔案。

下表描述由匯出程序新增的這些新資料夾和檔案:

Folder 檔案 說明
.development\deployment LogicAppStandardConnections.parameters.json 用於部署受控連接器的 Azure Resource Manager 範本參數檔案
LogicAppStandardConnections.template.json 用於部署受控連接器的 Azure Resource Manager 範本定義
LogicAppStandardInfrastructure.parameters.json 用於部署標準邏輯應用程式資源的 Azure Resource Manager 範本參數檔案
LogicAppStandardInfrastructure.template.json 用於部署標準邏輯應用程式資源的 Azure Resource Manager 範本定義
.logs\export exportReport.json 匯出報表摘要原始檔案,其包含匯出後補救所需的全部步驟
exportValidation.json 驗證報表原始檔案,包含每個已匯出邏輯應用程式的驗證結果。
README.md 具有匯出結果摘要的 Markdown 檔案,包括已建立的邏輯應用程式和所有必要的後續步驟。

下一步