致远OACIP业务数据集成-表单与公文数据交换

一、业务数据集成架构

二、数据交换模式

2.1 单向同步

适用场景：从第三方系统获取数据到OA，如ERP凭证同步到OA。

2.2 双向同步

适用场景：OA和第三方系统数据互相同步，如合同数据双向同步。

2.3 事件驱动

适用场景：基于事件触发的数据同步，如流程审批完成后同步到ERP。

三、表单数据集成

3.1 表单数据流向

3.2 表单数据集成流程

3.3 表单字段映射

映射配置：

第三方字段	OA表单字段	字段类型	转换规则
order_no	orderNo	文本	直接映射
order_date	orderDate	日期	格式转换
amount	amount	数值	单位转换
status	status	枚举	枚举值映射

映射示例：

{
    "mapping": [
        {"source": "order_no", "target": "orderNo", "type": "string"},
        {"source": "order_date", "target": "orderDate", "type": "date", "format": "yyyy-MM-dd"},
        {"source": "amount", "target": "amount", "type": "number", "converter": "yuan_to_fen"},
        {"source": "status", "target": "status", "type": "enum", "map": {"0": "草稿", "1": "审批中", "2": "已完成"}}
    ]
}

3.4 表单创建接口

请求地址：/seeyon/rest/cip/form/create

请求方式：POST

请求参数：

参数	类型	说明
appCode	string	应用编码
appKey	string	应用密钥
formTemplateId	string	表单模板ID
data	object	表单数据（JSON格式）
creatorId	string	创建人ID

响应参数：

参数	类型	说明
success	boolean	是否成功
message	string	提示信息
formId	string	表单ID

四、公文数据集成

4.1 公文数据流向

4.2 公文类型

公文类型	说明
收文	外部单位发来的文件
发文	本单位发出的文件
签报	内部请示报告

4.3 公文数据集成流程

4.4 公文创建接口

请求地址：/seeyon/rest/cip/document/create

请求方式：POST

请求参数：

参数	类型	说明
appCode	string	应用编码
appKey	string	应用密钥
documentType	string	公文类型（收文/发文/签报）
title	string	公文标题
content	string	公文内容
sender	string	发文单位
receiver	string	收文单位
createTime	datetime	创建时间

响应参数：

参数	类型	说明
success	boolean	是否成功
message	string	提示信息
documentId	string	公文ID

五、DEE数据交换平台

5.1 DEE架构

5.2 DEE核心组件

数据读取器：

读取器类型	说明
数据库读取器	从数据库表/视图读取数据
API读取器	从REST API读取数据
文件读取器	从文件（CSV/XML/JSON）读取数据
队列读取器	从消息队列读取数据

数据转换器：

转换功能	说明
字段映射	源字段到目标字段的映射
格式转换	日期、数值、字符串格式转换
数据过滤	根据条件过滤数据
数据聚合	多表数据聚合

数据写入器：

写入器类型	说明
数据库写入器	写入数据库表
API写入器	调用REST API写入数据
文件写入器	写入文件
队列写入器	写入消息队列

5.3 DEE作业配置

作业配置流程：

调度策略：

调度类型	说明
定时调度	按固定时间间隔执行
事件调度	基于事件触发执行
手动调度	手动触发执行

六、数据监控与异常处理

6.1 监控指标

指标	说明
执行状态	运行中/成功/失败/暂停
处理数量	已处理的记录数量
成功数量	成功处理的记录数量
失败数量	处理失败的记录数量
执行时间	作业执行耗时
数据延迟	数据从源到目标的延迟时间

6.2 异常处理机制

6.3 异常快照

异常发生时，系统会自动保存异常快照：

快照内容	说明
原始数据	处理失败的原始数据
错误信息	具体的错误描述
时间戳	异常发生时间
重试次数	已重试次数

6.4 报文重发

支持报文重发功能，确保数据最终一致性：

七、数据集成配置步骤

7.1 配置流程图

7.2 详细配置步骤

第一步：产品登记和应用注册

参考《02-CIP应用接入指南：产品登记与应用注册》。

第二步：数据源配置

参数	说明	必填
数据源名称	数据源标识	是
数据源类型	数据库/API/文件/队列	是
连接信息	根据类型配置	是

第三步：数据读取器配置

参数	说明	必填
读取器名称	读取器标识	是
数据源	选择已配置的数据源	是
读取规则	SQL查询/API参数/文件路径	是

第四步：字段映射配置

参数	说明	必填
源字段	数据源中的字段	是
目标字段	OA表单/公文字段	是
字段类型	文本/数值/日期/枚举	是
转换规则	格式转换/枚举映射	否

第五步：数据写入器配置

参数	说明	必填
写入器名称	写入器标识	是
目标系统	OA表单/公文/第三方系统	是
写入规则	接口地址/表名	是

第六步：调度策略配置

参数	说明	必填
调度类型	定时/事件/手动	是
调度频率	执行间隔	定时调度必填
触发事件	触发条件	事件调度必填

第七步：作业测试

运行测试作业，验证数据集成是否正常。

第八步：上线运行

确认测试通过后，启用作业正式运行。

八、数据集成最佳实践

8.1 数据格式规范

8.2 数据一致性保障

保障措施	说明
事务处理	使用数据库事务保证数据一致性
幂等性	确保重复执行不会产生副作用
数据校验	在数据转换前进行校验
日志记录	记录完整的执行日志

8.3 性能优化

8.4 安全策略

安全项	建议
数据加密	敏感数据传输加密
访问控制	限制接口访问权限
数据脱敏	敏感字段脱敏处理
审计日志	记录数据访问日志

九、常见问题

9.1 数据同步失败

现象：数据同步任务执行失败

排查步骤：

检查项	说明
日志查看	查看DEE平台执行日志
数据源连接	检查数据源连接是否正常
字段映射	检查字段映射是否正确
数据格式	检查数据格式是否符合要求

9.2 数据重复

现象：OA中出现重复数据

排查步骤：

检查项	说明
主键冲突	检查主键是否重复
去重逻辑	检查是否有去重逻辑
幂等性	检查接口是否支持幂等性

9.3 数据延迟

现象：数据同步存在延迟

排查步骤：

检查项	说明
调度频率	检查调度频率是否合理
网络延迟	检查网络连接状态
处理性能	检查数据处理性能
队列积压	检查消息队列是否积压

9.4 字段映射错误

现象：部分字段数据不正确

排查步骤：

检查项	说明
字段类型	检查字段类型是否匹配
转换规则	检查转换规则是否正确
枚举映射	检查枚举值映射是否正确
日期格式	检查日期格式是否正确