电子签章安装、部署、二次开发、应用

发布时间 2023-10-24 14:58:49作者: zwbsoft

系统环境: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