移轉至 Azure Logic Apps 第 3 階段 - 轉換:產生工作流程

適用於:Azure Logic Apps (標準)

當複雜的原始碼產物難以在 Azure Logic Apps(標準版)中轉換為可部署資源時,整合專案的遷移過程可能會停滯。 在轉換階段,Visual Studio Code 中的 Azure Logic Apps 遷移代理程式會利用核准的規劃結果來建立並執行有序的轉換任務計畫。 此過程產生包含標準工作流程定義、連線設定及支援檔案的產物。

本文說明 Azure Logic Apps 遷移代理程式如何建立轉換任務,將原始整合產物映射到現成部署的標準邏輯應用專案資源,並執行這些任務以產生現成部署與執行的專案產物。

轉換階段動作

在 Azure Logic Apps 遷移代理中,完成 Plan Logic 應用程式設計活動後,Create Conversion Tasks 活動就會開放。 當你選擇 Create Conversion Tasks 活動時,@migration-converter GitHub Copilot Agent 會建立產生目標邏輯應用程式專案工件所需的轉換任務。

當你檢視這些任務並選擇執行轉換任務活動後,@migration-converterGitHub 的 Copilot Agent 會依相依順序處理所需的任務。 可選的 雲端部署與測試 任務不包含在此操作中,且需另行審核。

1:產生邏輯應用程式專案工件

@migration-converter代理人會產生以下章節所述的輸出。

專案支架結構

@migration-converter代理程式首先在資料夾下方out建立一個 Visual Studio Code 工作區和一個標準邏輯應用程式專案。 後續轉換任務會在核准計畫需要時,新增一個或多個工作流程定義、連接、產物及 .NET 函式專案:

out/
└── <workspace-name>/
    ├── <workspace-name>.code-workspace
    ├── <logic-app-name>/
    │   ├── host.json
    │   ├── local.settings.json
    │   ├── connections.json                 # Added when connectors are configured
    │   ├── <workflow-name>/
    │   │   └── workflow.json
    │   ├── Artifacts/                       # Added only when required
    │   └── lib/custom/                      # Added when local functions are built
    └── Functions/                           # Added only when local functions are required

以下範例展示了 @migration-converter 代理建立專案支架結構與檔案的過程:

截圖顯示轉換階段產生 Logic Apps Standard 工作流程檔案。

工作流程定義檔案

對於核准計畫中的每個工作流程, @migration-converter 代理會 workflow.json 產生一個包含以下工作流程操作的檔案:

Operation Description
Trigger 每個工作流程總是從一個觸發器開始,這是工作流程的入口點。 代理會將此觸發器從來源的接收埠或監聽器中映射出來。
Action 每個工作流程都有一個或多個執行任務的動作。 Agent 會從來源中的協調流程圖形、流程處理器或活動,對應這些動作。
條件或迴圈 執行控制流程邏輯的動作,例如 If、 For each 和 Until。 Agent 會從來源中的決策圖形和迴圈翻譯這些動作。
範圍 具有 run-after 設定的動作,你可以用來設定錯誤處理。

連線組態

@migration-converter代理程式會產生一個connections.json檔案,儲存你工作流程中連接器操作所需的設定。

下表描述了高階連接器群組:

連接器群組 描述與範例
內建 連接器含有與 Azure Logic Apps (Standard) 執行階段在相同處理序中執行的作業。 例如,這些連接器包括 Request、File System、HTTP、Azure Blob 儲存體、服務匯流排、SQL Server、AS2、EDIFACT, X12,以及其他。

如需詳細資訊,請參閱:

- Azure Logic Apps 中的內建連接器
- Azure Logic Apps(標準)內建連接器參考
共享 或「管理」 連接器含有在多租用戶 Azure 中執行的作業。 例如,這些連接器包括 Salesforce、SAP、Office 365 Outlook、Power BI、SharePoint 等。 Azure Logic Apps 支援 1,400+ 共享連接器,適用於雲端、本地部署及混合環境中的 Microsoft、Azure 及其他平台。

欲了解更多資訊,請參閱Azure Logic Apps
中的管理或共用連接器。
自定義 來自其他出版商或你組織的連結器,是你為自訂 API 或其他服務所建立的。 欲了解更多資訊,請參閱 「為標準工作流程建立自訂內建連接器」。

欲了解更多資訊,請參考Azure Logic Apps中的連接器是什麼。

.NET 局部函式

如果你的原始平台元件在 Azure Logic Apps(標準@migration-converter版)中沒有直接連接器對應,代理程式可以建立一個獨立的 .NET Functions 專案,並將本地函式建置到該 Logic App 專案的lib/custom資料夾中。 這種行為常見於以下情況:

  • 自訂資料轉換邏輯
  • 複雜的解析或驗證規則
  • 透過自訂協定呼叫本地系統
  • 商業規則評估

2. 檢查輸出完整性與品質

@migration-converter代理使用no-stubs-code-generation此技能,要求產生的輸出不得包含存根實作、佔位程式碼或TODO註解。 這項要求並不取代手動審查或執行時測試。

此技能對產生的檔案套用以下標準:

標準 Description
沒有存根或佔位程式碼 所有產生的程式碼都是完整且可運作的。
有效的 JSON 所有 workflow.json 和 connections.json 檔案皆有效且符合 Azure Logic Apps 架構。
正確的參考資料 工作流程動作會參考正確的連線與參數。
錯誤處理 工作流程包含適當的錯誤處理範圍。

為了準備產生的輸出,供本地執行工作流程測試階段使用,務必手動檢查工作流程定義、連線及任何產生的 .NET 本地函式是否有不準確。

這很重要

作為最佳實務,使用任何 AI 產生的輸出前,務必先檢視它們。 這些輸出可能包含錯誤資訊。

欲了解更多資訊,請參閱 快速入門:使用 Azure Logic Apps 遷移代理程式 遷移整合專案。

下一步