外部数据模型

变更记录

1 简介

1.1 功能介绍

注：外部数据接入功能只是为异构系统生成凭证时，提供灵活定义中间表结构和接口报文结构的能力。产品上虽然支持已导入数据的查询，但此功能是用于监控导入状态/查看报错信息的。因此它不提供单据的功能，例如手动的增、删、改、多维度筛选、审批、打印、接入附件、影像集成、业务流程处理等。如果需要这类能力，仍然需要通过单据集成来实现。

外部数据模型（原事件模型菜单）是一种用于定义数据结构的，可视化配置工具。通过配置数据模型，可以同时完成：数据接口的报文结构定义、数据存储结构定义（接口表）。系统集成时通过预设的模型完成外部业务数据的导入。

1.2 应用场景

外部数据模型主要用于接入其他厂商的单据信息到星瀚系统，将接入的数据进行结构化存储；支持根据模型配置凭证模板，生成总账凭证。

1.3 系统路径

【财务云】→【会计事件库】→【外部数据接入】→【外部数据模型】

注意事项：用户实际使用的菜单与产品出厂菜单可能不同，若因路径不同导致无法找到最终菜单，可通过页面右上角的搜索栏搜索菜单。

1.4 关键字段/按钮说明

模型基本信息字段说明

数据字段分组字段说明

数据字段自定义说明

字段属性字段说明

关键按钮说明

2 主要操作

2.1 新老模型参数设置

适用场景

对于在5.0023之前已使用外部数据（原会计事件）的客户，可以选择继续新增旧版本的老模型，也可以启用5.0023之后的新模型。但对于5.0023才启用外部数据的客户，只允许新增新模型

操作步骤

步骤1：在【公共设置】-【系统参数】-【财务云】-【会计事件库】的【外部数据接入】页签找到<启用新外部数据模型>参数，如果参数打开，则新增的模型为新模型，关闭则新增的模型为老模型

注意事项：1.新模型的使用需要两种许可，一是会计事件库的许可；二是苍穹的二开许可

2.打开参数后，新增的模型是新模型，但是不影响原本系统里老模型的使用，老模型的使用方法仍与原来保持一致

3.打开参数后，老模型不会自动升级为新模型，允许系统里面老模型和新模型两套方式并行

4.<启用新外部数据模型>参数为全局参数，只允许在组织设置是否启用

5.5.0023以后的客户只允许新增新模型，无法新增老模型

2.2 定义外部数据模型分组

适用场景

用户根据自己的业务场景抽象外部数据模型模型分组，例如：定义AR应收的分组，将外部数据模型为“应收开票”和“确认收入”放入“应收”分组中

操作步骤

步骤1：在【外部数据模型列表】定义【外部数据模型分组】，点击<新增>分组

步骤2： 填写编码和名称

注意事项：编码需要以英文字母开头，由字母、数字和下划线组成，且不允许重复

后续操作

外部数据模型分组支持新增、修改、删除

1：新增；2：修改；3：删除

2.3 定义外部数据模型

适用场景

与异构系统约定好要传输的内容，有哪些字段，字段存储类型，单据数据结构等

操作步骤

步骤1： 定义外部数据模型时，需要关联具体的外部数据模型分组

在列表里显示所有定义的外部数据模型，新增外部数据模型的方法有两种：

• 先选择外部数据模型分组，直接点击<新增>进行填写。

• 在右边选择外部数据模型进行<复制>新增。

步骤2：定义数据字段分组，分为三个分组，系统字段分组、数据头分组和数据分录分组。其中：

• 系统字段分组不允许编辑，是外部数据导入的必填字段，只允许修改<显示>属性；

• 数据头分组用于设置外部数据的头字段，支持设置多个头面板信息（只支持一层级）；

• 数据分录分组用于设置外部数据的分录字段，支持设置多个分录面板信息（可以支持二级分录）

注意事项：需要先新增分组，再在对应分组下新增字段

步骤3： 定义需要从异构系统导入的所有字段。选择了字段类型后，自动设置字段属性默认值，字段属性可以根据具体业务应用场景更改

2.4 外部数据预览

适用场景

定义好外部数据模型后，可以预览模型打开外部数据页面，检查外部数据模型设