Image 字段的一般属性
- 字段名称。在特定技能中该字段的唯一名称。字段名称不能包含句号、逗号、斜杠、冒号、星号、问号、引号、小于号、大于号或竖线等特殊字符。字段名称的最大长度为 90 个字符。
- 必填字段。表示字段的值不能为空。启用此属性会在页面上添加验证规则。如果字段在提取后为空,文档将会因错误而被发送到人工审核。
- 允许多个项。表示该字段可以有多个实例。例如,如果一份协议由多个参与方签署,您可能希望将所有签名都作为同一个图像字段的实例进行提取。
使用提取的图像
- 通过 Vantage API。
- 在 Custom 活动或 Output 活动(外部系统)脚本中。Field 对象具有一个用于存储文件名的 Value 属性,以及一个包含图像二进制表示的 Image 属性。
- 通过在 Output 活动中配置 Shared Folder 导出。如果某个文档包含图像字段,用于保存该文档数据的 JSON 文件会在相应图像字段的 value 键中存储每个图像的文件名。图像文件将被放入一个与该 JSON 文件同名的子文件夹中。
文件命名
- 从字段中提取的图像会继承该字段名称作为其文件名。例如,如果图像字段名为 Signature,则生成的文件名为 Signature.jpg。
- 如果某个字段有多个实例,每个实例的文件名会追加以下划线分隔的实例编号作为后缀。例如,如果 signature 字段有两个实例,文件名将为
Signature_1.jpg和Signature_2.jpg。 - 如果该字段属于某个组或组的嵌套结构,则文件名将包含到该图像字段的完整路径,并以下划线作为分隔符。例如,如果 signature 字段是 Group2 字段组的子项,而 Group2 又是 Group1 字段组的子项,则生成的文件名将为
Group1_Group2_Signature.jpg。
注意: 如果按照此命名规则生成的文件名长度超过 256 个字符(包括所有分隔符、后缀编号和文件扩展名),则会使用备用命名规则:Field_{Guid of image field}.jpg。
