如何通过SPFx代码检测当前站点列表是否配置Power Automate流？

我们开发了用于自定义的SharePoint Framework（SPFx）应用，使用@pnp/sp对SharePoint列表执行GET/POST操作。系统通过Power Automate发送邮件通知，当列表中添加或更新项目时会触发对应的流。由于同一应用部署在多个子站点中，需验证每个站点是否已配置对应的Power Automate流，否则邮件通知功能将无法正常工作。我们尝试了以下代码，但无法正常运行：

import { sp } from "@pnp/sp";

const listName = "EmailData";

const result = await sp.web.lists
  .getByTitle(listName)
  .usingCaching()
  .get()
  .then(async () => {
      return await sp.web.lists
        .getByTitle(listName)
        .rootFolder
        .select("ServerRelativeUrl")
        .get();
  });

// Call the custom endpoint
const syncFlowInstances = await sp.web
  .get(`${result.ServerRelativeUrl}/SyncFlowInstances`)
  .get();

console.log(syncFlowInstances);

可行解决方案 #

1. 通过SharePoint REST API查询列表关联的工作流（推荐）

Power Automate流关联到列表后，会被记录在列表的WorkflowAssociations集合中，可直接通过@pnp/sp查询该集合并筛选目标流：

import { sp } from "@pnp/sp";

const listName = "EmailData";
// 查询列表所有关联的工作流/流
const workflowAssociations = await sp.web.lists.getByTitle(listName).WorkflowAssociations.get();

// 根据流名称或唯一标识判断是否存在目标流
const targetFlowExists = workflowAssociations.some(assoc => {
  // 替换为你的Power Automate流的名称或ID
  return assoc.Name === "邮件通知触发流";
});

console.log("当前列表是否配置目标流：", targetFlowExists);

2. 修复原有自定义端点调用代码

如果SyncFlowInstances是你自定义开发的端点，原有代码的问题在于await与then混用导致返回值异常，修正后代码如下：

import { sp } from "@pnp/sp";

const listName = "EmailData";

// 单独获取列表根文件夹路径，避免await和then混用
const listFolder = await sp.web.lists.getByTitle(listName).rootFolder.select("ServerRelativeUrl").get();

// 确保端点路径正确拼接
const syncFlowInstances = await sp.web.get(`${listFolder.ServerRelativeUrl}/SyncFlowInstances`).get();

console.log(syncFlowInstances);

同时需确认自定义端点已正确部署到目标站点，且权限配置允许当前用户访问。

3. 通过Power Automate管理API查询站点关联流

若你拥有Power Automate管理权限，可调用官方API查询当前站点关联的流：

import { sp } from "@pnp/sp";

const siteUrl = await sp.web.select("Url").get().then(res => res.Url);
const environmentId = "你的Power Automate环境ID"; // 替换为实际环境ID

// 获取当前用户的SPO认证令牌，用于调用Power Automate API
const authToken = await sp.web.getAuthToken();

const response = await fetch(
  `https://api.flow.microsoft.com/providers/Microsoft.PowerApps/scopes/admin/environments/${environmentId}/flows?$filter=contains(properties/definition/triggers/When_an_item_is_created/parameters/siteUrl, '${siteUrl}')`,
  {
    headers: {
      "Authorization": `Bearer ${authToken}`
    }
  }
);

const flows = await response.json();
// 根据流名称判断是否存在
const targetFlowExists = flows.value.some(flow => flow.properties.displayName === "邮件通知触发流");

console.log("当前站点是否配置目标流：", targetFlowExists);

注意：此方法需要用户拥有流的查看权限，且需提前获取Power Automate环境ID。

内容的提问来源于stack exchange，提问作者thedeepponkiya