Rendu de Forms au format HTML

Le service Forms effectue le rendu des formulaires au format HTML en réponse à une requête HTTP provenant d’un navigateur Web. Le rendu d’un formulaire au format HTML présente l’avantage que l’ordinateur sur lequel se trouve le navigateur Web client ne nécessite ni Adobe Reader, ni Acrobat, ni Flash Player (pour les guides de formulaire (obsolète)).

Pour générer un formulaire au format HTML, la conception de formulaire doit être enregistrée dans un fichier XDP. Une conception de formulaire enregistrée au format PDF ne peut pas être générée au format HTML. Lorsque vous développez une conception de formulaire dans Designer qui sera rendue au format HTML, tenez compte des critères suivants :

• N’utilisez pas les propriétés de bordure d’un objet pour tracer des lignes, des zones ou des grilles dans un formulaire. Certains navigateurs n’alignent pas les bordures exactement comme elles sont présentées dans un aperçu de Les objets risquent de se chevaucher ou de déplacer d’autres objets de manière imprévue.
• Vous pouvez utiliser des lignes, des rectangles et des cercles pour définir l’arrière-plan.
• Tracez du texte légèrement plus grand que ce qui semble être nécessaire pour s’adapter au texte. Certains navigateurs Web n’affichent pas le texte de manière lisible.

Pages HTML

Lorsqu’une conception de formulaire est générée sous la forme d’un formulaire HTML, chaque sous-formulaire de second niveau est généré sous la forme d’une page HTML (panneau). Vous pouvez vue la hiérarchie d’un sous-formulaire dans Designer. Les sous-formulaires enfants qui appartiennent au sous-formulaire racine (le nom par défaut d’un sous-formulaire racine est form1) sont les sous-formulaires de panneau. L’exemple suivant montre les sous-formulaires d’une conception de formulaire.

     form1 
         Master Pages 
         PanelSubform1 
             NestedDynamicSubform 
                 TextEdit1 
         PanelSubform2 
             TextEdit1 
         PanelSubform3 
             TextEdit1 
         PanelSubform4 
             TextEdit1

Lorsque les conceptions de formulaire sont générées sous forme de formulaires HTML, les panneaux ne sont pas limités à une taille de page particulière. Si vous disposez de sous-formulaires dynamiques, ils doivent être imbriqués dans le sous-formulaire de panneau. Les sous-formulaires dynamiques peuvent s’étendre à un nombre infini de pages HTML.

Lorsqu’un formulaire est rendu sous la forme d’un formulaire HTML, les formats de page (requis pour paginer les formulaires rendus au format PDF) n’ont aucune signification. Un formulaire avec une disposition souple pouvant atteindre un nombre infini de pages HTML, il est important d’éviter les pieds de page sur le gabarit. Un pied de page situé sous la zone de contenu d’un gabarit peut remplacer le contenu HTML qui déborde d’une limite de page.

Vous devez explicitement passer d’un panneau à l’autre à l’aide des méthodes xfa.host.pageUp et xfa.host.pageDown. Vous changez de page en envoyant un formulaire au service Forms et en demandant au service Forms de le rendre à nouveau sur le périphérique client, généralement un navigateur Web.

.fsc-ds-ssb : Cette feuille de style est applicable en cas de champ de signe vide.

.fsc-ds-ssv : Cette feuille de style est applicable en cas de champ de signature valide.

.fsc-ds-ssc : Cette feuille de style s’applique dans le cas d’un champ de signature valide, mais les données ont changé.

.fsc-ds-ssi : Cette feuille de style est applicable en cas de champ de signature non valide.

.fsc-ds-popup-bg : Cette propriété de feuille de style n’est pas utilisée.

.fsc-ds-popup-btn : Cette propriété de feuille de style n’est pas utilisée.

Exécution de scripts

Un auteur de formulaire indique si un script s’exécute sur le serveur ou sur le client. Le service Forms crée un environnement de traitement distribué et événement pour l’exécution de l’intelligence des formulaires qui peut être distribué entre le client et le serveur à l’aide de l’attribut runAt. Pour plus d’informations sur cet attribut ou la création de scripts dans les conceptions de formulaire, voir Forms Designer.

Le service Forms peut exécuter des scripts pendant la génération du formulaire. Par conséquent, vous pouvez préremplir un formulaire avec des données en vous connectant à une base de données ou à des services Web qui ne sont peut-être pas disponibles sur le client. Vous pouvez également définir le événement Click d’un bouton pour qu’il s’exécute sur le serveur de sorte que le client effectue un aller-retour des données vers le serveur. Cela permet au client d’exécuter des scripts qui peuvent nécessiter des ressources serveur, telles qu’une base de données d’entreprise, pendant qu’un utilisateur interagit avec un formulaire. Pour les formulaires HTML, les scripts formcalc peuvent être exécutés sur le serveur uniquement. Par conséquent, vous devez marquer ces scripts pour qu’ils s’exécutent à server ou both.

Vous pouvez concevoir des formulaires qui se déplacent entre les pages (panneaux) en appelant les méthodes xfa.host.pageUp et xfa.host.pageDown. Ce script est placé dans le événement Click d’un bouton et l’attribut runAt est défini sur Both. La raison pour laquelle vous choisissez Both est telle que Adobe Reader ou Acrobat (pour les formulaires rendus au format PDF) peut modifier les pages sans passer par le serveur et que les formulaires HTML peuvent modifier les pages en arrondissant les données de tri au serveur. En d’autres termes, un formulaire est envoyé au service Forms et un formulaire est rendu au format HTML avec la nouvelle page affichée.

Il est recommandé de ne pas donner aux variables de script et aux champs de formulaire les mêmes noms que les éléments, par exemple. Certains navigateurs Web, tels qu’Internet Explorer, peuvent ne pas initialiser une variable portant le même nom qu’un champ de formulaire, ce qui entraîne une erreur de script. Il est recommandé de donner différents noms aux champs de formulaire et aux variables de script.

Lors du rendu de formulaires HTML qui contiennent à la fois la fonctionnalité de navigation de page et les scripts de formulaire (par exemple, supposons qu’un script récupère les données de champ d’une base de données chaque fois que le formulaire est rendu), assurez-vous que le script de formulaire se trouve dans le événement form:calculate et non dans le formulaire:readyevent.

Les scripts de formulaire situés dans le événement form:ready ne sont exécutés qu’une seule fois lors du rendu initial du formulaire et ne sont pas exécutés pour les récupérations de page suivantes. En revanche, le événement form:calculate est exécuté pour chaque navigation de page dans laquelle le formulaire est généré.

Vous pouvez appeler des scripts personnalisés avant d’envoyer un formulaire. Cette fonction fonctionne sur tous les navigateurs disponibles. Cependant, il ne peut être utilisé que lorsque les utilisateurs effectuent le rendu du formulaire HTML dont la propriété Output Type est définie sur Form Body. Il ne fonctionnera pas lorsque Output Type est Full HTML. Reportez-vous à la rubrique Configuration de formulaires dans l’aide à l’administration pour connaître les étapes de configuration de cette fonctionnalité.

Vous devez d’abord définir une fonction de rappel appelée avant d’envoyer le formulaire, où le nom de la fonction est _user_onsubmit. On suppose que la fonction ne va pas lancer d'exception, ou si elle le fait, l'exception sera ignorée. Il est recommandé de placer la fonction JavaScript dans la section head du fichier html ; toutefois, vous pouvez le déclarer n’importe où avant la fin des balises de script qui incluent xfasubset.js.

Lorsque le serveur de formulaires effectue le rendu d’un fichier XDP contenant une liste déroulante, en plus de créer la liste déroulante, il crée également deux champs de texte masqués. Ces champs de texte stockent les données de la liste déroulante (l’un stocke le nom d’affichage des options et l’autre stocke la valeur des options). Par conséquent, chaque fois qu’un utilisateur envoie le formulaire, toutes les données de la liste déroulante sont envoyées. En supposant que vous ne souhaitiez pas envoyer autant de données à chaque fois, vous pouvez écrire un script personnalisé pour désactiver cette fonction. Par exemple : Le nom de la liste déroulante est drpOrderedByStateProv et est placé sous l’en-tête de sous-formulaire. Le nom de l’élément d’entrée HTML sera header[0].drpOrderedByStateProv[0]. Le nom des champs masqués qui stockent et envoient les données de la liste déroulante porte les noms suivants : header[0].drpOrderedByStateProv_DISPLAYITEMS_[0] header[0].drpOrderedByStateProv_VALUEITEMS_[0]

Vous pouvez désactiver ces éléments d’entrée de la manière suivante si vous ne souhaitez pas publier les données. var __CUSTOM_SCRIPTS_VERSION = 1; //enabling the feature function _user_onsubmit() { var elems = document.getElementsByName("header[0].drpOrderedByStateProv_DISPLAYITEMS_[0]"); elems[0].disabled = true; elems = document.getElementsByName("header[0].drpOrderedByStateProv_VALUEITEMS_[0]"); elems[0].disabled = true; }

header[0].drpOrderedByStateProv_DISPLAYITEMS_[0] header[0].drpOrderedByStateProv_VALUEITEMS_[0]

var __CUSTOM_SCRIPTS_VERSION = 1; //enabling the feature 
    function _user_onsubmit() { 
    var elems = document.getElementsByName("header[0].drpOrderedByStateProv_DISPLAYITEMS_[0]"); 
    elems[0].disabled = true; 
    elems = document.getElementsByName("header[0].drpOrderedByStateProv_VALUEITEMS_[0]"); 
    elems[0].disabled = true; 
    }

Sous-ensembles XFA

Lors de la création de conceptions de formulaire à générer au format HTML, vous devez limiter votre script au sous-ensemble XFA pour les scripts en langage JavaScript.

Les scripts qui s’exécutent sur le client ou sur le client et le serveur doivent être écrits dans le sous-ensemble XFA. Les scripts qui s’exécutent sur le serveur peuvent utiliser le modèle de script XFA complet et également FormCalc. Pour plus d’informations sur l’utilisation de JavaScript, voir Forms Designer.

Lors de l’exécution de scripts sur le client, seul le panneau actif affiché peut utiliser un script ; par exemple, vous ne pouvez pas effectuer de script sur les champs situés dans le panneau A lorsque le panneau B est affiché. Lors de l’exécution de scripts sur le serveur, tous les panneaux sont accessibles.

Vous devez également être prudent lors de l’utilisation d’expressions de modèle d’objet de script (SOM) dans des scripts exécutés sur le client. Seuls les scripts exécutés sur le client prennent en charge un sous-ensemble simplifié d’expressions SOM.

minutage de événement

Le sous-ensemble XFA définit les événements XFA qui sont associés à des événements HTML. Il y a une légère différence de comportement dans le timing des événements de calcul et de validation. Dans un navigateur Web, un événement de calcul complet est exécuté lorsque vous quittez un champ. Les événements de calcul ne sont pas automatiquement exécutés lorsque vous modifiez la valeur d’un champ. Vous pouvez forcer un événement de calcul en appelant la méthode xfa.form.execCalculate.

Dans un navigateur Web, les événements de validation ne sont exécutés que lorsque vous quittez un champ ou envoyez un formulaire. Vous pouvez forcer un événement de validation en utilisant la méthode xfa.form.execValidate.

Forms affiché dans un navigateur Web (par opposition à Adobe Reader ou Acrobat) est conforme au test null XFA (erreurs ou avertissements) pour les champs obligatoires.

• Si le test null génère une erreur et que vous quittez un champ sans spécifier de valeur, une boîte de message s’affiche et vous êtes repositionné dans le champ après avoir cliqué sur OK.
• Si un test null génère un avertissement et que vous quittez un champ sans spécifier de valeur, vous êtes invité à cliquer sur OK ou sur Annuler, ce qui vous permet de continuer sans spécifier de valeur ou de revenir au champ pour entrer une valeur.

Pour plus d’informations sur un test null, voir Forms Designer.

Boutons de formulaire

Le fait de cliquer sur un bouton d’envoi envoie des données de formulaire au service Forms et représente la fin du traitement du formulaire. Le événement preSubmit peut être configuré pour s'exécuter sur le client ou le serveur. Le événement preSubmit s’exécute avant l’envoi du formulaire s’il est configuré pour s’exécuter sur le client. Sinon, le événement preSubmit s’exécute sur le serveur pendant l’envoi du formulaire. Pour plus d’informations sur le événement preSubmit, voir Forms Designer.

Si aucun script client n’est associé à un bouton, les données sont envoyées au serveur, les calculs sont effectués sur le serveur et le formulaire HTML est régénéré. Si un bouton contient un script client, les données ne sont pas envoyées au serveur et le script client est exécuté dans le navigateur Web.

Navigateur Web HTML 4.0

Un navigateur Web qui ne prend en charge que HTML 4.0 ne peut pas prendre en charge le modèle de script côté client du sous-ensemble XFA. Lors de la création d’une conception de formulaire compatible avec HTML 4.0 et MSDHTML ou CSS2HTML, un script marqué pour s’exécuter sur le client s’exécute sur le serveur. Supposons, par exemple, qu’un utilisateur clique sur un bouton situé sur un formulaire affiché dans un navigateur Web HTML 4.0. Dans ce cas, les données de formulaire sont envoyées au serveur sur lequel le script client est exécuté.

Il est recommandé de placer la logique de formulaire dans les événements de calcul, qui s’exécutent sur le serveur dans HTML 4.0 et sur le client pour MSDHTML ou CSS2HTML.

Maintenance des modifications de présentation

Lorsque vous vous déplacez entre des pages HTML (panneaux), seul l’état des données est conservé. Les paramètres tels que la couleur d’arrière-plan ou les paramètres de champ obligatoire ne sont pas conservés (s’ils diffèrent des paramètres initiaux). Pour conserver l’état de présentation, vous devez créer des champs (généralement masqués) qui représentent l’état de présentation des champs. Si vous ajoutez un script au événement Calculate d’un champ qui modifie la présentation en fonction des valeurs de champ masqué, vous pouvez conserver l’état de la présentation lorsque vous passez d’une page HTML à l’autre (panneaux).

Le script suivant conserve la valeur fillColor d’un champ en fonction de la valeur de hiddenField. Supposons que ce script se trouve dans le événement Calculate d’un champ.

     If (hiddenField.rawValue == 1) 
         this.fillColor = "255,0,0" 
     else 
         this.fillColor = "0,255,0"

Signature numérique de formulaires HTML

Vous ne pouvez pas signer un formulaire HTML qui contient un champ de signature numérique si le formulaire est généré comme l’une des transformations HTML suivantes :

• AHTML
• HTML4
• StaticHTML
• NoScriptXHTML

Pour plus d’informations sur la signature numérique d’un document, voir Signature numérique et certification de Documents.

Rendu d’un formulaire XHTML conforme aux directives d’accessibilité

Vous pouvez générer un formulaire HTML complet conforme aux directives d’accessibilité. En d’autres termes, le formulaire est généré dans des balises HTML complètes, contrairement au formulaire HTML généré dans des balises body (et non dans une page HTML complète).

Validation des données de formulaire

Il est recommandé de limiter l’utilisation des règles de validation pour les champs de formulaire lors du rendu du formulaire au format HTML. Certaines règles de validation peuvent ne pas être prises en charge pour les formulaires HTML. Par exemple, lorsqu’un modèle de validation MM-JJ-AAAA est appliqué à un champ Date/Time situé dans une conception de formulaire rendue sous la forme d’un formulaire HTML, il ne fonctionne pas correctement, même si la date est correctement saisie. Cependant, ce modèle de validation fonctionne correctement pour les formulaires rendus au format PDF.

Résumé des étapes

Pour générer un formulaire HTML, procédez comme suit :

1. Incluez des fichiers de projet.
2. Créez un objet API Client Forms.
3. Définissez les options d’exécution HTML.
4. Générer un formulaire HTML.
5. Ecrivez le flux de données du formulaire dans le navigateur Web client.

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’un objet API Client Forms

Avant de pouvoir importer des données par programmation dans une API FormsClient PDF, vous devez créer un client du service d’intégration des données de formulaire. Lors de la création d’un client de service, vous définissez les paramètres de connexion requis pour appeler un service.

Définition des options d’exécution HTML

Vous définissez les options d’exécution HTML lors du rendu d’un formulaire HTML. Par exemple, vous pouvez ajouter une barre d’outils à un formulaire HTML pour permettre aux utilisateurs de sélectionner des pièces jointes situées sur l’ordinateur client ou de récupérer les pièces jointes générées avec le formulaire HTML. Par défaut, une barre d’outils HTML est désactivée. Pour ajouter une barre d’outils à un formulaire HTML, vous devez configurer par programmation les options d’exécution. Par défaut, une barre d’outils HTML se compose des boutons suivants :

• Home: Fournit un lien vers la racine Web de l’application.
• Upload: Fournit une interface utilisateur permettant de sélectionner les fichiers à joindre au formulaire actif.
• Download: Fournit une interface utilisateur pour afficher les fichiers joints.

Lorsqu’une barre d’outils HTML s’affiche sur un formulaire HTML, un utilisateur peut sélectionner un maximum de dix fichiers à envoyer avec les données de formulaire. Une fois les fichiers envoyés, le service Forms peut récupérer les fichiers.

Lors du rendu d’un formulaire au format HTML, vous pouvez spécifier une valeur d’agent utilisateur. Une valeur user-agent fournit des informations sur le navigateur et le système. Il s’agit d’une valeur facultative et vous pouvez transmettre une valeur de chaîne vide. Le début rapide Rendu d’un formulaire HTML à l’aide de l’API Java montre comment obtenir une valeur d’agent utilisateur et l’utiliser pour générer un formulaire au format HTML.

Les URL HTTP vers l’emplacement de publication des données du formulaire peuvent être spécifiées en définissant l’URL de cible à l’aide de l’API Client du service Forms ou peuvent être spécifiées dans le bouton Envoyer contenu dans la conception de formulaire XDP. Si l’URL de la cible est spécifiée dans la conception de formulaire, ne définissez pas de valeur à l’aide de l’API du client de service Forms.

Génération d’un formulaire HTML

Pour générer un formulaire HTML, vous devez spécifier une conception de formulaire créée dans Designer et enregistrée dans un fichier XDP. Vous devez également sélectionner un type de transformation HTML. Par exemple, vous pouvez spécifier le type de transformation HTML qui effectue le rendu d’un fichier HTML dynamique pour Internet Explorer 5.0 ou version ultérieure.

Le rendu d’un formulaire HTML requiert également des valeurs, telles que des valeurs URI, requises pour effectuer le rendu d’autres types de formulaire.

Ecrire le flux de données du formulaire dans le navigateur Web client

Lorsque le service Forms effectue le rendu d’un formulaire HTML, il renvoie un flux de données de formulaire que vous devez écrire dans le navigateur Web client. Lorsqu’il est écrit dans le navigateur Web client, le formulaire HTML est visible pour l’utilisateur.

Voir également

Générer un formulaire au format HTML à l’aide de l’API Java

Générer un formulaire au format HTML à l’aide de l’API du service Web

Inclusion des fichiers de bibliothèque Java AEM Forms

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

Débuts rapides de l’API du service Forms

Rendu des PDF forms interactifs

Rendu de HTML Forms avec des barres d’outils personnalisées

Création d’Applications web renvoyant Forms

Générer un formulaire au format HTML à l’aide de l’API Java

Générer un formulaire HTML à l’aide de l’API Forms (Java) :

1. Inclure les fichiers de projet

   Incluez des fichiers JAR client, tels que adobe-forms-client.jar, dans le chemin de classe de votre projet Java.

2. Création d’un objet API Client Forms

   • Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
   • Créez un objet FormsServiceClient en utilisant son constructeur et en transmettant l'objet ServiceClientFactory.

3. Définition des options d’exécution HTML

   • Créez un objet HTMLRenderSpec en utilisant son constructeur.
   • Pour générer un formulaire HTML avec une barre d’outils, appelez la méthode HTMLRenderSpec de l’objet setHTMLToolbar et transmettez une valeur d’énumération HTMLToolbar. Par exemple, pour afficher une barre d’outils HTML verticale, transmettez HTMLToolbar.Vertical.
   • Pour définir la valeur du paramètre régional du formulaire HTML, appelez la méthode HTMLRenderSpec de l’objet setLocale et transmettez une valeur de chaîne qui spécifie la valeur du paramètre régional. (Ce paramètre est facultatif.)
   • Pour effectuer le rendu du formulaire HTML au sein de balises HTML complètes, appelez la méthode HTMLRenderSpec de l’objet setOutputType et transmettez OutputType.FullHTMLTags. (Ce paramètre est facultatif.)
   REMARQUE

   Forms ne s’affiche pas correctement dans HTML lorsque l’option StandAlone est true et que ApplicationWebRoot fait référence à un serveur autre que le serveur d’applications J2EE hébergeant AEM Forms (la valeur ApplicationWebRoot est spécifiée à l’aide de l’objet URLSpec transmis à la méthode (Deprecated) renderHTMLForm de l’objet FormsServiceClient). Lorsque ApplicationWebRoot* est un autre serveur de l’AEM Forms hôte, la valeur de l’URI racine Web dans Administration Console doit être définie en tant que valeur de l’URI de l’application Web du formulaire. Pour ce faire, connectez-vous à Administration Console, cliquez sur Services > Forms et définissez l’URI racine Web sur https://server-name:port/FormServer. Enregistrez ensuite vos paramètres.*

4. Génération d’un formulaire HTML

   Appelez la méthode (Deprecated) renderHTMLForm de l’objet FormsServiceClient et transmettez les valeurs suivantes :

   • Valeur de chaîne qui spécifie le nom de la conception de formulaire, y compris l’extension du nom de fichier. Si vous référencez une conception de formulaire faisant partie d’une application Forms, veillez à spécifier le chemin d’accès complet, tel que Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
   • Valeur d’énumération TransformTo qui spécifie le type de préférence HTML. Par exemple, pour générer un formulaire HTML compatible avec le code HTML dynamique pour Internet Explorer 5.0 ou une version ultérieure, spécifiez TransformTo.MSDHTML.
   • Objet com.adobe.idp.Document contenant les données à fusionner avec le formulaire. Si vous ne souhaitez pas fusionner de données, transmettez un objet com.adobe.idp.Document vide.
   • Objet HTMLRenderSpec qui stocke les options d’exécution HTML.
   • Valeur de chaîne qui spécifie la valeur d'en-tête HTTP_USER_AGENT ; par exemple, Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322).
   • Objet URLSpec qui stocke les valeurs URI requises pour générer un formulaire HTML.
   • Objet java.util.HashMap qui stocke les pièces jointes. Il s’agit d’un paramètre facultatif et vous pouvez spécifier null si vous ne souhaitez pas joindre de fichiers au formulaire.

   La méthode (Deprecated) renderHTMLForm renvoie un objet FormsResult contenant un flux de données de formulaire pouvant être écrit dans le navigateur Web client.

5. Ecrire le flux de données du formulaire dans le navigateur Web client

   • Créez un objet com.adobe.idp.Document en appelant la méthode FormsResult de l'objet "s getOutputContent.
   • Obtenez le type de contenu de l'objet com.adobe.idp.Document 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 com.adobe.idp.Document.
   • Créez un objet javax.servlet.ServletOutputStream utilisé pour écrire le flux de données du formulaire dans le navigateur Web client en appelant la méthode javax.servlet.http.HttpServletResponse de l’objet getOutputStream.
   • Créez un objet java.io.InputStream en appelant la méthode com.adobe.idp.Document de l'objet getInputStream.
   • Créez un tableau d’octets et remplissez-le avec le flux de données du formulaire en appelant la méthode InputStream de l’objet read et en transmettant le tableau d’octets comme argument.
   • Appelez la méthode javax.servlet.ServletOutputStream de l’objet write pour envoyer le flux de données de formulaire au navigateur Web client. Transférez le tableau d’octets à la méthode write.

Voir également

Rendu de Forms au format HTML

Début rapide (mode SOAP) : Rendu d’un formulaire HTML à l’aide de l’API Java

Inclusion des fichiers de bibliothèque Java AEM Forms

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

Générer un formulaire au format HTML à l’aide de l’API du service Web

Générer un formulaire HTML à l’aide de l’API Forms (service Web) :

1. Inclure les fichiers de projet

   • Créez des classes de proxy Java qui utilisent le WSDL du service Forms.
   • Incluez les classes proxy Java dans votre chemin de classe.

2. Création d’un objet API Client Forms

   Créez un objet FormsService et définissez des valeurs d’authentification.

3. Définition des options d’exécution HTML

   • Créez un objet HTMLRenderSpec en utilisant son constructeur.
   • Pour générer un formulaire HTML avec une barre d’outils, appelez la méthode HTMLRenderSpec de l’objet setHTMLToolbar et transmettez une valeur d’énumération HTMLToolbar. Par exemple, pour afficher une barre d’outils HTML verticale, transmettez HTMLToolbar.Vertical.
   • Pour définir la valeur du paramètre régional du formulaire HTML, appelez la méthode HTMLRenderSpec de l’objet setLocale et transmettez une valeur de chaîne qui spécifie la valeur du paramètre régional. Pour plus d’informations, voir Référence de l’API AEM Forms.
   • Pour effectuer le rendu du formulaire HTML au sein de balises HTML complètes, appelez la méthode HTMLRenderSpec de l’objet setOutputType et transmettez OutputType.FullHTMLTags.
   REMARQUE

   Forms ne s’affiche pas correctement dans HTML lorsque l’option StandAlone est true et que ApplicationWebRoot fait référence à un serveur autre que le serveur d’applications J2EE hébergeant AEM Forms (la valeur ApplicationWebRoot est spécifiée à l’aide de l’objet URLSpec transmis à la méthode (Deprecated) renderHTMLForm de l’objet FormsServiceClient). Lorsque ApplicationWebRoot* est un autre serveur de l’AEM Forms hôte, la valeur de l’URI racine Web dans Administration Console doit être définie en tant que valeur de l’URI de l’application Web du formulaire. Pour ce faire, connectez-vous à Administration Console, cliquez sur Services > Forms et définissez l’URI racine Web sur https://server-name:port/FormServer. Enregistrez ensuite vos paramètres. *

4. Génération d’un formulaire HTML

   Appelez la méthode (Deprecated) renderHTMLForm de l’objet FormsService et transmettez les valeurs suivantes :

   • Valeur de chaîne qui spécifie le nom de la conception de formulaire, y compris l’extension du nom de fichier. Si vous référencez une conception de formulaire faisant partie d’une application Forms, veillez à spécifier le chemin d’accès complet, tel que Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
   • Valeur d’énumération TransformTo qui spécifie le type de préférence HTML. Par exemple, pour générer un formulaire HTML compatible avec le code HTML dynamique pour Internet Explorer 5.0 ou une version ultérieure, spécifiez TransformTo.MSDHTML.
   • Objet BLOB contenant les données à fusionner avec le formulaire. Si vous ne souhaitez pas fusionner les données, transmettez null. (Voir Préremplissage de Forms avec des dispositions souple.)
   • Objet HTMLRenderSpec qui stocke les options d’exécution HTML.
   • Valeur de chaîne qui spécifie la valeur d'en-tête HTTP_USER_AGENT ; par exemple, Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322). Vous pouvez transmettre une chaîne vide si vous ne souhaitez pas définir cette valeur.
   • Objet URLSpec qui stocke les valeurs URI requises pour générer un formulaire HTML. (Voir Spécification des valeurs URI.)
   • Objet java.util.HashMap qui stocke les pièces jointes. Il s’agit d’un paramètre facultatif et vous pouvez spécifier null si vous ne souhaitez pas joindre de fichiers au formulaire. (Voir Joindre des fichiers au formulaire.)
   • Objet com.adobe.idp.services.holders.BLOBHolder vide renseigné par la méthode. Cette valeur de paramètre stocke le formulaire rendu.
   • Objet com.adobe.idp.services.holders.BLOBHolder vide renseigné par la méthode. Ce paramètre stocke les données XML de sortie.
   • 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 javax.xml.rpc.holders.StringHolder vide renseigné par la méthode. Cet argument stocke la valeur de rendu HTML utilisée.
   • Un objet com.adobe.idp.services.holders.FormsResultHolder vide qui contiendra les résultats de cette opération.

   La méthode (Deprecated) renderHTMLForm remplit 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.

5. Ecrire le flux de données du formulaire dans le navigateur Web client

   • Créez un objet FormResult en obtenant la valeur du membre de données com.adobe.idp.services.holders.FormsResultHolder de l'objet value.
   • Créez un objet BLOB contenant des données de formulaire en appelant la méthode FormsResult de l'objet getOutputContent.
   • 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 du formulaire dans le navigateur Web client en appelant la méthode javax.servlet.http.HttpServletResponse de l’objet getOutputStream.
   • Créez un tableau d’octets et remplissez-le en appelant la méthode BLOB de l’objet getBinaryData. Cette tâche affecte le contenu de l'objet FormsResult au tableau d'octets.
   • Appelez la méthode javax.servlet.http.HttpServletResponse de l’objet write pour envoyer le flux de données de formulaire au navigateur Web client. Transférez le tableau d’octets à la méthode write.

Voir également

Rendu de Forms au format HTML

Appel de AEM Forms à l’aide du codage Base64