# Excel 导入

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

## 功能定位

Excel 导入使用受控模板批量维护业务字典。系统先校验文件、再做差异比对，只有校验通过且无错误行时才允许写入，导入对象统一生成草稿。

![Excel 导入](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-j9nbb07o.png)

*图 6-7　模板下载、校验批次、差异清单和受控提交*

## 适用角色

建模人员、数据管理员和业务专家。

## 页面入口

业务建模中心 → Excel 导入（`/bi/bm/import`）。

## 操作步骤

1. 点击“下载导入模板”，不要自行修改 Sheet 名称和列标题。
2. 选择目标项目，上传 `.xlsx` 文件并点击“校验文件”。
3. 系统返回批次 ID、模板版本、文件 SHA-256 和过期时间。
4. 查看错误清单，按 Sheet、行号、列、字段、错误码和说明逐项修正。
5. 查看差异清单，确认新增、修改和冲突对象。
6. 校验无错误后点击“确认导入”；提交时需匹配文件摘要，防止文件被替换。
7. 导入结果为草稿，仍需在业务字典中逐项提交审核。

## 输入与输出

输入是 `BM-V2.0.0` 模板文件；输出是校验批次、错误与差异清单、草稿对象。

## 宏澜家电示例

销售专家用模板一次性导入 12 个渠道指标和 20 个客户维度，系统发现 3 行指标单位为空、1 个编码重复；修正后重新校验并导入，随后提交审核。

## 客户应用演示：用 Excel 批量导入销售指标和维度

**业务情境：** 已有标准模板的 30 个销售指标需要批量进入建模工作台。

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

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

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

进入“业务建模中心 → Excel 导入”，先下载最新模板。

### 第二步：按模板填写业务域、对象类型、编码、名称、定义、公式和负责人

![第2步重点操作：按模板填写业务域、对象类型、编码、名称、定义、公式和负责人](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-tpgyqexv.jpeg)

*步骤图 29-02　第2步：按模板填写业务域、对象类型、编码、名称、定义、公式和负责人。红框标出按模板填写业务域、对象类型、编码、名称、定义、公式和负责人。*

按模板填写业务域、对象类型、编码、名称、定义、公式和负责人。

### 第三步：上传文件

![第3步重点操作：上传文件](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-twzvovgg.jpeg)

*步骤图 29-03　第3步：上传文件。红框标出上传文件。*

上传文件，查看预校验结果：必填、编码重复、引用关系和格式。

### 第四步：修正错误行后重新校验

![第4步重点操作：修正错误行后重新校验](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-cxoouuvh.jpeg)

*步骤图 29-04　第4步：修正错误行后重新校验。红框标出修正错误行后重新校验。*

修正错误行后重新校验，确认通过行数和错误行数为零。

### 第五步：选择导入范围并保存导入设计清单

![第5步重点操作：选择导入范围并保存导入设计清单](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-ivgh1r05.jpeg)

*步骤图 29-05　第5步：选择导入范围并保存导入设计清单。红框标出选择导入范围并保存导入设计清单。*

选择导入范围并保存导入设计清单，检查导入结果。

## 最终结果与效果

批量对象进入待维护或审核流程，页面保留导入清单和错误记录。当前版本保存的是导入设计，不自动创建真实数据源或执行器。

> **操作提示：** 不要修改模板列名；大批量导入前先用 3—5 行试导。

## 常见问题

**有错误行还能导入吗。** 不能。必须先修正全部阻断错误。

**批次过期。** 重新上传并校验，不要复用过期批次。

**导入后看不到对象。** 导入对象为草稿，需要到业务字典按对象类型查询并提交审核。

## 开发人员参考

- 接口：`GET /bi/bm/imports/template`、`POST /bi/bm/imports/validate`、`POST /bi/bm/imports/{batchId}/commit`
- 权限：`bi:bm:dict:import`
- 提交携带 `expectedFileSha256`，默认 `ABORT_ON_CONFLICT`；批次有过期时间。