集成平台

# 插件功能说明

插件名称为【盖章设备集成】。

1695708692006.png

# 组织机构同步

OA主动推送组织机构信息到群杰系统。 1、每次重启时执行一次全量同步。 2、单位、部门、人员在增删改时，会执行单条记录同步。通过监听事件实现的。

# 印章拉取

1695708754728.png

  • 查看印章列表画面 1695708789212.png

OA主动拉取群杰印章列表到OA。

群杰印章开启后，会在【枚举管理】-【公共枚举】下创建一个【印章设备】的分类，并在该分类下 创建【群杰印章设备】和【非群杰印章设备】两个分类。 如果SeeyonConfig中【qunje.running】配置项配置了【立即执行】，重启时就会执行印章同步， 后面则会定时同步。 定时同步的频率通过SeeyonConfig中【qunje.period】配置项进行修改。

# 用印申请

OA主动发起用印申请到群杰系统。

1、配置CAP4表单。 表单配置有字段名称限制。有一个标准表单可以提供现场。 2、配置业务流程集成、绑定节点事件 3、发起流程表单，审批节点提交前，发起用印申请到群杰系统。 实际调用群杰的/item/applyAuthorize接口，发起用印申请。 4、调用接口成功后，OA会在表单回写一个验证码。 OA将群杰返回的校验码(safeCode)回填到表单的【校验码】控件上。

# 用印记录回写

群杰系统回调OA的rest接口。

1、群杰系统调用OA的rest接口：/seeyon/rest/seal/rewrite,将用印信息推送给OA。 2、OA获取到用印信息后，将这些回填到表单上。 相关字段：实际用印次数、用印地址、用印状态、实际用印时间

# 用印详情

OA调用群杰系统获取用印详情。

1、用户点击表单明细表中的【用印详情】按钮。该按钮绑定了一个URL地址用以获取用印详情。 2、OA调用/file/getImageByApplyId接口，通过applyId参数获取用印图片。 3. OA打开一个新画面，展示用印图片、和表单中的其他用印信息。

# 配置步骤

# 群杰侧配置

仅供要点参考，具体操作为群杰系统实施工作，非OA实施内容。

# 1. 检查版本是否匹配

  • OA的V8.0(包括)后版本只能对接群杰的5.0版本
  • OA的V8.0之前版本只能对接群杰的3.0版本

# 2. 设置初始化组织机构

  • 群杰初始化组织机构根节点必须设置为1，这是对接双方约定好的。
  • 根节点不为1的错误效果 1695709224224.png
  • 根节点为1的正确效果 1695709253121.png

# 3. 配置OA的接口地址

  • 用印记录回写依赖群杰系统回调OA的rest接口。
  • rest接口地址：/seeyon/rest/seal/rewrite

# 4. 配置OA的rest用户名密码

  • 由OA提供给群杰后配置到群杰系统中。
  • OA-rest用户创建方式如下： 1695709306496.png

# 5. 提供群杰的接口地址和rest账户密码给OA

  • 提供可供OA服务器调用的完整接口地址，如：http://10.3.4.5:11002/api
  • 可以是内网也可以是外网，确保OA服务器可以正常请求即可。
  • 可通过curl、浏览器、postman测试接口是否正常。

# 对接参数配置

运行【{Seeyon Home}/ApacheJetspeed/conf】目录下seeyonconfig配置程序。

进入【插件参数设置】页签，设置相关参数。

1695709410268.png 1695709621316.png

# 1. 配置同步参数

  • 配置qunje.period，只跟印章同步功能相关
  • 配置qunje.running，只跟印章同步功能相关

# 2. 配置接口地址和rest账户密码

  • 配置qunje.sysUrl，由群杰提供
  • 配置qunje.restLoginName和qunje.restPWD，由群杰提供

# 3. 配置OA回调接口地址

  • 需要配置qunje.a8Url，如http://10.3.4.5:8999
  • 配置群杰服务器可访问到的OA服务地址。
  • 点击确定后，重启OA使配置生效。

# 组织机构同步

# 1. 登录集团管理员

# 2. 进入【CIP集成平台-->协同+集成插件-->智能印章集成】菜单。

# 3. 检查组织机构以及人员是否同步成功

  • 查看OA同步日志是否成功
  • 可以按姓名、类型、操作、结果、时间不同维度进行查询。 1695709746789.png
  • 登录群杰管理后台，查看组织机构是否正常
  • 如果同步成功了，继续下一步操作。
  • 如果同步未成功，请查看上一章节检查配置。

# 流程表单配置

# 1. 登录应用设计师账户，导入基础表单

  • 导入基础表单，从群杰cap4基础表单下载地址 (opens new window)下载
  • 标准表单中的所有控件都是有存在意义的，不允许修改、删除、从主表挪到明细表、从明细表挪动到主表、隐藏字段的操作，否则会造成发起流程失败。
  • 表单导入后会新建枚举，不再是对应内置的枚举项。所以明细表的印章枚举，需要重新进行绑定为插件同步产生的枚举。
  • 【校验码】控件必须设置为浏览态。
  • 如要自行配置表单，控件要求如下 1695709929598.png

# 2. 配置流程

1695710109410.png

# 3. 配置业务流程集成

依赖【业务流程集成】插件，需购买该插件才可以创建业务流程集成绑定。

  • 登录集团管理员，切换到【CIP集成平台-->业务流程集成】菜单
  • 新建一条业务流程集成 1695710158550.png
  • 关联应用，关联任意一个都可 1695710177715.png

# 4. 配置节点事件

  • 新建节点事件 1695710199147.png
  • 绑定节点事件到指定节点上 1695710214224.png
  • 绑定成功效果
  • 绑定节点事件后，该节点提交处理前就会发起用印申请到群杰系统，并授权通过后将验证码取到OA。 1695710229895.png

# 5. 配置流程事件

  • 该流程事件用于终止用印授权。如果用印申请已经提交，此时终止OA流程，会同步调用群杰的取消授权接口取消用印授权。 1695710247537.png

# 6. 点击确定保存

1695710264796.png

# 验证流程

# 1、 填写表单，发起流程

  • 每张表单不能选择重复的印章填写明细。同一印章需加盖不同文件时需要合并明细填写一行或者分成多个流程发送。
  • 是否必填说明 1695710288520.png

# 2、 提交用印申请，获取验证码

# 3、 使用验证码用印

# 4、 用印完成后，查看用印详情、用印图片

1695710330714.png 1695710334738.png

创建人：suyj

快速跳转

← 后台配置帮助文档 →