在 Power Pages 中配置 Power Automate 云端流

项目
01/29/2025

Power Automate 云端流允许用户在不同的应用程序和服务之间创建自动化工作流。可以使用 Power Automate 云端流来创建逻辑，以便在发生某个事件时执行一个或多个任务。例如，配置按钮，以便当用户选择此按钮时，发送电子邮件或会议请求、更新记录、收集数据、同步文件和执行其他任务。

现在，您可以从 Power Pages 安全地调用 Power Automate 云端流，与 1000 多个外部数据源进行交互并将其集成到您的业务站点中。

备注

您的 Power Pages 站点版本必须为 9.5.4.xx 或更高版本才能使用此功能。
您的起始站点包版本必须为 9.3.2304.x 或更高版本。

先决条件

要与 Power Pages 集成，需要 Power Automate 许可证。建议在生产实例中使用 Power Automate Process 许可。

集成云端流的步骤

创建云端流。
向站点添加流。
从您的网站调用流。

创建流

登录到 Power Pages。
选择站点 + 编辑。
导航至设置工作区，然后选择集成下的云端流。
选择 + 创建新流。
搜索 Power Pages，选择当 Power Pages 调用流时触发器。
定义您的流步骤和返回值并选择保存。

备注

只有解决方案感知流才能附加到 Power Pages 站点。

向您的网站添加流

创建即时云端流后，它需要与 Power Pages 站点相关联并使用 Web 角色进行保护。

登录到 Power Pages。
选择站点 + 编辑。
导航至设置工作区，然后选择集成下的云端流。
选择 + 添加云端流。
搜索最近创建的流。
在角色下面选择 + 添加角色。
选择应有权访问流的角色。
选择保存。

备注

当您将流添加到站点时，将生成一个唯一 URL，允许您从您的站点调用云。

从网页调用流

使用 Power Pages 云端流 API 与 Power Automate 交互以执行外部服务集成。云端流 API 操作包含 HTTP 请求和响应。

Operation	方法	URI
调用云端流	POST	[站点 URI]_/api/cloudflow/v1.0/trigger/<guid>

示例:

Request

POST https://contoso.powerappsportals.com/_api/cloudflow/v1.0/trigger/4d22a1a2-8a67-e681-9985-3f36acfb8ed4
{
    "Location":"Seattle"
}

Response

没有响应操作的云端流

HTTP/1.1 Accepted
Content-Type: application/json

有响应操作的云端流

HTTP/1.1 200 OK
Content-Type: application/json
Body
{
    "conditions":"Rain",
    "humidity":"93",
    "latitude":"47.60620880126953",
    "longitude":"-122.33206939697266"
}

对云端流 API 请求进行验证

您不需要包含身份验证代码，因为应用程序会话管理身份验证和授权。所有 API 调用都必须包括跨网站请求伪造 (CSRF) 令牌。

将参数传递到云端流

在云端流中，您可以定义类型为 Text、Boolean、File 和 Number 的输入参数。您在请求正文中定义的参数名称应与云端流触发器中定义的参数名称匹配。

重要提示

您必须传递云端流中定义的请求参数名称。
不支持将参数传递到配置了安全输入的流。

调用流的示例 JavaScript

此示例演示如何使用异步 JavaScript 和 XML (AJAX) 调用流。

    shell.ajaxSafePost({
        type: "POST",
        url: "/_api/cloudflow/v1.0/trigger/44a4b2f2-0d1a-4820-bf93-9376278d49c4",
        data: {"eventData":JSON.stringify({"Email": "abc@contoso.com", "File":{"name":"Report.pdf", "contentBytes":"base 64 encoded string"} })}
    })
    .done(function (response) {
    
    })
    .fail(function(){
    
    });

备注

如果触发器中未定义输入参数，请在请求中传递一个空的有效负载。
有关云端流限制的信息，请参阅自动、预定和即时流的限制。

云端流的应用生命周期管理 (ALM)

将包含云端流的 Power Pages 站点组件从一个环境移动到另一个环境时，必须在目标环境中注册云端流。如果未注册云端流，则从网站调用它们会导致禁止错误。

若要将流注册到目标环境，请按照下列步骤操作：

登录 Power Pages，然后选择目标环境。
找到站点并选择编辑。
转至设置工作区，然后选择集成下的云端流。
在此站点中的云端流列表中查找注册按钮。
若要注册流，请选择图标。

通过