Préremplissage de Forms avec des mises en page souples

Préremplissage de Forms avec des mises en page souples

Le préremplissage de formulaires affiche des données aux utilisateurs dans un formulaire rendu. Supposons, par exemple, qu’un utilisateur se connecte à un site web avec un nom d’utilisateur et un mot de passe. Si l’authentification est réussie, l’application cliente interroge une base de données pour obtenir des informations sur l’utilisateur. Les données sont fusionnées dans le formulaire, puis le formulaire est rendu à l’utilisateur. Par conséquent, l’utilisateur peut afficher des données personnalisées dans le formulaire.

Le préremplissage d’un formulaire présente les avantages suivants :

  • Elle permet à l’utilisateur d’afficher des données personnalisées dans un formulaire.
  • Réduit la quantité de saisie que l’utilisateur fait pour remplir un formulaire.
  • Elle assure l’intégrité des données grâce au contrôle du placement des données.

Les deux sources de données XML suivantes peuvent préremplir un formulaire :

  • Une source de données XDP, qui est du code XML conforme à la syntaxe XFA (ou des données XFDF pour préremplir un formulaire créé à l’aide d’Acrobat).
  • Une source de données XML arbitraire qui contient des paires nom/valeur correspondant aux noms de champ du formulaire (les exemples de cette section utilisent une source de données XML arbitraire).

Un élément XML doit exister pour chaque champ de formulaire que vous souhaitez préremplir. Le nom de l’élément XML doit correspondre au nom du champ. Un élément XML est ignoré s’il ne correspond pas à un champ de formulaire ou si le nom de l’élément XML ne correspond pas au nom du champ. Il n'est pas nécessaire de correspondre à l'ordre dans lequel les éléments XML sont affichés, tant que tous les éléments XML sont spécifiés.

Lorsque vous préremplissez un formulaire qui contient déjà des données, vous devez spécifier les données déjà affichées dans la source de données XML. Supposons qu’un formulaire contenant 10 champs comporte des données dans quatre champs. Supposons ensuite que vous souhaitiez préremplir les six champs restants. Dans ce cas, vous devez spécifier 10 éléments XML dans la source de données XML utilisée pour préremplir le formulaire. Si vous ne spécifiez que six éléments, les quatre champs d'origine sont vides.

Vous pouvez, par exemple, préremplir un formulaire tel que l’exemple de formulaire de confirmation. (Voir "Formulaire de confirmation" dans Rendu des PDF forms interactifs.)

Pour préremplir l’exemple de formulaire de confirmation, vous devez créer une source de données XML qui contient trois éléments XML correspondant aux trois champs du formulaire. Ce formulaire contient les trois champs suivants : FirstName, LastName et Amount. La première étape consiste à créer une source de données XML contenant des éléments XML correspondant aux champs situés dans la conception de formulaire. L’étape suivante consiste à attribuer des valeurs de données aux éléments XML, comme illustré dans le code XML suivant.

     <Untitled>
         <FirstName>Jerry</FirstName>
         <LastName>Johnson</LastName>
         <Amount>250000</Amount>
     </Untitled>

Une fois que vous avez prérempli le formulaire de confirmation avec cette source de données XML, puis effectué le rendu du formulaire, les valeurs de données que vous avez attribuées aux éléments XML s’affichent, comme illustré dans le diagramme ci-dessous.

pf_pf_confirmxml3

Préremplissage des formulaires avec des dispositions à disposition souple

Les Forms avec disposition souple sont utiles pour afficher une quantité indéterminée de données aux utilisateurs. Étant donné que la disposition du formulaire s’ajuste automatiquement à la quantité de données fusionnées, il n’est pas nécessaire de prédéfinir une disposition ou un nombre fixe de pages pour le formulaire, comme vous le devez pour un formulaire avec une disposition fixe.

Un formulaire est généralement rempli avec des données obtenues lors de l’exécution. Par conséquent, vous pouvez préremplir un formulaire en créant une source de données XML en mémoire et en plaçant les données directement dans la source de données XML en mémoire.

Prenons l’exemple d’une application web, telle qu’une boutique en ligne. Une fois qu’un acheteur en ligne a terminé son achat, tous les articles achetés sont placés dans une source de données XML en mémoire qui est utilisée pour préremplir un formulaire. Le diagramme suivant illustre ce processus, qui est expliqué dans le tableau suivant le diagramme.

pf_pf_finsrv_webapp_v1

Le tableau suivant décrit les étapes de ce diagramme.

Étape

Description

1

Un utilisateur achète des articles dans une boutique en ligne basée sur le Web.

2

Une fois que l’utilisateur a terminé ses achats et cliqué sur le bouton Envoyer, une source de données XML en mémoire est créée. Les éléments achetés et les informations utilisateur sont placés dans la source de données XML en mémoire.

3

La source de données XML est utilisée pour préremplir un formulaire de bon de commande (un exemple de ce formulaire est illustré ci-dessous).

4

Le formulaire de bon de commande est rendu dans le navigateur Web client.

Le diagramme suivant illustre un exemple de formulaire de bon de commande. Les informations du tableau peuvent s’adapter au nombre d’enregistrements dans les données XML.

pf_pf_poform

REMARQUE

Un formulaire peut être prérempli avec des données provenant d’autres sources, telles qu’une base de données d’entreprise ou des applications externes.

Considérations relatives à la conception de formulaire

Les Forms avec disposition souple sont basées sur des conceptions de formulaire créées dans Designer. Une conception de formulaire spécifie un ensemble de règles de disposition, de présentation et de capture de données, y compris le calcul de valeurs en fonction des entrées de l’utilisateur. Les règles sont appliquées lorsque des données sont entrées dans un formulaire. Les champs ajoutés à un formulaire sont des sous-formulaires qui se trouvent dans la conception de formulaire. Par exemple, dans le formulaire de bon de commande illustré dans le diagramme précédent, chaque ligne est un sous-formulaire. Pour plus d’informations sur la création d’une conception de formulaire contenant des sous-formulaires, voir Création d’un formulaire de bon de commande doté d’une disposition souple.

Présentation des sous-groupes de données

Une source de données XML est utilisée pour préremplir les formulaires avec des mises en page fixes et des mises en page à disposition souple. Cependant, la différence réside dans le fait qu’une source de données XML qui préremplit un formulaire avec une disposition souple contient des éléments XML qui se répètent et sont utilisés pour préremplir les sous-formulaires qui sont répétés dans le formulaire. Ces éléments XML qui se répètent sont appelés sous-groupes de données.

Une source de données XML utilisée pour préremplir le formulaire de bon de commande illustré dans le diagramme précédent contient quatre sous-groupes de données qui se répètent. Chaque sous-groupe de données correspond à un article acheté. Les articles achetés sont un écran, une lampe de bureau, un téléphone et un carnet d’adresses.

La source de données XML suivante est utilisée pour préremplir le formulaire de bon de commande.

     <header>
         <!-- XML elements used to prepopulate non-repeating fields such as address
         <!and city
         <txtPONum>8745236985</txtPONum>
         <dtmDate>2004-02-08</dtmDate>
         <txtOrderedByCompanyName>Any Company Name</txtOrderedByCompanyName>
         <txtOrderedByAddress>555, Any Blvd.</txtOrderedByAddress>
         <txtOrderedByCity>Any City</txtOrderedByCity>
         <txtOrderedByStateProv>ST</txtOrderedByStateProv>
         <txtOrderedByZipCode>12345</txtOrderedByZipCode>
         <txtOrderedByCountry>Any Country</txtOrderedByCountry>
         <txtOrderedByPhone>(123) 456-7890</txtOrderedByPhone>
         <txtOrderedByFax>(123) 456-7899</txtOrderedByFax>
         <txtOrderedByContactName>Contact Name</txtOrderedByContactName>
         <txtDeliverToCompanyName>Any Company Name</txtDeliverToCompanyName>
         <txtDeliverToAddress>7895, Any Street</txtDeliverToAddress>
         <txtDeliverToCity>Any City</txtDeliverToCity>
         <txtDeliverToStateProv>ST</txtDeliverToStateProv>
         <txtDeliverToZipCode>12346</txtDeliverToZipCode>
         <txtDeliverToCountry>Any Country</txtDeliverToCountry>
         <txtDeliverToPhone>(123) 456-7891</txtDeliverToPhone>
         <txtDeliverToFax>(123) 456-7899</txtDeliverToFax>
         <txtDeliverToContactName>Contact Name</txtDeliverToContactName>
     </header>
     <detail>
         <!-- A data subgroup that contains information about the monitor>
         <txtPartNum>00010-100</txtPartNum>
         <txtDescription>Monitor</txtDescription>
         <numQty>1</numQty>
         <numUnitPrice>350.00</numUnitPrice>
     </detail>
     <detail>
         <!-- A data subgroup that contains information about the desk lamp>
         <txtPartNum>00010-200</txtPartNum>
         <txtDescription>Desk lamps</txtDescription>
         <numQty>3</numQty>
         <numUnitPrice>55.00</numUnitPrice>
     </detail>
     <detail>
         <!-- A data subgroup that contains information about the Phone>
             <txtPartNum>00025-275</txtPartNum>
             <txtDescription>Phone</txtDescription>
             <numQty>5</numQty>
             <numUnitPrice>85.00</numUnitPrice>
     </detail>
     <detail>
         <!-- A data subgroup that contains information about the address book>
         <txtPartNum>00300-896</txtPartNum>
         <txtDescription>Address book</txtDescription>
         <numQty>2</numQty>
         <numUnitPrice>15.00</numUnitPrice>
     </detail>

Notez que chaque sous-groupe de données contient quatre éléments XML qui correspondent à ces informations :

  • Numéro de pièce des éléments
  • Description des éléments
  • Quantité d’articles
  • Prix unitaire

Le nom de l’élément XML parent d’un sous-groupe de données doit correspondre au nom du sous-formulaire situé dans la conception de formulaire. Par exemple, dans le diagramme précédent, notez que le nom de l’élément XML parent du sous-groupe de données est detail. Cela correspond au nom du sous-formulaire situé dans la conception de formulaire sur laquelle repose le formulaire de bon de commande. Si le nom de l’élément XML parent du sous-groupe de données et le sous-formulaire ne correspondent pas, aucun formulaire côté serveur n’est prérempli.

Chaque sous-groupe de données doit contenir des éléments XML correspondant aux noms des champs dans le sous-formulaire. Le sous-formulaire detail situé dans la conception de formulaire contient les champs suivants :

  • txtPartNum
  • txtDescription
  • numQty
  • numUnitPrice
REMARQUE

Si vous tentez de préremplir un formulaire avec une source de données contenant des éléments XML qui se répètent et que vous définissez l’option RenderAtClient sur No, seul le premier enregistrement de données est fusionné dans le formulaire. Pour vous assurer que tous les enregistrements de données sont fusionnés dans le formulaire, définissez RenderAtClient sur Yes. Pour plus d’informations sur l’option RenderAtClient, voir Rendu du Forms sur le client.

REMARQUE

Pour plus d’informations sur le service Forms, voir Référence des services pour AEM Forms.

Résumé des étapes

Pour préremplir un formulaire avec une disposition souple, procédez comme suit :

  1. Inclure les fichiers de projet.
  2. Créez une source de données XML en mémoire.
  3. Convertir la source de données XML.
  4. Générer un formulaire prérempli.

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.

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.

Création d’une source de données XML en mémoire

Vous pouvez utiliser les classes org.w3c.dom pour créer une source de données XML en mémoire afin de préremplir un formulaire avec une disposition souple. Vous devez placer les données dans une source de données XML conforme au formulaire. Pour plus d’informations sur la relation entre un formulaire avec une disposition souple et la source de données XML, voir Présentation des sous-groupes de données.

Conversion de la source de données XML

Une source de données XML en mémoire créée à l’aide des classes org.w3c.dom peut être convertie en objet com.adobe.idp.Document avant de pouvoir être utilisée pour préremplir un formulaire. Une source de données XML en mémoire peut être convertie à l’aide de classes de transformation XML Java.

REMARQUE

Si vous utilisez le WSDL du service Forms pour préremplir un formulaire, vous devez convertir un objet org.w3c.dom.Document en objet BLOB.

Rendu d’un formulaire prérempli

Vous générez un formulaire prérempli comme tout autre formulaire. La seule différence est que vous utilisez l’objet com.adobe.idp.Document qui contient la source de données XML pour préremplir le formulaire.

Voir également

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Réglage des propriétés de la connexion

Démarrages rapides de l’API Forms Service

Rendu des PDF forms interactifs

Création d’applications web qui renvoient Forms

Préremplissage des formulaires à l’aide de l’API Java

Pour préremplir un formulaire avec une disposition souple à l’aide de l’API Forms (Java), procédez comme suit :

  1. Inclure les fichiers de projet

    Incluez les fichiers JAR client, tels que adobe-forms-client.jar, dans le chemin de classe de votre projet Java. Pour plus d’informations sur l’emplacement de ces fichiers, voir Inclusion des fichiers de bibliothèque Java AEM Forms.

  2. Création d’une source de données XML en mémoire

    • Créez un objet Java DocumentBuilderFactory en appelant la méthode DocumentBuilderFactory class’ newInstance .

    • Créez un objet Java DocumentBuilder en appelant la méthode newDocumentBuilder de l’objet DocumentBuilderFactory.

    • Appelez la méthode newDocument de l’objet DocumentBuilder pour instancier un objet org.w3c.dom.Document.

    • Créez l’élément racine de la source de données XML en appelant la méthode createElement de l’objet org.w3c.dom.Document. Cela crée un objet Element qui représente l’élément racine. Transmettez une valeur string représentant le nom de l’élément à la méthode createElement . Convertissez la valeur de retour en Element. Ensuite, ajoutez l’élément racine au document en appelant la méthode appendChild de l’objet Document et transmettez l’objet d’élément racine en tant qu’argument. Les lignes de code suivantes présentent cette logique d’application :

       Element root = (Element)document.createElement("transaction");  document.appendChild(root);

    • Créez l’élément d’en-tête de la source de données XML en appelant la méthode createElement de l’objet Document. Transmettez une valeur string représentant le nom de l’élément à la méthode createElement . Convertissez la valeur de retour en Element. Ensuite, ajoutez l’élément d’en-tête à l’élément racine en appelant la méthode appendChild de l’objet root et transmettez l’objet d’élément d’en-tête en tant qu’argument. Les éléments XML ajoutés à l’élément d’en-tête correspondent à la partie statique du formulaire. Les lignes de code suivantes présentent cette logique d’application :

       Element header = (Element)document.createElement("header");  root.appendChild(header);

    • Créez un élément enfant qui appartient à l’élément d’en-tête en appelant la méthode createElement de l’objet Document et transmettez une valeur string qui représente le nom de l’élément. Convertissez la valeur de retour en Element. Ensuite, définissez une valeur pour l’élément enfant en appelant sa méthode appendChild et transmettez la méthode createTextNode de l’objet Document en tant qu’argument. Spécifiez une valeur string qui apparaît comme valeur de l’élément enfant. Enfin, ajoutez l’élément enfant à l’élément d’en-tête en appelant la méthode appendChild de l’élément d’en-tête et transmettez l’objet d’élément enfant comme argument. Les lignes de code suivantes présentent cette logique d’application :

       Element poNum= (Element)document.createElement("txtPONum");  poNum.appendChild(document.createTextNode("8745236985"));  header.appendChild(LastName);

    • Ajoutez tous les éléments restants à l’élément d’en-tête en répétant la dernière sous-étape pour chaque champ apparaissant dans la partie statique du formulaire (dans le diagramme de la source de données XML, ces champs sont affichés dans la section A. (Voir Présentation des sous-groupes de données).

    • Créez l’élément de détail de la source de données XML en appelant la méthode createElement de l’objet Document. Transmettez une valeur string représentant le nom de l’élément à la méthode createElement . Convertissez la valeur de retour en Element. Ensuite, ajoutez l’élément de détail à l’élément racine en appelant la méthode appendChild de l’objet root et transmettez l’objet d’élément de détail comme argument. Les éléments XML ajoutés à l’élément de détail correspondent à la partie dynamique du formulaire. Les lignes de code suivantes présentent cette logique d’application :

       Element detail = (Element)document.createElement("detail");  root.appendChild(detail);

    • Créez un élément enfant qui appartient à l’élément de détail en appelant la méthode createElement de l’objet Document et transmettez une valeur string qui représente le nom de l’élément. Convertissez la valeur de retour en Element. Ensuite, définissez une valeur pour l’élément enfant en appelant sa méthode appendChild et transmettez la méthode createTextNode de l’objet Document en tant qu’argument. Spécifiez une valeur string qui apparaît comme valeur de l’élément enfant. Enfin, ajoutez l’élément enfant à l’élément de détail en appelant la méthode appendChild de l’élément de détail et transmettez l’objet de l’élément enfant comme argument. Les lignes de code suivantes présentent cette logique d’application :

       Element txtPartNum = (Element)document.createElement("txtPartNum");  txtPartNum.appendChild(document.createTextNode("00010-100"));  detail.appendChild(txtPartNum);

    • Répétez la dernière sous-étape pour tous les éléments XML à ajouter à l’élément de détail. Pour créer correctement la source de données XML utilisée pour remplir le formulaire de bon de commande, vous devez ajouter les éléments XML suivants à l’élément de détail : txtDescription, numQty et numUnitPrice.

    • Répétez les deux dernières sous-étapes pour tous les éléments de données utilisés pour préremplir le formulaire.

  3. Conversion de la source de données XML

    • Créez un objet javax.xml.transform.Transformer en appelant la méthode javax.xml.transform.Transformer statique de l’objet newInstance.
    • Créez un objet Transformer en appelant la méthode newTransformer de l’objet TransformerFactory.
    • Créez un objet ByteArrayOutputStream en utilisant son constructeur.
    • Créez un objet javax.xml.transform.dom.DOMSource en utilisant son constructeur et en transmettant l’objet org.w3c.dom.Document créé à l’étape 1.
    • Créez un objet javax.xml.transform.dom.DOMSource en utilisant son constructeur et en transmettant l’objet ByteArrayOutputStream.
    • Renseignez l’objet Java ByteArrayOutputStream en appelant la méthode transform de l’objet javax.xml.transform.Transformer et en transmettant les objets javax.xml.transform.dom.DOMSource et javax.xml.transform.stream.StreamResult.
    • Créez un tableau d’octets et affectez la taille de l’objet ByteArrayOutputStream au tableau d’octets.
    • Renseignez le tableau d’octets en appelant la méthode toByteArray de l’objet ByteArrayOutputStream.
    • Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant le tableau d’octets.
  4. Rendu d’un formulaire prérempli

    Appelez la méthode renderPDFForm de l’objet FormsServiceClient et transmettez les valeurs suivantes :

    • Une valeur string qui spécifie le nom de la conception de formulaire, y compris l’extension du nom de fichier.
    • Objet com.adobe.idp.Document contenant les données à fusionner avec le formulaire. Assurez-vous d’utiliser l’objet com.adobe.idp.Document créé aux étapes 1 et 2.
    • Objet PDFFormRenderSpec qui stocke les options d’exécution.
    • Objet URLSpec contenant des valeurs URI requises par le service Forms.
    • Objet java.util.HashMap qui stocke les pièces jointes. Il s’agit d’un paramètre facultatif qui vous permet de spécifier null si vous ne souhaitez pas joindre de fichiers au formulaire.

    La méthode renderPDFForm renvoie un objet FormsResult contenant un flux de données de formulaire qui doit être écrit dans le navigateur Web client.

    • Créez un objet javax.servlet.ServletOutputStream utilisé pour envoyer un flux de données de formulaire au navigateur Web client.
    • Créez un objet com.adobe.idp.Document en appelant la méthode FormsResult de l’objet getOutputContent.
    • Créez un objet java.io.InputStream en appelant la méthode getInputStream de l’objet com.adobe.idp.Document.
    • Créez un tableau d’octets pour le remplir avec le flux de données de formulaire en appelant la méthode InputStream de l’objet read et en transmettant le tableau d’octets en tant qu’argument.
    • Appelez la méthode write de l’objet javax.servlet.ServletOutputStream pour envoyer le flux de données de formulaire au navigateur Web client. Transmettez le tableau d’octets à la méthode write .

Voir également

Démarrage rapide (mode SOAP) : Préremplissage de Forms avec des mises en page souples à l’aide de l’API Java

Inclusion des fichiers de bibliothèque Java d’AEM Forms

Réglage des propriétés de la connexion

Préremplissage des formulaires à l’aide de l’API de service Web

Pour préremplir un formulaire avec une disposition souple à l’aide de l’API Forms (service Web), procédez comme suit :

  1. Inclure les fichiers de projet

  2. Création d’une source de données XML en mémoire

    • Créez un objet Java DocumentBuilderFactory en appelant la méthode DocumentBuilderFactory class’ newInstance .

    • Créez un objet Java DocumentBuilder en appelant la méthode newDocumentBuilder de l’objet DocumentBuilderFactory.

    • Appelez la méthode newDocument de l’objet DocumentBuilder pour instancier un objet org.w3c.dom.Document.

    • Créez l’élément racine de la source de données XML en appelant la méthode createElement de l’objet org.w3c.dom.Document. Cela crée un objet Element qui représente l’élément racine. Transmettez une valeur string représentant le nom de l’élément à la méthode createElement . Convertissez la valeur de retour en Element. Ensuite, ajoutez l’élément racine au document en appelant la méthode appendChild de l’objet Document et transmettez l’objet d’élément racine en tant qu’argument. Les lignes de code suivantes présentent cette logique d’application :

       Element root = (Element)document.createElement("transaction");  document.appendChild(root);

    • Créez l’élément d’en-tête de la source de données XML en appelant la méthode createElement de l’objet Document. Transmettez une valeur string représentant le nom de l’élément à la méthode createElement . Convertissez la valeur de retour en Element. Ensuite, ajoutez l’élément d’en-tête à l’élément racine en appelant la méthode appendChild de l’objet root et transmettez l’objet d’élément d’en-tête en tant qu’argument. Les éléments XML ajoutés à l’élément d’en-tête correspondent à la partie statique du formulaire. Les lignes de code suivantes présentent cette logique d’application :

       Element header = (Element)document.createElement("header");  root.appendChild(header);

    • Créez un élément enfant qui appartient à l’élément d’en-tête en appelant la méthode createElement de l’objet Document et transmettez une valeur string qui représente le nom de l’élément. Convertissez la valeur de retour en Element. Ensuite, définissez une valeur pour l’élément enfant en appelant sa méthode appendChild et transmettez la méthode createTextNode de l’objet Document en tant qu’argument. Spécifiez une valeur string qui apparaît comme valeur de l’élément enfant. Enfin, ajoutez l’élément enfant à l’élément d’en-tête en appelant la méthode appendChild de l’élément d’en-tête et transmettez l’objet d’élément enfant comme argument. Les lignes de code suivantes présentent cette logique d’application :

       Element poNum= (Element)document.createElement("txtPONum");  poNum.appendChild(document.createTextNode("8745236985"));  header.appendChild(LastName);

    • Ajoutez tous les éléments restants à l’élément d’en-tête en répétant la dernière sous-étape pour chaque champ apparaissant dans la partie statique du formulaire (dans le diagramme de la source de données XML, ces champs sont affichés dans la section A. (Voir Présentation des sous-groupes de données).

    • Créez l’élément de détail de la source de données XML en appelant la méthode createElement de l’objet Document. Transmettez une valeur string représentant le nom de l’élément à la méthode createElement . Convertissez la valeur de retour en Element. Ensuite, ajoutez l’élément de détail à l’élément racine en appelant la méthode appendChild de l’objet root et transmettez l’objet d’élément de détail comme argument. Les éléments XML ajoutés à l’élément de détail correspondent à la partie dynamique du formulaire. Les lignes de code suivantes présentent cette logique d’application :

       Element detail = (Element)document.createElement("detail");  root.appendChild(detail);

    • Créez un élément enfant qui appartient à l’élément de détail en appelant la méthode createElement de l’objet Document et transmettez une valeur string qui représente le nom de l’élément. Convertissez la valeur de retour en Element. Ensuite, définissez une valeur pour l’élément enfant en appelant sa méthode appendChild et transmettez la méthode createTextNode de l’objet Document en tant qu’argument. Spécifiez une valeur string qui apparaît comme valeur de l’élément enfant. Enfin, ajoutez l’élément enfant à l’élément de détail en appelant la méthode appendChild de l’élément de détail et transmettez l’objet de l’élément enfant comme argument. Les lignes de code suivantes présentent cette logique d’application :

       Element txtPartNum = (Element)document.createElement("txtPartNum");  txtPartNum.appendChild(document.createTextNode("00010-100"));  detail.appendChild(txtPartNum);

    • Répétez la dernière sous-étape pour tous les éléments XML à ajouter à l’élément de détail. Pour créer correctement la source de données XML utilisée pour remplir le formulaire de bon de commande, vous devez ajouter les éléments XML suivants à l’élément de détail : txtDescription, numQty et numUnitPrice.

    • Répétez les deux dernières sous-étapes pour tous les éléments de données utilisés pour préremplir le formulaire.

  3. Conversion de la source de données XML

    • Créez un objet javax.xml.transform.Transformer en appelant la méthode javax.xml.transform.Transformer statique de l’objet newInstance.
    • Créez un objet Transformer en appelant la méthode newTransformer de l’objet TransformerFactory.
    • Créez un objet ByteArrayOutputStream en utilisant son constructeur.
    • Créez un objet javax.xml.transform.dom.DOMSource en utilisant son constructeur et en transmettant l’objet org.w3c.dom.Document créé à l’étape 1.
    • Créez un objet javax.xml.transform.dom.DOMSource en utilisant son constructeur et en transmettant l’objet ByteArrayOutputStream.
    • Renseignez l’objet Java ByteArrayOutputStream en appelant la méthode transform de l’objet javax.xml.transform.Transformer et en transmettant les objets javax.xml.transform.dom.DOMSource et javax.xml.transform.stream.StreamResult.
    • Créez un tableau d’octets et affectez la taille de l’objet ByteArrayOutputStream au tableau d’octets.
    • Renseignez le tableau d’octets en appelant la méthode toByteArray de l’objet ByteArrayOutputStream.
    • Créez un objet BLOB à l’aide de son constructeur, appelez sa méthode setBinaryData et transmettez le tableau d’octets.
  4. Rendu d’un formulaire prérempli

    Appelez la méthode renderPDFForm de l’objet FormsService et transmettez les valeurs suivantes :

    • Une valeur string qui spécifie le nom de la conception de formulaire, y compris l’extension du nom de fichier.
    • Objet BLOB contenant les données à fusionner avec le formulaire. Assurez-vous d’utiliser l’objet BLOB créé aux étapes 1 et 2.
    • Objet PDFFormRenderSpecc qui stocke les options d’exécution. Pour plus d’informations, voir Référence de l’API AEM Forms.
    • Objet URLSpec contenant des valeurs URI requises par le service Forms.
    • Objet java.util.HashMap qui stocke les pièces jointes. Il s’agit d’un paramètre facultatif qui vous permet de spécifier null si vous ne souhaitez pas joindre de fichiers au formulaire.
    • Objet com.adobe.idp.services.holders.BLOBHolder vide renseigné par la méthode . Il est utilisé pour stocker le formulaire PDF rendu.
    • Objet javax.xml.rpc.holders.LongHolder vide renseigné par la méthode . (Cet argument stocke le nombre de pages dans le formulaire).
    • Objet javax.xml.rpc.holders.StringHolder vide renseigné par la méthode . (Cet argument stocke la valeur du paramètre régional).
    • Objet com.adobe.idp.services.holders.FormsResultHolder vide qui contiendra les résultats de cette opération.

    La méthode renderPDFForm renseigne l’objet com.adobe.idp.services.holders.FormsResultHolder transmis en tant que valeur du dernier argument avec un flux de données de formulaire qui doit être écrit dans le navigateur Web client.

    • Créez un objet FormResult en obtenant la valeur du membre de données value de l’objet com.adobe.idp.services.holders.FormsResultHolder.
    • Créez un objet BLOB contenant des données de formulaire en appelant la méthode getOutputContent de l’objet FormsResult.
    • Obtenez le type de contenu de l’objet BLOB en appelant sa méthode getContentType.
    • Définissez le type de contenu de l’objet javax.servlet.http.HttpServletResponse en appelant sa méthode setContentType et en transmettant le type de contenu de l’objet BLOB.
    • Créez un objet javax.servlet.ServletOutputStream utilisé pour écrire le flux de données de formulaire dans le navigateur Web client en appelant la méthode getOutputStream de l’objet javax.servlet.http.HttpServletResponse.
    • Créez un tableau d’octets et renseignez-le en appelant la méthode getBinaryData de l’objet BLOB. Cette tâche affecte le contenu de l’objet FormsResult au tableau d’octets.
    • Appelez la méthode write de l’objet javax.servlet.http.HttpServletResponse pour envoyer le flux de données de formulaire au navigateur Web client. Transmettez le tableau d’octets à la méthode write .
    REMARQUE

    La méthode renderPDFForm renseigne l’objet com.adobe.idp.services.holders.FormsResultHolder transmis en tant que valeur du dernier argument avec un flux de données de formulaire qui doit être écrit dans le navigateur Web client.

Voir également

Appel d’AEM Forms à l’aide du codage Base64

Sur cette page