SecSeal扩展技术开发手册 SecSeal扩展技术开发手册V3.22福建凯特信息安全技术有限公司2007年4月目 录1 简介 12 盖章系统接口控件 22.1 原理及流程说明 22.2 接口调用详细说明(适用于脚本) 33 OA系统发文改造 103.1 初始流程 103.2 改造后流程 103.3 改造实现 113.3.1 增设“盖章”环节 113.3.2 盖章系统调用 123.3.3 示例代码 134 公文要素提取控件 394.1 原理说明 394.2 接口调用详细说明 395 公文模板编辑插件 515.1 目的及功能 515.2 使用方法 5150地址:福州市湖前路58号 邮政编码:350003:0591 - 87732332 :0591 - 87738531 网址: 1 简介为实现SecSeal安全电子印章系统与公文交换平台及各类OA系统的无缝连接,我们开发了两个符合COM标准的客户端及服务器组件:EDCProxy: 用于EDC文件在流转过程中同OA系统的无缝结合。
EDCCheckInCtrl: 用于提取EDC文件中的标准公文元素DocTemplatePlugin: 用于制作公文模板2 盖章系统接口控件2.1 原理及流程说明EDCProxy是一个运行于客户端的ActiveX组件,它的功能相当于实现了用户将存于服务器端的文档下载到本地,然后调用盖章系统盖章,再上传至服务器的自动化过程其工作的基本流程为控件自动从服务器下载所需要盖章的文档,暂存于客户机本地目录,然后自动调用盖章系统打开此文档,等待用户盖章并输出公文完成后,控件又将盖完章的公文自动上传至服务器则服务器端需要一个文件接收及处理的页面流程图如下所示:EDCProxy对于Web服务器端起着公文的自动下载和上传得角色,在客户端则自动调用盖章系统打开公文,同时传递相关参数,使盖章系统知道用户需要干什么 EDCProxy支持用户对公文盖章输出红头,或者对红头公文输出黑头公文的操作2.2 接口调用详细说明(适用于脚本)u 枚举JOB_OPERATION 枚举值名称数值描述JOB_MAKE_RED0x1对word文件盖章,制做红头公文JOB_MAKE_BLACK0x2将红头公文转换成黑头公文JOB_REPEAT_RED0x3对红头公文加盖公章,输出红头公文(联合盖章)JOB_MAKE_RED_XML0x4对XML文件盖章,制做红头公文JOB_MAKE_MULTI0x5对word文件盖章,同时输出红头和黑头JOB_MAKE_MULTI_XML0x6对XML文件盖章,同时输出红头和黑头JOB_REPEAT_MULTI0x7对红头公文加盖公章,同时输出红头和黑头公文(联合盖章)u 对象对象集合名称APPIDCLSID标记安全可创建EDCProxyEDCExt.EDCProxy.1831F5638-D9CD-4A7E-BB16-21606AEA7AE7是是EditJobEDCExt.EditJob.193FFD1F5-B3D3-4BA8-9D49-C14264C6984D是否u 功能EDCProxy名称:CreateJob类别:方法功能:创建一个编辑任务参数:无返回值:返回EditJob对象描述:无名称:RemoveJob类别:方法功能:删除一个编辑任务参数:名称说明lJobIdentity编辑任务ID返回值:返回布尔值指示操作是否成功描述:无名称:ForceSubmit类别:属性功能:获取/设置布尔值, 指示是否强制提交任务参数:名称说明返回值:无描述:当提交表单时是否自动检测编辑任务是否正确并把不正确的任务从提交数据中删除,设置为true时将不进行任务的有效性检测名称:ErrorDescription类别:属性(只读)功能:返回最后一次错误的文本描述参数:名称说明返回值:无描述:无EditJob名称:ExecEdit类别:方法功能:开始编辑一个远程文档参数:名称说明bstrSource远程文档的基于Http协议的URL返回值:返回布尔值指示操作是否成功描述:无名称:ExecSave类别:方法功能:将当前任务编辑状态进行保存参数:名称说明bstrName指定文件名称域的名称,将在提交表单时加入返回值:返回布尔值指示操作是否成功描述:此保存操作仅保存上次编辑信息,说明上次的ExecEdit是有效操作,操作不会保存文档到表单中,即使此调用成功也不能保证此编辑任务是有效的,要判断任务是否有效请使用IsValidJob属性名称:IsValidJob类别:属性(只读)功能:获取布尔值, 指示当前任务是否有效参数:名称说明返回值:无描述:当提交表单时如果EdcProxy对象的ForceSubmit属性设置为false,那么EdcProxy将根据编辑任务的此属性值进行自动有效性检测并把不正确的任务从提交数据中删除名称:Operation类别:属性功能:获取/设置当前任务的操作类型参数:名称说明返回值:枚举型JOB_OPERATION描述:不能在执行保存后进行设置,设置有可能破坏当前的任务名称:JobIdentity类别:属性(只读)功能:编辑任务标识,在EdcProxy唯一标识一个编辑任务对象参数:名称说明返回值:无描述:可以使用此标识对EdcProxy进行删除编辑任务的操作名称:JobName类别:属性功能:获取/设置当前编辑任务的名称参数:名称说明返回值:无描述:当有错误发生时,系统将使用此编辑任务的名称来返回表示错误的编辑对象,如果此属性为空或未进行设置,将使用编辑任务的标识来返回表示错误的编辑对象名称:ReadOnly类别:属性功能:设置盖章的时候word公文是否可写参数:名称说明返回值:无描述:如果为true,则word公文为写保护状态,用户无法编辑word公文名称:AutoExit类别:属性功能:设置盖章完成后程序是否自动退出参数:名称说明返回值:无描述:如果为true,则盖章输出公文后,盖章程序自动退出(2007年04月20日版本加入支持)名称:ImportCerts类别:方法功能:导入证书数据参数:名称说明bstrCertsData被导入到SecSeal系统的证书数据返回值:返回布尔值指示操作是否成功描述:在调用ExecEdit()方法之前导入证书,并且盖章完成之后,证书会被自动删除.如果导入多个证书,先将每个证书进行B64编码,再用连接符“,”逗号串连后传入.名称:GetImportedCertCount类别:方法功能:获取导入证书的个数参数:名称说明返回值:返回布尔值指示操作是否成功描述:在调用ImportCerts()之后调用本方法,可以获取证书的个数值.名称:OutCertItemsToXml类别:方法功能:将已导入的证书项信息输出到一个临时XML策略文件参数:名称说明返回值:返回临时XML策略文件的全路径.描述:在调用ImportCerts()之后调用本方法, 可以将已导入的证书项信息输出到一个临时XML策略文件.名称:SetCertItemValue类别:方法功能:修改导入证书项的属性值参数:名称说明lItemIndex证书项的索引bstrPropertyName证书项的属性名(参见”常量定义”)bstrVal证书项的新属性值返回值:返回布尔值指示操作是否成功描述:在调用ImportCerts()之后且OutCertItemsToXml()方法之前调用本方法,可以设置证书项的属性值.名称:StrategyFile类别:属性功能:获取/设置XML策略文件参数:名称说明bstrStrategyFile策略文件名的全路径返回值:策略文件的全路径描述:名称:SavedEdcFile类别:只读属性功能:获取任务完成后保存的红头文件(全路径)参数:名称说明返回值:红头文件的全路径描述:名称:SavedBdcFile类别:只读属性功能:获取任务完成后保存的黑头文件(全路径)参数:名称说明返回值:黑头文件的全路径描述:u 脚本调用规则1. 客户端MS InternetExplore版本必须大于5.52. 在使用控件的表单页中必须有如下配置:l 对必须如下配置:l 在
无素内必须包含有对控件的引用 ,如下所示:
l 在元素内必须包含有对引用控件的声明,如下所示:l 在使用控件的表单中实例化控件,并给予对象ID号
l 在上步标记的表单内就可以使用此控件,示例的控件名称为OAFormEdcProxy, 一定不能够直接使用