你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
适用于:Azure 逻辑应用(标准)
注释
此预览版功能受 Microsoft Azure 预览版补充使用条款的约束。
当复杂源项目难以转换为Azure 逻辑应用(标准)中的可部署资源时,集成项目的迁移过程可能会停滞。 在转换阶段,Visual Studio Code中的Azure 逻辑应用迁移代理通过在迁移计划中运行任务计划来解决此问题。 此过程将创建完整的工件,其中包括可部署的标准化工作流定义、连接配置和支持文件。
本文介绍如何 Azure 逻辑应用 迁移代理创建转换任务,这些任务将源集成工件映射到可部署的标准逻辑应用项目资源,以及代理如何运行这些任务以生成可部署和运行的项目工件。
转换阶段操作
在Azure 逻辑应用迁移代理中,完成 Plan 逻辑应用设计活动后,创建转换任务活动可用。 选择 创建转换任务活动时,GitHub Copilot 代理会创建生成目标逻辑应用项目工件所需的转换任务。
查看这些任务并选择 执行转换任务活动后,@migration-converter GitHub Copilot 智能体 处理每个任务计划并执行以下操作。
1:生成逻辑应用项目工件
代理 @migration-converter 将生成以下部分中介绍的输出。
项目基架结构
代理 @migration-converter 生成标准逻辑应用项目。 此项目包含每个逻辑流组一个标准工作流定义文件、连接配置文件、主机配置文件和其他支持文件:
<project-root>/
├── host.json # Host configuration for Standard logic app
├── local.settings.json # Local development settings
├── connections.json # Connector configurations
├── <workflow-name>/
│ └── workflow.json # Workflow definition file per flow group
├── <workflow-name-2>/
│ └── workflow.json # Workflow definition file per flow group
└── lib/
└── custom/
└── <function-name>.cs # .NET local function, if necessary
以下示例展示了 @migration-converter 代理如何创建项目的基架结构和文件:
工作流定义文件
对于每个逻辑流组, @migration-converter 代理将生成包含以下 workflow.json 工作流操作的文件:
| Operation | Description |
|---|---|
| Trigger | 每个工作流始终以单个触发器(即工作流的入口点)开头。 代理从源中的接收端口或侦听器映射此触发器。 |
| Action | 每个工作流都有一个或多个执行任务的操作。 代理从源中的业务流程形状、流处理器或活动映射这些操作。 |
| 条件或循环 | 执行控制流逻辑的操作,例如 If、 For each 和 Until。 代理将源中的决策模型和循环结构翻译成这些操作。 |
| 作用域 | 具有可用于设置错误处理的 run-after 配置的操作。 |
连接配置
代理 @migration-converter 会生成一个 connections.json 文件,该文件将连接器操作所需的配置存储在工作流中。
下表描述了高级连接器组:
| 连接器组 | 描述和示例 |
|---|---|
| 内置 | 与 Azure 逻辑应用(标准版)运行时在同一进程中运行的操作连接器。 例如,这些连接器包括 Request、File System、HTTP、 Azure Blob 存储、服务总线、SQL Server、AS2、EDIFACT、 X12 等。 有关详细信息,请参阅: - Azure 逻辑应用 中的内置连接器 - Azure 逻辑应用(标准版)内置连接器参考 |
| 共享 或“托管” | 在多租户 Azure 中运行的操作连接器。 例如, 这些连接器包括 Salesforce、SAP、Office 365 Outlook、Power BI、SharePoint 等。 Azure 逻辑应用支持 1,400 多个共享连接器,适用于云、本地和混合环境中的 Microsoft、Azure 和其他平台。 有关详细信息,请参阅 Azure 逻辑应用 中的托管连接器或共享连接器。 |
| 自定义 | 其他发布者或您的组织为自定义 API 或其他服务创建的连接器。 有关详细信息,请参阅 为标准工作流创建自定义内置连接器。 |
有关详细信息,请参阅Azure 逻辑应用 中的连接器是什么。
.NET本地函数
如果源平台组件在 Azure 逻辑应用(标准)中没有等效的直接连接器,则 @migration-converter 代理将生成.NET本地函数。 此行为通常在以下情况下发生:
- 自定义数据转换逻辑
- 复杂的分析或验证规则
- 通过自定义协议调用本地系统
- 业务规则评估
2.检查输出完整性和质量
代理程序 @migration-converter 生成完整的、可直接运行的、可部署的项目。 若要确认所有生成的代码都完全正常运行且已完成,代理使用 no-stubs-code-generation 技能来确保所有生成的代码都完整、功能完整,并且不存在存根实现、占位符代码或 TODO 注释。
代理使用以下标准来验证每个生成的文件是否满足以下标准:
| 标准 | Description |
|---|---|
| 无存根或占位符代码 | 所有生成的代码都已完成且功能正常。 |
| 有效的 JSON | 所有 workflow.json 和 connections.json 文件都有效且符合Azure 逻辑应用架构。 |
| 正确的引用 | 工作流操作引用正确的连接和参数。 |
| 错误处理 | 工作流包括适当的错误处理范围。 |
若要为本地运行工作流进行测试的验证阶段准备生成的输出,请确保手动检查工作流定义、连接以及任何生成的.NET本地函数的不准确情况。
Important
最佳做法是,在使用这些输出之前,请始终查看任何 AI 生成的输出。 此类输出可能包含不正确的信息。
有关详细信息,请参阅 Quickstart:使用 Azure 逻辑应用 迁移代理迁移集成项目。