将 Power Automate 流添加到代码应用（预览版）

本文介绍如何使用 npm CLI 从 Power Apps 代码应用中发现、添加、调用和删除 Power Automate 云流。

先决条件

• 初始化的 Power Apps 应用程序代码。 请参阅 快速入门：使用 npm CLI 创建代码应用。
• 一个可 识别解决方案 的 Power Automate 流，是具有 PowerApps 触发器类型的即时流。 如果流尚不在解决方案中，请参阅 向解决方案添加现有流。
• @microsoft/power-apps npm 包版本 1.1.1 或更高版本。

步骤 1：列出可用流

运行以下命令，列出当前环境中的所有解决方案感知流：

npx power-apps list-flows

该命令输出可用流的表：

Name                    Status   Modified On   Flow ID
──────────────────────────────────────────────────────────────────────────────
Approval Workflow       Started  2026-01-15    a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1
Send Notification       Started  2026-02-01    b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2

Total flows: 2

若要按名称筛选结果，请使用 --search 以下选项：

npx power-apps list-flows --search approval

复制要添加的流的 流 ID 值。

第2步：在您的代码应用中添加流程

运行以下命令，将 <flow-id> 替换为上一步中的值：

npx power-apps add-flow --flow-id <flow-id>

示例：

npx power-apps add-flow --flow-id a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1

命令成功后，CLI 确认添加了流：

Flow added successfully.

什么是add-flow的功能

该命令会下载流的 OpenAPI 定义，在项目中生成强类型 TypeScript 文件，并使用流的连接引用更新power.config.json。

生成的文件

运行 add-flow后，CLI 会在项目中创建以下文件（文件名派生自流的显示名称）：

src/
  services/
    ApprovalWorkflowService.ts   ← generated service class with typed methods
  models/
    ApprovalWorkflowModel.ts     ← generated TypeScript types for inputs/outputs
schemas/
  logicflows/
    ApprovalWorkflow.Schema.json ← flow's OpenAPI schema (do not edit manually)

以下条目也添加到 power.config.json：

"<uuid>": {
  "id": "/providers/microsoft.powerapps/apis/shared_logicflows",
  "displayName": "Logic flows",
  "dataSources": ["ApprovalWorkflow"],
  "workflowDetails": {
    "workflowEntityId": "<dataverse-entity-guid>",
    "workflowDisplayName": "Approval Workflow",
    "workflowName": "<flow-id>",
    "dependencies": {
      "shared_office365": "<dependency-uuid>"
    }
  }
}

步骤 3：从应用调用流

生成的服务类公开静态 Run 方法。 确切的签名取决于流的触发器是否定义输入参数。

包含输入参数的流

import { ApprovalWorkflowService } from './services/ApprovalWorkflowService';

const result = await ApprovalWorkflowService.Run({
  requester: 'Alex',
  amount: 1500,
});

if (result.success) {
  console.log('Flow triggered. Response:', result.data);
} else {
  console.error('Flow failed:', result.error);
}

没有输入参数的流

import { SendNotificationService } from './services/SendNotificationService';

const result = await SendNotificationService.Run();

if (result.success) {
  console.log('Flow triggered.');
}

该 result 对象具有以下形状：

更新流程

如果流的定义发生更改（例如，其作者添加了一个新参数或更新连接引用）则使用相同的流 ID 重新运行 add-flow 以选取最新定义并重新生成服务文件：

npx power-apps add-flow --flow-id a1b2c3d4-e5f6-7890-abcd-ef1234567890

该命令通过 workflowEntityId 匹配流并在 power.config.json 中重用现有的 UUID，因此不需要进行手动清理。

删除流

若要从代码应用中删除流，请使用 remove-flow。 可以通过数据源名称（在 power.config.json 中出现）或原始流 ID 来标识流。

按数据源名称：

npx power-apps remove-flow --flow-name ApprovalWorkflow

按流 ID：

npx power-apps remove-flow --flow-id a1b2c3d4-e5f6-7890-abcd-ef1234567890

命令：

• 从power.config.json中删除流。
• 重新生成所有模型服务。

部署应用

使用本地 npm run dev添加流并验证应用后，像往常一样生成和部署：

npm run build
npx power-apps push

限制和考虑事项

将流添加到代码应用时，请记住以下限制和注意事项。

相关文章

• 快速入门：使用 npm CLI 创建代码应用
• 将数据源添加到代码应用
• 将现有流添加到解决方案
• 在环境中配置用户安全性