有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

签署方分类

签署方分为以下类:
参与方类型
必传字段
说明
个人
Name、Mobile
个人参与方,目前签署控件只支持:
SIGN_SIGNATURE:手写签名
SIGN_DATE:签署日期
企业签署方
Name、Mobile、OrganizationName
企业参与方,其中:OrganizationName:为签署方在工商注册的企业名称支持的签署控件:
SIGN_SIGNATURE:手写签名
SIGN_SEAL:签署印章
SIGN_DATE:签署日期
企业静默签署方
\\
此签署方由系统自动完成签署。
无需指定参与人信息,签署人信息默认为发起人(Operator)的信息。
必须为 SIGN_SEAL 类型的控件指定印章 ID(控件的 ComponentValue 字段)。
不能指定 SIGN_SIGNATURE 类型的签署控件,因为系统无法进行手写签名。

签署方具体参数

签署方的参数有非常多,最简单可以发起合同的参数如上面所示。如果您需要更多功能,请参见 ApproverInfo

指定签署控件

签署控件是绑定在签署人上的,通过 ApproverInfo 中的 SignComponents 字段指定:
SignComponent 数据结构如下:
Component
控件在 PDF 上的定位方式可以以下几种:
绝对定位方式。
表单域(FIELD)定位方式。
关键字(KEYWORD)定位方式。

Component 三种定位方式说明

绝对定位方式

{
"ComponentPosX": 160,
"ComponentPosY": 260,
"ComponentWidth": 100,
"ComponentHeight": 100,
"FileIndex": 0,
"ComponentType": "SIGN_SIGNATURE",
"ComponentPage": 1
}
直接指定控件在 PDF 中的 X、Y 绝对位置。关于如何计算 PDF 控件请参见 计算签署坐标

表单域(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 参数。
关键字定位注意事项:
使用关键字进行定位时会进行全文匹配,所有具有关键字的位置均会被匹配上。
目前无法通过任何参数控制进行关键字匹配的页数。
无法使用跨行的内容作为关键字进行定位。
如果匹配到了多处关键字位置,目前无法通过参数选择仅生效一处或多处。
您可以结合您自己的使用场景来使用不同的定位方式。