本文介绍如何使用 Power Apps CLI 发现、添加、调用、更新和删除Power Apps代码应用中的Power Automate云流。
重要
代码应用仅支持使用 Power Apps 触发器的解决方案感知即时流。 不支持使用其他触发器的计划流、自动化流和即时流。
先决条件
- 使用
pa app init初始化的 Power Apps 代码应用 - 使用 Power Apps 触发器的解决方案感知即时云流
-
@microsoft/power-apps版本 1.1.1 或更高版本
如果流不在解决方案中,请参阅 将现有云流添加到解决方案。
步骤 1:列出可用流
使用 pa app list-flows 命令列出当前环境中的解决方案感知流:
pa app 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 参数:
pa app list-flows --search approval
复制要添加的流的 流 ID 。
注释
该命令仅列出可识别解决方案的流。 如果未列出流,请先将其添加到解决方案。
步骤 2:添加流
pa app add flow使用命令将流添加到代码应用:
pa app add flow --flow-id <flow-id>
例如:
pa app add flow --flow-id a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1
使用同一流 ID 再次运行该命令会使用最新的流定义更新生成的文件。
命令的作用
命令:
- 下载流的 OpenAPI 定义。
- 生成强类型 TypeScript 模型和服务。
- 将流及其连接引用添加到
power.config.json。
重要
运行 pa app add flow 的人员必须有权访问流及其基础连接。 如果该人员无权访问所需的连接,该命令将失败。
生成的文件
CLI 创建类似于以下示例的文件:
src/
services/
ApprovalWorkflowService.ts
models/
ApprovalWorkflowModel.ts
schemas/
logicflows/
ApprovalWorkflow.Schema.json
CLI 还会将流配置添加到 power.config.json。
步骤 3:调用流
生成的服务类提供静态 Run 方法。 方法签名基于流的 OpenAPI 定义中的输入参数。
包含输入参数的流
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.');
}
结果包含以下属性:
| 财产 | 类型 | 说明 |
|---|---|---|
success |
boolean |
指示流是否已成功触发。 |
data |
多种多样 | 包含来自流的类型化响应(如果可用)。 |
error |
Error |
包含错误信息(如果 success 为 false. ) |
打开生成的服务文件,查看流的确切输入和输出类型。
更新流
如果流定义发生更改,请使用相同的流 ID 再次运行 pa app add flow :
pa app add flow --flow-id a1b2c3d4-e5f6-7890-abcd-ef1234567890
该命令更新生成的文件并保留现有流条目。power.config.json
删除流
用于 pa app remove flow 按其数据源名称删除流:
pa app remove flow --flow-name ApprovalWorkflow
或者通过流 ID 将其删除:
pa app remove flow --flow-id a1b2c3d4-e5f6-7890-abcd-ef1234567890
该命令从模型和服务中删除流 power.config.json 并重新生成。
运行并发布应用
在本地运行应用:
npm run dev
生成并发布应用:
npm run build
pa app push
限制和考虑事项
| Limitation | 详细信息 |
|---|---|
| 需要Power Apps触发器 | 仅支持使用 Power Apps 触发器的即时流。 |
| 所需的解决方案感知流 | 流必须属于解决方案,然后才能添加它。 |
| 需要创建者访问权限 | 添加流的人员必须有权访问流及其基础连接。 |
| 所需的 Dataverse 权限 | 最终用户需要足够的 Dataverse 权限才能调用流。 分配应用打开器安全角色或等效角色。 |
| 需要手动更新 | 流定义更改后再次运行 pa app add flow 。 |