一、功能概述

1、功能描述

数据仓库简称数仓，可以按照线下或其他系统中的数据结构，创建自定义表单，用于存储数据并生成凭证。

创建数仓表单的过程，即为数仓配置，是使用数仓功能的起点

2、功能路径

【数据仓库】-【配置】

3、流程说明

配置→数仓凭证生成配置→上传数据至数据源数仓→生成凭证

二、界面总览

三、操作指引

（一）创建表单

1、点击“创建表单”

2、设置基础信息

在弹出界面设置基础信息，操作方法如下：

表名：数仓表单的英文名，系统自动生成

表描述：必填，数仓表单的中文名

表单分类：必填，默认=普通表单，无需修改

表类型：必选，可选单表、主表、附表，影响表单样式，不影响凭证生成，最常用的是“单表”

单表：不区分表头、表体，如下图所示

主表、附表：组合使用，主表为表头，附表为表体，如下图所示：红框为主表、绿框为附表

视图名、视图描述：非必填，凭证生成逻辑极其复杂（无法通过单一表单、2个表单简单映射实现）的场景下，需搭配SQL时才需要进行设置

接口兼容编辑：默认=是，无需修改

3、系统预设

创建表单时，无论单表、主表还是附表，系统都会自动生成以下5行

注意：除下列提及字段，不要修改系统自动生成的其他信息

公司主体行：

需设置“字典配置”参数为“公司主体”否则影响凭证生成，上传表格必须包含此字段

凭证id行：

不要做任何操作，否则影响凭证生成，上传表格无需包含此字段

会计期间行：

字段备注可按实际需要进行修改

举例说明：如将标题行“获客日期”作为生成凭证的日期，则可将“会计期间”修改为“获客日期”，不必新增行。也可此行不做任何设置，额外新增行，将字段备注设置为“获客日期”，设置效果相同。

表单编码、录入日期行：不要做任何操作，否则影响凭证生成，上传表格无需包含此字段

4、单表的设置

点击数据库属性下的”添加“，即出现下图所示空白行

 此行可根据实际需要，将上传表格的标题行字段在此进行设置

注意：参数设置后，上传表格的标题行信息、所属列格式需与设置的参数相符合，否则无法成功上传。

数据库属性各列含义及注意事项如下：

字段名称：必填，系统自动生成，无需修改

字段备注：必填，字段显示的名称，内容前后不能有空格（如有，系统强制删除）

，需与上传表格的标题行一致

字段长度：必填，在数仓中存储数据的字段长度，数字越大，允许导入、存储的内容越多

小数点：必填，系统保存数据的小数位数，举例说明：

当小数点设置为2，若上传表格对应列的数据保留5位小数，则在数仓中保留的数据为4舍5入后的2位小数

默认值：非必填，如该字段未设置为校验必填，但生成凭证时需要取值时需设置，举例说明：

如社保公积金台账中，由于该字段没有值是正常情况（所以未勾选校验必填），但如果有值需生成凭证，在这种场景下，需要设置默认值=0，否则会影响凭证生成

字段类型：必选，可选字符串、文本、日期、整数、精确浮点、布尔

注意：字段类型需与小数点匹配，举例说明：

小数点设置为2，字段类型应设置为精确浮点；小数点设置为0，字段类型应设置为整数

允许空值：勾选，可以不填写该字段，表单字段无特殊标记

未勾选，必须填写该字段，表单字段前面标记*

表单显示：勾选，在系统中录入数据时列示该字段；不勾选，不列示

列表显示：勾选，在数据表单列表页列示该字段；不勾选，不列示

控件类型：必选，即对数据格式的要求，导入数据必须与数仓表单设置的控件类型一致

可选文本框、下拉框、单选框、多选、多行文本、月份（yyyy-MM）、日期（YYYY-MM-dd）、日期（yyyy-MM-dd HH:mm:ss）、金额

注意：控件类型需与控件类型匹配，举例说明：

字段类型设置为日期，控件类型应选月份（yyyy-MM）、日期（YYYY-MM-dd）、日期（yyyy-MM-dd HH:mm:ss）

字段类型设置为整数或者精确浮点，控件类型应选择金额

控件长度：必填，默认=120，可修改，影响数仓列表页该字段列示的长度

是否查询：勾选后，可作为筛选条件字段

勾选任一字段，则在数仓列表页列示“筛选”按钮；所有字段均未勾选，不列示

举例说明：

“获客数量统计表”中，所有字段均未勾选“是否查询”，则“筛选”按钮不会出现，如图所示：

“获客数量统计表”中，“获客日期”、“业务线”勾选“是否查询”，则出现“筛选”按钮

查询类型：必选，可选普通查询、范围查询

普通查询：以单一固定值作为查询条件

范围查询：以一段区间、上下边界作为查询条件

举例说明：将获客日期设置为范围查询、城市设置为普通查询

动态填值：按照导入时指定的固定值覆盖导入文件中的信息

勾选：系统将在导入文件时弹出对话框，要求输入一个固定值。此值将被统一应用到整列，并覆盖导入文件中该字段的原有内容。

不勾选：按导入文件中填写的信息存储数据

举例说明：“文件备注”字段勾选了动态填值，则在系统中导入文件时，需要在弹出界面输入备注内容

系统按该设置存储数据，导入文件中填写的信息被覆盖

字段Href：可设置为网址，在数仓数据中点击可跳转至该网址，举例说明：

将字段“来访店铺”该字段设置为百度网址

正常录入/导入数据后，该字段内容会添加超链接

点击可跳转至设置的网址

校验规则：录入数据的校验规则，举例说明：

将字段“联系方式”的校验规则设置为“手机号”

则在系统中录入数据时，如该字段的格式不符合手机号的规则，会弹出如下错误提示

校验必填：校验该字段是否填写

勾选：在系统中新增数据时，如不填写无法提交

导入文件中如该字段未填写，无法导入

不勾选：不校验该字段

举例说明：“城市”字段勾选了校验必填，在系统中录入数据或导入文件时，如该字段未填写，无法提交/导入

权限关联：如需根据用户进行数据隔离，需勾选权限关联，同时设置“字典配置”

字典配置：控件类型选择下拉框或勾选权限关联时，需设置

设置完成后，系统会根据当前登录用户的系统权限，对数据源进行：筛选列示、录入枚举筛选、查询选框枚举筛选、数据导入的卡控

目前支持的卡控维度：公司主体、部门、客户、供应商，如对多个数据权限卡控限制，当前登录用户可见的数据范围为所有卡控的交集。

公司主体：登录用户拥有当前主体的权限

部门：登录用户拥有当前主体下此部门的权限

客户：登录用户拥有权限的公司主体下存在此客户

供应商：登录用户拥有权限的公司主体下存在此供应商

5、主表、附表的设置

（1）主表

除“表类型”选择"主表“外，其他与单表的设置方法相同

（2）附表

表类型：

选择附表时，还需设置关联方式，可选：一对一、一对多

示例1：附表设置为一对一时，数仓表单如下图所示：

示例2：附表设置为一对多时，还需设置序号，即附表列示的顺序，举例说明：

合同附表1序号设置为1

合同附表2序号设置为2

则合同表单如下图所示：

附表关联至主表：

附表需要额外添加1行，将附表关联至主表，如下图所示：

设置方法如下：

“字段备注”：设置为固定值“主表id”

主表名：填写对应主表的“表名”

主表字段：填写固定值“id”

6、提交

设置数仓表单相关参数后，点击“提交”

（二）复制表单

勾选需要复制的表单后（单选），点击"复制表单"

在弹出界面设置表单名称后，点击“提交”

复制后的表单，需要同步数据库，如下图所示：

（三）同步数据库

提交表单后，该表单的“同步数据库”状态为“未同步”，此时表单尚未创建完成，如下图所示：

1、设置方法

点击表单所在行右侧的“同步数据库”

选择“强制同步”后，点击“确定”

在弹出界面点击“确定”，表单创建完成

2、同步方式

数据库同步方式有两种：强制同步、普通同步

强制同步：会在修改表单的同时清空该表单的所有数据

普通同步：选择普通同步，会在修改表单的同时保留该表单的所有数据

（1）创建表单后首次同步

必须选择“强制同步”才能创建表单成功

（2）该数仓已有数据的情况下同步

A、修改的字段仅涉及非关键信息

如：表单显示、列表显示、是否查询、查询方式

可选择“普通同步”，即可实现在保留系统现有数据的同时，对表单进行修改

B、修改的字段涉及关键信息

如：字段备注、字段类型、控件类型

最好先将系统中的数仓数据导出备份，然后再点击“强制同步”更新表单后，重新上传数据

如点击“普通同步”，可能因为已导入的数据与表单字段关键信息不一致，导致无法生成凭证

注意：强制同步删除数仓数据时，数据对应的凭证也会删除

（四）表单配置

设置表单标题行、尾部行范围，确认数据导入范围，设置方法如下：

点击数仓表单所在行右侧的“表单配置”

在弹出界面设置标题行、尾部行数后，点击“提交”

数据标题所在行行号：不设置，默认=1，即第1行是标题，第2行是数据，从第1行开始导入

举例说明：如存在复合标题，前3行是标题，第4行是数据，设置为3

忽略尾部几行：不设置，默认=0，即标题行下的所有数据内容均导入

举例说明：如在正式数据下，还存在1行合计+1行情况说明，设置为2

（五）功能测试

点击数仓表单所在行右侧的“功能测试”，即可进入表单进行查看、测试

（六）添加菜单

表单创建完成后，并不能在菜单栏找到该表单，还需要添加菜单，操作方法如下：

点击数仓表单所在行右侧的“添加至菜单”

在弹出界面点击“好的”

注销账号重新登录

即可在“数据仓库-数据源数仓”下看到该数仓表单名称

（七）下载接口文档

如需下载该表单的接口文档，点击点击数仓表单所在行右侧的“接口文档”

四、特殊说明事项

（一）视图

1、适用场景

数仓涉及N个报表，且这N个报表与科目映射表之间有相当复杂的匹配逻辑，无法直接通过映射表取数

2、实施步骤

（1）数仓配置N个报表的表单

（2）

SQL写视图，命名为ABC视图

（3）

数仓配置视图虚拟表单

注意：字段名称必须与SQL里的别名一致、必须有1个字段是“原表名”、填写视图名称、接口兼容编辑选择是

（4）

上述N个报表的表单：补充视图名，与视图绑定

（5）数仓凭证生成配置：表单选ABC视图对应的虚拟表单

（6）上述N个报表上传数据（视图ABC是虚拟表单，无法上传、查看数据）

（7）生成凭证

哪些数据生成凭证，只能在上述N个报表里查看

，如配置凭证生成配置时：

上述N个表单作为数据源的凭证生成配置1，同时ABC视图作为数据源的凭证生成配置2

在上述N个表单：勾选数据生成凭证，只按配置2生成（即：视图生成凭证优先级更高）

在数仓凭证生成配置：勾选配置生成凭证，如同时勾选1、2，则1条数据会生成2个凭证（不区分优先级，都生成）

（二）数仓权限设置

1、设置页面控件权限

在系统管理-菜单管理列表页，点击“数据仓库”下“配置”或“数仓权限”所在行的“页面控件权限”

点击“操作录入”

在弹出界面设置设置页面控件名称、页面控件编码后，点击“提交”

常用的页面控件信息如下：

2、设置角色权限

在基础设置-组织管理-角色管理中，设置相关权限。角色同时拥有配置权限、数仓权限时，以配置权限进行控制。

点击需设置权限的角色所在行的“权限设置”

在弹出界面，点击数据仓库下的“配置”或“数仓权限”后，在“页面控件权限规则”区域勾选需要设置的权限后，点击保存