Power Apps组件框架多表查询：Dynamics 365 Sales组件数据获取求助

要实现需求中的数据统计，核心是通过Dynamics 365 Web API执行聚合查询，结合当前Lead记录的ID过滤关联的Visit数据。以下是具体实现步骤：

1. 获取当前Lead记录ID #

在PCF组件中，可通过上下文直接获取当前表单的Lead ID：

// 获取当前Lead的GUID（去除大括号的字符串格式）
const currentLeadId = context.mode.contextInfo.entityId.replace("{", "").replace("}", "");

如果组件绑定到Lead实体字段，也可通过context.parameters.yourFieldName.raw获取，但直接使用entityId更可靠。

2. 构造聚合查询的FetchXML #

因为需要同时获取总数、最新日期、时长总和、价值平均值四个聚合值，用FetchXML的聚合语法最直接：

<fetch aggregate='true'>
  <entity name='new_visit'>
    <attribute name='new_visitid' alias='totalVisits' aggregate='count' />
    <attribute name='createdon' alias='latestVisitDate' aggregate='max' />
    <attribute name='new_duration' alias='totalDuration' aggregate='sum' />
    <attribute name='new_value' alias='avgValue' aggregate='avg' />
    <filter type='and'>
      <condition attribute='new_new_parent_leadid' operator='eq' value='{currentLeadId}' />
    </filter>
  </entity>
</fetch>

将上述XML中的{currentLeadId}替换为实际的Lead GUID字符串。

3. 调用Web API执行查询 #

使用PCF内置的WebAPI.retrieveMultipleRecords方法执行FetchXML查询，注意处理异步逻辑：

import { WebAPI } from "@microsoft/powerapps-component-framework";

// 构造FetchXML字符串（替换占位符）
const fetchXml = `
<fetch aggregate='true'>
  <entity name='new_visit'>
    <attribute name='new_visitid' alias='totalVisits' aggregate='count' />
    <attribute name='createdon' alias='latestVisitDate' aggregate='max' />
    <attribute name='new_duration' alias='totalDuration' aggregate='sum' />
    <attribute name='new_value' alias='avgValue' aggregate='avg' />
    <filter type='and'>
      <condition attribute='new_new_parent_leadid' operator='eq' value='${currentLeadId}' />
    </filter>
  </entity>
</fetch>
`;

// 执行查询并处理结果
async function getVisitAggregates() {
  try {
    const response = await WebAPI.retrieveMultipleRecords(
      "new_visit",
      "?fetchXml=" + encodeURIComponent(fetchXml)
    );
    
    // 提取聚合结果（处理空数据情况）
    if (response.entities.length === 0) {
      // 无关联访问记录时的默认值处理
      return { totalVisits: 0, latestVisitDate: null, totalDuration: 0, avgValue: 0 };
    }

    const result = response.entities[0];
    const stats = {
      totalVisits: result["totalVisits"],
      latestVisitDate: result["latestVisitDate"], // ISO格式日期字符串
      totalDuration: result["totalDuration"],
      avgValue: result["avgValue"]
    };

    // 后续将数据绑定到组件UI
    console.log(stats);
    return stats;
  } catch (error) {
    console.error("查询访问记录失败:", error);
    return null;
  }
}

// 在组件初始化或视图更新时触发查询
getVisitAggregates();

关键注意事项 #

• 确保PCF组件的安全角色拥有对Visit实体的读取权限，否则会返回权限错误。
• 日期字段createdon返回的是ISO格式字符串，可根据需求转换为本地化日期格式。
• 数值字段的聚合结果会自动处理类型（如sum返回数字，avg返回带小数的数字）。

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