# 业务字典

<!-- BookStack import page: id=bm-dictionary chapter=业务建模中心 -->

## 功能定位

业务字典统一管理业务域、业务过程、指标和维度，是报表、模型、大屏和 AI 问数共同引用的业务语义底座。

![业务字典](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-3jpouip1.png)

*图 6-3　四类业务对象及审核状态*

## 适用角色

业务专家、指标管理员、数据架构师和模型开发人员。

## 页面入口

业务建模中心 → 业务字典（`/bi/bm/dictionary`）。

## 对象说明

| 对象 | 回答的问题 | 示例 |
|---|---|---|
| 业务域 | 企业有哪些稳定的业务主题？ | 销售、生产、库存、财务、市场、人力 |
| 业务过程 | 业务中发生了什么事件？ | 销售下单、生产完工、采购入库、费用报销 |
| 指标 | 如何衡量业务结果？ | 成交金额、毛利率、库存周转天数 |
| 维度 | 从哪些角度分析？ | 时间、区域、渠道、产品、客户、组织 |

## 操作步骤

1. 选择项目和对象页签，按编码或名称查询。
2. 点击“新增”填写编码、名称、业务域、责任角色、描述和生效日期。
3. 指标必须填写业务口径、计算说明和单位；维度需说明来源表与类型。
4. 保存草稿后点击“提交审核”，对象进入待审核状态。
5. 审核通过后对象变为已通过并生成不可变版本；驳回后按意见修订再提交。
6. 已通过对象需要变更时使用“修订”，不要直接删除历史对象。

## 宏澜家电示例

销售部门提交指标“成交金额”，口径为含税订单金额扣除取消订单，单位为元，分析粒度为订单日期和销售组织；财务部门审核确认含税规则后通过。

## 客户应用演示：定义“毛利率”指标口径

**业务情境：** 销售和财务对毛利率的计算口径不一致，需要形成统一业务定义。

### 第一步：进入“业务建模中心 → 业务字典”

![第1步重点操作：进入“业务建模中心 → 业务字典”](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-z8fqbavu.jpeg)

*步骤图 25-01　第1步：进入“业务建模中心 → 业务字典”。红框标出进入业务建模中心 → 业务字典。*

进入“业务建模中心 → 业务字典”，选择销售业务域。

### 第二步：新增指标“毛利率”

![第2步重点操作：新增指标“毛利率”](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-umlo7dpc.jpeg)

*步骤图 25-02　第2步：新增指标“毛利率”。红框标出新增指标毛利率。*

新增指标“毛利率”，填写业务定义、计算公式、分子分母、时间粒度和单位。

### 第三步：关联销售额与毛利额指标

![第3步重点操作：关联销售额与毛利额指标](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-u8s0qh94.jpeg)

*步骤图 25-03　第3步：关联销售额与毛利额指标。红框标出关联销售额与毛利额指标。*

关联销售额与毛利额指标，注明是否含税、是否排除取消订单和退货。

### 第四步：选择负责人并提交审核

![第4步重点操作：选择负责人并提交审核](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-fruuwuo5.jpeg)

*步骤图 25-04　第4步：选择负责人并提交审核。红框标出选择负责人并提交审核。*

选择负责人并提交审核；在审核中心由财务审核人复核。

### 第五步：审核通过后

![第5步重点操作：审核通过后](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-cr7bqw1k.jpeg)

*步骤图 25-05　第5步：审核通过后。红框标出审核通过后。*

审核通过后，在版本与审计中确认不可变版本和摘要。

## 最终结果与效果

“毛利率”成为可被报表、数据集、看板和 AI 问数共同引用的统一指标，口径和审核记录可追溯。

> **操作提示：** 指标定义要说明边界条件，不能只写公式名称。

## 常见问题

**审核通过后不能直接改。** 这是版本控制设计；应提交新修订，保留历史口径。

**编码重复。** 编码在项目内应保持唯一且稳定；业务含义变化时新增编码或按治理规范升版。

## 开发人员参考

- 接口：`/bi/bm/projects/{projectId}/domains|processes|metrics|dimensions`
- 权限：`bi:bm:dict:edit`、`bi:bm:dict:submit`、`bi:bm:dict:review`
- 审核通过生成带 SHA-256 的不可变快照；修订号用于乐观锁。