精通 Salesforce 联合报表：统一跨对象数据的咨询顾问指南

十一月 11, 2025

背景与应用场景

作为一名 Salesforce 咨询顾问，我经常遇到的一个典型业务挑战是：客户的高层管理人员希望在一个视图中看到跨越不同业务流程的整体情况。例如，销售副总裁可能会问：“对于我们那些有高优先级未解决支持个案 (Cases) 的大客户 (Accounts)，他们当前所有进行中的业务机会 (Opportunities) 的总金额是多少？”

这个问题无法通过一个标准的 Salesforce 报表来直接回答。一个标准的报表通常基于一个报表类型 (Report Type)，它定义了报表可以访问的主要对象及其相关的子对象。您可以创建一个“客户与业务机会”的报表，或者一个“客户与个案”的报表，但很难将这两者的数据优雅地并排呈现在一个统一的视图中。

这正是 Salesforce 联合报表 (Joined Report) 发挥其强大作用的地方。联合报表允许您在单个报表界面中，将来自不同报表类型的数据组合在一起，从而提供一个全面的、360度的业务视图。它能够解决以下典型的应用场景：

销售与服务协同： 在一个视图中同时查看客户的未完成业务机会和未解决的客户服务个案，帮助客户经理全面了解客户健康状况。
营销与销售漏斗分析： 将本季度通过营销活动生成的潜在客户 (Leads) 与由这些潜在客户转化而来的业务机会进行并排比较。
年度业绩对比： 创建两个或多个数据块，分别显示今年和去年的销售业绩，按客户或销售代表进行分组对比。
跨对象活动跟踪： 汇总特定客户名下的所有活动，无论是与业务机会、联系人还是个案相关，都在一个报表中呈现。

对于希望在不编写复杂代码或购买昂贵商业智能 (BI) 工具的情况下，深入挖掘数据、发现跨部门洞见的组织而言，联合报表是一个不可或缺的强大工具。

原理说明

要理解联合报表的工作原理，核心在于理解其独特的结构，该结构由以下几个关键概念组成：

1. 块 (Blocks)

联合报表不是一个单一的数据集，而是由最多五个独立的块 (Block) 组成。您可以将每个块想象成一个独立的、常规的 Salesforce 报表。每个块都有自己的：

报表类型 (Report Type)： 例如，块 1 可以是“客户与业务机会”，块 2 可以是“客户与个案”。
字段 (Fields)： 您可以为每个块选择不同的列。
筛选条件 (Filters)： 每个块都可以拥有自己独立的筛选逻辑。例如，块 1 可以筛选“进行中”的业务机会，而块 2 可以筛选“高优先级”的个案。
排序 (Sorting)： 每个块内的数据可以独立排序。

这种设计提供了极大的灵活性，允许您将完全不同类型的数据源并置在同一个报表画布上。

2. 公共字段与分组 (Common Fields & Grouping)

联合报表的“联合”魔力体现在分组上。为了让不同块之间的数据产生关联，您需要根据一个或多个公共字段 (Common Fields) 对它们进行分组。这些是存在于所有块中的通用字段，最常见的例子就是“客户名称 (Account Name)”、“业务机会所有者 (Opportunity Owner)”或“创建日期 (Created Date)”。

当您按“客户名称”对联合报表进行分组时，系统会：

从块 1（业务机会）中提取所有按客户名称汇总的数据。
从块 2（个案）中提取所有按客户名称汇总的数据。
将这些数据行对齐，使得同一个客户的业务机会信息和个案信息出现在同一行中。

如果某个客户在某个块中没有数据（例如，某个客户有业务机会但没有个案），那么在该块对应的列中，该客户的行将显示为空白。这种“外连接 (Outer Join)”式的数据呈现方式是联合报表的一个关键特征。

值得注意的是，您也可以创建不含公共分组字段的联合报表。在这种情况下，各个块的数据将独立显示，报表更像一个并排的仪表板组件，而不是一个真正“联合”的数据集。这在需要同时查看完全不相关的数据摘要时也很有用。

3. 报表格式 (Report Format)

联合报表有其独特的格式，它既不是纯粹的摘要报表 (Summary Report)，也不是矩阵报表 (Matrix Report)。它是一种混合格式，支持跨块的行分组，但不支持跨块的列分组。您最多可以添加三个分组字段，以实现更深层次的数据分析。

以编程方式与联合报表交互

虽然联合报表的创建和设计主要通过 Salesforce 的声明式报表生成器 (Report Builder) 完成，但在实际业务流程中，我们常常需要通过代码来自动执行这些报表并获取其结果，以便进行后续的数据集成、自定义通知或在自定义界面中展示。这可以通过 Salesforce Analytics REST API 来实现。

以下示例展示了如何使用 Analytics REST API 同步执行一个已存在的联合报表并获取其数据。请注意，您需要先获得报表的 ID（可以从浏览器 URL 中获取，例如 `00O...`）。

示例：通过 REST API 执行联合报表

要执行一个报表，您需要向 `instances` 端点发送一个 `POST` 请求。这个请求会立即运行报表并返回结果。这对于数据量不大、可以快速返回结果的报表非常适用。

POST /services/data/v58.0/analytics/reports/00Oxx0000000000000/instances

// HTTP Headers:
// Authorization: Bearer [Your_Access_Token]
// Content-Type: application/json

// Request Body (可以为空, 或包含覆盖筛选条件的 reportMetadata)
{}

返回结果详解 (JSON Response)

执行成功后，API 会返回一个复杂的 JSON 结构，其中包含了报表的所有数据和元数据。对于联合报表，这个结构尤为重要。

{
  "allData": true,
  "factMap": {
    "0!T!T": { // 块 1 的总计行
      "aggregates": [{ "label": "$1,500,000", "value": 1500000 }],
      "rows": []
    },
    "1!T!T": { // 块 2 的总计行
      "aggregates": [{ "label": "50", "value": 50 }],
      "rows": []
    },
    "0!0!0": { // 块 1, 第 1 个分组, 第 1 行数据
      "aggregates": [{ "label": "$700,000", "value": 700000 }],
      "rows": [
        { "dataCells": [{ "label": "Big Corp Opportunity 1", "value": "..." }, /* ... */] },
        { "dataCells": [{ "label": "Big Corp Opportunity 2", "value": "..." }, /* ... */] }
      ]
    },
    "1!0!0": { // 块 2, 第 1 个分组, 第 1 行数据
      "aggregates": [{ "label": "5", "value": 5 }],
      "rows": [
        { "dataCells": [{ "label": "Case 001 - Critical Issue", "value": "..." }, /* ... */] }
      ]
    }
    // ... more data keys
  },
  "groupingsDown": {
    "groupings": [
      {
        "groupings": [],
        "key": "0",
        "label": "Big Corp", // 第一个分组的值
        "value": "..."
      },
      {
        "groupings": [],
        "key": "1",
        "label": "Global Tech Inc.", // 第二个分组的值
        "value": "..."
      }
    ]
  },
  "reportMetadata": {
    "reportFormat": "JOINED",
    "id": "00Oxx0000000000000",
    "name": "Opportunities and Cases by Account",
    "reportBlocks": [ // 描述每个块的元数据
      {
        "blockId": "0",
        "reportType": { "label": "Opportunities", "type": "Opportunity" },
        "columns": [ /* ... */ ]
      },
      {
        "blockId": "1",
        "reportType": { "label": "Cases", "type": "Case" },
        "columns": [ /* ... */ ]
      }
    ]
    // ... more metadata
  }
}

代码注释：

`factMap`: 这是数据的核心。key 的格式为 `[blockId]![groupingLevel1]![groupingLevel2]`。例如，`0!0!0` 代表块 0（第一个块）、第一个分组级别下的第一行数据。`T` 代表总计 (Total)。通过解析这些 key，您可以将数据与相应的块和分组关联起来。
`groupingsDown`: 描述了报表的行分组结构。在这个例子中，报表是按客户名称分组的，"Big Corp" 和 "Global Tech Inc." 是分组的具体值。
`reportMetadata`: 提供了关于报表本身的元数据。`reportFormat: "JOINED"` 明确指出了这是一个联合报表。`reportBlocks` 数组则详细定义了每个块的信息，包括块 ID、所用的报表类型和列定义。这对于动态解析报表结果至关重要。

通过这种方式，开发人员和集成工程师可以系统地消费联合报表的数据，从而将其嵌入到更广泛的自动化流程和自定义应用中。

注意事项

作为咨询顾问，在为客户设计和部署联合报表解决方案时，我总是会强调以下几个关键的限制和注意事项：

1. 限制与约束

块的数量： 一个联合报表最多只能包含 5 个块。对于需要比较超过 5 个不同数据集的复杂场景，可能需要考虑其他工具，如 Tableau CRM (现已更名为 CRM Analytics)。
图表限制： 您可以为联合报表添加图表，但该图表只能基于其中一个块的数据。它无法实现跨块数据的可视化。
订阅与调度： 联合报表支持订阅，但用户无法选择在订阅邮件中接收 `.csv` 或 `.xls` 格式的附件。只能接收格式化的报表结果。
导出行为： 当您导出联合报表时，选择“格式化报表 (Formatted Report)”会保留块状结构，但选择“仅详细信息 (Details Only)”会导出一个扁平化的文件，每个块的数据会追加在后面，这可能会让不熟悉该报表结构的用户感到困惑。
不支持存储桶字段： 联合报表不支持使用存储桶字段 (Bucket Fields) 进行分组。
跨块筛选： 无法应用一个跨所有块的通用筛选器。每个块的筛选器都需要单独配置。

2. 权限 (Permissions)

要创建或编辑联合报表，用户需要拥有“创建和自定义报表 (Create and Customize Reports)”以及“报表生成器 (Report Builder)”的权限。
用户必须对报表中所有块涉及的对象和字段具有至少“读取”权限，否则他们将无法看到相应的数据。

3. API 与性能

使用 Analytics API 执行大型联合报表时，应优先考虑异步执行 (`/runAsync`)，以避免因请求超时而失败。
设计不佳的联合报表（例如，缺少有效筛选条件、处理海量数据）可能会运行缓慢，影响用户体验。始终建议在每个块中添加尽可能精确的筛选条件来限制数据范围。

总结与最佳实践

Salesforce 联合报表是一个功能强大的声明式分析工具，它填补了标准报表和复杂 BI 工具之间的空白。它使业务用户能够通过点击式配置，回答涉及多个业务领域的复杂问题，从而获得宝贵的商业洞见。

作为 Salesforce 咨询顾问，我为客户提供以下最佳实践建议：

从业务问题出发： 在创建任何报表之前，首先清晰地定义您想要回答的业务问题。这将指导您选择正确的报表类型和数据块。不要为了技术而技术。
选择合适的工具： 了解何时使用联合报表，何时不使用。
- 标准报表 (Standard Report)： 用于分析单一对象及其直接相关子对象的数据。
- 自定义报表类型 (Custom Report Type)： 用于定义新的对象关系（例如祖父-父-子），以创建一个全新的、可重复使用的报表基础。
- 联合报表 (Joined Report)： 用于并排比较来自不同报表类型的数据，特别是当这些数据共享一个公共分组时。
- CRM Analytics (Tableau CRM)： 用于需要大规模数据整合、复杂数据转换、预测性分析和高级可视化的场景。
保持简洁和清晰：
- 明智地命名块： 为每个块指定一个有意义的名称（例如，“Open Opportunities CY”或“High-Priority Cases”），而不是保留默认的“Block 1”、“Block 2”。
- 移除不必要的列： 只在报表中保留回答业务问题所必需的字段，避免信息过载。
培训最终用户： 确保使用报表的用户理解其结构，特别是如何解读分组数据和如何正确地导出数据。向他们解释“格式化报表”和“仅详细信息”导出之间的区别至关重要。

通过遵循这些原则，您可以充分利用 Salesforce 联合报表的潜力，将分散的数据转化为驱动决策的、具有凝聚力的商业洞察，从而为您的客户或组织创造真正的价值。

Salesforce中文网