CBSignatoryRect.go 5.2 KB

123456789101112131415161718192021222324
  1. package common
  2. // 【签署位置】签署位置 【作用】 指定签署动作的签署位置 【传参方式】 签署位置有以下两种表现方式: 1、用关键字确定坐标: keyword:关键字。 keywordIndex:第几个关键字,0:全部,-1:最后一个,其他:第keyIndex个,默认为1。 关键字处于实际印章位置y轴中央。 offsetX:横坐标偏移量;默认为0,取值范围是(-1, 1)。 offsetY:纵坐标偏移量;默认为0,取值范围是(-1, 1)。 找到实际印章位置的坐标(x, y),再加上偏移量(offsetX, offsetY),最终得到的坐标是(x+offsetX, y+offsetY),如果实际印章位置超出纸张边缘,会适当偏移位置。 偏移量的坐标原点是实际印章位置的坐标(x, y)的左下角。 2、直接确定坐标: page:印章所在页码;从1开始。 offsetX:横坐标;默认电子签约页的宽为1,所以取值范围是(0, 1)。 offsetY:纵坐标;默认电子签约页的高为1,所以取值范围是(0, 1)。 由page确定页码,由(offsetX, offsetY)确定坐标。 坐标原点是电子签约页的左下角,坐标是指印章图片的左下角的坐标。
  3. type CbSignatoryRect struct {
  4. // <ext>core:true</ext> 【签署位置类型】签署位置类型 【传参】 取值范围:ADOBE_SIGNATURE(电子签名),INLINE_IMAGE(图章),DIGITAL_SIGNATURE(数字签名),ADOBE_TIMESTAMP(时间戳),SEAL_PERSONAL_FULL_NAME(全名信息),SEAL_JOB_POSITION(职务信息)。 【特殊说明】 1、电子签名:签署人可在邮箱中收到adobe发送的签署通知。用户点击链接即可添加签名/印章,使用签名Adobe平台颁发的证书进行签署 2、数字签名:签署人可在邮箱中收到adobe发送的签署通知。用户点击链接即可添加签名/印章,使用信任服务提供商(TSP)/如证书颁发机构(CA)颁发的数字证书进行签署 3、用印流程配置不允许添加日期,则传入的时间戳无效
  5. RectType string `json:"rectType"`
  6. // <ext>core:true</ext> 【X轴坐标】X轴坐标 【作用】 通过坐标指定签署位置时,以页面左下角为原点,页面宽度为1,通过比例定位签署位置左下角所在的横向位置 【传参】 1、坐标定位时必传 2、最小值:-1(不包含),最大值:1(不包含);不传值默认为:0。
  7. OffsetX *float64 `json:"offsetX,omitempty"`
  8. // <ext>core:true</ext> 【Y轴坐标】Y轴坐标 【作用】 通过坐标指定签署位置时,以页面左下角为原点,页面高度为1,通过比例定位签署位置左下角所在的纵向位置。 【传参】 1、坐标定位时必传。 2、最小值:-1(不包含),最大值:1(不包含);不传值默认为:0。
  9. OffsetY *float64 `json:"offsetY,omitempty"`
  10. // <ext>core:true</ext> 【签署页码】签署页码 【作用】 指定签署位置所在的文件页码 【传参】 1、使用坐标指定位置时必须传入。 2、0:全部页,-1:最后一页,其他:第page页(例如:第7页,则传入7)。
  11. Page *int64 `json:"page,omitempty"`
  12. // <ext>core:true</ext> 【签署位置宽度】签署位置宽度 【作用】 设置签署位置的宽度,防止用户在文件上添加的签名过大或过小 【传参】 1、支持个人签署、时间戳位置, 2、仅传宽度时,高度按比例适配,两者均传参以宽度为准 3、最小值:10(包含),最大值:120(包含);不传值默认为:系统默认大小。
  13. Width *float64 `json:"width,omitempty"`
  14. // <ext>core:true</ext> 【签署位置高度】签署位置高度 【作用】 设置签署位置的高度,防止用户在文件添加的签名过大或过小 【传参】 1、支持个人签署、时间戳位置 2、仅传宽度时,高度按比例适配,两者均传参以宽度为准 3、最小值:4(包含),最大值:48(包含);不传值默认为:系统默认大小。
  15. Height *float64 `json:"height,omitempty"`
  16. // <ext>core:true;format:string</ext> 【签署文档id】签署文档id 【作用】 用于指定签署位置所在的签署文档 【传参】 不传入documentid(签署文档id)、documentids(签署文档id集合)、templates(文件模板id集合)时,签署位置默认对全部签署文档生效
  17. DocumentId *int64 `json:"documentId,omitempty"`
  18. // <ext>core:true;format:string</ext> 【签署文档id集合】签署文档id集合 【作用】 用于指定签署位置所在的签署文档 【传参】 1、格式:[123123123213,123213213213] 2、不传入documentid(签署文档id)、documentids(签署文档id集合)、templates(文件模板id集合)时,签署位置默认对全部签署文档生效
  19. DocumentIds []int64 `json:"documentIds,omitempty"`
  20. // <ext>core:true;format:string</ext> 【文件模板id】文件模板id 【作用】 用印流程绑定文件模板时,支持传入模板id用于指定签署位置 【传参】 1、传入多个模板id时,使用“,”间隔,示例:[123123123213,123213213213] 2、不传入documentid(签署文档id)、documentids(签署文档id集合)、templates(文件模板id集合)时,签署位置默认对全部签署文档生效
  21. Templates []int64 `json:"templates,omitempty"`
  22. }