# 参考数据

功能简介：对基础数据进行定义，供模型配置引用，即数据字典。数据字典通常可定义确定的标准的静态数据分类，如：性别（男、女），计量单位（台、件、个等）,省（陕西省、浙江省）、市（西安市、杭州市）、区（莲湖区、西湖区）等。

访问路径【管理门户】->【模型管理】->【参考数据】，进入【参考数据】定义维护页面，如下图所示：

# 新增数据字典

数据字典需要按照主题归类，所以需要先准备一些主题分类。点击主题列表下的【新建主题】按钮，弹出【新建主题信息】页面，如图所示：

访问路径【管理门户】->【模型管理】->【参考数据】-> 【左侧主题树上某主题节点操作区：新增参考数据模型】，进入【参考数据】定义维护页面，如下图所示：

字典名称：手动输入名称，必填项，最多可输入256个字符。

字典编码：手动输入编码信息，输入内容必须是数字、字母和下划线，是必填项，同层级资源目录下，“数据字典编码”唯一，最多可输入64个字符。

字典类型：默认勾选“列表”，待选项包括“列表、树形”：勾选“列表结构”时，数据字典按照列表形式维护“编码字段、显示字段、排序字段”项；勾选“树形”时，数据字典按照树形式维护“编码字段、显示字段、排序字段、父字段”项，并且初始化多一个“父字段”字段。

排序号：显示排序次序。

编码字段：作为编码的字段。

显示字段：在选择中显示为选项的字段。

排序字段：用以排序的字段。

父字段：仅在字典类型为“树形”时需要维护。

备注：其他说明，上限为512字符。

提交之后，按需配置模型业务信息其他字段，如下图所示；配置完需要的字段即可发布（即建表）。

模型发布之后，切换至【数据列表】标签页页面，可进行该数据字典的数据维护。

注意，当数据字典在【修订】状态时，字典记录将不可见，也不能对记录进行其他操作。修订完成回到【发布】状态后，即可继续进行数据维护。

点击列表上方的【新增】按钮，弹出数据字典的数据维护页面，如下图示：

数据填写完成后，点击【提交】按钮即可。

先点击【模板下载】按钮下载Excel模板文件，按模板文件规范录入业务数据完成后点击【数据导入】按钮，上传Excel文件，可以批量对字典数据进行添加。导入时，需要字段名称和顺序完全匹配。

在字典数据列表下，点击上方【数据导出】按钮，完成字典数据的分页导出。

导出文件格式为Excel表格，如图所示：

在字典的数据订阅页面，通过设置字典数据订阅，从而能够推送字典数据。

实现数据订阅首先需要配置订阅者，关于如何配置订阅者，请参考订阅者管理。

切换到【数据订阅标签页】，点击【新增】按钮，新增字典的数据订阅。

订阅者：必选项，可以选择【系统管理-订阅者管理】中的订阅者，且不可选既存的字典订阅者。

推送方式：支持手动和实时推送，默认手动。

推送状态：默认启用，如果是禁用状态则字典推送时不可选该订阅者。

当业务数据发生新增/修改/删除会自动触发推送调度，可到推送日志中查看推送记录。

在数据订阅页面新增启用状态的订阅者后，切换到业务数据列表页面，选择数据后点击数据推送。如下图所示：

在数据订阅页面，点击【订阅日志】按钮，查看该字典的订阅日志。

操作区点击“查看详情”链接打开推送涉及的业务数据详情列表。如下图所示：