分享方式:


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

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

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

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

注意

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

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

本文提供匯出程序的相關資訊,並說明如何將邏輯應用程式工作流程從取用工作流程匯出至 Visual Studio Code 中的本機標準邏輯應用程式專案。

已知問題與限制

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

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

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

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

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

可匯出的作業類型

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

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

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

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

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

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

  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 訂用帳戶和地區,然後選取 [下一步]。

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

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

    提示

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

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

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

  6. 在 [進階選項] 區段中,您可以選取下列選項:

    選項 預設 描述
    產生基礎結構範本 另一 匯出程序會建立基礎結構範本,其中包含一個標準邏輯應用程式的 ARM 範本,以及一個每個所匯出 Azure 受控連線的 ARM 範本。
    複製連線認證 關閉 匯出程序在部署過程中,會將認證從原始的 Azure 受控連線複製到在 Azure 中建立的新 Azure 受控連線。 僅適用於匯出連線維持 Azure 受控連線的情況,例如 Office 365 Outlook 連線。

    重要事項:請小心使用此選項。 根據預設,兩個新的連線會指向相同的資源,這可能會建立競爭條件。
    預設為整合帳戶做為轉換和驗證的來源 關閉 在本機或在整合帳戶中參考對應和結構描述檔案。 如果已啟用,請勿將對應和結構描述複製到目的地專案。 您必須在邏輯應用程式的應用程式設定中新增整合帳戶的參考。 根據預設,[轉換 XML] 和 [XML 驗證] 動作會使用整合帳戶做為來源。
    將自訂連接器匯出為 API 管理動作 關閉 如果啟用,自訂連接器會建立為 API 管理動作,而不是 HTTP 動作,因此您可以將自訂動作實作為 API 管理中的 API 作業。 如需詳細資訊,請參閱連線至客戶服務或 API 的 Azure Logic Apps 標準選項
  7. 完成時,選取下一步

檢閱匯出驗證結果

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

整合帳戶動作和設定

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

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

下一步