跳转到主要内容
图像字段用于将文档的部分内容保存为图片。例如,在处理证件照片、签名或印章时,这会非常有用。 可以通过单击 Add Image 图标来添加图像字段。如有需要,可以添加图像区域,但请注意,图像字段无法进行训练。对于每个包含图像字段的文档,都需要在人工审核期间,或使用 Custom activity 脚本,找到对应的图像并为其设置区域。 一个图像字段不能包含多个区域。

Image 字段的一般属性

  • 字段名称。在特定技能中该字段的唯一名称。字段名称不能包含句号、逗号、斜杠、冒号、星号、问号、引号、小于号、大于号或竖线等特殊字符。字段名称的最大长度为 90 个字符。
  • 必填字段。表示字段的值不能为空。启用此属性会在页面上添加验证规则。如果字段在提取后为空,文档将会因错误而被发送到人工审核。
  • 允许多个项。表示该字段可以有多个实例。例如,如果一份协议由多个参与方签署,您可能希望将所有签名都作为同一个图像字段的实例进行提取。

使用提取的图像

在数据导出时,系统会根据图像的区域坐标进行提取,并以 JPG 格式保存。您可以像访问其他提取数据一样访问这些图像:
  • 通过 Vantage API。
  • 在 Custom 活动或 Output 活动(外部系统)脚本中。Field 对象具有一个用于存储文件名的 Value 属性,以及一个包含图像二进制表示的 Image 属性。
  • 通过在 Output 活动中配置 Shared Folder 导出。如果某个文档包含图像字段,用于保存该文档数据的 JSON 文件会在相应图像字段的 value 键中存储每个图像的文件名。图像文件将被放入一个与该 JSON 文件同名的子文件夹中。

文件命名

图像文件名遵循以下命名规则:
  • 从字段中提取的图像会继承该字段名称作为其文件名。例如,如果图像字段名为 Signature,则生成的文件名为 Signature.jpg。
  • 如果某个字段有多个实例,每个实例的文件名会追加以下划线分隔的实例编号作为后缀。例如,如果 signature 字段有两个实例,文件名将为 Signature_1.jpgSignature_2.jpg
  • 如果该字段属于某个组或组的嵌套结构,则文件名将包含到该图像字段的完整路径,并以下划线作为分隔符。例如,如果 signature 字段是 Group2 字段组的子项,而 Group2 又是 Group1 字段组的子项,则生成的文件名将为 Group1_Group2_Signature.jpg
注意: 如果按照此命名规则生成的文件名长度超过 256 个字符(包括所有分隔符、后缀编号和文件扩展名),则会使用备用命名规则:Field_{Guid of image field}.jpg

另请参见