天印簽章系統(tǒng)技術(shù)白皮書V2.0

1、天印簽章系統(tǒng)技術(shù)白皮書00天印簽章系統(tǒng) pdf 版技術(shù)白皮書version 杭州天谷信息科技有限公司2014 年 3 月天印簽章系統(tǒng)技術(shù)白皮書11文檔修改記錄序號修改人修改時間內(nèi)容說明1蔣淑紅2013-7-18創(chuàng)建文檔2蔣淑紅2013-9-30更新版本 v3蔣淑紅2013-10-31更新版本 v4蔣淑紅2013-11-20更新版本 v5蔣淑紅2013-12-11更新版本 v6蔣淑紅2014-3-28更新版本 v保密聲明本文檔包含杭州天谷信息科技有限公司的專用商業(yè)信息和保密信息。本文檔保密時間為 20 年。接受方同意維護本文檔所提供信息的保密性，承諾不對其進行復(fù)制，或向其他公司或個人公開此信息。

2、對于以下三種信息，接受方可不向天谷公司承擔保密責任：1）可以通過其他渠道公開獲得的信息；2）天谷科技承諾可公開的信息；3）已超過保密時間要求的信息。天印簽章系統(tǒng)技術(shù)白皮書22目目 錄錄概述概述 .3 31.1. 產(chǎn)品研發(fā)背景產(chǎn)品研發(fā)背景 .3 32.2. 產(chǎn)品特點產(chǎn)品特點 .3 33.3. 產(chǎn)品組成產(chǎn)品組成 .4 44.4. 產(chǎn)品體系架構(gòu)產(chǎn)品體系架構(gòu) .5 5中間件接口說明中間件接口說明 .6 61.1. 中間件接口概述中間件接口概述 .6 6plugin 接口屬性.7plugin 接口事件.9plugin 接口函數(shù).12更新說明更新說明 .4646附件一附件一 工具欄按鈕標識索引表工具欄按鈕

3、標識索引表 .5454附件二附件二 中間件操作指令表中間件操作指令表 .5656附件三附件三 右鍵菜單按鈕標識索引表右鍵菜單按鈕標識索引表 .5858附件四附件四 錯誤碼索引表錯誤碼索引表 .5959天印簽章系統(tǒng)技術(shù)白皮書33概述概述1.1.產(chǎn)品研發(fā)背景產(chǎn)品研發(fā)背景在現(xiàn)實社會中，我們在辦事過程中通過簽字蓋章的方式來確認辦事人員的身份，并作為對文檔確認的憑據(jù)。這種物理上簽字、蓋章防止假冒的有效性基礎(chǔ)包括筆跡和法律保障。然而在網(wǎng)絡(luò)中，辦事的過程中雙方是不見面的，如何解決身份認證和行為確認的問題呢？2005 年 4 月 1 日，中華人民共和國電子簽名法正式生效，從法律層面上確認了“電子簽名”具有和手

4、寫簽名相同的法律效力。而目前最為成熟的電子簽名技術(shù)是“數(shù)字簽名技術(shù)”。天印電子簽章產(chǎn)品正是在以上需求及法律背景下研發(fā)的一款產(chǎn)品，可應(yīng)用于所有網(wǎng)絡(luò)應(yīng)用，解決在網(wǎng)絡(luò)辦事過程中的簽字、蓋章等身份識別和行為確認的問題。在網(wǎng)絡(luò)辦事過程中應(yīng)用最廣的就是版式文件了，即 pdf，因此，研發(fā)天印簽章系統(tǒng) pdf 版應(yīng)運而生。2.2.產(chǎn)品特點產(chǎn)品特點產(chǎn)品成熟：2004 年即開始研發(fā)，40 多萬用戶使用；適應(yīng)性強：支持所有 ie 內(nèi)核的瀏覽器；功能豐富：單頁、多頁、關(guān)鍵字、批量、坐標簽章，騎縫章，數(shù)字水印，時間戳可開發(fā)性強：大量二次開發(fā)接口，滿足絕大多數(shù)應(yīng)用場景；可靠性強：支持雙機熱備、智能選擇服務(wù)器。3.3.產(chǎn)品

5、組成產(chǎn)品組成天印簽章系統(tǒng)pdf版天印簽章pdf閱讀器天印簽章pdf中間件天印簽章系統(tǒng) pdf 版包含天印簽章 pdf 閱讀器和天印簽章 pdf 中間件兩個組件。天印簽章 pdf 閱讀器是運行于客戶機上的一個可執(zhí)行程序，是一個結(jié)合了簽章功能的成熟 pdf 閱讀器。天印簽章 pdf 中間件提供了 ocx 和 dll 接口，可以供web 網(wǎng)頁或其他應(yīng)用程序靈活調(diào)用。天印簽章系統(tǒng)技術(shù)白皮書444.4.產(chǎn)品體系架構(gòu)產(chǎn)品體系架構(gòu)其他應(yīng)用程序web網(wǎng)頁天印簽章pdf中間件調(diào)用dll調(diào)用ocx天印簽章pdf閱讀器客戶機天印簽章服務(wù)器端處理部分數(shù)據(jù)庫或文件系統(tǒng)http協(xié)議http協(xié)議天印簽章系統(tǒng)技術(shù)白皮書55中

6、間件接口說明中間件接口說明1.1.中間件接口概述中間件接口概述天印簽章 pdf中間件plugincurrentpdfpath當前打開文檔本地路徑currentcachepath當前打開文檔緩存路徑version產(chǎn)品版本號lasterrorcode最后的錯誤碼errorcodeinner最后的內(nèi)部錯誤碼mergestatus合并操作的結(jié)果屬性onloadurlfinish打開網(wǎng)絡(luò)pdf文件后觸發(fā)onsignfinish簽章完成后觸發(fā)onuploadfinish上傳完成后觸發(fā)onbatchsealsignfinish批量簽章完成后觸發(fā)onconvertfiletopdffinish文件轉(zhuǎn)換后觸發(fā)o

7、nsignaturedelete簽章刪除后觸發(fā)事件loadpdf打開本地pdfloadurlpdf打開網(wǎng)絡(luò)pdfsetremoteserver設(shè)置簽章服務(wù)器地址displaytoolbutton控制工具欄按鈕顯示enabletoolbutton控制工具欄按鈕可用性controltoolbutton控制中間件模式getcurrentpagenum獲取當前頁碼gotopage跳轉(zhuǎn)至指定頁碼savepdffile保存當前pdfclosecurrentdoc關(guān)閉當前pdfcontrolpdf根據(jù)指令代碼執(zhí)行操作addbookmark添加書簽gotobookmark跳轉(zhuǎn)至書簽displaybookmar

8、k控制書簽欄顯示checkpdfissignd檢查pdf是否簽章checksealnum獲取pdf簽章個數(shù)checkpagenum獲取pdf總頁數(shù)verifypdf驗證pdf簽章有效性sign用usbkey證書簽章silencesign用pfx證書簽章signmu本地多個pdf批量簽章并上傳batchsealsign本地多個pdf批量簽章keywordsign本地pdf關(guān)鍵字簽章keywordsignslience本地pdf關(guān)鍵字簽章（靜默）uploadsignedfile上傳pdfgetcurrentpdfmergeinfo 獲取簽章信息用于合成clearmergeinfo清空合成列表add

9、pdfmergeinfo添加合成信息到列表sefpdfile設(shè)置合成文件函數(shù)天印簽章系統(tǒng)技術(shù)白皮書66天印簽章 pdf中間件pluginrunmerge對合成列表中信息執(zhí)行合成runmergepdffile合成單個簽章信息到文件addqrcode增加二維碼clearsignmu清空批量簽章列表addmufile增加批量簽章信息到列表runsignmu執(zhí)行網(wǎng)絡(luò)pdf批量簽章并上傳convertwordfiletopdfword轉(zhuǎn)換為pdfconvertwordfiletopdfslicenceword轉(zhuǎn)換為pdf（靜默）setslaveserver設(shè)置備份簽章服務(wù)器地址getpdfallsign

10、info獲取pdf所有簽章證書信息handsign手寫板簽名displaypopupbutton控制右鍵彈出菜單按鈕的顯示/隱藏displaysignimg控制簽章和水印的顯示/隱藏xssaveasstream獲取當前文檔文件流xsopenfromstream用文件流打開文檔getsealnum根據(jù)類型獲取簽章個數(shù)mutisignbysealtype根據(jù)類型進行多頁簽章mutisignbysealimg用本地圖片進行多頁簽章printfile控制文件打印verifypdfbysealtype根據(jù)類型驗證簽章verifysensepin驗證深思usbkey的pin碼setprojectflag設(shè)

11、置項目標識符loadpdfnokeywords打開本地pdf文件（無關(guān)鍵字過濾）setfilezoom設(shè)置文件縮放比例loadtexttofile在文件中添加文本settransparent設(shè)置簽章透明屬性handsignserver手寫簽批（服務(wù)端簽名）函數(shù)1.11.1 pluginplugin 接口屬性接口屬性1)1)currentpdfpathcurrentpdfpath特性：只讀類型：字符串型功能：獲取當前打開文檔的本地路徑調(diào)用：var pdfpath = ;2)2)currentcachepathcurrentcachepath特性：只讀天印簽章系統(tǒng)技術(shù)白皮書77類型：字符串型功能：

12、獲取當前打開文檔的緩存路徑調(diào)用：var pdfpath = ;說明：為了保證 pdf 文件操作的效率，打開本地文件和網(wǎng)絡(luò) pdf 文件時，均會將文件保存到緩存路徑中。3)3)versionversion特性：只讀類型：整數(shù)型功能：獲取產(chǎn)品版本號調(diào)用：var version = ;4)4)lasterrorcodelasterrorcode特性：只讀類型：整數(shù)型功能：獲取最后的錯誤代碼調(diào)用：var errorcode = ;5)5)errorcodeinnererrorcodeinner特性：只讀類型：整數(shù)型功能：獲取內(nèi)部錯誤代碼調(diào)用：var errorcode = ;6)6)mergestat

13、usmergestatus特性：只讀類型：整數(shù)型功能：獲取當前合并結(jié)果碼（0：未執(zhí)行合并，1：合并成功，2：合并失?。┱{(diào)用：var mergestatus = ;1.21.2 pluginplugin 接口事件接口事件1)1)onloadurlfinishonloadurlfinish參數(shù)：ltype整數(shù)型天印簽章系統(tǒng)技術(shù)白皮書88handsign (“c:123”, 1, 100, 100, 0);1)1)displaypopupbuttondisplaypopupbutton功能說明：控制天印簽章 pdf 中間件右鍵菜單的按鈕，顯示或隱藏按鈕。輸入?yún)?shù)：lid整數(shù)型 setopiniont

14、ext (“同意”);2)2)backsigncspbacksigncsp功能說明：使用插在電腦上的 usbkey 數(shù)字證書在 pdf 文件指定位置進行電子簽章，證書過濾采用 csp。輸入?yún)?shù)：bstrfilepath字符串型1. df”；2. 修改簽章操作后的文件顯示位置，由原來的顯示簽章頁起始位置更改為顯示簽章所在位置；3. 實現(xiàn) tif 文件轉(zhuǎn) pdf 功能；4. 實現(xiàn) wps 文件轉(zhuǎn) pdf 功能；5. 增加文件添加水印的中間件接口；6. 增加云端簽章功能。-版本：日期：2013-9-30內(nèi)容：1. 增加服務(wù)端簽名的手寫簽批中間件接口；2. 修改 pdf 文件中添加文字的中間件接口，增

15、加參數(shù)標識是否簽名；3. 更改簽章圖片顯示模式，不區(qū)分透明與非透明模式，所有顯示以半透明方式顯示；4. 更改批量驗證效果，批量驗證時顯示簽名面板，面板中包含了所有簽章信息天印簽章系統(tǒng)技術(shù)白皮書99及每個簽章的驗證結(jié)果；5. 調(diào)整產(chǎn)品升級機制，在應(yīng)用啟動時自動檢查升級；-版本：日期：2013-8-30內(nèi)容：1. 增加控制右鍵菜單的顯示/隱藏中間件接口；2. 增加控制 pdf 文檔中簽章和水印的顯示/隱藏中間件接口；3. 增加打開文件流和獲取文件流的中間件接口；4. 增加根據(jù)頁碼和印章類型簽章、獲取印章個數(shù)及驗證簽章的中間件接口；5. 增加使用本地圖片進行后臺簽章的中間件接口；6. 增加打印控制的

16、中間件接口；7. 增加驗證深思 usbkey pin 碼的中間件接口；8. 實現(xiàn)多個中間件在同個頁面中打開時，窗口同步滾動功能；9. 增加設(shè)置文件顯示縮放比例的中間件接口；10. 增加在 pdf 文件中添加文字的中間件接口；11. 增加設(shè)置簽章透明屬性的中間件接口；12. 增加打開文件時自動驗證簽章的設(shè)置項，簽章驗證失敗時印章變灰；13. 增加簽章區(qū)域的判斷，不允許加蓋不完整印章；14. 增加打印文檔自動驗證功能，打印文檔時先自動驗證文檔，驗證失敗不允許打印。-版本：日期：2013-7-1內(nèi)容：1. 改進圖片轉(zhuǎn)換為 pdf 文件時的自適應(yīng)排版；2. 增加手寫板簽名功能；3. 增加 autoca

17、d 轉(zhuǎn)換為 pdf 文件的功能（特殊版本提供）；4. 增加手寫板簽名中間件接口；5. 增加客戶端菜單欄自適應(yīng)排版；6. 改進 word 轉(zhuǎn) pdf 文件，轉(zhuǎn)換后保持原有 word 文字的格式；7. 修復(fù)圖片轉(zhuǎn) pdf 時簽章驗證失敗的問題；8. 修復(fù)工具欄按鈕顯示中間件接口在頁面 onload 時調(diào)用無效的問題；-版本：日期：2013-6-1內(nèi)容：1. 增加閱讀器的縮放自適應(yīng)；2. 增加主從熱備功能；3. 增加簽章后自動上傳簽章文件的功能4. 修復(fù)版本中的 bug天印簽章系統(tǒng)技術(shù)白皮書1010-版本：日期：2013-5-1內(nèi)容：1. 增加 word 轉(zhuǎn)換為 pdf 文件的功能-版本：日期：20

18、13-4-1內(nèi)容：2. 增加將突破文件轉(zhuǎn)換為 pdf 文件的功能；3. 增加試用版升級為正式版的功能；-版本：日期：2012-12-1內(nèi)容：1. 簽章透明改進，由用戶自定義是否透明-版本：日期：2012-10-15內(nèi)容：1. 解決部分文檔簽章定位不準確的問題；2. 開發(fā)測試版本天印簽章系統(tǒng) pdf 版-版本：日期：2012-8-1內(nèi)容：1. 解決表格上簽章不透明的問題；2. 解決時間戳設(shè)置無法保存的問題；3. 解決打開幫助手冊進行簽章時崩潰的問題；4. 批量簽章解決增加關(guān)鍵字簽章功能。-版本：日期：2009-8-15內(nèi)容：1. 解決批量簽章接口失效的問題-版本：日期：2009-7-1天印簽章系

19、統(tǒng)技術(shù)白皮書1111內(nèi)容：1. 解決部分文檔打開崩潰的問題；2. 解決部分 ie 中打開中間件崩潰的問題；3. 解決部分文件無法簽章的問題；-版本：日期：2007-8-9內(nèi)容：1. 橫向文檔定位改進；2. 騎縫章算法改進；-版本：日期：2006-6-11內(nèi)容：1. 增加二維碼功能；2. 增加縮略圖自動上傳功能；-版本：日期：2004-12-3內(nèi)容：4. 簽章定位方式改進，由原左上角修改為簽章中心點。-版本：日期：2004-9-20內(nèi)容：5. 安裝向?qū)е校黾右蕴煊『炚萝浖鳛槟J打開方式的選項；6. 安裝過程中，檢測本機 frameword 環(huán)境，已經(jīng)安裝更高版本時不重復(fù)安裝；7. 連接服務(wù)器

20、時增加“正在連接服務(wù)器，請等待”提示信息天印簽章系統(tǒng)技術(shù)白皮書1212天印簽章系統(tǒng)技術(shù)白皮書1313附件一附件一 工具欄按鈕標識索引表工具欄按鈕標識索引表按鈕名稱按鈕名稱標識標識索引號索引號打開idm_open400保存idm_save205另存為idm_saveas402查看書簽idm_view_bookmarks417打印idm_print403上一頁idm_goto_prev_page431下一頁idm_goto_next_page430自適應(yīng)寬度連續(xù)模式idt_view_fit_width3026自適應(yīng)單頁模式idt_view_fit_page3027縮小idt_view_zoomin3012放大idt_view_zoomout3013向左旋轉(zhuǎn)idm_view_rotate_left415向右旋轉(zhuǎn)idm_view_rotate_right416電子簽章idm_sign483簽騎縫章idm_qfsign485多頁簽章idm_batchsign488手寫簽名idm_handsign487關(guān)鍵字簽章idm_keywordsign489批量驗證idm_validate484天印簽章系統(tǒng)技術(shù)白皮書1414附件二附件二 中間件操作指令表中間件操作指令表指