iSignatureAPI技术白皮书

iSignatureAPIOFFICE签章应用开发接口Version7.1.0.126中间件技术白皮书江西金格网络科技有限责任公司版权所有地址：江西南昌高新开发区高新大道南大科技园二号楼806网址：邮件：[e-mail]邮编：330029电话：[phone]江西金格网络科技有限责任公司网络-技术-服务金格科技版权所有电话：[phone]第2页共23页一、开发背景随着办公自动化中对文档的安全性、真实性的要求不断的提高，特别是针对手写签名、电子印章需求更加严格，要求在Word/Excel/Html文档上签名、盖章，需要实现多人会签、签章可验证、可认证、防抵赖等功能。公司根据实际情况，自行研制开发了iSignature手写签名电子印章软件管理方案。该方案采用信息加密和数据压缩处理技术，可靠性好，扩展性强，适用于政府、企业和软件开发商应用集成。由于越来越多软件开发商集成iSignature电子签章产品，为了解决软件开发商与签章的无缝集成难的问题，为了更好的满足开发商对iSiganture产品的开发需求，推出了OFFICE版本的电子签章API控件iSignatureAPI.ocx（HTML有专用的）。二、软件特点1、可以与所有OFFICE文档编辑控件集成使用iSignature电子签章产品。2、使用JavaScript对iSignatureAPI控件进行开发，开发简单，接口丰富。3、实现了客户端软件自动升级的功能。本中间件采用插件技术，能够通过版本号的更新，实现客户端软件自动更新功能。三、技术特点1、采用插件技术，可以完全融入IE浏览器中，方便系统维护、方便用户操作。2、采用了ActiveX技术，很好的实现了跨平台系统，便于开发。四、运行环境硬件平台：台式机CPU建议Pentium800以上，内存推荐128M以上，硬盘10G以上空间。软件平台：客户机Windows2000/XP/2003/VISTA简体中文版MicrosoftOffice2000简体中文IE5.0以上版本网络-技术-服务江西金格网络科技有限责任公司金格科技版权所有电话：[phone]第3页共23页五、接口说明1、iSignatureAPI.ocx接口iSignatureAPI二次开发中间件SignatureInstalled检测当前电脑是否安装电子签章软件ActiveDocument当前需要设置的活动文档SelectionState当前活动文档输入点状态CreateSignature在当前文档输入点创建电子签章InitSignatureItems初始化活动文档内所有签章数据SignatureCount当前活动文档内存在的签章数量SignatureItem访问单个电子签章ReleaseActiveDocument释放设置的活动文档ShedCryptoDocument脱密文档签章HasErrorSignature查询文档是否有无效签章AddGlobalMem增加系统内存变量DelGlobalMem删除系统内存变量LockDocument锁定文档UnLockDocument解锁文档SetSignatureParam设置签章参数BeginLoadSignature调用KEY内签章信息，申请资源EndLoadSignature结束调用签章，释放申请资源SignatureNames密钥盘签章对象名称CreateGroupSignature创建批量签章对象EnabledSignaturesMove当前文档签章移动控制CreateComment建立批注文字ReadComment读取批注文字DeleteComment删除批注文字GetLocalPrinterInfo获取本地打印机相关信息(V6.0.0.38)LocalPrinterNameList获取本地打印机名称列表(V6.0.0.38)LocalPrinterDriverList获取本地打印机驱动列表(V6.0.0.38)GetLocalAdapterMac获取网卡物理地址(V6.0.0.38)BarCodeCount二维条码数量V(V6.0.0.42)BarCodeItem访问单个条码信息(V6.0.0.42)江西金格网络科技有限责任公司网络-技术-服务金格科技版权所有电话：[phone]第4页共23页iSignatureAPI.ocx版本适用于电子签章Office客户端版本V6.0.0.42V6.0.0.156以后版本V6.0.0.44V6.0.0.156以后版本V6.0.0.46V6.0.0.164以后版本V6.0.0.56V6.0.0.176以后版本V6.1.0.58V6.0.0.180以后版本V7.0.0.78V7.0以后版本V7.1.0.100V7.1.0.364以后版本V7.1.0.104V7.1.0.368以后版本V7.1.0.122V7.1.0.418以后版本WebUrl企业版客户端访问服务器URL地址（V6.0.0.44）PDF417WebUrlPDF417条码获取14要素访问URL地址（V6.0.0.44）CreatePDF417String建立PDF417串14要素（V6.0.0.46）DeletePDF417String删除建立的PDF417条码字符串V6.0.0.46)SaveToFileNoSignature保存文档到本地，且不存在印章。（V6.1.0.58）GetPrintSelect文档是否设置了打印份数限制（V6.1.0.58）SetPublicParam设置电子签章系统公有参数(V6.1.0.76)SaveToPDF将当前设置的活动文档转化为PDF(V6.1.0.78)WebGetKeySN获取当前电脑上KEY的硬件序列号（V7.0.0.78）VerifyPin验证当前电脑上KEY的PIN码（V7.0.0.78）WebSendMessage发送数据消息（V7.0.0.78）WebMsgTextClear清空数据消息（V7.0.0.78）SetMsgByName设置数据消息内容（V7.0.0.78）GetMsgByName获取数据消息内容（V7.0.0.78）WebMsgError获取数据返回错误信息（V7.0.0.78）OnLineCertVerify在线验证数字证书（V7.0.0.88）RefreshSignature重设印章背景（V7.0.0.90）PDFSecurity设置PDF的安全性（V7.0.0.92）ResetShedCryptProtectState重设脱密模式下的印章无保护状态（V7.0.0.94）SelectIndex盖章前设置下拉框选择的签章索引（V7.0.0.96）PrintCreate打印开始GDCA专用（V7.0.0.98）PrintRelease打印结束GDCA专用（V7.0.0.98）ResetProtectState重设签章保护状态（V7.0.0.98）SignatureCtrlToPicture签章转化为图片(V7.1.0.100)CreateSignatureExt通过书签将与书签关联的REF域位置都签章(V7.1.0.102)DeleteSignature按撤销原则进行删除印章(V7.1.0.104)SetSignatureParamEx设置签章参数的扩展（V7.1.0.120）GetDocumentHash获取最后一个印章存储的文档哈希值（V7.1.0.122）网络-技术-服务江西金格网络科技有限责任公司金格科技版权所有电话：[phone]第5页共23页2、SignatureInstalled(函数)功能描述：检测当前电脑是否已经安装iSignature电子签章软件参数说明：无返回值：true:已安装；false：未安装。调用：If(SignatureAPI.SignatureInstalled()){Alert(“电子签章已安装”);}Else{Alert(“电子签章未正常安装”);}3、ActiveDocument(属性，可读、写)功能描述：设置iSignatureAPI控件要访问的活动文档对象。参数说明：无说明：1.文档是WORD，请传入Document对象,2.文档是Excel，请传入Worksheet对象调用：SignatureAPI.ActiveDocument=WebOffice.WebObject4、SelectionState(属性，只读)功能描述：检测当前活动文档输入点状态参数说明：无返回值：ssFailed=-1;//未知状态ssSucceeded=0x0000;//成功ssNoInstall=0x0001;//电脑未正确安装电子签章软件！ssNoActiveDocument=0x0002;//不存在活动的文档或者未设置ActiveDocument！ssDocumentLocked=0x0003;//文档已经锁定ssDocumentInObject=0x0004;//光标置于对象之上，请处于编辑状态ssDocumentInHFooter=0x0005;//光标在页眉面脚上，不能签章。ssDocumentInTextbox=0x0006;//光标不能在文档框内签章ssDocumentInEdit=0x0007;//EXCEL不能在编译模式下进行签章。调用：Alert(SignatureAPI.SelectionState);5、CreateSignature(函数)功能描述：在当前文档输入点创建电子签章江西金格网络科技有限责任公司网络-技术-服务金格科技版权所有电话：[phone]第6页共23页参数说明：AType:integer，类型如下：stSign=0x00000001;//电子签章stHand=0x00000002;//手写签名返回值：执行成功返回true，失败返回false。调用：SignatureAPI.CreateSignature(stSign)；6、InitSignatureItems（方法）功能描述：初始化活动文档内所有签章数据参数说明：无调用：SignatureAPI.InitSignatureItems()7、SignatureCount(属性，只读)功能描述：当前活动文档内存在的签章数量说明：执行InitSignatureItems方法后有效。调用：alert(SignatureAPI.SignatureCount);8、SignatureItem(数组属性，只读)功能描述：访问单个签章，获取单个签章的签章信息参数说明：Index:Integer;说明：参数Index下标从0开始返回值：返回索引为Index的签章XML信息。调用：alert(SignatureAPI.SignatureItem(0));9、ReleaseActiveDocument(方法)功能描述：释放iSignatureAPI的ActiveDocument.参数说明：无说明：如果设置了ActiveDocument,在关闭文档之前，请先调用该方法释放对象。调用：SignatureAPI.ReleaseActiveDocument()10、ShedCryptoDocument(函数)功能描述：脱密活动文档内的签章参数说明：无说明：调用：SignatureAPI.ShedCryptoDocument()网络-技术-服务江西金格网络科技有限责任公司金格科技版权所有电话：[phone]第7页共23页11、HasErrorSignature(函数)功能描述：查询文档是否有无效签章参数说明：无说明：返回值：True:存在无效签章