天印签章系统技术白皮书V2.0

1、天印签章系统技术白皮书00天印签章系统 pdf 版技术白皮书version 杭州天谷信息科技有限公司2014 年 3 月天印签章系统技术白皮书11文档修改记录序号修改人修改时间内容说明1蒋淑红2013-7-18创建文档2蒋淑红2013-9-30更新版本 v3蒋淑红2013-10-31更新版本 v4蒋淑红2013-11-20更新版本 v5蒋淑红2013-12-11更新版本 v6蒋淑红2014-3-28更新版本 v保密声明本文档包含杭州天谷信息科技有限公司的专用商业信息和保密信息。本文档保密时间为 20 年。接受方同意维护本文档所提供信息的保密性，承诺不对其进行复制，或向其他公司或个人公开此信息。

2、对于以下三种信息，接受方可不向天谷公司承担保密责任：1）可以通过其他渠道公开获得的信息；2）天谷科技承诺可公开的信息；3）已超过保密时间要求的信息。天印签章系统技术白皮书22目目 录录概述概述 .3 31.1. 产品研发背景产品研发背景 .3 32.2. 产品特点产品特点 .3 33.3. 产品组成产品组成 .4 44.4. 产品体系架构产品体系架构 .5 5中间件接口说明中间件接口说明 .6 61.1. 中间件接口概述中间件接口概述 .6 6plugin 接口属性.7plugin 接口事件.9plugin 接口函数.12更新说明更新说明 .4646附件一附件一 工具栏按钮标识索引表工具栏按钮

3、标识索引表 .5454附件二附件二 中间件操作指令表中间件操作指令表 .5656附件三附件三 右键菜单按钮标识索引表右键菜单按钮标识索引表 .5858附件四附件四 错误码索引表错误码索引表 .5959天印签章系统技术白皮书33概述概述1.1.产品研发背景产品研发背景在现实社会中，我们在办事过程中通过签字盖章的方式来确认办事人员的身份，并作为对文档确认的凭据。这种物理上签字、盖章防止假冒的有效性基础包括笔迹和法律保障。然而在网络中，办事的过程中双方是不见面的，如何解决身份认证和行为确认的问题呢？2005 年 4 月 1 日，中华人民共和国电子签名法正式生效，从法律层面上确认了“电子签名”具有和手

4、写签名相同的法律效力。而目前最为成熟的电子签名技术是“数字签名技术”。天印电子签章产品正是在以上需求及法律背景下研发的一款产品，可应用于所有网络应用，解决在网络办事过程中的签字、盖章等身份识别和行为确认的问题。在网络办事过程中应用最广的就是版式文件了，即 pdf，因此，研发天印签章系统 pdf 版应运而生。2.2.产品特点产品特点产品成熟：2004 年即开始研发，40 多万用户使用；适应性强：支持所有 ie 内核的浏览器；功能丰富：单页、多页、关键字、批量、坐标签章，骑缝章，数字水印，时间戳可开发性强：大量二次开发接口，满足绝大多数应用场景；可靠性强：支持双机热备、智能选择服务器。3.3.产品

5、组成产品组成天印签章系统pdf版天印签章pdf阅读器天印签章pdf中间件天印签章系统 pdf 版包含天印签章 pdf 阅读器和天印签章 pdf 中间件两个组件。天印签章 pdf 阅读器是运行于客户机上的一个可执行程序，是一个结合了签章功能的成熟 pdf 阅读器。天印签章 pdf 中间件提供了 ocx 和 dll 接口，可以供web 网页或其他应用程序灵活调用。天印签章系统技术白皮书444.4.产品体系架构产品体系架构其他应用程序web网页天印签章pdf中间件调用dll调用ocx天印签章pdf阅读器客户机天印签章服务器端处理部分数据库或文件系统http协议http协议天印签章系统技术白皮书55中

6、间件接口说明中间件接口说明1.1.中间件接口概述中间件接口概述天印签章 pdf中间件plugincurrentpdfpath当前打开文档本地路径currentcachepath当前打开文档缓存路径version产品版本号lasterrorcode最后的错误码errorcodeinner最后的内部错误码mergestatus合并操作的结果属性onloadurlfinish打开网络pdf文件后触发onsignfinish签章完成后触发onuploadfinish上传完成后触发onbatchsealsignfinish批量签章完成后触发onconvertfiletopdffinish文件转换后触发o

7、nsignaturedelete签章删除后触发事件loadpdf打开本地pdfloadurlpdf打开网络pdfsetremoteserver设置签章服务器地址displaytoolbutton控制工具栏按钮显示enabletoolbutton控制工具栏按钮可用性controltoolbutton控制中间件模式getcurrentpagenum获取当前页码gotopage跳转至指定页码savepdffile保存当前pdfclosecurrentdoc关闭当前pdfcontrolpdf根据指令代码执行操作addbookmark添加书签gotobookmark跳转至书签displaybookmar

8、k控制书签栏显示checkpdfissignd检查pdf是否签章checksealnum获取pdf签章个数checkpagenum获取pdf总页数verifypdf验证pdf签章有效性sign用usbkey证书签章silencesign用pfx证书签章signmu本地多个pdf批量签章并上传batchsealsign本地多个pdf批量签章keywordsign本地pdf关键字签章keywordsignslience本地pdf关键字签章（静默）uploadsignedfile上传pdfgetcurrentpdfmergeinfo 获取签章信息用于合成clearmergeinfo清空合成列表add

9、pdfmergeinfo添加合成信息到列表sefpdfile设置合成文件函数天印签章系统技术白皮书66天印签章 pdf中间件pluginrunmerge对合成列表中信息执行合成runmergepdffile合成单个签章信息到文件addqrcode增加二维码clearsignmu清空批量签章列表addmufile增加批量签章信息到列表runsignmu执行网络pdf批量签章并上传convertwordfiletopdfword转换为pdfconvertwordfiletopdfslicenceword转换为pdf（静默）setslaveserver设置备份签章服务器地址getpdfallsign

10、info获取pdf所有签章证书信息handsign手写板签名displaypopupbutton控制右键弹出菜单按钮的显示/隐藏displaysignimg控制签章和水印的显示/隐藏xssaveasstream获取当前文档文件流xsopenfromstream用文件流打开文档getsealnum根据类型获取签章个数mutisignbysealtype根据类型进行多页签章mutisignbysealimg用本地图片进行多页签章printfile控制文件打印verifypdfbysealtype根据类型验证签章verifysensepin验证深思usbkey的pin码setprojectflag设

11、置项目标识符loadpdfnokeywords打开本地pdf文件（无关键字过滤）setfilezoom设置文件缩放比例loadtexttofile在文件中添加文本settransparent设置签章透明属性handsignserver手写签批（服务端签名）函数1.11.1 pluginplugin 接口属性接口属性1)1)currentpdfpathcurrentpdfpath特性：只读类型：字符串型功能：获取当前打开文档的本地路径调用：var pdfpath = ;2)2)currentcachepathcurrentcachepath特性：只读天印签章系统技术白皮书77类型：字符串型功能：

12、获取当前打开文档的缓存路径调用：var pdfpath = ;说明：为了保证 pdf 文件操作的效率，打开本地文件和网络 pdf 文件时，均会将文件保存到缓存路径中。3)3)versionversion特性：只读类型：整数型功能：获取产品版本号调用：var version = ;4)4)lasterrorcodelasterrorcode特性：只读类型：整数型功能：获取最后的错误代码调用：var errorcode = ;5)5)errorcodeinnererrorcodeinner特性：只读类型：整数型功能：获取内部错误代码调用：var errorcode = ;6)6)mergestat

13、usmergestatus特性：只读类型：整数型功能：获取当前合并结果码（0：未执行合并，1：合并成功，2：合并失败）调用：var mergestatus = ;1.21.2 pluginplugin 接口事件接口事件1)1)onloadurlfinishonloadurlfinish参数：ltype整数型天印签章系统技术白皮书88handsign (“c:123”, 1, 100, 100, 0);1)1)displaypopupbuttondisplaypopupbutton功能说明：控制天印签章 pdf 中间件右键菜单的按钮，显示或隐藏按钮。输入参数：lid整数型 setopiniont

14、ext (“同意”);2)2)backsigncspbacksigncsp功能说明：使用插在电脑上的 usbkey 数字证书在 pdf 文件指定位置进行电子签章，证书过滤采用 csp。输入参数：bstrfilepath字符串型1. df”；2. 修改签章操作后的文件显示位置，由原来的显示签章页起始位置更改为显示签章所在位置；3. 实现 tif 文件转 pdf 功能；4. 实现 wps 文件转 pdf 功能；5. 增加文件添加水印的中间件接口；6. 增加云端签章功能。-版本：日期：2013-9-30内容：1. 增加服务端签名的手写签批中间件接口；2. 修改 pdf 文件中添加文字的中间件接口，增

15、加参数标识是否签名；3. 更改签章图片显示模式，不区分透明与非透明模式，所有显示以半透明方式显示；4. 更改批量验证效果，批量验证时显示签名面板，面板中包含了所有签章信息天印签章系统技术白皮书99及每个签章的验证结果；5. 调整产品升级机制，在应用启动时自动检查升级；-版本：日期：2013-8-30内容：1. 增加控制右键菜单的显示/隐藏中间件接口；2. 增加控制 pdf 文档中签章和水印的显示/隐藏中间件接口；3. 增加打开文件流和获取文件流的中间件接口；4. 增加根据页码和印章类型签章、获取印章个数及验证签章的中间件接口；5. 增加使用本地图片进行后台签章的中间件接口；6. 增加打印控制的

16、中间件接口；7. 增加验证深思 usbkey pin 码的中间件接口；8. 实现多个中间件在同个页面中打开时，窗口同步滚动功能；9. 增加设置文件显示缩放比例的中间件接口；10. 增加在 pdf 文件中添加文字的中间件接口；11. 增加设置签章透明属性的中间件接口；12. 增加打开文件时自动验证签章的设置项，签章验证失败时印章变灰；13. 增加签章区域的判断，不允许加盖不完整印章；14. 增加打印文档自动验证功能，打印文档时先自动验证文档，验证失败不允许打印。-版本：日期：2013-7-1内容：1. 改进图片转换为 pdf 文件时的自适应排版；2. 增加手写板签名功能；3. 增加 autoca

17、d 转换为 pdf 文件的功能（特殊版本提供）；4. 增加手写板签名中间件接口；5. 增加客户端菜单栏自适应排版；6. 改进 word 转 pdf 文件，转换后保持原有 word 文字的格式；7. 修复图片转 pdf 时签章验证失败的问题；8. 修复工具栏按钮显示中间件接口在页面 onload 时调用无效的问题；-版本：日期：2013-6-1内容：1. 增加阅读器的缩放自适应；2. 增加主从热备功能；3. 增加签章后自动上传签章文件的功能4. 修复版本中的 bug天印签章系统技术白皮书1010-版本：日期：2013-5-1内容：1. 增加 word 转换为 pdf 文件的功能-版本：日期：20

18、13-4-1内容：2. 增加将突破文件转换为 pdf 文件的功能；3. 增加试用版升级为正式版的功能；-版本：日期：2012-12-1内容：1. 签章透明改进，由用户自定义是否透明-版本：日期：2012-10-15内容：1. 解决部分文档签章定位不准确的问题；2. 开发测试版本天印签章系统 pdf 版-版本：日期：2012-8-1内容：1. 解决表格上签章不透明的问题；2. 解决时间戳设置无法保存的问题；3. 解决打开帮助手册进行签章时崩溃的问题；4. 批量签章解决增加关键字签章功能。-版本：日期：2009-8-15内容：1. 解决批量签章接口失效的问题-版本：日期：2009-7-1天印签章系

19、统技术白皮书1111内容：1. 解决部分文档打开崩溃的问题；2. 解决部分 ie 中打开中间件崩溃的问题；3. 解决部分文件无法签章的问题；-版本：日期：2007-8-9内容：1. 横向文档定位改进；2. 骑缝章算法改进；-版本：日期：2006-6-11内容：1. 增加二维码功能；2. 增加缩略图自动上传功能；-版本：日期：2004-12-3内容：4. 签章定位方式改进，由原左上角修改为签章中心点。-版本：日期：2004-9-20内容：5. 安装向导中，增加以天印签章软件作为默认打开方式的选项；6. 安装过程中，检测本机 frameword 环境，已经安装更高版本时不重复安装；7. 连接服务器

20、时增加“正在连接服务器，请等待”提示信息天印签章系统技术白皮书1212天印签章系统技术白皮书1313附件一附件一 工具栏按钮标识索引表工具栏按钮标识索引表按钮名称按钮名称标识标识索引号索引号打开idm_open400保存idm_save205另存为idm_saveas402查看书签idm_view_bookmarks417打印idm_print403上一页idm_goto_prev_page431下一页idm_goto_next_page430自适应宽度连续模式idt_view_fit_width3026自适应单页模式idt_view_fit_page3027缩小idt_view_zoomin3012放大idt_view_zoomout3013向左旋转idm_view_rotate_left415向右旋转idm_view_rotate_right416电子签章idm_sign483签骑缝章idm_qfsign485多页签章idm_batchsign488手写签名idm_handsign487关键字签章idm_keywordsign489批量验证idm_validate484天印签章系统技术白皮书1414附件二附件二 中间件操作指令表中间件操作指令表指