Passer au contenu principal
Un champ image vous permet d’enregistrer des parties de documents sous forme d’images. Par exemple, cela peut être utile pour les photos d’identité, les signatures ou les tampons. Vous pouvez ajouter un champ image en cliquant sur l’icon Add Image. Ajoutez la région de l’image si nécessaire ; notez toutefois que les champs image ne peuvent pas être entraînés. Pour chaque document qui contient un champ image, vous devrez localiser cette image et définir sa région soit lors de la relecture manuelle, soit à l’aide d’un script d’activité Custom. Un champ image ne peut pas comporter plusieurs régions.

Propriétés générales du champ Image

  • Nom du champ. Le nom unique du champ dans une compétence donnée. Le nom du champ ne peut pas contenir de caractères spéciaux tels que des points, des virgules, des barres obliques, des deux-points, des astérisques, des points d’interrogation, des guillemets, les signes inférieur (<) et supérieur (>), ni des barres verticales. La longueur maximale autorisée pour un nom de champ est de 90 caractères.
  • Champ requis. Indique que la valeur du champ ne peut pas être laissée vide. L’activation de cette propriété ajoute une règle de validation à la Page. Si le champ est vide après l’extraction, le Document sera envoyé en relecture manuelle avec une erreur.
  • Autoriser plusieurs éléments. Indique que le champ peut avoir plusieurs occurrences. Par exemple, si un accord est signé par plusieurs parties, vous pouvez extraire toutes les signatures comme occurrences du même champ image.

Utilisation des images extraites

Lors de l’export des données, l’image est découpée à partir de ses coordonnées de région et enregistrée au format JPG. Vous pourrez accéder aux images de la même manière que pour les autres données extraites :
  • Via l’API Vantage.
  • Dans des scripts d’activité Custom ou d’activité Output (système externe). L’objet Field possède une propriété Value qui stocke le nom de fichier et une propriété Image qui contient la représentation binaire de l’image.
  • En utilisant l’export Shared Folder configuré dans votre activité Output. Si un document contient des champs image, le fichier JSON contenant les données du document stockera le nom de fichier de chaque image dans la clé value du champ image correspondant. Les fichiers image seront placés dans un sous-dossier portant le même nom que le fichier JSON.

Nommage des fichiers

Les noms des fichiers image suivent le schéma de nommage ci-dessous :
  • Une image extraite d’un champ reprend le nom du champ comme nom de fichier. Par exemple, si un champ image s’appelle Signature, le nom de fichier obtenu est Signature.jpg
  • Si un champ comporte plusieurs instances, le nom de chaque fichier reçoit un suffixe avec le numéro d’instance, séparé par un underscore. Par exemple, si un champ signature comporte deux instances, les noms de fichier seront Signature_1.jpg et Signature_2.jpg.
  • Si le champ fait partie d’un groupe ou d’un groupe imbriqué, le nom de fichier contiendra le chemin complet vers le champ image, avec un underscore comme séparateur. Par exemple, si un champ signature est un enfant du groupe de champs Group2, lui‑même enfant du groupe de champs Group1, le nom de fichier obtenu sera Group1_Group2_Signature.jpg.
Remarque : Si un nom de fichier créé selon ce schéma de nommage dépasse 256 caractères (y compris tous les séparateurs, les numéros de suffixe et l’extension), un schéma de nommage alternatif sera utilisé : Field_{Guid of image field}.jpg.

Voir également