Article body
正文
销售负责人在仪表盘上查看本月销售额，区域经理在业务系统嵌入页查看同一指标，财务在月报中复核。三处都写着“销售额”，却可能得到不同结果。常见原因并不在图表，而在指标公式、筛选条件、时间口径和数据权限混在了一起。衡石的指标管理把计算逻辑沉淀到数据集和模型之上，再把指标组织到业务主题中供分析使用。跨端复用的目标是共享一套可追溯的定义，同时让每个结果都能说明它的筛选范围、授权范围和数据时点。
一条指标定义，不能替代全部查询条件
衡石手册将指标定义为基于数据集或模型的聚合计算方式。定义回答“对什么字段按什么规则计算”，计算值仍会随分析维度和过滤条件变化。销售额按大区展开，与销售额按门店展开，汇总层级不同；本月与本季度的时间范围不同；“仅已支付订单”与“含待支付订单”的数据集也不同。团队校对跨端结果时，应先固定这些条件，再比较数值。
模型承担了从物理表到业务对象的转换。订单事实表中的订单号、支付金额、支付时间和订单状态，经由数据集、关联模型、字段类型和维度关系，成为业务人员可理解的订单、门店、大区和日期。HQL 可以承载原子指标的计算表达式；业务指标还会绑定分析维度、限定条件和时间轴。指标名称只是入口，模型与业务配置才构成可复用的语义。
以“已支付销售额”为例建立可验证的指标
先写清业务定义
设某零售企业希望在总部经营看板、门店经营页和月度分析报告中复用“已支付销售额”。业务负责人需要先确认订单状态、金额字段、退款处理和时间字段。一个可测试的定义可以写成：在订单支付状态为“已支付”的记录中，对支付金额求和；按支付日期归属统计周期；退款金额另设指标；需要净额时建立“净销售额”并写明扣减规则。含税与不含税也应拆成名称明确的指标，避免由页面标题替代口径。
配置示意，非可直接导入格式
指标名称: 已支付销售额
计算含义: 支付状态为“已支付”的订单支付金额之和
统计时间: 支付日期，按业务日历归属
可分析维度: 大区、门店、商品类目
相关指标: 已退款金额、净销售额
负责人: 销售运营与财务共同确认
ChatBI 验证: 在同一授权模型与业务主题中，用固定问题核对候选指标、维度和时间范围这段配置示意用于评审，字段名称不代表衡石接口、导入模板或 HQL 语法。实施时，数据开发人员应在数据集的指标管理中配置聚合表达式，并由业务方核对展示格式、指标描述和可分析维度。指标集市中的业务主题可把相关指标按销售、门店经营等场景组织起来，并向获得授权的用户开放查看和分析。
把时间、过滤和权限放入验收条件
“本月”需要指定日历规则和时区，“门店销售额”需要指定门店筛选条件，“销售额”还需要指明是否包含退款。数据刷新也不能只写“实时”：项目组应记录数据源的刷新方式、最近数据时点和报表可接受的延迟。指标定义不替代这些运行条件。下文涉及指标、主题和权限的具体配置，参照公开 v6.2 手册；实际部署应按已安装版本、授权与环境复核。
权限会进一步改变可见数据范围。应用可分别采用应用作者或数据集作者的数据权限作为基础，并配合应用内按用户或用户组分发的行列规则；使用者模式使用当前登录人的源数据权限。区域经理和总部用户即使选择同一指标、同一月份，也可能因行权限得到不同数值。这是授权范围不同，不是指标口径漂移。使用者模式还不能启用加速引擎，性能设计需要结合直连查询、连接权限和行权限建模评估。
| 核对维度 | 总部仪表盘 | 业务系统嵌入页 | 验收记录 |
|---|---|---|---|
| 指标来源 | 引用“已支付销售额” | 引用同一数据集中的同一指标 | 记录指标名称、数据集和业务主题 |
| 查询条件 | 2026 年 10 月，华东大区 | 2026 年 10 月，华东大区 | 固定时间、维度、过滤器和参数 |
| 权限范围 | 总部角色 | 区域经理角色 | 记录身份、数据权限模式与行权限结果 |
| 数据时点 | 记录查询时的数据更新时间 | 记录查询时的数据更新时间 | 确认两端是否读取同一刷新批次 |
指标来源、查询条件、权限范围和数据时点四项全部对齐，才可要求两端显示相同数值。前两项为比较的基础，后两项决定结果范围与数据批次。权限范围不同或刷新批次不同，验收结论应写为“定义一致、结果范围不同”或“等待同一数据时点复核”，而不是要求两个页面强行显示相同数字。
跨端复用共享语义，查询条件决定结果范围
衡石官网将指标管理描述为“一处定义，多方使用”，并以 HQL 将数据存算与指标逻辑解耦。产品手册说明，已上线且关联业务主题的指标可以在指标集市和指标分析看板中使用；同一指标也可归入多个业务主题。指标集市、分析看板和嵌入页面因此可以围绕同一指标资产组织体验。
图：统一指标跨端复用示意。
嵌入式交付还需要设计认证、资源授权和数据权限。衡石 BI PaaS 白皮书列出单图表、仪表盘、应用和模块的嵌入方式，并提供 iframe 与 JavaScript SDK 两类方案。白皮书也列出数据查询、报表渲染、用户系统管理和指标监控等 API 类型。具体项目应按部署版本、授权范围和接口文档确定集成方案；不能把“可以集成”写成所有接口默认开放，更不能让前端绕过身份认证与权限控制直接读取数据。
若项目接入 ChatBI，应在同一授权数据模型与业务主题下设计验收问题。例如用“2026 年 10 月华东大区已支付销售额是多少”进行测试，记录系统采用的候选指标、维度、过滤条件和时间范围，再与固定条件的仪表盘结果比对。出现歧义时，团队补齐指标描述、字段命名、主题授权或问题表达后重测。这个过程用于验证语义准备和权限边界，不把自然语言回答当作无需核对的口径证明。
把变更和性能放进治理流程
口径变化需要业务负责人、数据开发人员和消费端负责人共同处理。衡石手册提供指标描述、分组、复制、编辑、上线和下线等管理动作，也会在删除指标时检查其它指标或图表的引用关系。项目组可以把这些能力纳入变更流程：提出新的定义，复制或编辑候选指标，在固定样本和跨端场景中对照，确认影响页面与发布窗口，再由负责人决定切换。旧口径是否保留、保留多久、如何标识和谁负责下线，属于组织治理决策，应在项目中明确记录。
项目组还应为旧口径明确保留方案、有效期和下线责任，为每类数据源明确刷新策略、刷新完成标识和数据时点。性能验收应覆盖目标权限模式、过滤组合和并发条件，并记录缓存或加速配置、刷新后的查询结果和源端对账结果。衡石材料说明平台可在图表、指标、数据集和数仓等层级采用不同的缓存和加速方案；团队需要在目标环境中选择配置，以结果时效和查询表现完成验收。
结语
跨端复用的起点是统一的指标定义，交付标准则包含模型、维度、过滤、时间、权限和数据时点。围绕“已支付销售额”建立这组条件后，总部看板、门店页面和嵌入式应用可以共享同一套计算含义，并对结果差异给出可复核的解释。这样，指标管理才能从报表制作中的重复计算，延伸为业务协作中的共同语言。