Propiedades generales del campo Image
- Field name. El nombre único del campo en una Habilidad específica. El nombre del campo no puede contener caracteres especiales como puntos, comas, barras, dos puntos, asteriscos, signos de interrogación, comillas, signos menor que, mayor que o barras verticales. La longitud máxima permitida de un nombre de campo es de 90 caracteres.
- Required field. Especifica que el valor del campo no puede quedar vacío. Al habilitar esta propiedad se agrega una regla de validación a la Página. Si el campo está vacío después de la extracción, el documento se enviará a revisión manual con un error.
- Allow multiple items. Especifica que el campo puede tener varias instancias. Por ejemplo, si un contrato está firmado por varias partes, es posible que desee extraer todas las firmas como instancias del mismo campo de imagen.
Trabajo con imágenes extraídas
- A través de Vantage API.
- En scripts de Custom activity o Output activity (sistema externo). El objeto Field tiene una propiedad Value que almacena el nombre de archivo y una propiedad Image con la representación binaria de la imagen.
- Usando la exportación a Shared Folder configurada en su Output activity. Si un documento tiene campos de imagen, el archivo JSON que contiene los datos del documento almacenará el nombre de archivo de cada imagen en la clave value del campo de imagen correspondiente. Los archivos de imagen se colocarán en una subcarpeta con el mismo nombre que el archivo JSON.
Nomenclatura de archivos
- Una imagen extraída de un campo hereda el nombre del campo como nombre de archivo. Por ejemplo, si un campo de imagen se llama Signature, el nombre de archivo resultante es Signature.jpg.
- Si un campo tiene varias instancias, el nombre de archivo de cada una recibe un sufijo con el número de instancia, separado por un guion bajo. Por ejemplo, si un campo de firma tiene dos instancias, los nombres de archivo serán
Signature_1.jpgySignature_2.jpg. - Si el campo forma parte de un grupo o de un grupo de grupos, el nombre de archivo contendrá la ruta completa hasta el campo de imagen, con un guion bajo como separador. Por ejemplo, si un campo de firma es un elemento secundario del grupo de campos Group2, que a su vez es un elemento secundario del grupo de campos Group1, el nombre de archivo resultante será
Group1_Group2_Signature.jpg.
Nota: Si un nombre de archivo creado según este esquema de nomenclatura supera los 256 caracteres (incluidos todos los separadores, números de sufijo y la extensión del archivo), se utilizará un esquema de nomenclatura alternativo: Field_{Guid of image field}.jpg.
