1. 部署1.1. OA插件部署
a. 停止OA服务
b. 登录数据库客户端,执行SyncDataV1.0.0 build-22081101\A8-V7.1SP1_SyncData\doc\sql\{对应数据库类型}目录下的sql脚本
c. 将程序包中的SyncData V1.0.0build-22081101\A8-V7.1SP1_SyncData目录下seeyon文件夹,覆盖到OA部署目录D:\Seeyon\A8\ApacheJetspeed\webapps下seeyon目录
d. 启动OA服务
1.2. 可视化配置程序部署
a. 建议将程序部署到与A8同级目录下,如D:\Seeyon
b. 进入D:\Seeyon\syncdata\conf目录,修改application.yml文件中的数据库配置信息:
v MySQL
driver-class-name: com.mysql.cj.jdbc.Driver
url:jdbc:mysql://127.0.0.1:3306/a8v80sp2?createDatabaseIfNotExist=true&useSSL=false
database-platform: org.hibernate.dialect.MySQL5InnoDBDialect
v SQLServer
driver-class-name: com.microsoft.sqlserver.jdbc.SQLServerDriver
url:jdbc:microsoft:sqlserver://localhost:1433;DatabaseName=demo
database-platform:org.hibernate.dialect.SQLServerDialect
注意:
如果数据库类型为SqlServer时,请到D:\Seeyon\A8\ApacheJetspeed\lib目录下复制sqljdbc42.jar到D:\Seeyon\syncdata\lib目录下
c. 修改配置文件D:\Seeyon\syncdata\conf\application.yml中的OA信息
d. 进入D:\Seeyon\syncdata\bin目录,点击startup.bat启动服务(服务端口默认为8088)
2. 数据同步配置2.1. 访问系统
在服务器上,通过浏览器访问可视化配置系统
http://127.0.0.1:8088/view/index.html2.2. OA同步三方系统的档案数据2.2.1. 档案同步配置列表
2.2.2. 新建或编辑档案同步配置
2.2.2.1. 基本信息
n 显示名称:档案数据同步的配置名称,供配置人员查看
n 主表表名:OA中无流程表单主表表名,可通过表单数据字典查看
n CRON表达式:定时任务CRON表达式,没有设置时,默认凌晨1点执行
2.2.2.2. 详细信息
档案数据同步的具体配置信息,可以配置多个接口调用
n 单个接口配置信息
u 基本信息
l 接口名称:自定义配置
l 请求地址:待调用的三方系统接口地址
l 请求方式:接口调用的方法:POST、GET等
u 请求头
待调用接口要求传入的请求头参数信息列表
l 参数名:请求头参数名
l 是否数组:当前参数的数据格式是否为数组类型
l 参数值:当前参数需要传入的常量值
l 映射字段:如果需要从OA表单中取值的,此处配置相应表单的字段名(如field0001)
注意:如果映射字段和参数值同时配置时,默认只取用映射字段对应的表单字段值
u 请求参数
待调用接口要求传入的请求参数信息列表
l 参数名:请求参数名称
l 是否数组:当前参数的数据格式是否为数组类型
l 参数值:当前参数需要传入的常量值
l 映射字段:如果需要从OA表单中取值的,此处配置相应表单的字段名(如field0001)
注意:如果映射字段和参数值同时配置时,默认只取用映射字段对应的表单字段值
u 成功标识
接口调用成功标识,用于判断当前接口调用是否成功,默认接口响应数据为JSON对象
接口响应数据格式示例:
{“success”:true,”message”:”成功”,”data”:{“datas”:[]}}
u 成功后操作
接口调用成功后的操作,支持多个操作动作的配置,如一次接口调用向多个无流程表单中写数据
l 操作名称:当前操作的名称
l 操作类型:档案同步时,选择“同步数据”
l 表类型:
n 单位:同步单位信息(多组织版本时使用)
n 部门:同步部门信息(如果是多组织版本,首次同步时需要先在A8中配置相应的单位信息)
n 人员:同步人员信息
n 表单:同步无流程表单的档案数据
l 表名称:当表类型选择表单时,录入相应的无流程表单主表表名,其他类型时可以不录入
l 数据源:接口响应的JSON数据中待处理的数据,如data.datas
接口响应数据示例:{“success”:true,”message”:”成功”,”data”:{“datas”:[]}}
l 字段映射
点击“字段映射”列中的“设置”按钮,弹出字段映射窗口
n 字段名:OA表单中的字段名(如field0001)
n 是否数组:当前参数的数据格式是否为数组类型
n 字段值:如果当前字段为常量时,请录入常量值
n 映射字段:接口响应数据中的字段名称
注意:如果映射字段和字段值同时配置时,默认只取用映射字段对应的接口数据
2.2.2.3. 数据保存
配置好相应信息后,请先点击“配置信息”窗口底部的“确定”按钮,最后点击窗口左上角的“保存”按钮,完成配置信息的保存入库
2.2.3. 档案数据同步2.2.3.1. 定时同步
配置信息中,如果配置了CRON表达式,则在满足相应条件后,自动触发任务
2.2.3.2. 手工同步
在配置信息列表中,点击相应配置信息的“执行”按钮,进行档案数据的同步
2.3. OA向三方系统推送数据
流程处理或结束后,向三方系统推送A8流程表单中的数据
2.3.1. 推送数据配置列表
2.3.2. 新建或修改配置信息
2.3.2.1. 基本信息
n 显示名称:推送数据的配置名称
n 主表表名:待处理的流程表单主表表名
n 事件类型:待监听的流程事件
2.3.2.2. 详细信息
数据推送的具体配置信息,可以配置多个接口调用
n 单个接口配置信息
u 基本信息
l 接口名称:自定义配置
l 请求地址:待调用的三方系统接口地址
l 请求方式:接口调用的方法:POST、GET等
u 请求头
待调用接口要求传入的请求头参数信息列表
l 参数名:请求头参数名
l 是否数组:当前参数的数据格式是否为数组类型
l 参数值:当前参数需要传入的常量值
l 映射字段:如果需要从OA表单中取值的,此处配置相应表单的字段名(如field0001)
注意:如果映射字段和参数值同时配置时,默认只取用映射字段对应的表单字段值
u 请求参数
待调用接口要求传入的请求参数信息列表
l 参数名:请求参数名称
l 是否数组:当前参数的数据格式是否为数组类型
l 参数值:当前参数需要传入的常量值
l 映射字段:如果需要从OA表单中取值的,此处配置相应表单的字段名(如field0001)
注意:如果映射字段和参数值同时配置时,默认只取用映射字段对应的表单字段值
u 成功标识
接口调用成功标识,用于判断当前接口调用是否成功,默认接口响应数据为JSON对象
接口响应数据格式示例:
{“success”:true,”message”:”成功”,”data”:{“datas”:[]}}
u 成功后操作
接口调用成功后的操作,支持多个操作动作的配置,如一次接口调用向多个无流程表单中写数据
l 操作名称:当前操作的名称
l 操作类型:数据推送时,选择“回写表单”
l 表类型(请选择表单):
n 单位:同步单位信息(多组织版本时使用)
n 部门:同步部门信息(如果是多组织版本,首次同步时需要先在A8中配置相应的单位信息)
n 人员:同步人员信息
n 表单:同步无流程表单的档案数据
l 表名称:当表类型选择表单时,录入相应的无流程表单主表表名,其他类型时可以不录入
l 数据源:接口响应的JSON数据中待处理的数据,如data.datas
接口响应数据示例:{“success”:true,”message”:”成功”,”data”:{“datas”:[]}}
l 字段映射
点击“字段映射”列中的“设置”按钮,弹出字段映射窗口
n 字段名:OA表单中的字段名(如field0001)
n 是否数组:当前参数的数据格式是否为数组类型
n 字段值:如果当前字段为常量时,请录入常量值
n 映射字段:接口响应数据中的字段名称
注意:如果映射字段和字段值同时配置时,默认只取用映射字段对应的接口数据
2.3.2.3. 数据保存
配置好相应信息后,请先点击“配置信息”窗口底部的“确定”按钮,最后点击窗口左上角的“保存”按钮,完成配置信息的保存入库
2.3.3. 数据推送
在OA中发起流程,如果数据推送配置中监听的流程事件为“流程结束事件”,则在流程结束时,触发推送流程表单数据到三方系统