数据中心-导入模型设置-数据视图与统计-O2OA企业应用开发平台-人人都是协同系统开发专家

数据中心-导入模型设置

时间：2022-08-03

O2OA提供的数据管理中心，可以让用户通过配置的形式完成对数据的汇总，统计和数据分组展现，查询和搜索数据形成列表数据展现。也支持用户配置独立的数据表来适应特殊的业务的数据存储需求。本文主要介绍如何在O2OA中配置导入模型。

一、先决条件

1、O2Server服务器正常运行，系统安装部署请参考文档《如何在服务器上安装部署O2OA》。

2、以拥有管理员权限或拥有数据中心管理员（QueryManager角色）的用户账号登录O2OA(翱途)开发平台，如：xadmin。

二、导入模型简介

V6.2版本中，O2OA增加了导入模型配置。

导入模型可以让开发者通过配置，实现用户导入Excel数据到系统中，形成内容管理文档、流程管理工作和自建表数据的功能。同时系统还支持自动生成导入模板提供用户下载。

N_Q}HR8)XF6)K}J}}(04$)J.png

三、功能入口

点系统的左上角图标->应用->数据中心平台->具体应用->导入模型打开

3U85JQ}`L%UP]C[@]9VT$XN.png

四、创建导入模型

先打开之前创建的数据中心应用。

点击导航上的“导入模型”，再点击“新建图标”就可以创建数据表了：

$$9W{A9_B5$98E5FY)CK1[YE.png$

在界面上有四栏，左边是本应用的所有数据表列表；中间上部分是Excel列对应字段配置区，中间下部分是计算字段的配置区；右上是Excel字段选择区，右下是属性配置区。

QQ图片20210723142712.png

1、导入模型设置项

配置项	内容	说明
标识	视图ID	系统自动生成
名称	视图名称
别名	视图别名
导入目标	内容管理数据	Excel每行生成一条内容管理文档(document)
	自建表数据	Excel每行生成一条自建表数据
	流程平台数据	Excel行生成一条流程工作(work)
选择分类		导入到选择的内容管理分类
选择自建表		导入到选择的自建表
选择流程		导入到选择的流程
cms文档属性	文档类型	文档documentType字段
	文档创建者	文档creatorIdentity字段，必须导入身份，可以设置为导入时操作人的身份，或者设置为导入字段的值。
	发布时间	文档publishTime字段，可以设置为导入时间为发布时间，或者设置为导入字段的值。
	标题	文档title字段，可以设置为导入字段的值。
	摘要	文档summary字段，可以设置为导入字段的值。
流程work属性	流程状态	导入后工作所在的节点，可以选择起草节点（第一个人工节点）或结束节点。
	流程发起人	工作的creatorIdentity字段，必须导入身份，可以设置为导入时操作人的身份，或者设置为导入字段的值。
	标题	工作的title字段，可以设置为导入字段的值。
	指定表单（流程状态结束时有效）	工作的表单
	序号/文号（流程状态结束时有效）	工作的serial字段
	开始日期（流程状态结束时有效）	工作的startTime字段
	结束日期（流程状态结束时有效）	工作的completedTime字段
启用校验		如果不启用，导入的时候前台会进行比较要的校验：关键字段（带星号字段）是否已经填写或者长度符合系统大小。如果启用，导入的时候前台除了上述校验，还会校验字段类型，组织对象的值在平台中是否存在，以及不能为空字段（设置为不允许为空的字段）校验。
可执行者	可执行人	允许执行本导入模型的人员
可执行者	执行组织	允许执行本导入模型的组织

2、创建Excel列对应字段

Excel表格中每行每列的值可以对应平台的一个业务数据。Excel列对应字段进行字段和Excel表格的对应关系的配置。如下图所示：

VSB0(AQJ9LFD}GCOM}NVHL4.png

3、Excel列设置设置项

QQ图片20210723141838.png

配置项	内容	说明
字段标题		Excel第一行的文字，必填。
字段路径		对应平台中的业务字段，如果有多层路径，可以用点号(.)隔开，比如`datatable.0.textfield`
组织对象		如果该列对应的org组件字段，比如人员、身份、组织、群组等。那么将该列设置为“是”，系统会根据导入的值取组织管理中获取数据进行校验，并且生成组织对象，如： { "distinguishedName": "张三@c8f7ff61-1906-4a3f-bddb-f5ef7ecc9e1d@I", "id": "c8f7ff61-1906-4a3f-bddb-f5ef7ecc9e1d", "name": "张三", "person": "张三@zhangsan@P", "unit": "开发部@kfb@U", "unitLevelName": "兰德纵横/开发部", "unitName": "开发部" }
字段类型		平台中的字段类型，多值（如stringList类型）可以在单元格用换行、半角分号（;）、半角逗号（,）隔开。
换行符		当字段类型配置为string的时候，会把excel单元格的回车（）替换成配置的换行符，否则替换成空字符串。
校验	允许空值	该列是否允许为空
校验	校验字段类型	如，字段类型为number,那么导入的时候会判断值是否为数字。
CMS文档属性	是否作者	如果是内容管理文档，该列导入人员/组织/群组是否有权限编辑
CMS文档属性	是否读者	如果是内容管理文档，该列导入人员/组织/群组是否有权限阅读

4、计算字段设置

有些字段在Excel不能直接列出，需要在导入的时候根据导入的内容进行计算，这个时候可以用到“计算字段”。

QQ图片20210723152457.png

配置项	内容	说明
字段标题		选填。
字段路径		对应平台中的业务字段，如果有多层路径，可以用点号(.)隔开，比如datatable.0.textfield
值脚本		可以根据导入数据计算出额外的字段值。需要通过return返回字段值。可以通过this.target;获取当前导入行的数据，如下：{ "importedData" : {}, //导入的原始数据 "data" : {}, //系统根据配置生成的业务数据 "document" : {}, //如果导入CMS文档，系统生成的文档数据 "work" : {}, //如果导入流程work，系统生成的工作数据 }; 样例： `return this.target.data.date+ " " + this.target.data.time`
CMS文档属性	是否作者	如果是内容管理文档，该列导入人员/组织/群组是否有权限编辑
CMS文档属性	是否读者	如果是内容管理文档，该列导入人员/组织/群组是否有权限阅读