签署方分类
签署方分为以下类:
参与方类型 | 必传字段 | 说明 |
个人 | Name、Mobile | 个人参与方,目前签署控件只支持: SIGN_SIGNATURE:手写签名 SIGN_DATE:签署日期 |
企业签署方 | Name、Mobile、OrganizationName | 企业参与方,其中:OrganizationName:为签署方在工商注册的企业名称支持的签署控件: SIGN_SIGNATURE:手写签名 SIGN_SEAL:签署印章 SIGN_DATE:签署日期 |
企业静默签署方 | \\ | 此签署方由系统自动完成签署。 无需指定参与人信息,签署人信息默认为发起人(Operator)的信息。 必须为 SIGN_SEAL 类型的控件指定印章 ID(控件的 ComponentValue 字段)。 不能指定 SIGN_SIGNATURE 类型的签署控件,因为系统无法进行手写签名。 |
签署方具体参数
指定签署控件
签署控件是绑定在签署人上的,通过 ApproverInfo 中的 SignComponents 字段指定:
SignComponent 数据结构如下:
控件在 PDF 上的定位方式可以以下几种:
绝对定位方式。
表单域(FIELD)定位方式。
关键字(KEYWORD)定位方式。
Component 三种定位方式说明
绝对定位方式
{"ComponentPosX": 160,"ComponentPosY": 260,"ComponentWidth": 100,"ComponentHeight": 100,"FileIndex": 0,"ComponentType": "SIGN_SIGNATURE","ComponentPage": 1}
表单域(FIELD)定位方式
{"GenerateMode": "FIELD","ComponentName": "seal","FileIndex": 0,"ComponentType": "SIGN_SEAL"}
通过 Adobe 等 PDF 编辑工具创建表单域,随后指定表单域的对应名称,即可指定对应控件,控件的大小即为表单域的大小。
上图中的 seal 即对应了输入参数中的 seal 参数。
关键字(KEYWORD)定位方式
{"GenerateMode": "KEYWORD","ComponentId": "Test","FileIndex": 0,"ComponentType": "SIGN_SEAL","ComponentWidth": 100,"ComponentHeight": 100,"OffsetX": 100.5,"OffsetY": 200.5}
需要指定 GenerateMode 为 KEYWORD,开启关键字定位。
通过 ComponentType 指定控件类型。
通过 ComponentId 指定 PDF 文件中的关键字(例如:"甲方")来对签署控件进行定位。
需要通过设置 ComponentWidth 和 ComponentHeight 来指定控件的大小。
如未指定控件大小,即为关键字所对应控件的大小。
同时,可以指定 OffsetX、OffsetY 参数来调整控件的相对位置。
如上图中的 Test 即对应上面入参中的 Test 参数。关键字定位注意事项:
使用关键字进行定位时会进行全文匹配,所有具有关键字的位置均会被匹配上。
目前无法通过任何参数控制进行关键字匹配的页数。
无法使用跨行的内容作为关键字进行定位。
如果匹配到了多处关键字位置,目前无法通过参数选择仅生效一处或多处。
您可以结合您自己的使用场景来使用不同的定位方式。