tencentcloud-sdk-ess 3.0.732 → 3.0.734

Sign up to get free protection for your applications and to get access to all the features.
Files changed (4) hide show
  1. checksums.yaml +4 -4
  2. data/lib/VERSION +1 -1
  3. data/lib/v20201111/models.rb +163 -192
  4. metadata +2 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 3fd679ee714f6c038d6cf98cc67d7ac2705a9054
4
- data.tar.gz: 812cb23e63b89a7e15c13a3a29689fb8ad26e8fd
3
+ metadata.gz: ef316d635ddaebf1d189b1f75681e9252d81eca4
4
+ data.tar.gz: f410741fc5efb788216b512f67cca873273d635a
5
5
  SHA512:
6
- metadata.gz: fb7ebcae6ab01a8f2c10e3b25604ac8490847ec93bb24f7d2b5aedf97c609003ea23188a80d1eac6fd44785df9f586a55e7800053c329000f34feb9b6b6ac925
7
- data.tar.gz: af7946b5287de78ad8cf0f545122a1fec56a373a46ca6c30f14dc60e3d3847fe9ed9a6f0b31ab34357a22ffbc8cae0ab5ee3e9450343a269ec23c45248784f1f
6
+ metadata.gz: 3b118227cdd0565f0cd8a60a0511e96e530ba7979206c8db8c5cec8c646a161e46284ddc411cec24a2a326aa901a47b59961560ae076c63089a70f3d2cfd4601
7
+ data.tar.gz: 3b3595021255ea72c06738662adc38ef28f6c5430bf4dae149eed1020b39c2559f0a33a4876934509ccb8f8c2eef60c6500e8d7815e7fbf8006d41cfa2bad637
data/lib/VERSION CHANGED
@@ -1 +1 @@
1
- 3.0.732
1
+ 3.0.734
@@ -941,226 +941,193 @@ module TencentCloud
941
941
  # 可以参考官网说明
942
942
  # https://cloud.tencent.com/document/product/1323/78346#component-.E4.B8.89.E7.A7.8D.E5.AE.9A.E4.BD.8D.E6.96.B9.E5.BC.8F.E8.AF.B4.E6.98.8E
943
943
  class Component < TencentCloud::Common::AbstractModel
944
- # @param ComponentType: 如果是Component填写控件类型,则可选的字段为:
945
- # TEXT - 普通文本控件,输入文本字符串;
946
- # MULTI_LINE_TEXT - 多行文本控件,输入文本字符串;
947
- # CHECK_BOX - 勾选框控件,若选中填写ComponentValue 填写 true或者 false 字符串;
948
- # FILL_IMAGE - 图片控件,ComponentValue 填写图片的资源 ID;
949
- # DYNAMIC_TABLE - 动态表格控件;
950
- # ATTACHMENT - 附件控件,ComponentValue 填写附件图片的资源 ID列表,以逗号分隔;
951
- # SELECTOR - 选择器控件,ComponentValue填写选择的字符串内容;
952
- # DATE - 日期控件;默认是格式化为xxxx年xx月xx日字符串;
953
- # DISTRICT - 省市区行政区控件,ComponentValue填写省市区行政区字符串内容;
954
-
955
- # 如果是SignComponent签署控件类型,则可选的字段为
956
- # SIGN_SEAL - 签署印章控件;
957
- # SIGN_DATE - 签署日期控件;
958
- # SIGN_SIGNATURE - 用户签名控件;
959
- # SIGN_PERSONAL_SEAL - 个人签署印章控件(使用文件发起暂不支持此类型);
960
- # SIGN_PAGING_SEAL - 骑缝章;若文件发起,需要对应填充ComponentPosY、ComponentWidth、ComponentHeight
961
- # SIGN_OPINION - 签署意见控件,用户需要根据配置的签署意见内容,完成对意见内容的确认;
962
- # SIGN_LEGAL_PERSON_SEAL - 企业法定代表人控件。
963
-
964
- # 表单域的控件不能作为印章和签名控件
944
+ # @param ComponentType: **如果是Component填写控件类型,则可选的字段为**:
945
+
946
+ # <ul><li> <b>TEXT</b> : 普通文本控件,输入文本字符串;</li>
947
+ # <li> <b>MULTI_LINE_TEXT</b> : 多行文本控件,输入文本字符串;</li>
948
+ # <li> <b>CHECK_BOX</b> : 勾选框控件,若选中填写ComponentValue 填写 true或者 false 字符串;</li>
949
+ # <li> <b>FILL_IMAGE</b> : 图片控件,ComponentValue 填写图片的资源 ID;</li>
950
+ # <li> <b>DYNAMIC_TABLE</b> : 动态表格控件;</li>
951
+ # <li> <b>ATTACHMENT</b> : 附件控件,ComponentValue 填写附件图片的资源 ID列表,以逗号分隔;</li>
952
+ # <li> <b>SELECTOR</b> : 选择器控件,ComponentValue填写选择的字符串内容;</li>
953
+ # <li> <b>DATE</b> : 日期控件;默认是格式化为xxxx年xx月xx日字符串;</li>
954
+ # <li> <b>DISTRICT</b> : 省市区行政区控件,ComponentValue填写省市区行政区字符串内容;</li></ul>
955
+
956
+ # **如果是SignComponent签署控件类型,则可选的字段为**
957
+
958
+ # <ul><li> <b>SIGN_SEAL</b> : 签署印章控件;</li>
959
+ # <li> <b>SIGN_DATE</b> : 签署日期控件;</li>
960
+ # <li> <b>SIGN_SIGNATURE</b> : 用户签名控件;</li>
961
+ # <li> <b>SIGN_PERSONAL_SEAL</b> : 个人签署印章控件(使用文件发起暂不支持此类型);</li>
962
+ # <li> <b>SIGN_PAGING_SEAL</b> : 骑缝章;若文件发起,需要对应填充ComponentPosY、ComponentWidth、ComponentHeight</li>
963
+ # <li> <b>SIGN_OPINION</b> : 签署意见控件,用户需要根据配置的签署意见内容,完成对意见内容的确认;</li>
964
+ # <li> <b>SIGN_LEGAL_PERSON_SEAL</b> : 企业法定代表人控件。</li></ul>
965
+ # 注:` 表单域的控件不能作为印章和签名控件`
965
966
  # @type ComponentType: String
966
- # @param FileIndex: 控件所属文件的序号(取值为:0-N)。
967
- # 目前单文件的情况下,值是0
968
- # @type FileIndex: Integer
969
- # @param ComponentHeight: 参数控件高度,单位pt
967
+ # @param ComponentHeight: **在绝对定位方式和关键字定位方式下**,指定控件的高度, 控件高度是指控件在PDF文件中的高度,单位为pt(点)。
970
968
  # @type ComponentHeight: Float
971
- # @param ComponentWidth: 参数控件宽度,单位pt
969
+ # @param ComponentWidth: **在绝对定位方式和关键字定位方式下**,指定控件宽度,控件宽度是指控件在PDF文件中的宽度,单位为pt(点)。
972
970
  # @type ComponentWidth: Float
973
- # @param ComponentPage: 参数控件所在页码,取值为:1-N
971
+ # @param ComponentPage: **在绝对定位方式方式下**,指定控件所在PDF文件上的页码
972
+
973
+ # 注:
974
+ # 1. 页码编号是从<font color="red">1</font>开始编号的。
975
+ # 2. <font color="red">页面编号不能超过PDF文件的页码总数</font>。如果指定的页码超过了PDF文件的页码总数,在填写和签署时会出现错误,导致无法正常进行操作。
974
976
  # @type ComponentPage: Integer
975
- # @param ComponentPosX: 参数控件X位置,单位pt
977
+ # @param ComponentPosX: **在绝对定位方式和关键字定位方式下**,可以指定控件横向位置的位置,单位为pt(点)。
976
978
  # @type ComponentPosX: Float
977
- # @param ComponentPosY: 参数控件Y位置,单位pt
979
+ # @param ComponentPosY: **在绝对定位方式和关键字定位方式下**,可以指定控件纵向位置的位置,单位为pt(点)。
978
980
  # @type ComponentPosY: Float
981
+ # @param FileIndex: <font color="red">【暂未使用】</font>控件所属文件的序号(取值为:0-N)。 目前单文件的情况下,值一直为0
982
+ # @type FileIndex: Integer
983
+ # @param GenerateMode: 控件生成的方式:
984
+ # <ul><li> <b>NORMAL</b> : 绝对定位控件</li>
985
+ # <li> <b>FIELD</b> : 表单域</li>
986
+ # <li> <b>KEYWORD</b> : 关键字(设置关键字时,请确保PDF原始文件内是关键字以文字形式保存在PDF文件中,不支持对图片内文字进行关键字查找)</li></ul>
987
+ # @type GenerateMode: String
979
988
  # @param ComponentId: 控件唯一ID。
980
- # 或使用文件发起合同时用于GenerateMode==KEYWORD 指定关键字
989
+
990
+ # **在绝对定位方式方式下**,ComponentId为控件的ID,长度不能超过30,只能由中文、字母、数字和下划线组成,可以在后续的操作中使用该名称来引用控件。
991
+
992
+ # **在关键字定位方式下**,ComponentId不仅为控件的ID,也是关键字整词。此方式下可以通过"^"来决定是否使用关键字整词匹配能力。
993
+
994
+ # 例:
995
+
996
+ # - 如传入的关键字<font color="red">"^甲方签署^"</font >,则会在PDF文件中有且仅有"甲方签署"关键字的地方(<font color="red">前后不能有其他字符</font >)进行对应操作。
997
+ # - 如传入的关键字为<font color="red">"甲方签署</font >",则PDF文件中每个出现关键字的位置(<font color="red">前后可以有其他字符</font >)都会执行相应操作。
998
+ # - 如传入的关键字为<font color="red">"^甲方签署</font >",则PDF文件中每个出现关键字的位置(<font color="red">前面不能有其他字符</font >)都会执行相应操作。
999
+ # - 如传入的关键字为<font color="red">"甲方签署^</font >",则PDF文件中每个出现关键字的位置(<font color="red">后面不能有其他字符</font >)都会执行相应操作。
1000
+
1001
+
1002
+ # 注:`控件ID可以在一个PDF中不可重复`
981
1003
  # @type ComponentId: String
982
- # @param ComponentName: 控件名。
983
- # 或使用文件发起合同时用于GenerateMode==FIELD 指定表单域名称
1004
+ # @param ComponentName: **在绝对定位方式方式下**,ComponentName为控件名,长度不能超过20,只能由中文、字母、数字和下划线组成,可以在后续的操作中使用该名称来引用控件。
1005
+
1006
+ # **在表单域定位方式下**,ComponentName不仅为控件名,也是表单域名称。
1007
+
1008
+ # 注:`控件名可以在一个PDF中可以重复`
984
1009
  # @type ComponentName: String
985
- # @param ComponentRequired: 是否必选,默认为false-非必选
1010
+ # @param ComponentRequired: 如果是<b>填写控件</b>,ComponentRequired表示在填写页面此控件是否必填
1011
+ # <ul><li>false(默认):可以不填写</li>
1012
+ # <li>true :必须填写此填写控件</li></ul>
1013
+ # 如果是<b>签署控件</b>,签批控件中签署意见等可以不填写, 其他签署控件不受此字段影响
986
1014
  # @type ComponentRequired: Boolean
987
- # @param ComponentRecipientId: 控件关联的参与方ID,对应Recipient结构体中的RecipientId
1015
+ # @param ComponentRecipientId: **在通过接口拉取控件信息场景下**,为出参参数,此控件归属的参与方的角色ID角色(即RecipientId),**发起合同时候不要填写此字段留空即可**
988
1016
  # @type ComponentRecipientId: String
989
- # @param ComponentExtra: 扩展参数:
990
- # 为JSON格式。
991
- # 不同类型的控件会有部分非通用参数
992
-
993
- # ComponentType为TEXT、MULTI_LINE_TEXT时,支持以下参数:
994
- # 1 Font:目前只支持黑体、宋体
995
- # 2 FontSize: 范围12-72
996
- # 3 FontAlign: Left/Right/Center,左对齐/居中/右对齐
997
- # 4 FontColor:字符串类型,格式为RGB颜色数字
998
- # 参数样例:{\"FontColor\":\"255,0,0\",\"FontSize\":12}
999
-
1000
- # ComponentType为FILL_IMAGE时,支持以下参数:
1001
- # NotMakeImageCenter:bool。是否设置图片居中。false:居中(默认)。 true: 不居中
1002
- # FillMethod: int. 填充方式。0-铺满(默认);1-等比例缩放
1003
-
1004
- # ComponentType为SIGN_SIGNATURE类型可以控制签署方式
1005
- # {“ComponentTypeLimit”: [“xxx”]}
1006
- # xxx可以为:
1007
- # HANDWRITE 手写签名
1008
- # OCR_ESIGN -- AI智能识别手写签名
1009
- # ESIGN -- 个人印章类型
1010
- # SYSTEM_ESIGN -- 系统签名(该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署)
1011
- # 如:{“ComponentTypeLimit”: [“SYSTEM_ESIGN”]}
1012
-
1013
- # ComponentType为SIGN_DATE时,支持以下参数:
1014
- # 1 Font:字符串类型目前只支持"黑体"、"宋体",如果不填默认为"黑体"
1015
- # 2 FontSize: 数字类型,范围6-72,默认值为12
1016
- # 3 FontAlign: 字符串类型,可取Left/Right/Center,对应左对齐/居中/右对齐
1017
- # 4 Format: 字符串类型,日期格式,必须是以下五种之一 yyyy m d”,”yyyy年m月d日”,”yyyy/m/d”,”yyyy-m-d”,”yyyy.m.d”。
1018
- # 5 Gaps:: 字符串类型,仅在Format为“yyyy m d”时起作用,格式为用逗号分开的两个整数,例如”2,2”,两个数字分别是日期格式的前后两个空隙中的空格个数
1017
+ # @param ComponentExtra: **在所有的定位方式下**,控件的扩展参数,为<font color="red">JSON格式</font>,不同类型的控件会有部分非通用参数。
1018
+
1019
+ # <font color="red">ComponentType为TEXT、MULTI_LINE_TEXT时</font>,支持以下参数:
1020
+ # <ul><li> <b>Font</b>:目前只支持黑体、宋体</li>
1021
+ # <li> <b>FontSize</b>: 范围12 :72</li>
1022
+ # <li> <b>FontAlign</b>: Left/Right/Center,左对齐/居中/右对齐</li>
1023
+ # <li> <b>FontColor</b>:字符串类型,格式为RGB颜色数字</li></ul>
1024
+ # <b>参数样例</b>:`{"FontColor":"255,0,0","FontSize":12}`
1025
+
1026
+ # <font color="red">ComponentType为FILL_IMAGE时</font>,支持以下参数:
1027
+ # <ul><li> <b>NotMakeImageCenter</b>:bool。是否设置图片居中。false:居中(默认)。 true : 不居中</li>
1028
+ # <li> <b>FillMethod</b> : int. 填充方式。0-铺满(默认);1-等比例缩放</li></ul>
1029
+
1030
+ # <font color="red">ComponentType为SIGN_SIGNATURE类型时</font>,可以**ComponentTypeLimit**参数控制签署方式
1031
+ # <ul><li> <b>HANDWRITE</b> : 手写签名</li>
1032
+ # <li> <b>OCR_ESIGN</b> : AI智能识别手写签名</li>
1033
+ # <li> <b>ESIGN</b> : 个人印章类型</li>
1034
+ # <li> <b>SYSTEM_ESIGN</b> : 系统签名(该类型可以在用户签署时根据用户姓名一键生成一个签名来进行签署)</li>
1035
+ # <li> <b>IMG_ESIGN</b> : 图片印章(该类型支持用户在签署将上传的PNG格式的图片作为签名)</li></ul>
1036
+ # <b>参考样例</b>:`{"ComponentTypeLimit": ["SYSTEM_ESIGN"]}`
1037
+ # 印章的对应关系参考下图
1038
+ # ![image](https://qcloudimg.tencent-cloud.cn/raw/ee0498856c060c065628a0c5ba780d6b.jpg)
1039
+
1040
+ # <font color="red">ComponentType为SIGN_DATE时</font>,支持以下参数:
1041
+ # <ul><li> <b>Font</b> :字符串类型目前只支持"黑体"、"宋体",如果不填默认为"黑体"</li>
1042
+ # <li> <b>FontSize</b> : 数字类型,范围6-72,默认值为12</li>
1043
+ # <li> <b>FontAlign</b> : 字符串类型,可取Left/Right/Center,对应左对齐/居中/右对齐</li>
1044
+ # <li> <b>Format</b> : 字符串类型,日期格式,必须是以下五种之一 “yyyy m d”,”yyyy年m月d日”,”yyyy/m/d”,”yyyy-m-d”,”yyyy.m.d”。</li>
1045
+ # <li> <b>Gaps</b> : 字符串类型,仅在Format为“yyyy m d”时起作用,格式为用逗号分开的两个整数,例如”2,2”,两个数字分别是日期格式的前后两个空隙中的空格个数</li></ul>
1019
1046
  # 如果extra参数为空,默认为”yyyy年m月d日”格式的居中日期
1020
1047
  # 特别地,如果extra中Format字段为空或无法被识别,则extra参数会被当作默认值处理(Font,FontSize,Gaps和FontAlign都不会起效)
1021
- # 参数样例: "ComponentExtra": "{"Format":“yyyy m d”,"FontSize":12,"Gaps":"2,2", "FontAlign":"Right"}"
1048
+ # <b>参数样例</b>: ` "{"Format":"yyyy m d","FontSize":12,"Gaps":"2,2", "FontAlign":"Right"}"`
1022
1049
 
1023
- # ComponentType为SIGN_SEAL类型时,支持以下参数:
1024
- # 1.PageRangesPageRange的数组,通过PageRanges属性设置该印章在PDF所有页面上盖章(适用于标书在所有页面盖章的情况)
1025
- # 参数样例: "ComponentExtra":"{"PageRange":[{"BeginPage":1,"EndPage":-1}]}"
1050
+ # <font color="red">ComponentType为SIGN_SEAL类型时</font>,支持以下参数:
1051
+ # <ul><li> <b>PageRanges</b> :PageRange的数组,通过PageRanges属性设置该印章在PDF所有页面上盖章(适用于标书在所有页面盖章的情况)</li></ul>
1052
+ # <b>参数样例</b>:` "{"PageRange":[{"BeginPage":1,"EndPage":-1}]}"`
1026
1053
  # @type ComponentExtra: String
1027
- # @param IsFormType: 是否是表单域类型,默认false-不是
1054
+ # @param IsFormType: **在通过接口拉取控件信息场景下**,为出参参数,此控件是否通过表单域定位方式生成,默认false-不是,**发起合同时候不要填写此字段留空即可**
1028
1055
  # 注意:此字段可能返回 null,表示取不到有效值。
1029
1056
  # @type IsFormType: Boolean
1030
1057
  # @param ComponentValue: 控件填充vaule,ComponentType和传入值类型对应关系:
1031
- # TEXT - 文本内容
1032
- # MULTI_LINE_TEXT - 文本内容
1033
- # CHECK_BOX - true/false
1034
- # FILL_IMAGE、ATTACHMENT - 附件的FileId,需要通过UploadFiles接口上传获取
1035
- # SELECTOR - 选项值
1036
- # DYNAMIC_TABLE - 传入json格式的表格内容,具体见数据结构FlowInfo:https://cloud.tencent.com/document/api/1420/61525#FlowInfo
1037
- # DATE - 默认是格式化为xxxx年xx月xx
1038
- # SIGN_SEAL - 印章ID,于控制台查询获取
1039
- # SIGN_PAGING_SEAL - 可以指定印章ID,于控制台查询获取
1040
-
1041
- # 控件值约束说明:
1042
- # 企业全称控件:
1043
- # 约束:企业名称中文字符中文括号
1044
- # 检查正则表达式:/^[\u3400-\u4dbf\u4e00-\u9fa5()]+$/
1045
-
1046
- # 统一社会信用代码控件:
1047
- # 检查正则表达式:/^[A-Z0-9]{1,18}$/
1048
-
1049
- # 法人名称控件:
1050
- # 约束:最大50个字符,2到25个汉字或者1到50个字母
1051
- # 检查正则表达式:/^([\u3400-\u4dbf\u4e00-\u9fa5.·]{2,25}|[a-zA-Z·,\s-]{1,50})$/
1052
-
1053
- # 签署意见控件:
1054
- # 约束:签署意见最大长度为50字符
1055
-
1056
- # 签署人手机号控件:
1057
- # 约束:国内手机号 13,14,15,16,17,18,19号段长度11位
1058
-
1059
- # 签署人身份证控件:
1060
- # 约束:合法的身份证号码检查
1061
-
1062
- # 控件名称:
1063
- # 约束:控件名称最大长度为20字符
1064
-
1065
- # 单行文本控件:
1066
- # 约束:只允许输入中文,英文,数字,中英文标点符号
1067
-
1068
- # 多行文本控件:
1069
- # 约束:只允许输入中文,英文,数字,中英文标点符号
1070
-
1071
- # 勾选框控件:
1072
- # 约束:选择填字符串true,不选填字符串false
1073
-
1074
- # 选择器控件:
1075
- # 约束:同单行文本控件约束,填写选择值中的字符串
1076
-
1077
- # 数字控件:
1078
- # 约束:请输入有效的数字(可带小数点)
1079
- # 检查正则表达式:/^(-|\+)?\d+(\.\d+)?$/
1080
-
1081
- # 日期控件:
1082
- # 约束:格式:yyyy年mm月dd日
1083
-
1084
- # 附件控件:
1085
- # 约束:JPG或PNG图片,上传数量限制,1到6个,最大6个附件
1086
-
1087
- # 图片控件:
1088
- # 约束:JPG或PNG图片,填写上传的图片资源ID
1089
-
1090
- # 邮箱控件:
1091
- # 约束:请输入有效的邮箱地址, w3c标准
1092
- # 检查正则表达式:/^([A-Za-z0-9_\-.!#$%&])+@([A-Za-z0-9_\-.])+\.([A-Za-z]{2,4})$/
1093
- # 参考:https://emailregex.com/
1094
-
1095
- # 地址控件:
1096
- # 同单行文本控件约束
1097
-
1098
- # 省市区控件:
1099
- # 同单行文本控件约束
1100
-
1101
- # 性别控件:
1102
- # 同单行文本控件约束,填写选择值中的字符串
1103
-
1104
- # 学历控件:
1105
- # 同单行文本控件约束,填写选择值中的字符串
1058
+ # <ul><li> <b>TEXT</b> : 文本内容</li>
1059
+ # <li> <b>MULTI_LINE_TEXT</b> : 文本内容</li>
1060
+ # <li> <b>CHECK_BOX</b> : true/false</li>
1061
+ # <li> <b>FILL_IMAGE、ATTACHMENT</b> : 附件的FileId,需要通过UploadFiles接口上传获取</li>
1062
+ # <li> <b>SELECTOR</b> : 选项值</li>
1063
+ # <li> <b>DYNAMIC_TABLE</b> - 传入json格式的表格内容,详见说明:[数据表格](https://qian.tencent.com/developers/company/dynamic_table)</li>
1064
+ # <li> <b>DATE</b> : 默认是格式化为xxxx年xx月xx日</li>
1065
+ # <li> <b>SIGN_SEAL</b> : 印章ID,于控制台查询获取</li>
1066
+ # <li> <b>SIGN_PAGING_SEAL</b> : 可以指定印章ID,于控制台查询获取</li></ul>
1067
+
1068
+
1069
+ # <b>控件值约束说明</b>:
1070
+ # <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>
1071
+ # 注: `部分特殊控件需要在控制台配置模板形式创建`
1106
1072
  # @type ComponentValue: String
1107
- # @param GenerateMode: 控件生成的方式:
1108
- # NORMAL - 普通控件
1109
- # FIELD - 表单域
1110
- # KEYWORD - 关键字(设置关键字时,请确保PDF原始文件内是关键字以文字形式保存在PDF文件中,不支持对图片内文字进行关键字查找)
1111
- # @type GenerateMode: String
1112
- # @param ComponentDateFontSize: 日期签署控件的字号,默认为 12
1113
- # @type ComponentDateFontSize: Integer
1114
- # @param ChannelComponentId: 第三方应用集成平台模板控件 ID 标识
1115
- # @type ChannelComponentId: String
1116
- # @param OffsetX: 指定关键字时横坐标偏移量,单位pt
1073
+ # @param OffsetX: **如果控件是关键字定位方式**,可以对关键字定位出来的区域进行横坐标方向的调整,单位为pt(点)。例如,如果关键字定位出来的区域偏左或偏右,可以通过调整横坐标方向的参数来使控件位置更加准确。
1074
+ # 注意: `向左调整设置为负数, 向右调整设置成正数`
1117
1075
  # 注意:此字段可能返回 null,表示取不到有效值。
1118
1076
  # @type OffsetX: Float
1119
- # @param OffsetY: 指定关键字时纵坐标偏移量,单位pt
1077
+ # @param OffsetY: **如果控件是关键字定位方式**,可以对关键字定位出来的区域进行纵坐标方向的调整,单位为pt(点)。例如,如果关键字定位出来的区域偏上或偏下,可以通过调整纵坐标方向的参数来使控件位置更加准确。
1078
+ # 注意: `向上调整设置为负数, 向下调整设置成正数`
1120
1079
  # 注意:此字段可能返回 null,表示取不到有效值。
1121
1080
  # @type OffsetY: Float
1122
- # @param ChannelComponentSource: 第三方应用集成中子客企业控件来源。
1123
- # 0-平台指定;
1124
- # 1-用户自定义
1125
- # @type ChannelComponentSource: Integer
1126
- # @param KeywordOrder: 指定关键字排序规则,Positive-正序,Reverse-倒序。
1127
- # 传入Positive时会根据关键字在PDF文件内的顺序进行排列。在指定KeywordIndexes时,0代表在PDF内查找内容时,查找到的第一个关键字。
1128
- # 传入Reverse时会根据关键字在PDF文件内的反序进行排列。在指定KeywordIndexes时,0代表在PDF内查找内容时,查找到的最后一个关键字。
1081
+ # @param KeywordOrder: **如果控件是关键字定位方式**,指定关键字排序规则时,可以选择Positive或Reverse两种排序方式。
1082
+ # <ul><li> <b>Positive</b> :表示正序,即根据关键字在PDF文件内的顺序进行排列</li>
1083
+ # <li> <b>Reverse</b> :表示倒序,即根据关键字在PDF文件内的反序进行排列</li></ul>
1084
+
1085
+ # 在指定KeywordIndexes时,如果使用Positive排序方式,0代表在PDF内查找内容时,查找到的第一个关键字;如果使用Reverse排序方式,0代表在PDF内查找内容时,查找到的最后一个关键字。
1129
1086
  # @type KeywordOrder: String
1130
- # @param KeywordPage: 指定关键字页码。
1131
- # 指定页码后,将只在指定的页码内查找关键字,非该页码的关键字将不会查询出来
1087
+ # @param KeywordPage: **如果控件是关键字定位方式**,在KeywordPage中指定关键字页码时,将只会在该页码中查找关键字,非该页码的关键字将不会查询出来。如果不设置查找所有页面中的关键字。
1132
1088
  # @type KeywordPage: Integer
1133
- # @param RelativeLocation: 关键字位置模式,
1134
- # Middle-居中,
1135
- # Below-正下方,
1136
- # Right-正右方,
1137
- # LowerRight-右上角,
1138
- # UpperRight-右下角。
1089
+ # @param RelativeLocation: **如果控件是关键字定位方式**,关键字生成的区域的对齐方式, 可以设置下面的值
1090
+ # <ul><li> <b>Middle</b> :居中</li>
1091
+ # <li> <b>Below</b> :正下方</li>
1092
+ # <li> <b>Right</b> :正右方</li>
1093
+ # <li> <b>LowerRight</b> :右上角</li>
1094
+ # <li> <b>UpperRight</b> :右下角。</li></ul>
1139
1095
  # 示例:如果设置Middle的关键字盖章,则印章的中心会和关键字的中心重合,如果设置Below,则印章在关键字的正下方
1140
1096
  # @type RelativeLocation: String
1141
- # @param KeywordIndexes: 关键字索引。
1142
- # 如果一个关键字在PDF文件中存在多个,可以通过关键字索引指定使用第几个关键字作为最后的结果,可指定多个索引。
1143
- # 示例:[0,2],说明使用PDF文件内第1个和第3个关键字位置。
1097
+ # @param KeywordIndexes: **如果控件是关键字定位方式**,关键字索引是指在PDF文件中存在多个相同的关键字时,通过索引指定使用哪一个关键字作为最后的结果。可以通过指定多个索引来同时使用多个关键字。例如,[0,2]表示使用PDF文件内第1个和第3个关键字位置作为最后的结果。
1098
+
1099
+ # 注意:关键字索引是从0开始计数的
1144
1100
  # @type KeywordIndexes: Array
1145
- # @param LockComponentValue: 是否锁定控件值不允许编辑(嵌入式发起使用)
1146
- # <br/>默认false:不锁定控件值,允许在页面编辑控件值
1101
+ # @param LockComponentValue: **web嵌入发起合同场景下**, 是否锁定填写和签署控件值不允许嵌入页面进行编辑
1102
+ # <ul><li>false(默认):不锁定控件值,允许在页面编辑控件值</li>
1103
+ # <li>true:锁定控件值,在页面编辑控件值</li></ul>
1147
1104
  # 注意:此字段可能返回 null,表示取不到有效值。
1148
1105
  # @type LockComponentValue: Boolean
1149
- # @param ForbidMoveAndDelete: 是否禁止移动和删除控件
1150
- # <br/>默认false,不禁止移动和删除控件
1106
+ # @param ForbidMoveAndDelete: **web嵌入发起合同场景下**,是否禁止移动和删除填写和签署控件
1107
+ # <ul><li> <b>false(默认)</b> :不禁止移动和删除控件</li>
1108
+ # <li> <b>true</b> : 可以移动和删除控件</li></ul>
1151
1109
  # 注意:此字段可能返回 null,表示取不到有效值。
1152
1110
  # @type ForbidMoveAndDelete: Boolean
1111
+ # @param ComponentDateFontSize: <font color="red">【暂未使用】</font>日期签署控件的字号,默认为 12
1112
+ # @type ComponentDateFontSize: Integer
1113
+ # @param ChannelComponentId: <font color="red">【暂未使用】</font>第三方应用集成平台模板控件 ID 标识
1114
+ # @type ChannelComponentId: String
1115
+ # @param ChannelComponentSource: <font color="red">【暂未使用】</font>第三方应用集成中子客企业控件来源。
1116
+ # <ul><li> <b>0</b> :平台指定;</li>
1117
+ # <li> <b>1</b> :用户自定义</li></ul>
1118
+ # @type ChannelComponentSource: Integer
1153
1119
 
1154
- attr_accessor :ComponentType, :FileIndex, :ComponentHeight, :ComponentWidth, :ComponentPage, :ComponentPosX, :ComponentPosY, :ComponentId, :ComponentName, :ComponentRequired, :ComponentRecipientId, :ComponentExtra, :IsFormType, :ComponentValue, :GenerateMode, :ComponentDateFontSize, :ChannelComponentId, :OffsetX, :OffsetY, :ChannelComponentSource, :KeywordOrder, :KeywordPage, :RelativeLocation, :KeywordIndexes, :LockComponentValue, :ForbidMoveAndDelete
1120
+ attr_accessor :ComponentType, :ComponentHeight, :ComponentWidth, :ComponentPage, :ComponentPosX, :ComponentPosY, :FileIndex, :GenerateMode, :ComponentId, :ComponentName, :ComponentRequired, :ComponentRecipientId, :ComponentExtra, :IsFormType, :ComponentValue, :OffsetX, :OffsetY, :KeywordOrder, :KeywordPage, :RelativeLocation, :KeywordIndexes, :LockComponentValue, :ForbidMoveAndDelete, :ComponentDateFontSize, :ChannelComponentId, :ChannelComponentSource
1155
1121
 
1156
- def initialize(componenttype=nil, fileindex=nil, componentheight=nil, componentwidth=nil, componentpage=nil, componentposx=nil, componentposy=nil, componentid=nil, componentname=nil, componentrequired=nil, componentrecipientid=nil, componentextra=nil, isformtype=nil, componentvalue=nil, generatemode=nil, componentdatefontsize=nil, channelcomponentid=nil, offsetx=nil, offsety=nil, channelcomponentsource=nil, keywordorder=nil, keywordpage=nil, relativelocation=nil, keywordindexes=nil, lockcomponentvalue=nil, forbidmoveanddelete=nil)
1122
+ def initialize(componenttype=nil, componentheight=nil, componentwidth=nil, componentpage=nil, componentposx=nil, componentposy=nil, fileindex=nil, generatemode=nil, componentid=nil, componentname=nil, componentrequired=nil, componentrecipientid=nil, componentextra=nil, isformtype=nil, componentvalue=nil, offsetx=nil, offsety=nil, keywordorder=nil, keywordpage=nil, relativelocation=nil, keywordindexes=nil, lockcomponentvalue=nil, forbidmoveanddelete=nil, componentdatefontsize=nil, channelcomponentid=nil, channelcomponentsource=nil)
1157
1123
  @ComponentType = componenttype
1158
- @FileIndex = fileindex
1159
1124
  @ComponentHeight = componentheight
1160
1125
  @ComponentWidth = componentwidth
1161
1126
  @ComponentPage = componentpage
1162
1127
  @ComponentPosX = componentposx
1163
1128
  @ComponentPosY = componentposy
1129
+ @FileIndex = fileindex
1130
+ @GenerateMode = generatemode
1164
1131
  @ComponentId = componentid
1165
1132
  @ComponentName = componentname
1166
1133
  @ComponentRequired = componentrequired
@@ -1168,28 +1135,28 @@ module TencentCloud
1168
1135
  @ComponentExtra = componentextra
1169
1136
  @IsFormType = isformtype
1170
1137
  @ComponentValue = componentvalue
1171
- @GenerateMode = generatemode
1172
- @ComponentDateFontSize = componentdatefontsize
1173
- @ChannelComponentId = channelcomponentid
1174
1138
  @OffsetX = offsetx
1175
1139
  @OffsetY = offsety
1176
- @ChannelComponentSource = channelcomponentsource
1177
1140
  @KeywordOrder = keywordorder
1178
1141
  @KeywordPage = keywordpage
1179
1142
  @RelativeLocation = relativelocation
1180
1143
  @KeywordIndexes = keywordindexes
1181
1144
  @LockComponentValue = lockcomponentvalue
1182
1145
  @ForbidMoveAndDelete = forbidmoveanddelete
1146
+ @ComponentDateFontSize = componentdatefontsize
1147
+ @ChannelComponentId = channelcomponentid
1148
+ @ChannelComponentSource = channelcomponentsource
1183
1149
  end
1184
1150
 
1185
1151
  def deserialize(params)
1186
1152
  @ComponentType = params['ComponentType']
1187
- @FileIndex = params['FileIndex']
1188
1153
  @ComponentHeight = params['ComponentHeight']
1189
1154
  @ComponentWidth = params['ComponentWidth']
1190
1155
  @ComponentPage = params['ComponentPage']
1191
1156
  @ComponentPosX = params['ComponentPosX']
1192
1157
  @ComponentPosY = params['ComponentPosY']
1158
+ @FileIndex = params['FileIndex']
1159
+ @GenerateMode = params['GenerateMode']
1193
1160
  @ComponentId = params['ComponentId']
1194
1161
  @ComponentName = params['ComponentName']
1195
1162
  @ComponentRequired = params['ComponentRequired']
@@ -1197,18 +1164,17 @@ module TencentCloud
1197
1164
  @ComponentExtra = params['ComponentExtra']
1198
1165
  @IsFormType = params['IsFormType']
1199
1166
  @ComponentValue = params['ComponentValue']
1200
- @GenerateMode = params['GenerateMode']
1201
- @ComponentDateFontSize = params['ComponentDateFontSize']
1202
- @ChannelComponentId = params['ChannelComponentId']
1203
1167
  @OffsetX = params['OffsetX']
1204
1168
  @OffsetY = params['OffsetY']
1205
- @ChannelComponentSource = params['ChannelComponentSource']
1206
1169
  @KeywordOrder = params['KeywordOrder']
1207
1170
  @KeywordPage = params['KeywordPage']
1208
1171
  @RelativeLocation = params['RelativeLocation']
1209
1172
  @KeywordIndexes = params['KeywordIndexes']
1210
1173
  @LockComponentValue = params['LockComponentValue']
1211
1174
  @ForbidMoveAndDelete = params['ForbidMoveAndDelete']
1175
+ @ComponentDateFontSize = params['ComponentDateFontSize']
1176
+ @ChannelComponentId = params['ChannelComponentId']
1177
+ @ChannelComponentSource = params['ChannelComponentSource']
1212
1178
  end
1213
1179
  end
1214
1180
 
@@ -1335,7 +1301,10 @@ module TencentCloud
1335
1301
  # @type JumpUrl: String
1336
1302
  # @param SignatureTypes: 指定批量签署合同的签名类型,可传递以下值:
1337
1303
  # <ul><li>**0**:手写签名(默认)</li>
1338
- # <li>**1**:OCR楷体</li></ul>
1304
+ # <li>**1**:OCR楷体</li>
1305
+ # <li>**2**:姓名印章</li>
1306
+ # <li>**3**:图片印章</li>
1307
+ # <li>**4**:系统签名</li></ul>
1339
1308
  # 注:
1340
1309
  # <ul><li>默认情况下,签名类型为手写签名</li>
1341
1310
  # <li>您可以传递多种值,表示可用多种签名类型。</li></ul>
@@ -1639,6 +1608,8 @@ module TencentCloud
1639
1608
  # <ul>
1640
1609
  # <li>支持自动签传递印章,可通过指定自动签控件id,指定印章id来完成</li>
1641
1610
  # </ul>
1611
+ # 注:只有在控制台编辑模板时,<font color="red">归属给发起方</font>的填写控件(如下图)才能在创建文档的时候进行内容填充。
1612
+ # ![image](https://qcloudimg.tencent-cloud.cn/raw/a54a76a58c454593d06d8e9883ecc9b3.png)
1642
1613
  # @type FormFields: Array
1643
1614
  # @param NeedPreview: 是否为预览模式,取值如下:
1644
1615
  # <ul><li> **false**:非预览模式(默认),会产生合同流程并返回合同流程编号FlowId。</li>
@@ -1753,8 +1724,8 @@ module TencentCloud
1753
1724
  # <li>PREVIEW_SEAL_LIST:生成预览印章列表的嵌入页面</li>
1754
1725
  # <li>PREVIEW_SEAL_DETAIL:生成预览印章详情的嵌入页面</li>
1755
1726
  # <li>EXTEND_SERVICE:生成拓展服务的嵌入页面</li>
1756
- # <li>PREVIEW_FLOW:生成预览合同的嵌入页面</li>
1757
- # <li>PREVIEW_FLOW_DETAIL:生成查看合同详情的嵌入页面</li></ul>
1727
+ # <li>PREVIEW_FLOW:生成预览合同的嵌入页面(支持移动端)</li>
1728
+ # <li>PREVIEW_FLOW_DETAIL:生成查看合同详情的嵌入页面(仅支持PC端)</li></ul>
1758
1729
  # @type EmbedType: String
1759
1730
  # @param BusinessId: WEB嵌入的业务资源ID
1760
1731
  # <ul><li>PREVIEW_SEAL_DETAIL,必填,取值为印章id</li>
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: tencentcloud-sdk-ess
3
3
  version: !ruby/object:Gem::Version
4
- version: 3.0.732
4
+ version: 3.0.734
5
5
  platform: ruby
6
6
  authors:
7
7
  - Tencent Cloud
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-12-21 00:00:00.000000000 Z
11
+ date: 2023-12-25 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: tencentcloud-sdk-common