系统环境:win10开发
电子签章第三方服务:契约锁
1、第三方私有云安装说明(具体说明查看《安装指南PDF》):
- 安装jdk1.8
- MySQL数据库
- 启动第三方服务,启动路径为/bin/start.bat
- 启动服务后http://localhost:9180 登陆后进行私有云license申请,申请完成需要企业认证,认证完成后,生成MySQL依赖库文件
- 具体操作需要看契约锁提供的安装指南.PDF
-
具体查看私有云系统操作手册.doc及安装程序升级指南.doc
关闭程序路径为\bin\stop.bat双击即可
启动程序路径为\bin\start.bat双击即可
2、二次开发接口说明
3、二次开发程序配置项说明及部署
针对公司开发系统配置进行说明
- 配置说明
-
档案系统相关配置情况
1.前台配置中增加:"qysUrl":"http://192.0.0.0:9182"具体为部署契约锁的IP,端口为契约锁固定端口
2.后台配置说明:发布程序中xmlfile文件夹中有个qys.xml 具体注释已存在在xml中,修改以下几处即可,其他为默认值
<![CDATA[后台地址]]>
<ip>http://192.168.00.0:9182</ip>
<![CDATA[单点登录地址]]>
<vueUrl>http://192.168.00.0:9180/chop/electronic?singlesign=true@hide_menu=true</vueUrl>
<![CDATA[业务id]]>
<uniqueId>31231323</uniqueId>
<![CDATA[AES密钥与契约锁配置保持一致]]>
<key>day</key>
<![CDATA[契约锁集成管理应用token]]>
<appToken>hh</appToken>
<![CDATA[契约锁集成管理应用密钥]]>
<appSecret>cc</appSecret>
<![CDATA[数据库名称]]>
<datatable>server=192.168.00.00;userid=root;pwd=root;port=3306;database=qiyuesuodb;sslmode=none;</datatable>
前台界面操作流程详看契约锁电子签章功能说明.doc
后台配置项如下:
首先页面嵌入需绑定域名及IP地址
配置如下-----(契约锁后台http://localhost:9181/)
如果多个地址引用,那么需要逗号间隔,配置好后,需要重启契约锁服务,成功配置完成,在档案系统中会展示如下界面信息
- 后台集成代码逻辑说明
- 档号章签署说明(针对档案类型进行盖章)
- 盖章配置规则如下(每一个档案类型需要设定一个章面,章面信息从印章中设置)
关联印章界面如下
选定章面后,可设定签章位置,数据、颜色等信息。
自动获取和自定义获取概念说明
自动获取,根据章面奇数行的题头找到对应信息
自定义,在偶数行选定要对应的数值列,通过代码自动绑定相应数据
归档章签署:
如果文件已经签署过,再次点击签署按钮,会给出提示本次如何签署
跳过是指跳过该条数据进行其他数据的签署,覆盖则是针对条目下的电子件进行重复签署,覆盖上一次签署的数据文件。
-
未签署过的数据进行第一次签署,找出指定电子文件进行电子盖章,所盖印章为印章档号章设置的该档案类型的固定印章。
-
覆盖:找出原始文件再进行盖章操作,新创建的电子件为d_efile表的正式文件,F3指定原电子件syscode,源文件状态为-1。
利用章签署,利用章一般为公章
可不指定档案类型,如不指定档案类型,则所有档案类型公用同一印章,如有档案类型特殊指定,则按该档案类型下的章进行签署。 -
签署时自动弹出基础配置界面
-
利用章签署
签署界面基本相同,但是章面需要设置,设置界面如下:
关联档案类型可以不设置,不设置代表所有档案类型都使用该利用章的章面,如果有特别设定的,那么将特别的档案类型进行单独设定即可。
下面为实现逻辑,实施人员可跳过观看。
-
在档号章签署之后进行再次盖章,盖章文件为档号章文件,签章后的文件存入新表d_efile_sign_xxx中,后期其他业务的签章数据也存在此处。
签署成功后,可查看签章文件,签章成功的文件小于1个,则不展示签章文件标签。
签署文件需在该条数据下记录当前批次,针对批次进行查看签署文件。
具体签署原理(推送中签署的数据,不会影响正式数据中的电子件,每推送一次则只针对这一推送批次生成相关文件)
生成签署批次记录
找出该文件下的电子件,并对该文件进行日志记录,对电子件进行逐一创建合同文档(将本地文件以base64进行传输给契约锁)
电子件创建合同文档成功后,将该文件下所有电子件进行创建合同(给定合同名称,创建合同)
根据合同id和每个电子件生成的创建合同文档id,进行静默签署(对上传的文件进行盖章操作,具体盖章位置,相对签署位置通过1024*768计算,具体数值从前台传入,传入相关字段赋值必不可少)
静默签署成功后,将盖有印章的签署文件下载到本地,并生成对应文件,如果多次签署,只留一份正式转换的文件。
修改d_file表中数据F70签署状态1成功F71合同IDF72签章成功个数F73所属业务类别,对应s_electronic_type的type
Efile表F3源文件id值F4合同文档IDF6签章成功状态
以上所有操作都有对应操作记录,记录在s_electronic_process_log表中父级关联s_electronic_log