天印签章系统技术白皮书v

天印签章系统技术白皮书v内容摘要：

签章都需要选择对应的印章图片，第一个印章对应的索引值为 0，依次递增。 在签章过程中，只需要输入 USBKEY 证书口令就可以完成签章操作。 调用示例： (“c:\\123\”, 1, 100, 100, 0)。 20) SilenceSign 功能说明：使用本地 PFX 证书在本地 PDF 文件指定位置进行电子签章。 输入参数： bstrFilePath 字符串型 //PDF 文件本地路径 pfxFilePath 字符串型 //PFX 证书文件本地路径 password 字符串型 //PFX 证书文件密码 imagePath 字符串型 //印章图片文件本地路径 lPage 整数型 //签章位置所在页码 lX 整数型 //签章位置 X 坐标 lY 整数型 //签章位置 Y 坐标 width 整数型 //印章图片显示宽度（宽高同比） 输出参数：触发 OnSignFinish 事件 特别说明：所有参数均为必填项，签章位置坐标原点为 PDF 文件的左下角。 在 签章过程中，用户无需执行任何操作。 调用示例： (“c:\\123\”, 1, 100, 100, 0)。 20 21) SignMu 功能说明：对 网络上 多个 PDF 文件进行批量签章，并将签章后的文档上传。 输入参数： bstrContent 字符串型 //XML 格式字符串，具体格式如下： signMu filelist file downurl第一个 PDF 文件 URL 下载地址 /downurl coordinate签章位置 X 轴坐标， Y 轴坐标，页数 /coordinate parameters上传附件参数，格式： key=valueamp。 key2=value2/parameters upurl第一个 PDF 文件上传地址 /upurl /file file downurl第二个 PDF 文件 URL 下载地址 /downurl coordinate签章位置 X 轴坐标， Y 轴坐标，页数 /coordinate parameters上传附件参数，格式： key=valueamp。 key2=value2/parameters upurl第二个 PDF 文件上传地址 /upurl /file /filelist /signMu 输出参数：触发 OnSignFinish 事件 特别说明：在签章过程中，用户需要选择签章证书和印章。 21 调用示例： (“signMufilelistfiledownurl.pdf/downurlcoordinate100,100,1/coordinateparameters/parametersupurl //upurl/file/filelist/signMu”)。 22) BatchSealSign 功能说明：对本地多个 PDF 文件进行批量签章。 输入参数： pwszFileContents 字符串型 // XML 格式字符串，具体格式如下： signSeal staticSet签章位置设定标识（ 0：接口设定，参照 coordinate 节点； 1：显示位置设置对话框，由用户自己设置） /staticSet filelist file fileName第一个签章 PDF 文件本地路径 /fileName coordinate签章位置 X 轴坐标， Y 轴坐标，页数 /coordinate fileId文件标识，应用内部标识 fileId /file file file fileName第二个签章 PDF 文件本地路径 /fileName coordinate签章位置 X 轴坐标， Y 轴坐标，页数 /coordinate fileId文件标识，应用内部标识 fileId /file 22 /filelist /signSeal 输出参数：触发 OnBatchSealSignFinish 事件 特别说明：在签章过程中，用户需要选择签章证书和印章。 调用示例： (“signSealstaticSet0/staticSetfilelistfilefileNamec:\\123\/fileNamecoordinate200,200,1/coordinatefileId1fileId/file/filelist/signSeal”)。 23) KeyWordSign 功能说明：对本地 PDF 文件进行关键字签章。 输入参数： bstrPDFPath 字符串型 // PDF 文件本地路径 bstrKeyword 字符串型 //关键字 lSealIdx 整数型 //签章对应的印章索引 输出参数：触发 OnSignFinish 事件 特别说明：所谓关键字签章在文档中所有该项关键字所在的位置显示印章，在签章过程中，需要用户选择证书。 每次签章都需要选择对应的印章图片，第一个印章对应的索引值为 0，依次递增。 调用示例： (“c:\\123\”, “test”, 0)。 24) KeywordSignSlicence 功能说明：以静默方式对本地 PDF 文件进行关键字签章。 23 输入参数： bstrPDFPath 字符串型 // PDF 文件本地路径 bstrKeyword 字符串型 //关键字 lSealIdx 整数型 //签章对应的印章索引 输出参数： lResult 整数型 //签章结果， 0：成功， 1：失败 特别说明：以静默方式执行，签章完成后丌 触发事件，直接返回结果。 调用示例： (“c:\\123\”, “test”, 0)。 25) uploadSignedFile 功能说明：上传 PDF 文件。 输入参数： uploadUrl 字符串型 //PDF 文件上传地址 uploadFilePath 字符串型 //需要上传的 PDF 文件本地路径 uploadParameters 字符串型 // 上传附加参数（格式：key=valueamp。 key2=value2） 输出参数：触发 OnUploadFinish 事件 特别说明：文件上传接口是模拟 html file 表单，服务器端接收方式不 html file表单相同，属性名： myFile，另外，从请求中获取属性名为“ uploadParameters”的传递参数就可以获取所有上传附加参数，格式仍为 key=valueamp。 key2=value2。 调用示例： (“ “c:\\123\”, “”)。 26) GetCurrentPDFMergeInfo 功能说明：获取天印签章 PDF 中间件当前打开 PDF 文件的签章信息，用亍 24 签章合并。 输入参数： 无 输出参数： bstrMergeInfo 字符串型 //XML 格式的签章信息描述 特别说明：在部分应用场景中，同一个文档需要多个用户同时分别进行签章，各自签完章之后需要整合为同一个文档上传保存，这就是 PDF 文件签章合并过程。 合并时，应该先清空待合并列表信息（ ClearMergeInfo），再获取各个需要合并PDF 文件中的签章信息（ GetCurrentPDFMergeInfo），并添加到待合并列表中（ AddPDFMergeInfo），接着，指定待合并文档和合并后的输出文档（ SetPDFile），最后执行合并操作（ RunMerge），将所有待合并的签章信息添加到待合并文档中。 调用示例： ()。 27) ClearMergeInfo 功能说明：清空当前待合并列表中的签章信息。 输入参数： 无 输出参数： 无 特别说明：在部分应用场景中，同一个文档需要多个用户同时分别进行签章，各自签完章之后需要整合为同一个文档上传保存，这就是 PDF 文件签章合并过程。 合并时，应该先清 空待合并列表信息（ ClearMergeInfo），再获取各个需要合并PDF 文件中的签章信息（ GetCurrentPDFMergeInfo），并添加到待合并列表中（ AddPDFMergeInfo），接着，指定待合并文档和合并后的输出文档（ SetPDFile）， 25 最后执行合并操作（ RunMerge），将所有待合并的签章信息添加到待合并文档中。 调用示例： ()。 28) AddPDFMergeInfo 功能说明：将签章信息添加到待合并列表中。 输入参数： bstrMergeInfo 字符串型 //XML 格式签章信息描述，建议通过 GetCurrentPDFMergeInfo 方法获取。 输出参数： 无 特别说明：在部分应用场景中，同一个文档需要多个用户同时分别进行签章，各自签完章之后需要整合为同一个文档上传保存，这就是 PDF 文件签章合并过程。 合并时，应该先清空待合并列表信息（ ClearMergeInfo），再获取各个需要合并PDF 文件中的签章信息（ GetCurrentPDFMergeInfo），并添加到待合并列表中（ AddPDFMergeInfo），接着，指定待合并文档和合并后的输出文档（ SetPDFile），最后执行合并操作（ RunMerge），将所有待合并的签章信息添加到待合并文档中。 调用示例： (())。 29) SetPDFile 功能说明：指定待合并文档和合并后的输出文档。 输入参数： bstrIn 字符串型 //待合并文档本地路径 bstrPwd 字符串型 //待合并文档密码 bstrOut 字符串型 //合并后输出文档本地路径 输出参数： 无 26 特别说明：在部分应用场景中， 同一个文档需要多个用户同时分别进行签章，各自签完章之后需要整合为同一个文档上传保存，这就是 PDF 文件签章合并过程。 合并时，应该先清空待合并列表信息（ ClearMergeInfo），再获取各个需要合并PDF 文件中的签章信息（ GetCurrentPDFMergeInfo），并添加到待合并列表中（ AddPDFMergeInfo），接着，指定待合并文档和合并后的输出文档（ SetPDFile），最后执行合并操作（ RunMerge），将所有待合并的签章信息添加到待合并文档中。 调用示例： (“c:\\123\”, “”, “c:\\123\”)。 30) RunMerge 功能说明：执行合并操作，将待合并列表中所有的签章信息合并到待合并文档中，合并后保存为指定的文档。 输入参数： 无 输出参数： 无，可以通过 MergeStatus 属性获取合并结果 特别说明：在部分应用场景中，同一个文档需要多个用户同时分别进行签章，各自签完章之后需要整合为同一个文档上传保存，这就是 PDF 文件签章合并过程。 合并时，应该先清空待合并列表信息（ ClearMergeInfo），再获取各个需要合并PDF 文件中的签章信息（ GetCurrentPDFMergeInfo），并添加到待合并列表中（ AddPDFMergeInfo），接着，指定待合并文档和合并后的输出文档（ SetPDFile），最后执行合并操作（ RunMerge），将所有待合并的签章信息添加到待合并文档中。 调用示例： ()。 27 31) RunMergePdfFile 功能说明：将单个签章信息合并到指定的 PDF 文档中，仅支持无密码的 PDF文件。 输入参数： bstrIn 字符串型 //待合并文档本地路径 bstrOut 字符串型 //合并后输出文档本地路径 bstrMergeInfo 字符串型 //待合并签章信息， XML 格式签章信息描述，建议通过 GetCurrentPDFMergeInfo 方法获取 输出参数： lResult 整数型 //合并结果， 0：失败， 1：成功 调 用 示 例 ： (“c:\\123\”, “c:\\123\”, ())。 32) AddQRCode 功能说明：在 PDF 文件中添 加二维码。 输入参数： bstrPDFPath 字符串型 //本地 PDF 文件路径 message 字符串型 //二维码信息值 lPage 整数型 //二维码位置所在页码 lX 整数型 //二维码位置 X 坐标 lY 整数型 //二维码位置 Y 坐标 输出参数： 无 特别说明：二维码位置坐标原点 为 PDF 文件的左下角。 调用示例： (“c:\\123\”, “test”, 1, 100, 100)。 28 33) ClearSignMu 功能 说明：清空批量签章文件列表。 输入参数： 无 输出参数： 无 特别说明：在部分应用场景中，需要。