tencentcloud-sdk-nodejs-essbasic 4.0.775 → 4.0.776

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tencentcloud-sdk-nodejs-essbasic",
-  "version": "4.0.775",
+  "version": "4.0.776",
   "description": "Tencent Cloud API NODEJS SDK",
   "main": "tencentcloud/index.js",
   "scripts": {

package/products.md

@@ -23,7 +23,7 @@
 | batch | [批量计算](https://cloud.tencent.com/document/product/599) | 2024-01-01 00:02:00 |
 | bda | [人体分析](https://cloud.tencent.com/document/product/1208) | 2023-10-11 01:10:01 |
 | bi | [商业智能分析 BI](https://cloud.tencent.com/document/product/590) | 2023-12-22 01:07:03 |
-| billing | [费用中心](https://cloud.tencent.com/document/product/555) | 2023-12-27 01:07:34 |
+| billing | [费用中心](https://cloud.tencent.com/document/product/555) | 2024-01-09 01:07:19 |
 | bizlive | [商业直播](https://cloud.tencent.com/document/product) | 2020-03-10 01:08:07 |
 | bm | [黑石物理服务器CPM](https://cloud.tencent.com/document/product/386) | 2023-10-18 01:14:30 |
 | bma | [品牌经营管家](https://cloud.tencent.com/document/product/1296) | 2023-08-31 01:07:17 |
@@ -48,15 +48,15 @@
 | cdwdoris | [腾讯云数据仓库 TCHouse-D](https://cloud.tencent.com/document/product/1387) | 2024-01-05 01:09:22 |
 | cdwpg | [云数据仓库 PostgreSQL](https://cloud.tencent.com/document/product/878) | 2023-12-15 19:11:22 |
 | cfg | [混沌演练平台](https://cloud.tencent.com/document/product/1500) | 2023-11-24 01:09:00 |
-| cfs | [文件存储](https://cloud.tencent.com/document/product/582) | 2024-01-03 01:09:01 |
-| cfw | [云防火墙](https://cloud.tencent.com/document/product/1132) | 2024-01-05 01:09:38 |
+| cfs | [文件存储](https://cloud.tencent.com/document/product/582) | 2024-01-09 01:09:35 |
+| cfw | [云防火墙](https://cloud.tencent.com/document/product/1132) | 2024-01-09 01:09:43 |
 | chdfs | [云 HDFS](https://cloud.tencent.com/document/product/1105) | 2023-08-17 01:47:49 |
 | ciam | [账号风控平台](https://cloud.tencent.com/document/product/1441) | 2023-07-06 01:13:25 |
 | cii | [智能保险助手](https://cloud.tencent.com/document/product/1368) | 2023-05-18 01:12:07 |
 | cim | [](https://cloud.tencent.com/document/product) | 2019-05-16 17:21:18 |
 | cis | [](https://cloud.tencent.com/document/product) | 2018-06-07 15:01:42 |
 | ckafka | [消息队列 CKafka 版](https://cloud.tencent.com/document/product/597) | 2023-12-18 10:51:23 |
-| clb | [负载均衡](https://cloud.tencent.com/document/product/214) | 2023-12-08 01:24:17 |
+| clb | [负载均衡](https://cloud.tencent.com/document/product/214) | 2024-01-09 01:10:27 |
 | cloudaudit | [操作审计](https://cloud.tencent.com/document/product/629) | 2023-12-15 19:16:07 |
 | cloudhsm | [云加密机](https://cloud.tencent.com/document/product/639) | 2023-08-17 01:57:08 |
 | cloudstudio | [Cloud Studio（云端 IDE）](https://cloud.tencent.com/document/product/1039) | 2023-08-03 01:03:28 |
@@ -96,8 +96,8 @@
 | eis | [数据连接器](https://cloud.tencent.com/document/product/1270) | 2023-08-10 01:17:44 |
 | emr | [弹性 MapReduce](https://cloud.tencent.com/document/product/589) | 2023-12-25 00:10:01 |
 | es | [Elasticsearch Service](https://cloud.tencent.com/document/product/845) | 2024-01-03 01:15:03 |
-| ess | [腾讯电子签企业版](https://cloud.tencent.com/document/product/1323) | 2024-01-05 01:15:56 |
-| essbasic | [腾讯电子签（基础版）](https://cloud.tencent.com/document/product/1420) | 2024-01-08 00:10:12 |
+| ess | [腾讯电子签企业版](https://cloud.tencent.com/document/product/1323) | 2024-01-09 01:15:53 |
+| essbasic | [腾讯电子签（基础版）](https://cloud.tencent.com/document/product/1420) | 2024-01-09 01:16:08 |
 | facefusion | [人脸融合](https://cloud.tencent.com/document/product/670) | 2023-12-15 19:41:44 |
 | faceid | [人脸核身](https://cloud.tencent.com/document/product/1007) | 2023-12-27 01:19:47 |
 | fmu | [人脸试妆](https://cloud.tencent.com/document/product/1172) | 2023-12-25 00:11:01 |
@@ -146,7 +146,7 @@
 | mna | [多网聚合加速](https://cloud.tencent.com/document/product/1385) | 2023-12-01 01:19:47 |
 | mongodb | [云数据库 MongoDB](https://cloud.tencent.com/document/product/240) | 2023-12-27 01:26:46 |
 | monitor | [腾讯云可观测平台](https://cloud.tencent.com/document/product/248) | 2023-12-27 01:26:59 |
-| mps | [媒体处理](https://cloud.tencent.com/document/product/862) | 2024-01-03 01:19:35 |
+| mps | [媒体处理](https://cloud.tencent.com/document/product/862) | 2024-01-09 01:20:43 |
 | mrs | [医疗报告结构化](https://cloud.tencent.com/document/product/1314) | 2024-01-08 00:14:42 |
 | ms | [移动应用安全](https://cloud.tencent.com/document/product/283) | 2023-12-05 02:07:42 |
 | msp | [迁移服务平台](https://cloud.tencent.com/document/product/659) | 2023-08-17 04:18:22 |
@@ -191,7 +191,7 @@
 | tbm | [](https://cloud.tencent.com/document/product) | 2019-03-29 14:49:11 |
 | tbp | [腾讯智能对话平台](https://cloud.tencent.com/document/product/1060) | 2023-08-17 04:48:55 |
 | tcaplusdb | [游戏数据库 TcaplusDB](https://cloud.tencent.com/document/product/596) | 2023-09-25 01:25:42 |
-| tcb | [云开发 CloudBase](https://cloud.tencent.com/document/product/876) | 2023-12-27 01:32:04 |
+| tcb | [云开发 CloudBase](https://cloud.tencent.com/document/product/876) | 2024-01-09 01:24:12 |
 | tcbr | [云托管 CloudBase Run](https://cloud.tencent.com/document/product/1243) | 2023-05-18 01:51:15 |
 | tcex | [腾讯云释义](https://cloud.tencent.com/document/product/1266) | 2022-07-21 06:17:29 |
 | tchd | [腾讯云健康看板](https://cloud.tencent.com/document/product/1688) | 2023-11-28 01:24:39 |
@@ -204,7 +204,7 @@
 | tdmq | [消息队列 TDMQ](https://cloud.tencent.com/document/product/1179) | 2023-12-21 02:11:13 |
 | tds | [设备安全](https://cloud.tencent.com/document/product/1628) | 2023-11-15 02:26:59 |
 | tem | [弹性微服务](https://cloud.tencent.com/document/product/1371) | 2023-12-20 02:13:36 |
-| teo | [边缘安全加速平台](https://cloud.tencent.com/document/product/1552) | 2024-01-08 00:19:23 |
+| teo | [边缘安全加速平台](https://cloud.tencent.com/document/product/1552) | 2024-01-09 01:26:07 |
 | thpc | [高性能计算平台](https://cloud.tencent.com/document/product/1527) | 2023-11-27 00:20:12 |
 | tia | [智能钛机器学习](https://cloud.tencent.com/document/product/851) | 2021-10-21 11:12:52 |
 | tic | [资源编排 TIC](https://cloud.tencent.com/document/product/1213) | 2023-08-17 05:26:08 |
@@ -212,7 +212,7 @@
 | tics | [威胁情报云查服务](https://cloud.tencent.com/document/product/1013) | 2023-08-17 05:26:12 |
 | tiems | [腾讯云 TI 平台 TI-EMS ](https://cloud.tencent.com/document/product/1120) | 2022-07-19 06:19:39 |
 | tiia | [图像分析](https://cloud.tencent.com/document/product/865) | 2023-09-01 01:23:47 |
-| tione | [TI-ONE 训练平台](https://cloud.tencent.com/document/product/851) | 2024-01-01 00:19:59 |
+| tione | [TI-ONE 训练平台](https://cloud.tencent.com/document/product/851) | 2024-01-09 01:26:40 |
 | tiw | [互动白板](https://cloud.tencent.com/document/product/1137) | 2023-12-29 01:26:38 |
 | tke | [容器服务](https://cloud.tencent.com/document/product/457) | 2023-12-26 01:27:04 |
 | tkgdq | [腾讯知识图谱数据查询](https://cloud.tencent.com/document/product) | 2020-03-10 00:51:44 |
@@ -223,7 +223,7 @@
 | trocket | [消息队列 RocketMQ 版](https://cloud.tencent.com/document/product/1493) | 2024-01-04 01:25:28 |
 | trp | [T-Sec-安心平台(RP)](https://cloud.tencent.com/document/product/1458) | 2023-12-29 01:27:21 |
 | trro | [远程实时操控](https://cloud.tencent.com/document/product/1584) | 2023-07-18 01:53:24 |
-| trtc | [实时音视频](https://cloud.tencent.com/document/product/647) | 2024-01-08 00:21:01 |
+| trtc | [实时音视频](https://cloud.tencent.com/document/product/647) | 2024-01-09 01:27:58 |
 | tse | [微服务引擎 TSE](https://cloud.tencent.com/document/product/1364) | 2023-12-29 01:27:46 |
 | tsf | [微服务平台 TSF](https://cloud.tencent.com/document/product/649) | 2024-01-05 01:28:46 |
 | tsw | [微服务观测平台 TSW](https://cloud.tencent.com/document/product/1311) | 2023-05-18 02:04:00 |
@@ -231,7 +231,7 @@
 | ump | [客流数字化平台](https://cloud.tencent.com/document/product/1320) | 2023-08-17 05:50:27 |
 | vm | [视频内容安全](https://cloud.tencent.com/document/product/1265) | 2023-12-22 01:27:31 |
 | vms | [语音消息](https://cloud.tencent.com/document/product/1128) | 2023-08-17 05:50:56 |
-| vod | [云点播](https://cloud.tencent.com/document/product/266) | 2024-01-05 01:29:30 |
+| vod | [云点播](https://cloud.tencent.com/document/product/266) | 2024-01-09 01:28:56 |
 | vpc | [私有网络](https://cloud.tencent.com/document/product/215) | 2023-12-27 01:44:26 |
 | vrs | [声音复刻](https://cloud.tencent.com/document/product/1283) | 2023-11-27 00:23:42 |
 | waf | [Web 应用防火墙](https://cloud.tencent.com/document/product/627) | 2023-12-26 02:05:35 |

package/src/services/essbasic/v20210526/essbasic_models.ts

@@ -157,275 +157,240 @@ https://cloud.tencent.com/document/product/1323/78346#component-.E4.B8.89.E7.A7.
  */
 export interface Component {
   /**
-   * 控件编号
+   * 控件唯一ID。
 
-CreateFlowByTemplates发起合同时优先以ComponentId（不为空）填充；否则以ComponentName填充
+**在绝对定位方式方式下**，ComponentId为控件的ID，长度不能超过30，只能由中文、字母、数字和下划线组成，可以在后续的操作中使用该名称来引用控件。
 
-注：
-当GenerateMode=KEYWORD时，通过"^"来决定是否使用关键字整词匹配能力。
-例：当GenerateMode=KEYWORD时，如果传入关键字"^甲方签署^"，则会在PDF文件中有且仅有"甲方签署"关键字的地方进行对应操作。
-如传入的关键字为"甲方签署"，则PDF文件中每个出现关键字的位置都会执行相应操作。
+**在关键字定位方式下**，ComponentId不仅为控件的ID，也是关键字整词。此方式下可以通过"^"来决定是否使用关键字整词匹配能力。
+
+例：
+
+- 如传入的关键字<font color="red">"^甲方签署^"</font >，则会在PDF文件中有且仅有"甲方签署"关键字的地方（<font color="red">前后不能有其他字符</font >）进行对应操作。
+- 如传入的关键字为<font color="red">"甲方签署</font >"，则PDF文件中每个出现关键字的位置（<font color="red">前后可以有其他字符</font >）都会执行相应操作。
+- 如传入的关键字为<font color="red">"^甲方签署</font >"，则PDF文件中每个出现关键字的位置（<font color="red">前面不能有其他字符</font >）都会执行相应操作。
+- 如传入的关键字为<font color="red">"甲方签署^</font >"，则PDF文件中每个出现关键字的位置（<font color="red">后面不能有其他字符</font >）都会执行相应操作。
+
+
+注：`控件ID可以在一个PDF中不可重复`
 
-创建控件时，此值为空
-查询时返回完整结构
    */
   ComponentId?: string
   /**
-   * 如果是Component控件类型，则可选的字段为：
-TEXT - 普通文本控件，输入文本字符串；
-MULTI_LINE_TEXT - 多行文本控件，输入文本字符串；
-CHECK_BOX - 勾选框控件，若选中填写ComponentValue 填写 true或者 false 字符串；
-FILL_IMAGE - 图片控件，ComponentValue 填写图片的资源 ID；
-DYNAMIC_TABLE - 动态表格控件；
-ATTACHMENT - 附件控件,ComponentValue 填写附件图片的资源 ID列表，以逗号分割；
-SELECTOR - 选择器控件，ComponentValue填写选择的字符串内容；
-DATE - 日期控件；默认是格式化为xxxx年xx月xx日字符串；
-DISTRICT - 省市区行政区控件，ComponentValue填写省市区行政区字符串内容；
-
-如果是SignComponent控件类型，则可选的字段为
-SIGN_SEAL - 签署印章控件；
-SIGN_DATE - 签署日期控件；
-SIGN_SIGNATURE - 用户签名控件；
-SIGN_PERSONAL_SEAL - 个人签署印章控件（使用文件发起暂不支持此类型）；
-SIGN_PAGING_SEAL - 骑缝章；若文件发起，需要对应填充ComponentPosY、ComponentWidth、ComponentHeight
-SIGN_OPINION - 签署意见控件，用户需要根据配置的签署意见内容，完成对意见内容的确认;
-SIGN_LEGAL_PERSON_SEAL - 企业法定代表人控件。
-
-表单域的控件不能作为印章和签名控件
+   * **如果是Component填写控件类型，则可选的字段为**：
+
+<ul><li> <b>TEXT</b> : 普通文本控件，输入文本字符串；</li>
+<li> <b>MULTI_LINE_TEXT</b> : 多行文本控件，输入文本字符串；</li>
+<li> <b>CHECK_BOX</b> : 勾选框控件，若选中填写ComponentValue 填写 true或者 false 字符串；</li>
+<li> <b>FILL_IMAGE</b> : 图片控件，ComponentValue 填写图片的资源 ID；</li>
+<li> <b>DYNAMIC_TABLE</b> : 动态表格控件；</li>
+<li> <b>ATTACHMENT</b> : 附件控件,ComponentValue 填写附件图片的资源 ID列表，以逗号分隔；</li>
+<li> <b>SELECTOR</b> : 选择器控件，ComponentValue填写选择的字符串内容；</li>
+<li> <b>DATE</b> : 日期控件；默认是格式化为xxxx年xx月xx日字符串；</li>
+<li> <b>DISTRICT</b> : 省市区行政区控件，ComponentValue填写省市区行政区字符串内容；</li></ul>
+
+**如果是SignComponent签署控件类型，则可选的字段为**
+
+<ul><li> <b>SIGN_SEAL</b> : 签署印章控件；</li>
+<li> <b>SIGN_DATE</b> : 签署日期控件；</li>
+<li> <b>SIGN_SIGNATURE</b> : 用户签名控件；</li>
+<li> <b>SIGN_PERSONAL_SEAL</b> : 个人签署印章控件（使用文件发起暂不支持此类型）；</li>
+<li> <b>SIGN_PAGING_SEAL</b> : 骑缝章；若文件发起，需要对应填充ComponentPosY、ComponentWidth、ComponentHeight</li>
+<li> <b>SIGN_OPINION</b> : 签署意见控件，用户需要根据配置的签署意见内容，完成对意见内容的确认；</li>
+<li> <b>SIGN_LEGAL_PERSON_SEAL</b> : 企业法定代表人控件。</li></ul>
+注：` 表单域的控件不能作为印章和签名控件`
    */
   ComponentType?: string
   /**
-   * 控件简称，不超过30个字符
+   * **在绝对定位方式方式下**，ComponentName为控件名，长度不能超过20，只能由中文、字母、数字和下划线组成，可以在后续的操作中使用该名称来引用控件。
+
+**在表单域定位方式下**，ComponentName不仅为控件名，也是表单域名称。
+
+注：`控件名可以在一个PDF中可以重复`
+
    */
   ComponentName?: string
   /**
-   * 控件是否为必填项，
-默认为false-非必填
+   * 如果是<b>填写控件</b>，ComponentRequired表示在填写页面此控件是否必填
+<ul><li>false（默认）：可以不填写</li>
+<li>true ：必须填写此填写控件</li></ul>
+如果是<b>签署控件</b>，签批控件中签署意见等可以不填写， 其他签署控件不受此字段影响
    */
   ComponentRequired?: boolean
   /**
-   * 控件关联的参与方ID，对应Recipient结构体中的RecipientId
+   * **在通过接口拉取控件信息场景下**，为出参参数，此控件归属的参与方的角色ID角色（即RecipientId），**发起合同时候不要填写此字段留空即可**
    */
   ComponentRecipientId?: string
   /**
-   * 控件所属文件的序号 (文档中文件的排列序号，从0开始)
+   * <font color="red">【暂未使用】</font>控件所属文件的序号（取值为：0-N）。 目前单文件的情况下，值一直为0
    */
   FileIndex?: number
   /**
    * 控件生成的方式：
-NORMAL - 普通控件
-FIELD - 表单域
-KEYWORD - 关键字（设置关键字时，请确保PDF原始文件内是关键字以文字形式保存在PDF文件中，不支持对图片内文字进行关键字查找）
+<ul><li> <b>NORMAL</b> : 绝对定位控件</li>
+<li> <b>FIELD</b> : 表单域</li>
+<li> <b>KEYWORD</b> : 关键字（设置关键字时，请确保PDF原始文件内是关键字以文字形式保存在PDF文件中，不支持对图片内文字进行关键字查找）</li></ul>
    */
   GenerateMode?: string
   /**
-   * 参数控件宽度，默认100，单位px
-表单域和关键字转换控件不用填
+   * **在绝对定位方式和关键字定位方式下**，指定控件宽度，控件宽度是指控件在PDF文件中的宽度，单位为pt（点）。
+
    */
   ComponentWidth?: number
   /**
-   * 参数控件高度，默认100，单位px
-表单域和关键字转换控件不用填
+   * **在绝对定位方式和关键字定位方式下**，指定控件的高度， 控件高度是指控件在PDF文件中的高度，单位为pt（点）。
+
    */
   ComponentHeight?: number
   /**
-   * 参数控件所在页码，从1开始
+   * **在绝对定位方式方式下**，指定控件所在PDF文件上的页码
+
+注：
+1. 页码编号是从<font color="red">1</font>开始编号的。
+2.  <font color="red">页面编号不能超过PDF文件的页码总数</font>。如果指定的页码超过了PDF文件的页码总数，在填写和签署时会出现错误，导致无法正常进行操作。
    */
   ComponentPage?: number
   /**
-   * 参数控件X位置，单位px
+   * **在绝对定位方式和关键字定位方式下**，可以指定控件横向位置的位置，单位为pt（点）。
    */
   ComponentPosX?: number
   /**
-   * 参数控件Y位置，单位px
+   * **在绝对定位方式和关键字定位方式下**，可以指定控件纵向位置的位置，单位为pt（点）。
    */
   ComponentPosY?: number
   /**
-   * 扩展参数：
-为JSON格式。
-不同类型的控件会有部分非通用参数
-
-ComponentType为TEXT、MULTI_LINE_TEXT时，支持以下参数：
-1 Font：目前只支持黑体、宋体
-2 FontSize： 范围12-72
-3 FontAlign： Left/Right/Center，左对齐/居中/右对齐
-4 FontColor：字符串类型，格式为RGB颜色数字
-参数样例：{\"FontColor\":\"255,0,0\",\"FontSize\":12}
-
-ComponentType为FILL_IMAGE时，支持以下参数：
-NotMakeImageCenter：bool。是否设置图片居中。false：居中（默认）。 true: 不居中
-FillMethod: int. 填充方式。0-铺满（默认）；1-等比例缩放
-
-ComponentType为SIGN_SIGNATURE类型可以控制签署方式
-{“ComponentTypeLimit”: [“xxx”]}
-xxx可以为：
-HANDWRITE – 手写签名
-OCR_ESIGN -- AI智能识别手写签名
-ESIGN -- 个人印章类型
-SYSTEM_ESIGN -- 系统签名（该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署）
-如：{“ComponentTypeLimit”: [“SYSTEM_ESIGN”]}
-
-ComponentType为SIGN_DATE时，支持以下参数：
-1 Font：字符串类型目前只支持"黑体"、"宋体"，如果不填默认为"黑体"
-2 FontSize： 数字类型，范围6-72，默认值为12
-3 FontAlign： 字符串类型，可取Left/Right/Center，对应左对齐/居中/右对齐
-4 Format： 字符串类型，日期格式，必须是以下五种之一 “yyyy m d”，”yyyy年m月d日”，”yyyy/m/d”，”yyyy-m-d”，”yyyy.m.d”。
-5 Gaps:： 字符串类型，仅在Format为“yyyy m d”时起作用，格式为用逗号分开的两个整数，例如”2,2”，两个数字分别是日期格式的前后两个空隙中的空格个数
+   * **在所有的定位方式下**，控件的扩展参数，为<font color="red">JSON格式</font>，不同类型的控件会有部分非通用参数。
+
+<font color="red">ComponentType为TEXT、MULTI_LINE_TEXT时</font>，支持以下参数：
+<ul><li> <b>Font</b>：目前只支持黑体、宋体</li>
+<li> <b>FontSize</b>： 范围12 :72</li>
+<li> <b>FontAlign</b>： Left/Right/Center，左对齐/居中/右对齐</li>
+<li> <b>FontColor</b>：字符串类型，格式为RGB颜色数字</li></ul>
+<b>参数样例</b>：`{"FontColor":"255,0,0","FontSize":12}`
+
+<font color="red">ComponentType为FILL_IMAGE时</font>，支持以下参数：
+<ul><li> <b>NotMakeImageCenter</b>：bool。是否设置图片居中。false：居中（默认）。 true : 不居中</li>
+<li> <b>FillMethod</b> : int. 填充方式。0-铺满（默认）；1-等比例缩放</li></ul>
+
+<font color="red">ComponentType为SIGN_SIGNATURE类型时</font>，可以**ComponentTypeLimit**参数控制签署方式
+<ul><li> <b>HANDWRITE</b> : 手写签名</li>
+<li> <b>OCR_ESIGN</b> : AI智能识别手写签名</li>
+<li> <b>ESIGN</b> : 个人印章类型</li>
+<li> <b>SYSTEM_ESIGN</b> : 系统签名（该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署）</li>
+<li> <b>IMG_ESIGN</b> : 图片印章(该类型支持用户在签署将上传的PNG格式的图片作为签名)</li></ul>
+<b>参考样例</b>：`{"ComponentTypeLimit": ["SYSTEM_ESIGN"]}`
+印章的对应关系参考下图
+![image](https://qcloudimg.tencent-cloud.cn/raw/ee0498856c060c065628a0c5ba780d6b.jpg)
+
+<font color="red">ComponentType为SIGN_DATE时</font>，支持以下参数：
+<ul><li> <b>Font</b> :字符串类型目前只支持"黑体"、"宋体"，如果不填默认为"黑体"</li>
+<li> <b>FontSize</b> : 数字类型，范围6-72，默认值为12</li>
+<li> <b>FontAlign</b> : 字符串类型，可取Left/Right/Center，对应左对齐/居中/右对齐</li>
+<li> <b>Format</b> : 字符串类型，日期格式，必须是以下五种之一 “yyyy m d”，”yyyy年m月d日”，”yyyy/m/d”，”yyyy-m-d”，”yyyy.m.d”。</li>
+<li> <b>Gaps</b> : 字符串类型，仅在Format为“yyyy m d”时起作用，格式为用逗号分开的两个整数，例如”2,2”，两个数字分别是日期格式的前后两个空隙中的空格个数</li></ul>
 如果extra参数为空，默认为”yyyy年m月d日”格式的居中日期
 特别地，如果extra中Format字段为空或无法被识别，则extra参数会被当作默认值处理（Font，FontSize，Gaps和FontAlign都不会起效）
-参数样例： "ComponentExtra": "{"Format":“yyyy m d”,"FontSize":12,"Gaps":"2,2", "FontAlign":"Right"}"
+<b>参数样例</b>： ` "{"Format":"yyyy m d","FontSize":12,"Gaps":"2,2", "FontAlign":"Right"}"`
+
+<font color="red">ComponentType为SIGN_SEAL类型时</font>，支持以下参数：
+<ul><li> <b>PageRanges</b> :PageRange的数组，通过PageRanges属性设置该印章在PDF所有页面上盖章（适用于标书在所有页面盖章的情况）</li></ul>
+<b>参数样例</b>：` "{"PageRange":[{"BeginPage":1,"EndPage":-1}]}"`
+
 
-ComponentType为SIGN_SEAL类型时，支持以下参数：
-1.PageRanges：PageRange的数组，通过PageRanges属性设置该印章在PDF所有页面上盖章（适用于标书在所有页面盖章的情况）
-参数样例： "ComponentExtra":"{"PageRanges":[{"BeginPage":1,"EndPage":-1}]}"
+<font color="red">关键字模式下支持关键字找不到的情况下不进行报错的设置</font>
+<ul><li> <b>IgnoreKeywordError</b> :1-关键字查找不到时不进行报错</li></ul>
+场景说明：如果使用关键字进行定位，但是指定的PDF文件中又没有设置的关键字时，发起合同会进行关键字是否存在的校验，如果关键字不存在，会进行报错返回。如果不希望进行报错，可以设置"IgnoreKeywordError"来忽略错误。请注意，如果关键字签署控件对应的签署方在整个PDF文件中一个签署控件都没有，还是会触发报错逻辑。
+<b>参数样例</b>：` "{"IgnoreKeywordError":1}"`
    */
   ComponentExtra?: string
   /**
    * 控件填充vaule，ComponentType和传入值类型对应关系：
-TEXT - 文本内容
-MULTI_LINE_TEXT - 文本内容
-CHECK_BOX - true/false
-FILL_IMAGE、ATTACHMENT - 附件的FileId，需要通过UploadFiles接口上传获取
-SELECTOR - 选项值
-DATE - 默认是格式化为xxxx年xx月xx日
-DYNAMIC_TABLE - 传入json格式的表格内容，具体见数据结构FlowInfo：https://cloud.tencent.com/document/api/1420/61525#FlowInfo
-SIGN_SEAL - 印章ID
-SIGN_PAGING_SEAL - 可以指定印章ID
-
-控件值约束说明：
-企业全称控件：
-  约束：企业名称中文字符中文括号
-  检查正则表达式：/^[\u3400-\u4dbf\u4e00-\u9fa5（）]+$/
-
-统一社会信用代码控件：
-  检查正则表达式：/^[A-Z0-9]{1,18}$/
-
-法人名称控件：
-  约束：最大50个字符，2到25个汉字或者1到50个字母
-  检查正则表达式：/^([\u3400-\u4dbf\u4e00-\u9fa5.·]{2,25}|[a-zA-Z·,\s-]{1,50})$/
-
-签署意见控件：
-  约束：签署意见最大长度为50字符
+<ul><li> <b>TEXT</b> : 文本内容</li>
+<li> <b>MULTI_LINE_TEXT</b> : 文本内容</li>
+<li> <b>CHECK_BOX</b> : true/false</li>
+<li> <b>FILL_IMAGE、ATTACHMENT</b> : 附件的FileId，需要通过UploadFiles接口上传获取</li>
+<li> <b>SELECTOR</b> : 选项值</li>
+<li> <b>DYNAMIC_TABLE</b>  - 传入json格式的表格内容，详见说明：[数据表格](https://qian.tencent.com/developers/company/dynamic_table)</li>
+<li> <b>DATE</b> : 默认是格式化为xxxx年xx月xx日</li>
+<li> <b>SIGN_SEAL</b> : 印章ID，于控制台查询获取</li>
+<li> <b>SIGN_PAGING_SEAL</b> : 可以指定印章ID，于控制台查询获取</li></ul>
 
-签署人手机号控件：
-  约束：国内手机号 13,14,15,16,17,18,19号段长度11位
 
-签署人身份证控件：
-  约束：合法的身份证号码检查
-
-控件名称：
-  约束：控件名称最大长度为20字符
-
-单行文本控件：
-  约束：只允许输入中文，英文，数字，中英文标点符号
-
-多行文本控件：
-  约束：只允许输入中文，英文，数字，中英文标点符号
-
-勾选框控件：
-  约束：选择填字符串true，不选填字符串false
-
-选择器控件：
-  约束：同单行文本控件约束，填写选择值中的字符串
-
-数字控件：
-  约束：请输入有效的数字(可带小数点) 
-  检查正则表达式：/^(-|\+)?\d+(\.\d+)?$/
-
-日期控件：
-  约束：格式：yyyy年mm月dd日
-
-附件控件：
-  约束：JPG或PNG图片，上传数量限制，1到6个，最大6个附件
-
-图片控件：
-  约束：JPG或PNG图片，填写上传的图片资源ID
-
-邮箱控件：
-  约束：请输入有效的邮箱地址, w3c标准
-  检查正则表达式：/^([A-Za-z0-9_\-.!#$%&])+@([A-Za-z0-9_\-.])+\.([A-Za-z]{2,4})$/
-  参考：https://emailregex.com/
-
-地址控件：
-  同单行文本控件约束
-
-省市区控件：
-  同单行文本控件约束
-
-性别控件：
-  同单行文本控件约束，填写选择值中的字符串
-
-学历控件：
-  同单行文本控件约束，填写选择值中的字符串
+<b>控件值约束说明</b>：
+<table> <thead> <tr> <th>特殊控件</th> <th>填写约束</th> </tr> </thead> <tbody> <tr> <td>企业全称控件</td> <td>企业名称中文字符中文括号</td> </tr> <tr> <td>统一社会信用代码控件</td> <td>企业注册的统一社会信用代码</td> </tr> <tr> <td>法人名称控件</td> <td>最大50个字符，2到25个汉字或者1到50个字母</td> </tr> <tr> <td>签署意见控件</td> <td>签署意见最大长度为50字符</td> </tr> <tr> <td>签署人手机号控件</td> <td>国内手机号 13,14,15,16,17,18,19号段长度11位</td> </tr> <tr> <td>签署人身份证控件</td> <td>合法的身份证号码检查</td> </tr> <tr> <td>控件名称</td> <td>控件名称最大长度为20字符，不支持表情</td> </tr> <tr> <td>单行文本控件</td> <td>只允许输入中文，英文，数字，中英文标点符号，不支持表情</td> </tr> <tr> <td>多行文本控件</td> <td>只允许输入中文，英文，数字，中英文标点符号，不支持表情</td> </tr> <tr> <td>勾选框控件</td> <td>选择填字符串true，不选填字符串false</td> </tr> <tr> <td>选择器控件</td> <td>同单行文本控件约束，填写选择值中的字符串</td> </tr> <tr> <td>数字控件</td> <td>请输入有效的数字(可带小数点)</td> </tr> <tr> <td>日期控件</td> <td>格式：yyyy年mm月dd日</td> </tr> <tr> <td>附件控件</td> <td>JPG或PNG图片，上传数量限制，1到6个，最大6个附件，填写上传的资源ID</td> </tr> <tr> <td>图片控件</td> <td>JPG或PNG图片，填写上传的图片资源ID</td> </tr> <tr> <td>邮箱控件</td> <td>有效的邮箱地址, w3c标准</td> </tr> <tr> <td>地址控件</td> <td>只允许输入中文，英文，数字，中英文标点符号，不支持表情</td> </tr> <tr> <td>省市区控件</td> <td>只允许输入中文，英文，数字，中英文标点符号，不支持表情</td> </tr> <tr> <td>性别控件</td> <td>选择值中的字符串</td> </tr> <tr> <td>学历控件</td> <td>选择值中的字符串</td> </tr> </tbody> </table>
+注：   `部分特殊控件需要在控制台配置模板形式创建`
    */
   ComponentValue?: string
   /**
-   * 日期签署控件的字号，默认为 12
-
-签署区日期控件会转换成图片格式并带存证，需要通过字体决定图片大小
+   * <font color="red">【暂未使用】</font>日期签署控件的字号，默认为 12
    */
   ComponentDateFontSize?: number
   /**
-   * 控件所属文档的Id, 模板相关接口为空值
+   * <font color="red">【暂未使用】</font>控件归属的文档的ID， **发起合同时候不要填写此字段留空即可**
    */
   DocumentId?: string
   /**
-   * 控件描述，不超过30个字符
+   * <font color="red">【暂未使用】</font>控件描述，用户自定义，不影响合同发起流程
    */
   ComponentDescription?: string
   /**
-   * 指定关键字时横坐标偏移量，单位pt
+   * **如果控件是关键字定位方式**，可以对关键字定位出来的区域进行横坐标方向的调整，单位为pt（点）。例如，如果关键字定位出来的区域偏左或偏右，可以通过调整横坐标方向的参数来使控件位置更加准确。
+注意： `向左调整设置为负数， 向右调整设置成正数`
    */
   OffsetX?: number
   /**
-   * 指定关键字时纵坐标偏移量，单位pt
+   * **如果控件是关键字定位方式**，可以对关键字定位出来的区域进行纵坐标方向的调整，单位为pt（点）。例如，如果关键字定位出来的区域偏上或偏下，可以通过调整纵坐标方向的参数来使控件位置更加准确。
+注意： `向上调整设置为负数， 向下调整设置成正数`
    */
   OffsetY?: number
   /**
-   * 平台企业控件ID。
-如果不为空，属于平台企业预设控件；
+   * <font color="red">【暂未使用】</font>第三方应用集成平台模板控件 ID 标识
    */
   ChannelComponentId?: string
   /**
-   * 指定关键字排序规则，
-Positive-正序，
-Reverse-倒序。
-传入Positive时会根据关键字在PDF文件内的顺序进行排列。在指定KeywordIndexes时，0代表在PDF内查找内容时，查找到的第一个关键字。
-传入Reverse时会根据关键字在PDF文件内的反序进行排列。在指定KeywordIndexes时，0代表在PDF内查找内容时，查找到的最后一个关键字。
+   * **如果控件是关键字定位方式**，指定关键字排序规则时，可以选择Positive或Reverse两种排序方式。
+<ul><li> <b>Positive</b> :表示正序，即根据关键字在PDF文件内的顺序进行排列</li>
+<li> <b>Reverse</b> :表示倒序，即根据关键字在PDF文件内的反序进行排列</li></ul>
+
+在指定KeywordIndexes时，如果使用Positive排序方式，0代表在PDF内查找内容时，查找到的第一个关键字；如果使用Reverse排序方式，0代表在PDF内查找内容时，查找到的最后一个关键字。
    */
   KeywordOrder?: string
   /**
-   * 指定关键字页码。
-指定页码后，将只在指定的页码内查找关键字，非该页码的关键字将不会查询出来
+   * **如果控件是关键字定位方式**，在KeywordPage中指定关键字页码时，将只会在该页码中查找关键字，非该页码的关键字将不会查询出来。如果不设置查找所有页面中的关键字。
    */
   KeywordPage?: number
   /**
-   * 关键字位置模式，
-Middle-居中，
-Below-正下方，
-Right-正右方，
-LowerRight-右上角，
-UpperRight-右下角。
+   * **如果控件是关键字定位方式**，关键字生成的区域的对齐方式， 可以设置下面的值
+<ul><li> <b>Middle</b> :居中</li>
+<li> <b>Below</b> :正下方</li>
+<li> <b>Right</b> :正右方</li>
+<li> <b>LowerRight</b> :右上角</li>
+<li> <b>UpperRight</b> :右下角。</li></ul>
 示例：如果设置Middle的关键字盖章，则印章的中心会和关键字的中心重合，如果设置Below，则印章在关键字的正下方
    */
   RelativeLocation?: string
   /**
-   * 关键字索引，如果一个关键字在PDF文件中存在多个，可以通过关键字索引指定使用第几个关键字作为最后的结果，可指定多个索引。
-示例[0,2]，说明使用PDF文件内第1个和第3个关键字位置。
+   * **如果控件是关键字定位方式**，关键字索引是指在PDF文件中存在多个相同的关键字时，通过索引指定使用哪一个关键字作为最后的结果。可以通过指定多个索引来同时使用多个关键字。例如，[0,2]表示使用PDF文件内第1个和第3个关键字位置作为最后的结果。
+
+注意：关键字索引是从0开始计数的
    */
   KeywordIndexes?: Array<number | bigint>
   /**
-   * 填写提示的内容
+   * 填写控件在腾讯电子签小程序填写界面展示的提示信息，例如，在身份证号码填写控件中，提示信息可以设置成“请输入18位身份证号码”。
+注：`签署控件设置此字段无效`
 注意：此字段可能返回 null，表示取不到有效值。
    */
   Placeholder?: string
   /**
-   * 是否锁定控件值不允许编辑（嵌入式发起使用） <br/>默认false：不锁定控件值，允许在页面编辑控件值	
+   * **web嵌入发起合同场景下**， 是否锁定填写和签署控件值不允许嵌入页面进行编辑
+<ul><li>false（默认）：不锁定控件值，允许在页面编辑控件值</li>
+<li>true：锁定控件值，在页面编辑控件值</li></ul>
 注意：此字段可能返回 null，表示取不到有效值。
    */
   LockComponentValue?: boolean
   /**
-   * 是否禁止移动和删除控件 <br/>默认false，不禁止移动和删除控件	
+   * **web嵌入发起合同场景下**，是否禁止移动和删除填写和签署控件
+<ul><li> <b>false（默认）</b> :不禁止移动和删除控件</li>
+<li> <b>true</b> : 可以移动和删除控件</li></ul>
 注意：此字段可能返回 null，表示取不到有效值。
    */
   ForbidMoveAndDelete?: boolean

package/tencentcloud/services/essbasic/v20210526/essbasic_models.d.ts

@@ -136,275 +136,240 @@ https://cloud.tencent.com/document/product/1323/78346#component-.E4.B8.89.E7.A7.
  */
 export interface Component {
     /**
-     * 控件编号
+     * 控件唯一ID。
   
-  CreateFlowByTemplates发起合同时优先以ComponentId（不为空）填充；否则以ComponentName填充
+  **在绝对定位方式方式下**，ComponentId为控件的ID，长度不能超过30，只能由中文、字母、数字和下划线组成，可以在后续的操作中使用该名称来引用控件。
   
-  注：
-  当GenerateMode=KEYWORD时，通过"^"来决定是否使用关键字整词匹配能力。
-  例：当GenerateMode=KEYWORD时，如果传入关键字"^甲方签署^"，则会在PDF文件中有且仅有"甲方签署"关键字的地方进行对应操作。
-  如传入的关键字为"甲方签署"，则PDF文件中每个出现关键字的位置都会执行相应操作。
+  **在关键字定位方式下**，ComponentId不仅为控件的ID，也是关键字整词。此方式下可以通过"^"来决定是否使用关键字整词匹配能力。
+  
+  例：
+  
+  - 如传入的关键字<font color="red">"^甲方签署^"</font >，则会在PDF文件中有且仅有"甲方签署"关键字的地方（<font color="red">前后不能有其他字符</font >）进行对应操作。
+  - 如传入的关键字为<font color="red">"甲方签署</font >"，则PDF文件中每个出现关键字的位置（<font color="red">前后可以有其他字符</font >）都会执行相应操作。
+  - 如传入的关键字为<font color="red">"^甲方签署</font >"，则PDF文件中每个出现关键字的位置（<font color="red">前面不能有其他字符</font >）都会执行相应操作。
+  - 如传入的关键字为<font color="red">"甲方签署^</font >"，则PDF文件中每个出现关键字的位置（<font color="red">后面不能有其他字符</font >）都会执行相应操作。
+  
+  
+  注：`控件ID可以在一个PDF中不可重复`
   
-  创建控件时，此值为空
-  查询时返回完整结构
      */
     ComponentId?: string;
     /**
-     * 如果是Component控件类型，则可选的字段为：
-  TEXT - 普通文本控件，输入文本字符串；
-  MULTI_LINE_TEXT - 多行文本控件，输入文本字符串；
-  CHECK_BOX - 勾选框控件，若选中填写ComponentValue 填写 true或者 false 字符串；
-  FILL_IMAGE - 图片控件，ComponentValue 填写图片的资源 ID；
-  DYNAMIC_TABLE - 动态表格控件；
-  ATTACHMENT - 附件控件,ComponentValue 填写附件图片的资源 ID列表，以逗号分割；
-  SELECTOR - 选择器控件，ComponentValue填写选择的字符串内容；
-  DATE - 日期控件；默认是格式化为xxxx年xx月xx日字符串；
-  DISTRICT - 省市区行政区控件，ComponentValue填写省市区行政区字符串内容；
-  
-  如果是SignComponent控件类型，则可选的字段为
-  SIGN_SEAL - 签署印章控件；
-  SIGN_DATE - 签署日期控件；
-  SIGN_SIGNATURE - 用户签名控件；
-  SIGN_PERSONAL_SEAL - 个人签署印章控件（使用文件发起暂不支持此类型）；
-  SIGN_PAGING_SEAL - 骑缝章；若文件发起，需要对应填充ComponentPosY、ComponentWidth、ComponentHeight
-  SIGN_OPINION - 签署意见控件，用户需要根据配置的签署意见内容，完成对意见内容的确认;
-  SIGN_LEGAL_PERSON_SEAL - 企业法定代表人控件。
-  
-  表单域的控件不能作为印章和签名控件
+     * **如果是Component填写控件类型，则可选的字段为**：
+  
+  <ul><li> <b>TEXT</b> : 普通文本控件，输入文本字符串；</li>
+  <li> <b>MULTI_LINE_TEXT</b> : 多行文本控件，输入文本字符串；</li>
+  <li> <b>CHECK_BOX</b> : 勾选框控件，若选中填写ComponentValue 填写 true或者 false 字符串；</li>
+  <li> <b>FILL_IMAGE</b> : 图片控件，ComponentValue 填写图片的资源 ID；</li>
+  <li> <b>DYNAMIC_TABLE</b> : 动态表格控件；</li>
+  <li> <b>ATTACHMENT</b> : 附件控件,ComponentValue 填写附件图片的资源 ID列表，以逗号分隔；</li>
+  <li> <b>SELECTOR</b> : 选择器控件，ComponentValue填写选择的字符串内容；</li>
+  <li> <b>DATE</b> : 日期控件；默认是格式化为xxxx年xx月xx日字符串；</li>
+  <li> <b>DISTRICT</b> : 省市区行政区控件，ComponentValue填写省市区行政区字符串内容；</li></ul>
+  
+  **如果是SignComponent签署控件类型，则可选的字段为**
+  
+  <ul><li> <b>SIGN_SEAL</b> : 签署印章控件；</li>
+  <li> <b>SIGN_DATE</b> : 签署日期控件；</li>
+  <li> <b>SIGN_SIGNATURE</b> : 用户签名控件；</li>
+  <li> <b>SIGN_PERSONAL_SEAL</b> : 个人签署印章控件（使用文件发起暂不支持此类型）；</li>
+  <li> <b>SIGN_PAGING_SEAL</b> : 骑缝章；若文件发起，需要对应填充ComponentPosY、ComponentWidth、ComponentHeight</li>
+  <li> <b>SIGN_OPINION</b> : 签署意见控件，用户需要根据配置的签署意见内容，完成对意见内容的确认；</li>
+  <li> <b>SIGN_LEGAL_PERSON_SEAL</b> : 企业法定代表人控件。</li></ul>
+  注：` 表单域的控件不能作为印章和签名控件`
      */
     ComponentType?: string;
     /**
-     * 控件简称，不超过30个字符
+     * **在绝对定位方式方式下**，ComponentName为控件名，长度不能超过20，只能由中文、字母、数字和下划线组成，可以在后续的操作中使用该名称来引用控件。
+  
+  **在表单域定位方式下**，ComponentName不仅为控件名，也是表单域名称。
+  
+  注：`控件名可以在一个PDF中可以重复`
+  
      */
     ComponentName?: string;
     /**
-     * 控件是否为必填项，
-  默认为false-非必填
+     * 如果是<b>填写控件</b>，ComponentRequired表示在填写页面此控件是否必填
+  <ul><li>false（默认）：可以不填写</li>
+  <li>true ：必须填写此填写控件</li></ul>
+  如果是<b>签署控件</b>，签批控件中签署意见等可以不填写， 其他签署控件不受此字段影响
      */
     ComponentRequired?: boolean;
     /**
-     * 控件关联的参与方ID，对应Recipient结构体中的RecipientId
+     * **在通过接口拉取控件信息场景下**，为出参参数，此控件归属的参与方的角色ID角色（即RecipientId），**发起合同时候不要填写此字段留空即可**
      */
     ComponentRecipientId?: string;
     /**
-     * 控件所属文件的序号 (文档中文件的排列序号，从0开始)
+     * <font color="red">【暂未使用】</font>控件所属文件的序号（取值为：0-N）。 目前单文件的情况下，值一直为0
      */
     FileIndex?: number;
     /**
      * 控件生成的方式：
-  NORMAL - 普通控件
-  FIELD - 表单域
-  KEYWORD - 关键字（设置关键字时，请确保PDF原始文件内是关键字以文字形式保存在PDF文件中，不支持对图片内文字进行关键字查找）
+  <ul><li> <b>NORMAL</b> : 绝对定位控件</li>
+  <li> <b>FIELD</b> : 表单域</li>
+  <li> <b>KEYWORD</b> : 关键字（设置关键字时，请确保PDF原始文件内是关键字以文字形式保存在PDF文件中，不支持对图片内文字进行关键字查找）</li></ul>
      */
     GenerateMode?: string;
     /**
-     * 参数控件宽度，默认100，单位px
-  表单域和关键字转换控件不用填
+     * **在绝对定位方式和关键字定位方式下**，指定控件宽度，控件宽度是指控件在PDF文件中的宽度，单位为pt（点）。
+  
      */
     ComponentWidth?: number;
     /**
-     * 参数控件高度，默认100，单位px
-  表单域和关键字转换控件不用填
+     * **在绝对定位方式和关键字定位方式下**，指定控件的高度， 控件高度是指控件在PDF文件中的高度，单位为pt（点）。
+  
      */
     ComponentHeight?: number;
     /**
-     * 参数控件所在页码，从1开始
+     * **在绝对定位方式方式下**，指定控件所在PDF文件上的页码
+  
+  注：
+  1. 页码编号是从<font color="red">1</font>开始编号的。
+  2.  <font color="red">页面编号不能超过PDF文件的页码总数</font>。如果指定的页码超过了PDF文件的页码总数，在填写和签署时会出现错误，导致无法正常进行操作。
      */
     ComponentPage?: number;
     /**
-     * 参数控件X位置，单位px
+     * **在绝对定位方式和关键字定位方式下**，可以指定控件横向位置的位置，单位为pt（点）。
      */
     ComponentPosX?: number;
     /**
-     * 参数控件Y位置，单位px
+     * **在绝对定位方式和关键字定位方式下**，可以指定控件纵向位置的位置，单位为pt（点）。
      */
     ComponentPosY?: number;
     /**
-     * 扩展参数：
-  为JSON格式。
-  不同类型的控件会有部分非通用参数
-  
-  ComponentType为TEXT、MULTI_LINE_TEXT时，支持以下参数：
-  1 Font：目前只支持黑体、宋体
-  2 FontSize： 范围12-72
-  3 FontAlign： Left/Right/Center，左对齐/居中/右对齐
-  4 FontColor：字符串类型，格式为RGB颜色数字
-  参数样例：{\"FontColor\":\"255,0,0\",\"FontSize\":12}
-  
-  ComponentType为FILL_IMAGE时，支持以下参数：
-  NotMakeImageCenter：bool。是否设置图片居中。false：居中（默认）。 true: 不居中
-  FillMethod: int. 填充方式。0-铺满（默认）；1-等比例缩放
-  
-  ComponentType为SIGN_SIGNATURE类型可以控制签署方式
-  {“ComponentTypeLimit”: [“xxx”]}
-  xxx可以为：
-  HANDWRITE – 手写签名
-  OCR_ESIGN -- AI智能识别手写签名
-  ESIGN -- 个人印章类型
-  SYSTEM_ESIGN -- 系统签名（该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署）
-  如：{“ComponentTypeLimit”: [“SYSTEM_ESIGN”]}
-  
-  ComponentType为SIGN_DATE时，支持以下参数：
-  1 Font：字符串类型目前只支持"黑体"、"宋体"，如果不填默认为"黑体"
-  2 FontSize： 数字类型，范围6-72，默认值为12
-  3 FontAlign： 字符串类型，可取Left/Right/Center，对应左对齐/居中/右对齐
-  4 Format： 字符串类型，日期格式，必须是以下五种之一 “yyyy m d”，”yyyy年m月d日”，”yyyy/m/d”，”yyyy-m-d”，”yyyy.m.d”。
-  5 Gaps:： 字符串类型，仅在Format为“yyyy m d”时起作用，格式为用逗号分开的两个整数，例如”2,2”，两个数字分别是日期格式的前后两个空隙中的空格个数
+     * **在所有的定位方式下**，控件的扩展参数，为<font color="red">JSON格式</font>，不同类型的控件会有部分非通用参数。
+  
+  <font color="red">ComponentType为TEXT、MULTI_LINE_TEXT时</font>，支持以下参数：
+  <ul><li> <b>Font</b>：目前只支持黑体、宋体</li>
+  <li> <b>FontSize</b>： 范围12 :72</li>
+  <li> <b>FontAlign</b>： Left/Right/Center，左对齐/居中/右对齐</li>
+  <li> <b>FontColor</b>：字符串类型，格式为RGB颜色数字</li></ul>
+  <b>参数样例</b>：`{"FontColor":"255,0,0","FontSize":12}`
+  
+  <font color="red">ComponentType为FILL_IMAGE时</font>，支持以下参数：
+  <ul><li> <b>NotMakeImageCenter</b>：bool。是否设置图片居中。false：居中（默认）。 true : 不居中</li>
+  <li> <b>FillMethod</b> : int. 填充方式。0-铺满（默认）；1-等比例缩放</li></ul>
+  
+  <font color="red">ComponentType为SIGN_SIGNATURE类型时</font>，可以**ComponentTypeLimit**参数控制签署方式
+  <ul><li> <b>HANDWRITE</b> : 手写签名</li>
+  <li> <b>OCR_ESIGN</b> : AI智能识别手写签名</li>
+  <li> <b>ESIGN</b> : 个人印章类型</li>
+  <li> <b>SYSTEM_ESIGN</b> : 系统签名（该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署）</li>
+  <li> <b>IMG_ESIGN</b> : 图片印章(该类型支持用户在签署将上传的PNG格式的图片作为签名)</li></ul>
+  <b>参考样例</b>：`{"ComponentTypeLimit": ["SYSTEM_ESIGN"]}`
+  印章的对应关系参考下图
+  ![image](https://qcloudimg.tencent-cloud.cn/raw/ee0498856c060c065628a0c5ba780d6b.jpg)
+  
+  <font color="red">ComponentType为SIGN_DATE时</font>，支持以下参数：
+  <ul><li> <b>Font</b> :字符串类型目前只支持"黑体"、"宋体"，如果不填默认为"黑体"</li>
+  <li> <b>FontSize</b> : 数字类型，范围6-72，默认值为12</li>
+  <li> <b>FontAlign</b> : 字符串类型，可取Left/Right/Center，对应左对齐/居中/右对齐</li>
+  <li> <b>Format</b> : 字符串类型，日期格式，必须是以下五种之一 “yyyy m d”，”yyyy年m月d日”，”yyyy/m/d”，”yyyy-m-d”，”yyyy.m.d”。</li>
+  <li> <b>Gaps</b> : 字符串类型，仅在Format为“yyyy m d”时起作用，格式为用逗号分开的两个整数，例如”2,2”，两个数字分别是日期格式的前后两个空隙中的空格个数</li></ul>
   如果extra参数为空，默认为”yyyy年m月d日”格式的居中日期
   特别地，如果extra中Format字段为空或无法被识别，则extra参数会被当作默认值处理（Font，FontSize，Gaps和FontAlign都不会起效）
-  参数样例： "ComponentExtra": "{"Format":“yyyy m d”,"FontSize":12,"Gaps":"2,2", "FontAlign":"Right"}"
+  <b>参数样例</b>： ` "{"Format":"yyyy m d","FontSize":12,"Gaps":"2,2", "FontAlign":"Right"}"`
+  
+  <font color="red">ComponentType为SIGN_SEAL类型时</font>，支持以下参数：
+  <ul><li> <b>PageRanges</b> :PageRange的数组，通过PageRanges属性设置该印章在PDF所有页面上盖章（适用于标书在所有页面盖章的情况）</li></ul>
+  <b>参数样例</b>：` "{"PageRange":[{"BeginPage":1,"EndPage":-1}]}"`
+  
   
-  ComponentType为SIGN_SEAL类型时，支持以下参数：
-  1.PageRanges：PageRange的数组，通过PageRanges属性设置该印章在PDF所有页面上盖章（适用于标书在所有页面盖章的情况）
-  参数样例： "ComponentExtra":"{"PageRanges":[{"BeginPage":1,"EndPage":-1}]}"
+  <font color="red">关键字模式下支持关键字找不到的情况下不进行报错的设置</font>
+  <ul><li> <b>IgnoreKeywordError</b> :1-关键字查找不到时不进行报错</li></ul>
+  场景说明：如果使用关键字进行定位，但是指定的PDF文件中又没有设置的关键字时，发起合同会进行关键字是否存在的校验，如果关键字不存在，会进行报错返回。如果不希望进行报错，可以设置"IgnoreKeywordError"来忽略错误。请注意，如果关键字签署控件对应的签署方在整个PDF文件中一个签署控件都没有，还是会触发报错逻辑。
+  <b>参数样例</b>：` "{"IgnoreKeywordError":1}"`
      */
     ComponentExtra?: string;
     /**
      * 控件填充vaule，ComponentType和传入值类型对应关系：
-  TEXT - 文本内容
-  MULTI_LINE_TEXT - 文本内容
-  CHECK_BOX - true/false
-  FILL_IMAGE、ATTACHMENT - 附件的FileId，需要通过UploadFiles接口上传获取
-  SELECTOR - 选项值
-  DATE - 默认是格式化为xxxx年xx月xx日
-  DYNAMIC_TABLE - 传入json格式的表格内容，具体见数据结构FlowInfo：https://cloud.tencent.com/document/api/1420/61525#FlowInfo
-  SIGN_SEAL - 印章ID
-  SIGN_PAGING_SEAL - 可以指定印章ID
-  
-  控件值约束说明：
-  企业全称控件：
-    约束：企业名称中文字符中文括号
-    检查正则表达式：/^[\u3400-\u4dbf\u4e00-\u9fa5（）]+$/
-  
-  统一社会信用代码控件：
-    检查正则表达式：/^[A-Z0-9]{1,18}$/
-  
-  法人名称控件：
-    约束：最大50个字符，2到25个汉字或者1到50个字母
-    检查正则表达式：/^([\u3400-\u4dbf\u4e00-\u9fa5.·]{2,25}|[a-zA-Z·,\s-]{1,50})$/
-  
-  签署意见控件：
-    约束：签署意见最大长度为50字符
+  <ul><li> <b>TEXT</b> : 文本内容</li>
+  <li> <b>MULTI_LINE_TEXT</b> : 文本内容</li>
+  <li> <b>CHECK_BOX</b> : true/false</li>
+  <li> <b>FILL_IMAGE、ATTACHMENT</b> : 附件的FileId，需要通过UploadFiles接口上传获取</li>
+  <li> <b>SELECTOR</b> : 选项值</li>
+  <li> <b>DYNAMIC_TABLE</b>  - 传入json格式的表格内容，详见说明：[数据表格](https://qian.tencent.com/developers/company/dynamic_table)</li>
+  <li> <b>DATE</b> : 默认是格式化为xxxx年xx月xx日</li>
+  <li> <b>SIGN_SEAL</b> : 印章ID，于控制台查询获取</li>
+  <li> <b>SIGN_PAGING_SEAL</b> : 可以指定印章ID，于控制台查询获取</li></ul>
   
-  签署人手机号控件：
-    约束：国内手机号 13,14,15,16,17,18,19号段长度11位
   
-  签署人身份证控件：
-    约束：合法的身份证号码检查
-  
-  控件名称：
-    约束：控件名称最大长度为20字符
-  
-  单行文本控件：
-    约束：只允许输入中文，英文，数字，中英文标点符号
-  
-  多行文本控件：
-    约束：只允许输入中文，英文，数字，中英文标点符号
-  
-  勾选框控件：
-    约束：选择填字符串true，不选填字符串false
-  
-  选择器控件：
-    约束：同单行文本控件约束，填写选择值中的字符串
-  
-  数字控件：
-    约束：请输入有效的数字(可带小数点)
-    检查正则表达式：/^(-|\+)?\d+(\.\d+)?$/
-  
-  日期控件：
-    约束：格式：yyyy年mm月dd日
-  
-  附件控件：
-    约束：JPG或PNG图片，上传数量限制，1到6个，最大6个附件
-  
-  图片控件：
-    约束：JPG或PNG图片，填写上传的图片资源ID
-  
-  邮箱控件：
-    约束：请输入有效的邮箱地址, w3c标准
-    检查正则表达式：/^([A-Za-z0-9_\-.!#$%&])+@([A-Za-z0-9_\-.])+\.([A-Za-z]{2,4})$/
-    参考：https://emailregex.com/
-  
-  地址控件：
-    同单行文本控件约束
-  
-  省市区控件：
-    同单行文本控件约束
-  
-  性别控件：
-    同单行文本控件约束，填写选择值中的字符串
-  
-  学历控件：
-    同单行文本控件约束，填写选择值中的字符串
+  <b>控件值约束说明</b>：
+  <table> <thead> <tr> <th>特殊控件</th> <th>填写约束</th> </tr> </thead> <tbody> <tr> <td>企业全称控件</td> <td>企业名称中文字符中文括号</td> </tr> <tr> <td>统一社会信用代码控件</td> <td>企业注册的统一社会信用代码</td> </tr> <tr> <td>法人名称控件</td> <td>最大50个字符，2到25个汉字或者1到50个字母</td> </tr> <tr> <td>签署意见控件</td> <td>签署意见最大长度为50字符</td> </tr> <tr> <td>签署人手机号控件</td> <td>国内手机号 13,14,15,16,17,18,19号段长度11位</td> </tr> <tr> <td>签署人身份证控件</td> <td>合法的身份证号码检查</td> </tr> <tr> <td>控件名称</td> <td>控件名称最大长度为20字符，不支持表情</td> </tr> <tr> <td>单行文本控件</td> <td>只允许输入中文，英文，数字，中英文标点符号，不支持表情</td> </tr> <tr> <td>多行文本控件</td> <td>只允许输入中文，英文，数字，中英文标点符号，不支持表情</td> </tr> <tr> <td>勾选框控件</td> <td>选择填字符串true，不选填字符串false</td> </tr> <tr> <td>选择器控件</td> <td>同单行文本控件约束，填写选择值中的字符串</td> </tr> <tr> <td>数字控件</td> <td>请输入有效的数字(可带小数点)</td> </tr> <tr> <td>日期控件</td> <td>格式：yyyy年mm月dd日</td> </tr> <tr> <td>附件控件</td> <td>JPG或PNG图片，上传数量限制，1到6个，最大6个附件，填写上传的资源ID</td> </tr> <tr> <td>图片控件</td> <td>JPG或PNG图片，填写上传的图片资源ID</td> </tr> <tr> <td>邮箱控件</td> <td>有效的邮箱地址, w3c标准</td> </tr> <tr> <td>地址控件</td> <td>只允许输入中文，英文，数字，中英文标点符号，不支持表情</td> </tr> <tr> <td>省市区控件</td> <td>只允许输入中文，英文，数字，中英文标点符号，不支持表情</td> </tr> <tr> <td>性别控件</td> <td>选择值中的字符串</td> </tr> <tr> <td>学历控件</td> <td>选择值中的字符串</td> </tr> </tbody> </table>
+  注：   `部分特殊控件需要在控制台配置模板形式创建`
      */
     ComponentValue?: string;
     /**
-     * 日期签署控件的字号，默认为 12
-  
-  签署区日期控件会转换成图片格式并带存证，需要通过字体决定图片大小
+     * <font color="red">【暂未使用】</font>日期签署控件的字号，默认为 12
      */
     ComponentDateFontSize?: number;
     /**
-     * 控件所属文档的Id, 模板相关接口为空值
+     * <font color="red">【暂未使用】</font>控件归属的文档的ID， **发起合同时候不要填写此字段留空即可**
      */
     DocumentId?: string;
     /**
-     * 控件描述，不超过30个字符
+     * <font color="red">【暂未使用】</font>控件描述，用户自定义，不影响合同发起流程
      */
     ComponentDescription?: string;
     /**
-     * 指定关键字时横坐标偏移量，单位pt
+     * **如果控件是关键字定位方式**，可以对关键字定位出来的区域进行横坐标方向的调整，单位为pt（点）。例如，如果关键字定位出来的区域偏左或偏右，可以通过调整横坐标方向的参数来使控件位置更加准确。
+  注意： `向左调整设置为负数， 向右调整设置成正数`
      */
     OffsetX?: number;
     /**
-     * 指定关键字时纵坐标偏移量，单位pt
+     * **如果控件是关键字定位方式**，可以对关键字定位出来的区域进行纵坐标方向的调整，单位为pt（点）。例如，如果关键字定位出来的区域偏上或偏下，可以通过调整纵坐标方向的参数来使控件位置更加准确。
+  注意： `向上调整设置为负数， 向下调整设置成正数`
      */
     OffsetY?: number;
     /**
-     * 平台企业控件ID。
-  如果不为空，属于平台企业预设控件；
+     * <font color="red">【暂未使用】</font>第三方应用集成平台模板控件 ID 标识
      */
     ChannelComponentId?: string;
     /**
-     * 指定关键字排序规则，
-  Positive-正序，
-  Reverse-倒序。
-  传入Positive时会根据关键字在PDF文件内的顺序进行排列。在指定KeywordIndexes时，0代表在PDF内查找内容时，查找到的第一个关键字。
-  传入Reverse时会根据关键字在PDF文件内的反序进行排列。在指定KeywordIndexes时，0代表在PDF内查找内容时，查找到的最后一个关键字。
+     * **如果控件是关键字定位方式**，指定关键字排序规则时，可以选择Positive或Reverse两种排序方式。
+  <ul><li> <b>Positive</b> :表示正序，即根据关键字在PDF文件内的顺序进行排列</li>
+  <li> <b>Reverse</b> :表示倒序，即根据关键字在PDF文件内的反序进行排列</li></ul>
+  
+  在指定KeywordIndexes时，如果使用Positive排序方式，0代表在PDF内查找内容时，查找到的第一个关键字；如果使用Reverse排序方式，0代表在PDF内查找内容时，查找到的最后一个关键字。
      */
     KeywordOrder?: string;
     /**
-     * 指定关键字页码。
-  指定页码后，将只在指定的页码内查找关键字，非该页码的关键字将不会查询出来
+     * **如果控件是关键字定位方式**，在KeywordPage中指定关键字页码时，将只会在该页码中查找关键字，非该页码的关键字将不会查询出来。如果不设置查找所有页面中的关键字。
      */
     KeywordPage?: number;
     /**
-     * 关键字位置模式，
-  Middle-居中，
-  Below-正下方，
-  Right-正右方，
-  LowerRight-右上角，
-  UpperRight-右下角。
+     * **如果控件是关键字定位方式**，关键字生成的区域的对齐方式， 可以设置下面的值
+  <ul><li> <b>Middle</b> :居中</li>
+  <li> <b>Below</b> :正下方</li>
+  <li> <b>Right</b> :正右方</li>
+  <li> <b>LowerRight</b> :右上角</li>
+  <li> <b>UpperRight</b> :右下角。</li></ul>
   示例：如果设置Middle的关键字盖章，则印章的中心会和关键字的中心重合，如果设置Below，则印章在关键字的正下方
      */
     RelativeLocation?: string;
     /**
-     * 关键字索引，如果一个关键字在PDF文件中存在多个，可以通过关键字索引指定使用第几个关键字作为最后的结果，可指定多个索引。
-  示例[0,2]，说明使用PDF文件内第1个和第3个关键字位置。
+     * **如果控件是关键字定位方式**，关键字索引是指在PDF文件中存在多个相同的关键字时，通过索引指定使用哪一个关键字作为最后的结果。可以通过指定多个索引来同时使用多个关键字。例如，[0,2]表示使用PDF文件内第1个和第3个关键字位置作为最后的结果。
+  
+  注意：关键字索引是从0开始计数的
      */
     KeywordIndexes?: Array<number | bigint>;
     /**
-     * 填写提示的内容
+     * 填写控件在腾讯电子签小程序填写界面展示的提示信息，例如，在身份证号码填写控件中，提示信息可以设置成“请输入18位身份证号码”。
+  注：`签署控件设置此字段无效`
   注意：此字段可能返回 null，表示取不到有效值。
      */
     Placeholder?: string;
     /**
-     * 是否锁定控件值不允许编辑（嵌入式发起使用） <br/>默认false：不锁定控件值，允许在页面编辑控件值
+     * **web嵌入发起合同场景下**， 是否锁定填写和签署控件值不允许嵌入页面进行编辑
+  <ul><li>false（默认）：不锁定控件值，允许在页面编辑控件值</li>
+  <li>true：锁定控件值，在页面编辑控件值</li></ul>
   注意：此字段可能返回 null，表示取不到有效值。
      */
     LockComponentValue?: boolean;
     /**
-     * 是否禁止移动和删除控件 <br/>默认false，不禁止移动和删除控件
+     * **web嵌入发起合同场景下**，是否禁止移动和删除填写和签署控件
+  <ul><li> <b>false（默认）</b> :不禁止移动和删除控件</li>
+  <li> <b>true</b> : 可以移动和删除控件</li></ul>
   注意：此字段可能返回 null，表示取不到有效值。
      */
     ForbidMoveAndDelete?: boolean;