O2OA提供的数据管理中心,可以让用户通过配置的形式完成对数据的汇总,统计和数据分组展现,查询和搜索数据形成列表数据展现。也支持用户配置独立的数据表来适应特殊的业务的数据存储需求。本文主要介绍如何在O2OA中配置导入模型。
一、先决条件
1、O2Server服务器正常运行,系统安装部署请参考文档《如何在服务器上安装部署O2OA》。
2、以拥有管理员权限或拥有数据中心管理员(QueryManager角色)的用户账号登录O2OA(翱途)开发平台,如:xadmin。
V6.2版本中,O2OA增加了导入模型配置。
导入模型可以让开发者通过配置,实现用户导入Excel数据到系统中,形成内容管理文档、流程管理工作和自建表数据的功能。同时系统还支持自动生成导入模板提供用户下载。
点系统的左上角图标->应用->数据中心平台->具体应用->导入模型打开
先打开之前创建的数据中心应用。
点击导航上的“导入模型”,再点击“新建图标”就可以创建数据表了:
在界面上有四栏,左边是本应用的所有数据表列表;中间上部分是Excel列对应字段配置区,中间下部分是计算字段的配置区;右上是Excel字段选择区,右下是属性配置区。
配置项 | 内容 | 说明 |
标识 | 视图ID | 系统自动生成 |
名称 | 视图名称 | |
别名 | 视图别名 | |
导入目标 | 内容管理数据 | Excel每行生成一条内容管理文档(document) |
自建表数据 | Excel每行生成一条自建表数据 | |
流程平台数据 | Excel行生成一条流程工作(work) | |
选择分类 | 导入到选择的内容管理分类 | |
选择自建表 | 导入到选择的自建表 | |
选择流程 | 导入到选择的流程 | |
cms文档属性 | 文档类型 | 文档documentType字段 |
文档创建者 | 文档creatorIdentity字段,必须导入身份,可以设置为导入时操作人的身份,或者设置为导入字段的值。 | |
发布时间 | 文档publishTime字段,可以设置为导入时间为发布时间,或者设置为导入字段的值。 | |
标题 | 文档title字段,可以设置为导入字段的值。 | |
摘要 | 文档summary字段,可以设置为导入字段的值。 | |
流程work属性 | 流程状态 | 导入后工作所在的节点,可以选择起草节点(第一个人工节点)或结束节点。 |
流程发起人 | 工作的creatorIdentity字段,必须导入身份,可以设置为导入时操作人的身份,或者设置为导入字段的值。 | |
标题 | 工作的title字段,可以设置为导入字段的值。 | |
指定表单(流程状态结束时有效) | 工作的表单 | |
序号/文号(流程状态结束时有效) | 工作的serial字段 | |
开始日期(流程状态结束时有效) | 工作的startTime字段 | |
结束日期(流程状态结束时有效) | 工作的completedTime字段 | |
启用校验 | 如果不启用,导入的时候前台会进行比较要的校验:关键字段(带星号字段)是否已经填写或者长度符合系统大小。 如果启用,导入的时候前台除了上述校验,还会校验字段类型,组织对象的值在平台中是否存在,以及不能为空字段(设置为不允许为空的字段)校验。 | |
可执行者 | 可执行人 | 允许执行本导入模型的人员 |
执行组织 | 允许执行本导入模型的组织 |
Excel表格中每行每列的值可以对应平台的一个业务数据。Excel列对应字段进行字段和Excel表格的对应关系的配置。如下图所示:
配置项 | 内容 | 说明 |
字段标题 | Excel第一行的文字,必填。 | |
字段路径 | 对应平台中的业务字段,如果有多层路径,可以用点号(.)隔开,比如 | |
组织对象 | 如果该列对应的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文档属性 | 是否作者 | 如果是内容管理文档,该列导入人员/组织/群组是否有权限编辑 |
是否读者 | 如果是内容管理文档,该列导入人员/组织/群组是否有权限阅读 |
有些字段在Excel不能直接列出,需要在导入的时候根据导入的内容进行计算,这个时候可以用到“计算字段”。
配置项 | 内容 | 说明 |
字段标题 | 选填。 | |
字段路径 | 对应平台中的业务字段,如果有多层路径,可以用点号(.)隔开,比如datatable.0.textfield | |
值脚本 | 可以根据导入数据计算出额外的字段值。 需要通过return返回字段值。 可以通过this.target;获取当前导入行的数据,如下:{ "importedData" : {}, //导入的原始数据 "data" : {}, //系统根据配置生成的业务数据 "document" : {}, //如果导入CMS文档,系统生成的文档数据 "work" : {}, //如果导入流程work,系统生成的工作数据 }; 样例:
| |
CMS文档属性 | 是否作者 | 如果是内容管理文档,该列导入人员/组织/群组是否有权限编辑 |
是否读者 | 如果是内容管理文档,该列导入人员/组织/群组是否有权限阅读 |
配置完成后,可以点击“预览”按钮进行导入,并查看效果。
效果如下:
导入详情页:
参见api http://release.o2oa.net/api/module-importer.html#.upload
参见api http://release.o2oa.net/api/module-importer.html#.downloadTemplate
可以在内容管理表单、流程管理表单或门户页面中嵌入数据导入组件。
http://{hostip}/x_query_assemble_surface/jest/index.html
以上是对导入模型开发的介绍,希望对您有帮助。如果您想进一步了解数据中心的其他设计元素,可以查看以下文章:
上一篇:数据中心-自定义数据表