public class Component extends AbstractModel
header, skipSign
Constructor and Description |
---|
Component() |
Component(Component source)
NOTE: Any ambiguous key set via .set("AnyKey", "value") will be a shallow copy,
and any explicit key, i.e Foo, set via .setFoo("value") will be a deep copy.
|
Modifier and Type | Method and Description |
---|---|
String |
getChannelComponentId()
Get 【暂未使用】第三方应用集成平台模板控件 ID 标识
|
Long |
getComponentDateFontSize()
Get 【暂未使用】日期签署控件的字号,默认为 12
|
String |
getComponentDescription()
Get 【暂未使用】控件描述,用户自定义,不影响合同发起流程
|
String |
getComponentExtra()
Get **在所有的定位方式下**,控件的扩展参数,为JSON格式,不同类型的控件会有部分非通用参数。
ComponentType为TEXT、MULTI_LINE_TEXT时,支持以下参数:
Font:目前只支持黑体、宋体
FontSize: 范围12 :72
FontAlign: Left/Right/Center,左对齐/居中/右对齐
FontColor:字符串类型,格式为RGB颜色数字
参数样例:`{"FontColor":"255,0,0","FontSize":12}`
ComponentType为DATE时,支持以下参数:
Font:目前只支持黑体、宋体
FontSize: 范围12 :72
参数样例:`{"FontColor":"255,0,0","FontSize":12}`
ComponentType为FILL_IMAGE时,支持以下参数:
NotMakeImageCenter:bool。是否设置图片居中。false:居中(默认)。 true : 不居中
FillMethod : int.
|
Float |
getComponentHeight()
Get **在绝对定位方式和关键字定位方式下**,指定控件的高度, 控件高度是指控件在PDF文件中的高度,单位为pt(点)。
|
String |
getComponentId()
Get 控件唯一ID。
在绝对定位方式方式下**,ComponentId为控件的ID,长度不能超过30,只能由中文、字母、数字和下划线组成,可以在后续的操作中使用该名称来引用控件。
在关键字定位方式下**,ComponentId不仅为控件的ID,也是关键字整词。此方式下可以通过"^"来决定是否使用关键字整词匹配能力。
例:
- 如传入的关键字"^甲方签署^",则会在PDF文件中有且仅有"甲方签署"关键字的地方(前后不能有其他字符)进行对应操作。
- 如传入的关键字为"甲方签署",则PDF文件中每个出现关键字的位置(前后可以有其他字符)都会执行相应操作。
注:`控件ID可以在一个PDF中不可重复`
点击查看ComponentId在模板页面的位置
|
String |
getComponentName()
Get **在绝对定位方式方式下**,ComponentName为控件名,长度不能超过20,只能由中文、字母、数字和下划线组成,可以在后续的操作中使用该名称来引用控件。
在表单域定位方式下**,ComponentName不仅为控件名,也是表单域名称。
注:`控件名可以在一个PDF中可以重复`
点击查看ComponentName在模板页面的位置
|
Long |
getComponentPage()
Get **在绝对定位方式方式下**,指定控件所在PDF文件上的页码
注:
1.
|
Float |
getComponentPosX()
Get **在绝对定位方式和关键字定位方式下**,可以指定控件横向位置的位置,单位为pt(点)。
|
Float |
getComponentPosY()
Get **在绝对定位方式和关键字定位方式下**,可以指定控件纵向位置的位置,单位为pt(点)。
|
String |
getComponentRecipientId()
Get **在通过接口拉取控件信息场景下**,为出参参数,此控件归属的参与方的角色ID角色(即RecipientId),**发起合同时候不要填写此字段留空即可**
|
Boolean |
getComponentRequired()
Get 如果是填写控件,ComponentRequired表示在填写页面此控件是否必填
false(默认):可以不填写
true :必须填写此填写控件
如果是签署控件,签批控件中签署意见等可以不填写, 其他签署控件不受此字段影响
|
String |
getComponentType()
Get **如果是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_PAGING_SEAL : 骑缝章;若文件发起,需要对应填充ComponentPosY、ComponentWidth、ComponentHeight
SIGN_OPINION : 签署意见控件,用户需要根据配置的签署意见内容,完成对意见内容的确认;
SIGN_LEGAL_PERSON_SEAL : 企业法定代表人控件。
个人方
SIGN_DATE : 签署日期控件;
SIGN_SIGNATURE : 用户签名控件;
注:` 表单域的控件不能作为印章和签名控件`
|
String |
getComponentValue()
Get 控件填充vaule,ComponentType和传入值类型对应关系:
TEXT : 文本内容
MULTI_LINE_TEXT : 文本内容
CHECK_BOX : true/false
FILL_IMAGE、ATTACHMENT : 附件的FileId,需要通过UploadFiles接口上传获取
SELECTOR : 选项值
DYNAMIC_TABLE - 传入json格式的表格内容,详见说明:[数据表格](https://qian.tencent.com/developers/company/dynamic_table)
DATE : 默认是格式化为xxxx年xx月xx日
SIGN_SEAL : 印章ID,于控制台查询获取,[点击查看在控制上的位置](https://qcloudimg.tencent-cloud.cn/raw/cd403a5b949fce197fd9e88bb6db1517.png)
SIGN_PAGING_SEAL : 可以指定印章ID,于控制台查询获取,[点击查看在控制上的位置](https://qcloudimg.tencent-cloud.cn/raw/cd403a5b949fce197fd9e88bb6db1517.png)
控件值约束说明:
特殊控件 填写约束 企业全称控件 企业名称中文字符中文括号 统一社会信用代码控件 企业注册的统一社会信用代码 法人名称控件 最大50个字符,2到25个汉字或者1到50个字母 签署意见控件 签署意见最大长度为50字符 签署人手机号控件 国内手机号 13,14,15,16,17,18,19号段长度11位 签署人身份证控件 合法的身份证号码检查 控件名称 控件名称最大长度为20字符,不支持表情 单行文本控件 只允许输入中文,英文,数字,中英文标点符号,不支持表情 多行文本控件 只允许输入中文,英文,数字,中英文标点符号,不支持表情 勾选框控件 选择填字符串true,不选填字符串false 选择器控件 同单行文本控件约束,填写选择值中的字符串 数字控件 请输入有效的数字(可带小数点) 日期控件 格式:yyyy年mm月dd日 附件控件 JPG或PNG图片,上传数量限制,1到6个,最大6个附件,填写上传的资源ID 图片控件 JPG或PNG图片,填写上传的图片资源ID 邮箱控件 有效的邮箱地址, w3c标准 地址控件 只允许输入中文,英文,数字,中英文标点符号,不支持表情 省市区控件 只允许输入中文,英文,数字,中英文标点符号,不支持表情 性别控件 选择值中的字符串 学历控件 选择值中的字符串
注: `部分特殊控件需要在控制台配置模板形式创建`
|
Float |
getComponentWidth()
Get **在绝对定位方式和关键字定位方式下**,指定控件宽度,控件宽度是指控件在PDF文件中的宽度,单位为pt(点)。
|
String |
getDocumentId()
Get 【暂未使用】控件归属的文档的ID, **发起合同时候不要填写此字段留空即可**
|
Long |
getFileIndex()
Get 【暂未使用】控件所属文件的序号(取值为:0-N)。 目前单文件的情况下,值一直为0
|
Boolean |
getForbidMoveAndDelete()
Get **web嵌入发起合同场景下**,是否禁止移动和删除填写和签署控件
false(默认) :不禁止移动和删除控件
true : 可以移动和删除控件
注意:此字段可能返回 null,表示取不到有效值。
|
String |
getGenerateMode()
Get 控件生成的方式:
NORMAL : 绝对定位控件
FIELD : 表单域
KEYWORD : 关键字(设置关键字时,请确保PDF原始文件内是关键字以文字形式保存在PDF文件中,不支持对图片内文字进行关键字查找)
|
Long[] |
getKeywordIndexes()
Get **如果控件是关键字定位方式**,关键字索引是指在PDF文件中存在多个相同的关键字时,通过索引指定使用哪一个关键字作为最后的结果。可以通过指定多个索引来同时使用多个关键字。例如,[0,2]表示使用PDF文件内第1个和第3个关键字位置作为最后的结果。
注意:关键字索引是从0开始计数的
|
String |
getKeywordOrder()
Get **如果控件是关键字定位方式**,指定关键字排序规则时,可以选择Positive或Reverse两种排序方式。
Positive :表示正序,即根据关键字在PDF文件内的顺序进行排列
Reverse :表示倒序,即根据关键字在PDF文件内的反序进行排列
在指定KeywordIndexes时,如果使用Positive排序方式,0代表在PDF内查找内容时,查找到的第一个关键字;如果使用Reverse排序方式,0代表在PDF内查找内容时,查找到的最后一个关键字。
|
Long |
getKeywordPage()
Get **如果控件是关键字定位方式**,在KeywordPage中指定关键字页码时,将只会在该页码中查找关键字,非该页码的关键字将不会查询出来。如果不设置查找所有页面中的关键字。
|
Boolean |
getLockComponentValue()
Get **web嵌入发起合同场景下**, 是否锁定填写和签署控件值不允许嵌入页面进行编辑
false(默认):不锁定控件值,允许在页面编辑控件值
true:锁定控件值,在页面编辑控件值
注意:此字段可能返回 null,表示取不到有效值。
|
Float |
getOffsetX()
Get **如果控件是关键字定位方式**,可以对关键字定位出来的区域进行横坐标方向的调整,单位为pt(点)。例如,如果关键字定位出来的区域偏左或偏右,可以通过调整横坐标方向的参数来使控件位置更加准确。
注意: `向左调整设置为负数, 向右调整设置成正数`
|
Float |
getOffsetY()
Get **如果控件是关键字定位方式**,可以对关键字定位出来的区域进行纵坐标方向的调整,单位为pt(点)。例如,如果关键字定位出来的区域偏上或偏下,可以通过调整纵坐标方向的参数来使控件位置更加准确。
注意: `向上调整设置为负数, 向下调整设置成正数`
|
String |
getPlaceholder()
Get 填写控件在腾讯电子签小程序填写界面展示的提示信息,例如,在身份证号码填写控件中,提示信息可以设置成“请输入18位身份证号码”。
注:`签署控件设置此字段无效`
注意:此字段可能返回 null,表示取不到有效值。
|
String |
getRelativeLocation()
Get **如果控件是关键字定位方式**,关键字生成的区域的对齐方式, 可以设置下面的值
Middle :居中
Below :正下方
Right :正右方
LowerRight :右上角
UpperRight :右下角。
示例:如果设置Middle的关键字盖章,则印章的中心会和关键字的中心重合,如果设置Below,则印章在关键字的正下方
|
void |
setChannelComponentId(String ChannelComponentId)
Set 【暂未使用】第三方应用集成平台模板控件 ID 标识
|
void |
setComponentDateFontSize(Long ComponentDateFontSize)
Set 【暂未使用】日期签署控件的字号,默认为 12
|
void |
setComponentDescription(String ComponentDescription)
Set 【暂未使用】控件描述,用户自定义,不影响合同发起流程
|
void |
setComponentExtra(String ComponentExtra)
Set **在所有的定位方式下**,控件的扩展参数,为JSON格式,不同类型的控件会有部分非通用参数。
ComponentType为TEXT、MULTI_LINE_TEXT时,支持以下参数:
Font:目前只支持黑体、宋体
FontSize: 范围12 :72
FontAlign: Left/Right/Center,左对齐/居中/右对齐
FontColor:字符串类型,格式为RGB颜色数字
参数样例:`{"FontColor":"255,0,0","FontSize":12}`
ComponentType为DATE时,支持以下参数:
Font:目前只支持黑体、宋体
FontSize: 范围12 :72
参数样例:`{"FontColor":"255,0,0","FontSize":12}`
ComponentType为FILL_IMAGE时,支持以下参数:
NotMakeImageCenter:bool。是否设置图片居中。false:居中(默认)。 true : 不居中
FillMethod : int.
|
void |
setComponentHeight(Float ComponentHeight)
Set **在绝对定位方式和关键字定位方式下**,指定控件的高度, 控件高度是指控件在PDF文件中的高度,单位为pt(点)。
|
void |
setComponentId(String ComponentId)
Set 控件唯一ID。
在绝对定位方式方式下**,ComponentId为控件的ID,长度不能超过30,只能由中文、字母、数字和下划线组成,可以在后续的操作中使用该名称来引用控件。
在关键字定位方式下**,ComponentId不仅为控件的ID,也是关键字整词。此方式下可以通过"^"来决定是否使用关键字整词匹配能力。
例:
- 如传入的关键字"^甲方签署^",则会在PDF文件中有且仅有"甲方签署"关键字的地方(前后不能有其他字符)进行对应操作。
- 如传入的关键字为"甲方签署",则PDF文件中每个出现关键字的位置(前后可以有其他字符)都会执行相应操作。
注:`控件ID可以在一个PDF中不可重复`
点击查看ComponentId在模板页面的位置
|
void |
setComponentName(String ComponentName)
Set **在绝对定位方式方式下**,ComponentName为控件名,长度不能超过20,只能由中文、字母、数字和下划线组成,可以在后续的操作中使用该名称来引用控件。
在表单域定位方式下**,ComponentName不仅为控件名,也是表单域名称。
注:`控件名可以在一个PDF中可以重复`
点击查看ComponentName在模板页面的位置
|
void |
setComponentPage(Long ComponentPage)
Set **在绝对定位方式方式下**,指定控件所在PDF文件上的页码
注:
1.
|
void |
setComponentPosX(Float ComponentPosX)
Set **在绝对定位方式和关键字定位方式下**,可以指定控件横向位置的位置,单位为pt(点)。
|
void |
setComponentPosY(Float ComponentPosY)
Set **在绝对定位方式和关键字定位方式下**,可以指定控件纵向位置的位置,单位为pt(点)。
|
void |
setComponentRecipientId(String ComponentRecipientId)
Set **在通过接口拉取控件信息场景下**,为出参参数,此控件归属的参与方的角色ID角色(即RecipientId),**发起合同时候不要填写此字段留空即可**
|
void |
setComponentRequired(Boolean ComponentRequired)
Set 如果是填写控件,ComponentRequired表示在填写页面此控件是否必填
false(默认):可以不填写
true :必须填写此填写控件
如果是签署控件,签批控件中签署意见等可以不填写, 其他签署控件不受此字段影响
|
void |
setComponentType(String ComponentType)
Set **如果是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_PAGING_SEAL : 骑缝章;若文件发起,需要对应填充ComponentPosY、ComponentWidth、ComponentHeight
SIGN_OPINION : 签署意见控件,用户需要根据配置的签署意见内容,完成对意见内容的确认;
SIGN_LEGAL_PERSON_SEAL : 企业法定代表人控件。
个人方
SIGN_DATE : 签署日期控件;
SIGN_SIGNATURE : 用户签名控件;
注:` 表单域的控件不能作为印章和签名控件`
|
void |
setComponentValue(String ComponentValue)
Set 控件填充vaule,ComponentType和传入值类型对应关系:
TEXT : 文本内容
MULTI_LINE_TEXT : 文本内容
CHECK_BOX : true/false
FILL_IMAGE、ATTACHMENT : 附件的FileId,需要通过UploadFiles接口上传获取
SELECTOR : 选项值
DYNAMIC_TABLE - 传入json格式的表格内容,详见说明:[数据表格](https://qian.tencent.com/developers/company/dynamic_table)
DATE : 默认是格式化为xxxx年xx月xx日
SIGN_SEAL : 印章ID,于控制台查询获取,[点击查看在控制上的位置](https://qcloudimg.tencent-cloud.cn/raw/cd403a5b949fce197fd9e88bb6db1517.png)
SIGN_PAGING_SEAL : 可以指定印章ID,于控制台查询获取,[点击查看在控制上的位置](https://qcloudimg.tencent-cloud.cn/raw/cd403a5b949fce197fd9e88bb6db1517.png)
控件值约束说明:
特殊控件 填写约束 企业全称控件 企业名称中文字符中文括号 统一社会信用代码控件 企业注册的统一社会信用代码 法人名称控件 最大50个字符,2到25个汉字或者1到50个字母 签署意见控件 签署意见最大长度为50字符 签署人手机号控件 国内手机号 13,14,15,16,17,18,19号段长度11位 签署人身份证控件 合法的身份证号码检查 控件名称 控件名称最大长度为20字符,不支持表情 单行文本控件 只允许输入中文,英文,数字,中英文标点符号,不支持表情 多行文本控件 只允许输入中文,英文,数字,中英文标点符号,不支持表情 勾选框控件 选择填字符串true,不选填字符串false 选择器控件 同单行文本控件约束,填写选择值中的字符串 数字控件 请输入有效的数字(可带小数点) 日期控件 格式:yyyy年mm月dd日 附件控件 JPG或PNG图片,上传数量限制,1到6个,最大6个附件,填写上传的资源ID 图片控件 JPG或PNG图片,填写上传的图片资源ID 邮箱控件 有效的邮箱地址, w3c标准 地址控件 只允许输入中文,英文,数字,中英文标点符号,不支持表情 省市区控件 只允许输入中文,英文,数字,中英文标点符号,不支持表情 性别控件 选择值中的字符串 学历控件 选择值中的字符串
注: `部分特殊控件需要在控制台配置模板形式创建`
|
void |
setComponentWidth(Float ComponentWidth)
Set **在绝对定位方式和关键字定位方式下**,指定控件宽度,控件宽度是指控件在PDF文件中的宽度,单位为pt(点)。
|
void |
setDocumentId(String DocumentId)
Set 【暂未使用】控件归属的文档的ID, **发起合同时候不要填写此字段留空即可**
|
void |
setFileIndex(Long FileIndex)
Set 【暂未使用】控件所属文件的序号(取值为:0-N)。 目前单文件的情况下,值一直为0
|
void |
setForbidMoveAndDelete(Boolean ForbidMoveAndDelete)
Set **web嵌入发起合同场景下**,是否禁止移动和删除填写和签署控件
false(默认) :不禁止移动和删除控件
true : 可以移动和删除控件
注意:此字段可能返回 null,表示取不到有效值。
|
void |
setGenerateMode(String GenerateMode)
Set 控件生成的方式:
NORMAL : 绝对定位控件
FIELD : 表单域
KEYWORD : 关键字(设置关键字时,请确保PDF原始文件内是关键字以文字形式保存在PDF文件中,不支持对图片内文字进行关键字查找)
|
void |
setKeywordIndexes(Long[] KeywordIndexes)
Set **如果控件是关键字定位方式**,关键字索引是指在PDF文件中存在多个相同的关键字时,通过索引指定使用哪一个关键字作为最后的结果。可以通过指定多个索引来同时使用多个关键字。例如,[0,2]表示使用PDF文件内第1个和第3个关键字位置作为最后的结果。
注意:关键字索引是从0开始计数的
|
void |
setKeywordOrder(String KeywordOrder)
Set **如果控件是关键字定位方式**,指定关键字排序规则时,可以选择Positive或Reverse两种排序方式。
Positive :表示正序,即根据关键字在PDF文件内的顺序进行排列
Reverse :表示倒序,即根据关键字在PDF文件内的反序进行排列
在指定KeywordIndexes时,如果使用Positive排序方式,0代表在PDF内查找内容时,查找到的第一个关键字;如果使用Reverse排序方式,0代表在PDF内查找内容时,查找到的最后一个关键字。
|
void |
setKeywordPage(Long KeywordPage)
Set **如果控件是关键字定位方式**,在KeywordPage中指定关键字页码时,将只会在该页码中查找关键字,非该页码的关键字将不会查询出来。如果不设置查找所有页面中的关键字。
|
void |
setLockComponentValue(Boolean LockComponentValue)
Set **web嵌入发起合同场景下**, 是否锁定填写和签署控件值不允许嵌入页面进行编辑
false(默认):不锁定控件值,允许在页面编辑控件值
true:锁定控件值,在页面编辑控件值
注意:此字段可能返回 null,表示取不到有效值。
|
void |
setOffsetX(Float OffsetX)
Set **如果控件是关键字定位方式**,可以对关键字定位出来的区域进行横坐标方向的调整,单位为pt(点)。例如,如果关键字定位出来的区域偏左或偏右,可以通过调整横坐标方向的参数来使控件位置更加准确。
注意: `向左调整设置为负数, 向右调整设置成正数`
|
void |
setOffsetY(Float OffsetY)
Set **如果控件是关键字定位方式**,可以对关键字定位出来的区域进行纵坐标方向的调整,单位为pt(点)。例如,如果关键字定位出来的区域偏上或偏下,可以通过调整纵坐标方向的参数来使控件位置更加准确。
注意: `向上调整设置为负数, 向下调整设置成正数`
|
void |
setPlaceholder(String Placeholder)
Set 填写控件在腾讯电子签小程序填写界面展示的提示信息,例如,在身份证号码填写控件中,提示信息可以设置成“请输入18位身份证号码”。
注:`签署控件设置此字段无效`
注意:此字段可能返回 null,表示取不到有效值。
|
void |
setRelativeLocation(String RelativeLocation)
Set **如果控件是关键字定位方式**,关键字生成的区域的对齐方式, 可以设置下面的值
Middle :居中
Below :正下方
Right :正右方
LowerRight :右上角
UpperRight :右下角。
示例:如果设置Middle的关键字盖章,则印章的中心会和关键字的中心重合,如果设置Below,则印章在关键字的正下方
|
void |
toMap(HashMap<String,String> map,
String prefix)
Internal implementation, normal users should not use it.
|
any, fromJsonString, getBinaryParams, GetHeader, getMultipartRequestParams, getSkipSign, isStream, set, SetHeader, setParamArrayObj, setParamArraySimple, setParamObj, setParamSimple, setSkipSign, toJsonString
public Component()
public Component(Component source)
public String getComponentId()
public void setComponentId(String ComponentId)
ComponentId
- 控件唯一ID。
在绝对定位方式方式下**,ComponentId为控件的ID,长度不能超过30,只能由中文、字母、数字和下划线组成,可以在后续的操作中使用该名称来引用控件。
在关键字定位方式下**,ComponentId不仅为控件的ID,也是关键字整词。此方式下可以通过"^"来决定是否使用关键字整词匹配能力。
例:
- 如传入的关键字"^甲方签署^",则会在PDF文件中有且仅有"甲方签署"关键字的地方(前后不能有其他字符)进行对应操作。
- 如传入的关键字为"甲方签署",则PDF文件中每个出现关键字的位置(前后可以有其他字符)都会执行相应操作。
注:`控件ID可以在一个PDF中不可重复`
点击查看ComponentId在模板页面的位置public String getComponentType()
public void setComponentType(String ComponentType)
ComponentType
- **如果是Component填写控件类型,则可选的字段为**:
public String getComponentName()
public void setComponentName(String ComponentName)
ComponentName
- **在绝对定位方式方式下**,ComponentName为控件名,长度不能超过20,只能由中文、字母、数字和下划线组成,可以在后续的操作中使用该名称来引用控件。
在表单域定位方式下**,ComponentName不仅为控件名,也是表单域名称。
注:`控件名可以在一个PDF中可以重复`
点击查看ComponentName在模板页面的位置public Boolean getComponentRequired()
public void setComponentRequired(Boolean ComponentRequired)
ComponentRequired
- 如果是填写控件,ComponentRequired表示在填写页面此控件是否必填
public String getComponentRecipientId()
public void setComponentRecipientId(String ComponentRecipientId)
ComponentRecipientId
- **在通过接口拉取控件信息场景下**,为出参参数,此控件归属的参与方的角色ID角色(即RecipientId),**发起合同时候不要填写此字段留空即可**public Long getFileIndex()
public void setFileIndex(Long FileIndex)
FileIndex
- 【暂未使用】控件所属文件的序号(取值为:0-N)。 目前单文件的情况下,值一直为0public String getGenerateMode()
public void setGenerateMode(String GenerateMode)
GenerateMode
- 控件生成的方式:
public Float getComponentWidth()
public void setComponentWidth(Float ComponentWidth)
ComponentWidth
- **在绝对定位方式和关键字定位方式下**,指定控件宽度,控件宽度是指控件在PDF文件中的宽度,单位为pt(点)。public Float getComponentHeight()
public void setComponentHeight(Float ComponentHeight)
ComponentHeight
- **在绝对定位方式和关键字定位方式下**,指定控件的高度, 控件高度是指控件在PDF文件中的高度,单位为pt(点)。public Long getComponentPage()
public void setComponentPage(Long ComponentPage)
ComponentPage
- **在绝对定位方式方式下**,指定控件所在PDF文件上的页码
注:
1. 页码编号是从1开始编号的。
2. 页面编号不能超过PDF文件的页码总数。如果指定的页码超过了PDF文件的页码总数,在填写和签署时会出现错误,导致无法正常进行操作。public Float getComponentPosX()
public void setComponentPosX(Float ComponentPosX)
ComponentPosX
- **在绝对定位方式和关键字定位方式下**,可以指定控件横向位置的位置,单位为pt(点)。public Float getComponentPosY()
public void setComponentPosY(Float ComponentPosY)
ComponentPosY
- **在绝对定位方式和关键字定位方式下**,可以指定控件纵向位置的位置,单位为pt(点)。public String getComponentExtra()
public void setComponentExtra(String ComponentExtra)
ComponentExtra
- **在所有的定位方式下**,控件的扩展参数,为JSON格式,不同类型的控件会有部分非通用参数。
ComponentType为TEXT、MULTI_LINE_TEXT时,支持以下参数:
public String getComponentValue()
特殊控件 | 填写约束 |
---|---|
企业全称控件 | 企业名称中文字符中文括号 |
统一社会信用代码控件 | 企业注册的统一社会信用代码 |
法人名称控件 | 最大50个字符,2到25个汉字或者1到50个字母 |
签署意见控件 | 签署意见最大长度为50字符 |
签署人手机号控件 | 国内手机号 13,14,15,16,17,18,19号段长度11位 |
签署人身份证控件 | 合法的身份证号码检查 |
控件名称 | 控件名称最大长度为20字符,不支持表情 |
单行文本控件 | 只允许输入中文,英文,数字,中英文标点符号,不支持表情 |
多行文本控件 | 只允许输入中文,英文,数字,中英文标点符号,不支持表情 |
勾选框控件 | 选择填字符串true,不选填字符串false |
选择器控件 | 同单行文本控件约束,填写选择值中的字符串 |
数字控件 | 请输入有效的数字(可带小数点) |
日期控件 | 格式:yyyy年mm月dd日 |
附件控件 | JPG或PNG图片,上传数量限制,1到6个,最大6个附件,填写上传的资源ID |
图片控件 | JPG或PNG图片,填写上传的图片资源ID |
邮箱控件 | 有效的邮箱地址, w3c标准 |
地址控件 | 只允许输入中文,英文,数字,中英文标点符号,不支持表情 |
省市区控件 | 只允许输入中文,英文,数字,中英文标点符号,不支持表情 |
性别控件 | 选择值中的字符串 |
学历控件 | 选择值中的字符串 |
特殊控件 | 填写约束 |
---|---|
企业全称控件 | 企业名称中文字符中文括号 |
统一社会信用代码控件 | 企业注册的统一社会信用代码 |
法人名称控件 | 最大50个字符,2到25个汉字或者1到50个字母 |
签署意见控件 | 签署意见最大长度为50字符 |
签署人手机号控件 | 国内手机号 13,14,15,16,17,18,19号段长度11位 |
签署人身份证控件 | 合法的身份证号码检查 |
控件名称 | 控件名称最大长度为20字符,不支持表情 |
单行文本控件 | 只允许输入中文,英文,数字,中英文标点符号,不支持表情 |
多行文本控件 | 只允许输入中文,英文,数字,中英文标点符号,不支持表情 |
勾选框控件 | 选择填字符串true,不选填字符串false |
选择器控件 | 同单行文本控件约束,填写选择值中的字符串 |
数字控件 | 请输入有效的数字(可带小数点) |
日期控件 | 格式:yyyy年mm月dd日 |
附件控件 | JPG或PNG图片,上传数量限制,1到6个,最大6个附件,填写上传的资源ID |
图片控件 | JPG或PNG图片,填写上传的图片资源ID |
邮箱控件 | 有效的邮箱地址, w3c标准 |
地址控件 | 只允许输入中文,英文,数字,中英文标点符号,不支持表情 |
省市区控件 | 只允许输入中文,英文,数字,中英文标点符号,不支持表情 |
性别控件 | 选择值中的字符串 |
学历控件 | 选择值中的字符串 |
public void setComponentValue(String ComponentValue)
特殊控件 | 填写约束 |
---|---|
企业全称控件 | 企业名称中文字符中文括号 |
统一社会信用代码控件 | 企业注册的统一社会信用代码 |
法人名称控件 | 最大50个字符,2到25个汉字或者1到50个字母 |
签署意见控件 | 签署意见最大长度为50字符 |
签署人手机号控件 | 国内手机号 13,14,15,16,17,18,19号段长度11位 |
签署人身份证控件 | 合法的身份证号码检查 |
控件名称 | 控件名称最大长度为20字符,不支持表情 |
单行文本控件 | 只允许输入中文,英文,数字,中英文标点符号,不支持表情 |
多行文本控件 | 只允许输入中文,英文,数字,中英文标点符号,不支持表情 |
勾选框控件 | 选择填字符串true,不选填字符串false |
选择器控件 | 同单行文本控件约束,填写选择值中的字符串 |
数字控件 | 请输入有效的数字(可带小数点) |
日期控件 | 格式:yyyy年mm月dd日 |
附件控件 | JPG或PNG图片,上传数量限制,1到6个,最大6个附件,填写上传的资源ID |
图片控件 | JPG或PNG图片,填写上传的图片资源ID |
邮箱控件 | 有效的邮箱地址, w3c标准 |
地址控件 | 只允许输入中文,英文,数字,中英文标点符号,不支持表情 |
省市区控件 | 只允许输入中文,英文,数字,中英文标点符号,不支持表情 |
性别控件 | 选择值中的字符串 |
学历控件 | 选择值中的字符串 |
ComponentValue
- 控件填充vaule,ComponentType和传入值类型对应关系:
特殊控件 | 填写约束 |
---|---|
企业全称控件 | 企业名称中文字符中文括号 |
统一社会信用代码控件 | 企业注册的统一社会信用代码 |
法人名称控件 | 最大50个字符,2到25个汉字或者1到50个字母 |
签署意见控件 | 签署意见最大长度为50字符 |
签署人手机号控件 | 国内手机号 13,14,15,16,17,18,19号段长度11位 |
签署人身份证控件 | 合法的身份证号码检查 |
控件名称 | 控件名称最大长度为20字符,不支持表情 |
单行文本控件 | 只允许输入中文,英文,数字,中英文标点符号,不支持表情 |
多行文本控件 | 只允许输入中文,英文,数字,中英文标点符号,不支持表情 |
勾选框控件 | 选择填字符串true,不选填字符串false |
选择器控件 | 同单行文本控件约束,填写选择值中的字符串 |
数字控件 | 请输入有效的数字(可带小数点) |
日期控件 | 格式:yyyy年mm月dd日 |
附件控件 | JPG或PNG图片,上传数量限制,1到6个,最大6个附件,填写上传的资源ID |
图片控件 | JPG或PNG图片,填写上传的图片资源ID |
邮箱控件 | 有效的邮箱地址, w3c标准 |
地址控件 | 只允许输入中文,英文,数字,中英文标点符号,不支持表情 |
省市区控件 | 只允许输入中文,英文,数字,中英文标点符号,不支持表情 |
性别控件 | 选择值中的字符串 |
学历控件 | 选择值中的字符串 |
public Long getComponentDateFontSize()
public void setComponentDateFontSize(Long ComponentDateFontSize)
ComponentDateFontSize
- 【暂未使用】日期签署控件的字号,默认为 12public String getDocumentId()
public void setDocumentId(String DocumentId)
DocumentId
- 【暂未使用】控件归属的文档的ID, **发起合同时候不要填写此字段留空即可**public String getComponentDescription()
public void setComponentDescription(String ComponentDescription)
ComponentDescription
- 【暂未使用】控件描述,用户自定义,不影响合同发起流程public Float getOffsetX()
public void setOffsetX(Float OffsetX)
OffsetX
- **如果控件是关键字定位方式**,可以对关键字定位出来的区域进行横坐标方向的调整,单位为pt(点)。例如,如果关键字定位出来的区域偏左或偏右,可以通过调整横坐标方向的参数来使控件位置更加准确。
注意: `向左调整设置为负数, 向右调整设置成正数`public Float getOffsetY()
public void setOffsetY(Float OffsetY)
OffsetY
- **如果控件是关键字定位方式**,可以对关键字定位出来的区域进行纵坐标方向的调整,单位为pt(点)。例如,如果关键字定位出来的区域偏上或偏下,可以通过调整纵坐标方向的参数来使控件位置更加准确。
注意: `向上调整设置为负数, 向下调整设置成正数`public String getChannelComponentId()
public void setChannelComponentId(String ChannelComponentId)
ChannelComponentId
- 【暂未使用】第三方应用集成平台模板控件 ID 标识public String getKeywordOrder()
public void setKeywordOrder(String KeywordOrder)
KeywordOrder
- **如果控件是关键字定位方式**,指定关键字排序规则时,可以选择Positive或Reverse两种排序方式。
public Long getKeywordPage()
public void setKeywordPage(Long KeywordPage)
KeywordPage
- **如果控件是关键字定位方式**,在KeywordPage中指定关键字页码时,将只会在该页码中查找关键字,非该页码的关键字将不会查询出来。如果不设置查找所有页面中的关键字。public String getRelativeLocation()
public void setRelativeLocation(String RelativeLocation)
RelativeLocation
- **如果控件是关键字定位方式**,关键字生成的区域的对齐方式, 可以设置下面的值
public Long[] getKeywordIndexes()
public void setKeywordIndexes(Long[] KeywordIndexes)
KeywordIndexes
- **如果控件是关键字定位方式**,关键字索引是指在PDF文件中存在多个相同的关键字时,通过索引指定使用哪一个关键字作为最后的结果。可以通过指定多个索引来同时使用多个关键字。例如,[0,2]表示使用PDF文件内第1个和第3个关键字位置作为最后的结果。
注意:关键字索引是从0开始计数的public String getPlaceholder()
public void setPlaceholder(String Placeholder)
Placeholder
- 填写控件在腾讯电子签小程序填写界面展示的提示信息,例如,在身份证号码填写控件中,提示信息可以设置成“请输入18位身份证号码”。
注:`签署控件设置此字段无效`
注意:此字段可能返回 null,表示取不到有效值。public Boolean getLockComponentValue()
public void setLockComponentValue(Boolean LockComponentValue)
LockComponentValue
- **web嵌入发起合同场景下**, 是否锁定填写和签署控件值不允许嵌入页面进行编辑
public Boolean getForbidMoveAndDelete()
public void setForbidMoveAndDelete(Boolean ForbidMoveAndDelete)
ForbidMoveAndDelete
- **web嵌入发起合同场景下**,是否禁止移动和删除填写和签署控件
Copyright © 2024. All rights reserved.