將取用工作流程匯出至標準邏輯應用程式

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

如果您想要標準工作流程的優點,但您的工作流程在多租用戶 Azure Logic Apps 中執行,您現在可以將取用工作流程移至單一租用戶 Azure Logic Apps 中。 在需要某些標準功能 (例如隔離和網路整合、較低的延遲或較佳的成本可預測性) 的情況中,這種切換很有意義。

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

注意

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

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

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

已知問題與限制

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

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

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

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

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

可匯出的作業類型

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

受控ApiConnectionApiConnectionNotificationApiConnectionWebhook
動作 內建AppendToArrayVariableAppendToStringVariableComposeDecrementVariableForeachHttpHttpWebhookIfIncrementVariableInitializeVariableJavaScriptCodeJoinParseJsonResponseScopeSelectSetVariableSwitchTableTerminateUntilWait

- 受控ApiConnectionApiConnectionWebhook

必要條件

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

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

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

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

注意

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

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

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

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

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

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

將取用工作流程匯出成本機專案

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

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

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

    Screenshot showing Visual Studio Code Activity Bar with Azure icon selected.

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

    Screenshot showing Azure window, Workspace section toolbar, and Export Logic App selected.

  4. 在 [匯出] 索引標籤開啟後,選取您的 Azure 訂用帳戶和地區,然後選取 [下一步]。

    Screenshot showing Export tab with Azure subscription and region selected.

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

    提示

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

    Screenshot showing 'Select logic apps to export' section with logic apps selected for export.

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

檢閱匯出驗證結果

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

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

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

      Screenshot showing 'Review export status' section and validation status for logic app workflow with error.

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

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

      Screenshot showing 'Review export status' section and validation status for logic app workflow with warning.

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

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

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

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

    Screenshot showing 'Finish export' section and 'Export location' property with selected local export project folder.

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

    Screenshot showing 'Finish export' section with selected local export folder, 'Deploy managed connections' selected, and target resource group selected.

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

    Screenshot showing 'After export steps' section and required post-export steps, if any.

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

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

    Screenshot showing the 'Export status' section with export progress.

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

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

    Screenshot showing a new Standard logic app project with README.md file opened.

匯出後步驟

補救步驟

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

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

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

整合帳戶動作和設定

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

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 檔案,其包括已建立的邏輯應用程式和所有必要的後續步驟

下一步