Show Menu
SUJETS×

Utilisation de formulaires à code à barres

A propos du service Barcoded Forms

Le service Barcoded Forms automatise la capture des données des formulaires de remplissage et d’impression et intègre les informations capturées dans les principaux systèmes informatiques d’une entreprise.
Le service Barcoded Forms permet d’ajouter des codes à barres unidimensionnels et bidimensionnels aux formulaires PDF interactifs. Vous pouvez ensuite publier les formulaires à code à barres sur un site Web ou les distribuer par courrier électronique ou CD. Lorsqu’un utilisateur remplit un formulaire à code à barres à l’aide d’Adobe Reader, d’Acrobat Professional ou d’Acrobat Standard, le code à barres est automatiquement mis à jour afin de coder les données de formulaire fournies par l’utilisateur. L’utilisateur peut envoyer le formulaire par voie électronique, ou l’imprimer sur papier et l’envoyer par la poste, par télécopieur ou par la main. Vous pouvez ensuite extraire les données fournies par l’utilisateur dans le cadre d’un processus automatisé, en les transférant entre les processus d’approbation et les systèmes d’entreprise.
For more information about the barcoded forms service, see Services Reference for AEM Forms .

Décodage des données de formulaire à code à barres

Vous pouvez utiliser l’API du service Barcoded Forms pour décoder les données d’un formulaire PDF ou d’une image contenant un code à barres. Le décodage des données de formulaire consiste à extraire les données qui se trouvent dans le code à barres. Avant de pouvoir décoder les données d’un formulaire PDF (ou d’une image), l’utilisateur doit renseigner le formulaire avec des données.
For more information about the barcoded forms service, see Services Reference for AEM Forms .

Résumé des étapes

Pour décoder les données d’un formulaire PDF, procédez comme suit :
  1. Incluez des fichiers de projet.
  2. Créez un objet API Barcoded FormsClient.
  3. Obtenez un formulaire PDF contenant des données à code à barres.
  4. Décodez les données du formulaire PDF.
  5. Convertissez les données en source de données XML.
  6. Traitez les données décodées.
Inclure les fichiers de projet
Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services Web, veillez à inclure les fichiers proxy.
Les fichiers JAR suivants doivent être ajoutés au chemin de classe de votre projet :
  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-barcodedforms-client.jar
  • adobe-utilities.jar (requis si AEM Forms est déployé sur JBoss)
  • jbossall-client.jar (requis si AEM Forms est déployé sur JBoss)
  • xercesImpl.jar (situé dans <répertoire d’installation>/Adobe/Adobe_Experience_Manager_forms/sdk/client-libs\thirdparty)
Si AEM Forms est déployé sur un serveur d’applications J2EE pris en charge qui n’est pas JBOSS, vous devez remplacer adobe-utilities.jar et jbossall-client.jar par des fichiers JAR spécifiques au serveur d’applications J2EE sur lequel AEM Forms est déployé. For information about the location of all AEM Forms JAR files, see Including AEM Forms Java library files .
Création d’un objet API client de formulaires à code à barres
Avant de pouvoir exécuter une opération de service Barcoded Forms par programmation, vous devez créer un client de service Barcoded Forms. Si vous utilisez l’API Java, créez un BarcodedFormsServiceClient objet. Si vous utilisez l’API du service Web de formulaires à code à barres, créez un BarcodedFormsServiceService objet.
Obtenir un formulaire PDF contenant des données à code à barres
Vous devez obtenir un formulaire PDF contenant un code à barres rempli de données utilisateur.
Décodage des données du formulaire PDF
Après avoir obtenu un formulaire PDF (ou une image) contenant un code à barres, vous pouvez décoder les données. Le service Barcoded Forms prend en charge les types de codes à barres suivants :
  • Codes à barres PDF417.
  • Codes à barres de matrice de données.
  • Codes à barres de code QR.
  • Codes à barres de code.
  • Codes à barres Code 128.
  • Codes à barres Code 39.
  • Codes à barres EAN-13.
  • Codes à barres EAN-8.
L’entrée de jeu de caractères au format hexadécimal dans l’API de décodage implique que le contenu du code à barres est codé en tant que chaîne hexadécimale. Si, par exemple, UTF-8 est spécifié comme encodage de caractères dans le formulaire et Hex dans l’opération de décodage, le contenu du code à barres est codé en tant que chaîne hexadécimale dans l’élément < xb:content > de la sortie décodée. Vous pouvez convertir cette valeur hexadécimale pour obtenir le contenu d’origine en créant une logique d’application dans votre application cliente.
Convertir les données en source de données XML
Une fois les données de formulaire décodées, vous pouvez les convertir en données XDP ou XFDF. Supposons, par exemple, que vous souhaitiez importer les données dans un autre formulaire. Pour importer les données dans un formulaire XFA, vous devez convertir les données en données XDP. Pour plus d’informations, voir Importation de données de formulaire.
Traiter les données décodées
Vous pouvez traiter les données converties en fonction des besoins de votre entreprise. Par exemple, après avoir décodé et converti les données, vous pouvez les enregistrer dans un fichier, les stocker dans une base de données d’entreprise, remplir un autre formulaire, etc. Cette section explique comment enregistrer les données converties dans un fichier XML.
Le service Barcoded Forms ne parvient pas à décoder les données du code à barres lorsque le délimiteur de ligne et les paramètres de délimiteur de champ ont la même valeur.
Voir également

Décodage des données de formulaire à code à barres à l’aide de l’API Java

Décodez les données de formulaire à l’aide de l’API de formulaires à code à barres (Java) :
  1. Inclure les fichiers de projet
    Incluez les fichiers JAR client dans le chemin de classe de votre projet Java.
  2. Création d’un objet API client de formulaires à code à barres
    Créez un BarcodedFormsServiceClient objet en utilisant son constructeur et en transmettant un ServiceClientFactory objet contenant des propriétés de connexion.
  3. Obtenir un formulaire PDF contenant des données à code à barres
    • Créez un java.io.FileInputStream objet représentant le formulaire PDF contenant des données à code à barres à l’aide de son constructeur et transmettez une valeur de chaîne indiquant l’emplacement du document PDF.
    • Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream .
  4. Décodage des données du formulaire PDF
    Décodez les données du formulaire en appelant la BarcodedFormsServiceClient decode méthode de l’objet et en transmettant les valeurs suivantes :
    • Objet com.adobe.idp.Document contenant le formulaire PDF.
    • Objet java.lang.Boolean spécifiant si le code à barres PDF417 doit être décodé.
    • Objet java.lang.Boolean spécifiant si le code à barres d’une matrice de données doit être décodé.
    • Objet java.lang.Boolean spécifiant si le code à barres d’un code QR doit être décodé.
    • Objet java.lang.Boolean spécifiant s’il faut décoder un code à barres codabar.
    • Objet java.lang.Boolean spécifiant si un code à barres 128 doit être décodé.
    • Objet java.lang.Boolean qui spécifie s’il faut décoder un code à barres 39.
    • Objet java.lang.Boolean spécifiant si le code à barres EAN-13 doit être décodé.
    • Objet java.lang.Boolean qui spécifie s’il faut décoder un code à barres EAN-8.
    • Valeur com.adobe.livecycle.barcodedforms.CharSet d’énumération spécifiant la valeur de codage du jeu de caractères utilisée dans le code à barres.
    La decode méthode renvoie un org.w3c.dom.Document objet contenant des données de formulaire décodées.
  5. Convertir les données en source de données XML
    Convertissez les données décodées en données XDP ou XFDF en appelant la BarcodedFormsServiceClient extractToXML méthode de l’objet et en transmettant les valeurs suivantes :
    • Objet org.w3c.dom.Document contenant des données décodées (assurez-vous d’utiliser la valeur renvoyée par la decode méthode).
    • Valeur com.adobe.livecycle.barcodedforms.Delimiter d’énumération spécifiant le délimiteur de ligne. Il est recommandé de spécifier Delimiter.Carriage_Return .
    • Valeur com.adobe.livecycle.barcodedforms.Delimiter d’énumération spécifiant le délimiteur de champ. For example, specify Delimiter.Tab .
    • Valeur com.adobe.livecycle.barcodedforms.XMLFormat d’énumération spécifiant si les données du code à barres doivent être converties en données XML XDP ou XFDF. Par exemple, spécifiez XMLFormat.XDP pour convertir les données en données XDP.
    Ne spécifiez pas les mêmes valeurs pour les paramètres du délimiteur de ligne et du délimiteur de champ.
    La extractToXML méthode renvoie un java.util.List objet où chaque élément est un org.w3c.dom.Document objet. Il existe un élément distinct pour chaque code à barres situé sur le formulaire. En d’autres termes, s’il y a quatre codes à barres sur le formulaire, il y a quatre éléments dans l’ java.util.List objet renvoyé.
  6. Traiter les données décodées
    • Parcourez l’ java.util.List objet pour obtenir chaque org.w3c.dom.Document objet de la liste.
    • Pour chaque élément de la liste, convertissez l’ org.w3c.dom.Document objet en com.adobe.idp.Document objet. (La logique de l’application qui convertit un org.w3c.dom.Document objet en com.adobe.idp.Document objet s’affiche dans les données de formulaire à code à barres de décodage à l’aide de l’exemple d’API Java).
    • Enregistrez les données XML sous forme de fichier XML en appelant l’objet com.adobe.idp.Document copyToFile et en transmettant un objet File représentant le fichier XML.
Voir également

Décodage des données de formulaire à code à barres à l’aide de l’API du service Web

Décodez les données de formulaire à l’aide de l’API de formulaires à code à barres (service Web) :
  1. Inclure les fichiers de projet
  2. Création d’un objet API client de formulaires à code à barres
    A l’aide de l’assembly client Microsoft .NET qui consomme le fichier WSDL du service de formulaires à code à barres, créez un BarcodedFormsServiceService objet en appelant son constructeur par défaut.
  3. Obtenir un formulaire PDF contenant des données à code à barres
    • Créez un objet BLOB en utilisant son constructeur. L’ BLOB objet est utilisé pour stocker un document PDF contenant un code à barres.
    • Créez un System.IO.FileStream objet en appelant son constructeur et en transmettant une valeur de chaîne représentant l’emplacement du fichier PDF et le mode d’ouverture du fichier.
    • Créez un tableau d’octets qui stocke le contenu de l’ System.IO.FileStream objet. Vous pouvez déterminer la taille du tableau d’octets en obtenant la System.IO.FileStream Length propriété de l’objet.
    • Renseignez le tableau d’octets avec les données de flux en appelant la System.IO.FileStream Read méthode de l’objet et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.
    • Renseignez l’ BLOB objet en affectant sa binaryData propriété au contenu du tableau d’octets.
  4. Décodage des données du formulaire PDF
    Décodez les données du formulaire en appelant la BarcodedFormsServiceService decode méthode de l’objet et en transmettant les valeurs suivantes :
    • Objet BLOB contenant le formulaire PDF.
    • Objet Boolean spécifiant si le code à barres PDF417 doit être décodé.
    • Objet Boolean spécifiant si le code à barres d’une matrice de données doit être décodé.
    • Objet Boolean spécifiant si le code à barres d’un code QR doit être décodé.
    • Objet Boolean spécifiant s’il faut décoder un code à barres codabar.
    • Objet Boolean spécifiant si un code à barres 128 doit être décodé.
    • Objet Bolean qui spécifie s’il faut décoder un code à barres 39.
    • Objet Boolean spécifiant si le code à barres EAN-13 doit être décodé.
    • Objet Boolean qui spécifie s’il faut décoder un code à barres EAN-8.
    • Valeur CharSet d’énumération spécifiant la valeur de codage du jeu de caractères utilisée dans le code à barres.
    La decode méthode renvoie une valeur de chaîne contenant des données de formulaire décodées.
  5. Convertir les données en source de données XML
    Convertissez les données décodées en données XDP ou XFDF en appelant la BarcodedFormsServiceService extractToXML méthode de l’objet et en transmettant les valeurs suivantes :
    • Valeur de chaîne contenant des données décodées (veillez à utiliser la valeur renvoyée par la decode méthode).
    • Valeur Delimiter d’énumération spécifiant le délimiteur de ligne. Il est recommandé de spécifier Delimiter.Carriage_Return .
    • Valeur Delimiter d’énumération spécifiant le délimiteur de champ. For example, specify Delimiter.Tab .
    • Valeur XMLFormat d’énumération spécifiant si les données du code à barres doivent être converties en données XML XDP ou XFDF. Par exemple, spécifiez XMLFormat.XDP pour convertir les données en données XDP.
    Ne spécifiez pas les mêmes valeurs pour les paramètres du délimiteur de ligne et du délimiteur de champ.
    La extractToXML méthode renvoie un Object tableau où chaque élément est une BLOB instance. Il existe un élément distinct pour chaque code à barres situé sur le formulaire. En d’autres termes, s’il y a quatre codes à barres sur le formulaire, il y a quatre éléments dans le Object tableau renvoyé.
  6. Traiter les données décodées
    • Créez un System.IO.FileStream objet en appelant son constructeur et en transmettant une valeur de chaîne représentant l’emplacement du fichier du document PDF sécurisé.
    • Créez un tableau d’octets qui stocke le contenu des données de l’ BLOB objet renvoyé par la encryptPDFUsingPassword méthode. Renseignez le tableau d’octets en obtenant la valeur du membre BLOB binaryData de données de l’objet.
    • Create a System.IO.BinaryWriter object by invoking its constructor and passing the System.IO.FileStream object.
    • Ecrivez le contenu du tableau d’octets dans un fichier PDF en appelant la System.IO.BinaryWriter Write méthode de l’objet et en transmettant le tableau d’octets.
Voir également