# 群杰印章集成插件实施手册

本手册为V8.2之前旧版手册

1 概述 4

1.1 集成支持版本 4

1.2 核心价值 4

1.3 部署与使用流程 4

2 插件安装部署 5

2.1 基础配置 5

2.2 组织同步 6

2.3 单点登陆设置 7

3 员工操作 9

3.1 单点登陆 9

3.2 消息同步 10

3.3 业务数据同步 11

# 概述

盖章设备插件实现了 OA 发起用印申请流程，完成用印在盖章设备上的授权，并以栏目方式展现印章信息、使用情况等信息，提高效率、降低成本，实现了一体化的企业内部办公方案。

# 集成支持版本

A8版本：V8.0及其以上版本，群杰版本5.0

A8的8.0以下版本适配的是群杰3.0版本，升级到8.0后，则需使用群杰5.0，原有集成全部作废，需要按此文档重新适配。

# 核心价值

为协同平台引入智能印章管理功能，促进企业整体能力和效率的持续提升。

# 部署与使用流程

# A8端插件安装部署

# 基础配置

【操作人】系统管理员。

运行"{A8Home}/ApacheJetspeed/conf"下seeyonconfig配置程序。打开【A8 应用配置器】，进入【插件参数设置】页签，设置相关参数后，重启A8。见图参数配置说明：

[]{#_Toc42179407 .anchor}{width="6.0in" height="5.3493055555555555in"}

参数说明

名称值

qunje.period 印章设备同步周期；每5分钟、每小时、每天等

qunje.a8Url 群杰盖完章回调A8的地址。尽量填ip端口的格式（而不是域名的格式），一般和intertnet.sit.url参数一致，特别注意，最后不能有/。错误示例：http://192.168.10.225/

qunje.restLoginName 群杰接口访问授权用户（注意是群杰系统的rest账号，不是A8的rest账号，去跟群杰人员要）

qunje.restPWD 群杰接口访问授权用户密码

qunje.running 印章设备同步是否立即执行；立即执行、下一周期执行

qunje.sysUrl 盖章设备系统部署的接口地址（应该是群杰地址加上api，比如：http://127.0.0.1:88/api，注意最后没有/）

注意事项：

需要配置 intertnet.sit.url
需要开启Rest插件
使用盖章设备插件前请先确认 OA 加密狗中包含盖章设备插件
完成以上所有参数的配置插件才能启动

配置OA的外网地址，是群杰可访问的OA地址，群杰用印完后，将调用该地址回传A8信息。

{width="6.0in" height="5.246527777777778in"}

# 组织同步

系统自动在启动或组织变更时，同步部门、人员信息到群杰系统。注意群杰系统中根单位的id必须等于1。才会在id=1的单位下面同步组织结构

# 存在历史数据的组织机构同步

对于存在历史数据的环境，环境启动时将读取系统中的部门、人员数据调用群杰新增接口，对数据进行同步，同时将调用新增接口后的情况记录到同步日志中已方便查询同步结果。

# 无数据情况的组织机构同步

对我们系统的新增、修改、删除进行监听；在部门、人员信息进行操作后将最新的信息同步到群杰系统中。

注：应群杰要求，A8中人员的手机号必填，否则同步不成功。

# 同步日志查询

记录同步结果，提供删除、按姓名、类型、操作、结果、时间进行查询。

{width="6.75in" height="3.25in"}

# 印章同步

系统根据基础设置，自动同步连接的群杰智能印章平台的所有印章到A8枚举中。

通过qunje.running、qunje.period两个参数设置群杰系统中的印章设备向 OA 系统同步。可选启动时立即执行、和下一周期执行。而同步周期可选择每5分钟、每小时、每天等。

印章设备同步到 OA 系统中作为公共枚举：盖章设备，供印章审批流程表单使用。为了兼容非群杰用章场景，印章设备枚举设置为2级枚举。

同步时，会自动根据群杰系统的印章设备维护 OA 系统的盖章设备枚举值得启用、停用状态。

{width="6.772222222222222in" height="3.3027777777777776in"}

# 印章申请表单流程制作

向cip部门申请表单，给潘峰发协同即可，注明项目名称。

表单中的所有字段，不可改，不可删，可以新增，位置可调整（但是主表字段不能挪到重复表中，重复表的也不能挪到主表中）。

因为cap4导入后会新建枚举，不再是对应内置的枚举项，所以表体的印章枚举，需要重新进行绑定为系统内置的枚举，详见2.3章节的枚举项。

{width="5.408333333333333in" height="2.3333333333333335in"}

# 用印集成流程设置

【操作员】：集团管理员（集团版）/单位管理员（企业版）

流程需包含一个审批节点，审批不通过则流程接收；审批通过则向群杰系统提交用印授权，同时生成用印校验码回写到表单中，所以审批节点的下一节点需为实际用印人，实际用印人通过用印校验码使用群杰的盖章设备。

注意：审批节点印校验码元素必须设置为不可编辑。
前提约束：必须有"业务流程集成"插件授权。
- 第一步：登陆流程集成平台

集团管理员/单位管理员（以下简称管理员）登陆系统，选择CIP集成平台下的业务流程集成菜单。

{width="3.575in" height="1.9583333333333333in"}

第二步，新建业务分类。
第三步，在新建的业务分类下新建集成业务。

{width="3.1666666666666665in" height="2.7416666666666667in"}

窗体顶端

集成业务定义中表单流程模板名称选择对应的用印申请表单。

第四步，添加关联应用

选择任意一个注册应用，其中集成类型选择：V5推送第三方应用

{width="3.8583333333333334in" height="2.1333333333333333in"}

第五步：用印审批同步事件绑定

创建节点事件-用印审批推送事件：其中事件类型选择"处理前"，处理方式选择"扩展类"，处理名称从下拉列表中选择"群杰印章集成-审批前事件"

{width="6.772222222222222in" height="3.279861111111111in"}

绑定用印申请同步事件到指定节点

{width="6.772222222222222in" height="3.277083333333333in"}

{width="6.772222222222222in" height="4.565277777777778in"}

第六步，创建流程终止事件

创建流程事件-用印终止事件：其中事件类型选择"终止后"，处理方式选择"扩展类"，处理名称从下拉列表中选择"群杰印章集成-用印终止后事件"

{width="6.772222222222222in" height="3.2743055555555554in"}

CAP3与CAP4均可设置节点事件。

注意事项：实际用印人在 OA 系统中必须设置手机号码，否则审批不能通过。

# 群杰回调设置

# A8发布群杰Rest账号

创建rest帐号供群杰使用，实现实际用印次数、时间信息的回写表单。

将创建的rest帐号、密码给群杰
配置群杰回调A8系统地址（也就是A8自身地址），该地址会传给群杰，供群杰回传调用。
实施中往往出现用印次数等没有回写的情况，由于是群杰调用A8接口，**该问题需联系群杰进行初步解决，起码给出回调的url，有无具体什么异常。**若群杰那没问题，则在A8中ctp日志里搜索qunjerest关键字，如果没搜到，就是没收到群杰的消息。

{width="5.159722222222222in" height="3.1458333333333335in"}