Processus recommandés de préremplissage et d’envoi de formulaires adaptatifs sur la base de sources de données

Vous pouvez utiliser l’une des sources de données suivantes avec des formulaires adaptatifs convertis à l’aide du service de conversion automatisée de formulaires :

  • modèle de données de formulaire, OData, ou tout autre service tiers ;
  • schéma JSON ;
  • schéma XSD.

Selon la source de données, vous pouvez choisir de générer un formulaire adaptatif avec ou sans modèle de données.

Cet article décrit les processus recommandés pour préremplir les valeurs de champ et les options d’envoi après avoir sélectionné une source de données et généré un formulaire adaptatif à l’aide du service de conversion.

Source de données Processus recommandé

modèle de données de formulaire, OData, ou tout autre service tiers ;

Option 1 : vous sélectionnez le modèle de données de formulaire, OData, ou tout autre service tiers comme source de données. Vous générez un formulaire adaptatif sans liaison de données à l’aide du service de conversion automatisée de formulaires. Vous liez manuellement les champs de formulaire adaptatif aux entités de modèle de données de formulaire et utilisez l’option Form Data Model Prefill Service (Service de préremplissage de modèle de données de formulaire) pour préremplir les valeurs de champ. Vous utilisez l’option Submit using Form Data Model (Envoyer à l’aide du modèle de données de formulaire) pour envoyer le formulaire adaptatif.

Option 2 : vous sélectionnez le modèle de données de formulaire, OData, ou tout autre service tiers comme source de données. Vous générez un formulaire adaptatif sans liaison de données à l’aide du service de conversion automatisée de formulaires. Vous liez les champs de formulaire adaptatif à l’aide de l’éditeur de règles pour préremplir les valeurs de champs. Si nécessaire, modifiez les valeurs de champ et envoyez les données au référentiel crx-repository.

Pour obtenir des instructions détaillées sur l’exécution de ces processus, consultez la section Utiliser la base de données, OData, ou tout autre service tiers comme source de données.

Schéma JSON

Vous sélectionnez le schéma JSON comme source de données. Selon la source de données sélectionnée :

Option 1 : vous générez un formulaire adaptatif sans liaison de données à l’aide du service de conversion automatisée de formulaires et configurez le schéma JSON comme source de données. Vous liez manuellement les champs de formulaire adaptatif au schéma JSON et utilisez l’un des protocoles pris en charge pour préremplir les valeurs de champ. Si nécessaire, modifiez les valeurs de champ et envoyez les données au référentiel crx-repository.

Pour obtenir des instructions détaillées sur l’exécution des processus, consultez la section Utiliser le schéma JSON comme source de données.

Option 2 : vous générez un formulaire adaptatif avec liaison de données JSON à l’aide du service de conversion automatisée de formulaires. Le service de préremplissage et la fonction d’envoi de formulaire fonctionnent sans problème. Aucune étape de configuration n’est nécessaire.

Pour obtenir des instructions détaillées sur l’exécution des processus, consultez la section Utiliser le schéma JSON comme source de données.

schéma XSD.

Vous sélectionnez le schéma XSD comme source de données. Selon la source de données sélectionnée, vous générez un formulaire adaptatif sans liaison de données à l’aide du service de conversion automatisée de formulaires et configurez le schéma XSD comme source de données. Vous liez manuellement les champs de formulaire adaptatif au schéma XSD et utilisez l’un des protocoles pris en charge pour préremplir les valeurs de champ. Si nécessaire, modifiez les valeurs de champ et envoyez les données au référentiel crx-repository.

Pour obtenir des instructions détaillées sur l’exécution des processus, consultez la section Utiliser le schéma XSD comme source de données.

Pour plus d’informations sur le service de conversion automatisée de formulaires, consultez les articles suivants :

Ces articles s’adressent à un public qui possède une connaissance de base des concepts liés aux formulaires adaptatifs.

Conditions préalables

Exemple de formulaire adaptatif

Pour mettre en pratique les cas d’utilisation afin de préremplir les valeurs de champ dans un formulaire adaptatif et les envoyer à la source de données, téléchargez l’exemple de fichier PDF suivant.

Exemple de formulaire de demande de prêt

Obtenir le fichier

Le fichier PDF sert d’entrée au service de conversion automatisée de formulaires. Le service convertit ce fichier en un formulaire adaptatif. L’image suivante montre un exemple de formulaire de demande de prêt au format PDF.

exemple de formulaire de demande de prêt

Préparer les données pour le modèle de formulaire

L’intégration de données AEM Forms permet de configurer des sources de données disparates et de s’y connecter. Après avoir généré un formulaire adaptatif à l’aide du processus de conversion, vous pouvez définir le modèle de formulaire en fonction d’un modèle de données de formulaire, XSD, ou d’un schéma JSON. Vous pouvez utiliser une base de données, Microsoft Dynamics, ou tout autre service tiers pour créer un modèle de données de formulaire.

Ce tutoriel utilise la base de données MySQL comme source pour créer un modèle de données de formulaire. Créez un schéma loanapplication dans la base de données et ajoutez-y un tableau applicant en fonction des champs disponibles dans le formulaire adaptatif.

Exemples de données mysql

Vous pouvez utiliser l’instruction DDL suivante pour créer le tableau applicant dans la base de données.

CREATE TABLE `applicant` (
   `name` varchar(45) DEFAULT NULL,
   `address` varchar(45) DEFAULT NULL,
   `phonenumber` int(11) NOT NULL,
   `email` varchar(45) DEFAULT NULL,
   `occupation` varchar(45) DEFAULT NULL,
   `annualsalary` varchar(45) DEFAULT NULL,
   `familymembers` int(11) DEFAULT NULL,
   PRIMARY KEY (`phonenumber`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8

Si vous utilisez un schéma XSD comme modèle de formulaire pour mettre en pratique les cas d’utilisation, créez un fichier XSD avec le texte suivant :

<?xml version="1.0" encoding="utf-8" ?>
    <xs:schema targetNamespace="http://adobe.com/sample.xsd"
                    xmlns="http://adobe.com/sample.xsd"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema">

<xs:element name="sample" type="SampleType"/>

  <xs:complexType name="SampleType">
    <xs:sequence>
      <xs:element name="name" type="xs:string"/>
   <xs:element name="address" type="xs:string"/>
   <xs:element name="phonenumber" type="xs:int"/>
   <xs:element name="email" type="xs:string"/>
   <xs:element name="occupation" type="xs:string"/>
   <xs:element name="annualsalary" type="xs:string"/>
   <xs:element name="familymembers" type="xs:string"/>
 </xs:sequence>
  </xs:complexType>

  </xs:schema>

Ou téléchargez le schéma XSD sur le système de fichiers local.

Exemple de schéma XSD de demande de prêt

Obtenir le fichier

Pour plus d’informations sur l’utilisation du schéma XSD comme modèle de formulaire dans les formulaires adaptatifs, consultez Créer des formulaires adaptatifs à l’aide du schéma XML.

Si vous utilisez un schéma JSON comme modèle de formulaire pour mettre en pratique les cas d’utilisation, créez un fichier JSON avec le texte suivant :

{
    "$schema": "http://json-schema.org/draft-04/schema#",
    "definitions": {
        "loanapplication": {
            "type": "object",
            "properties": {
                "name": {
                    "type": "string"
                },
                "address": {
                    "type": "string"
                },
    "phonenumber": {
                    "type": "number"
                },
    "email": {
                    "type": "string"
                },
    "occupation": {
                    "type": "string"
                },
    "annualsalary": {
                    "type": "string"
                },
    "familymembers": {
                    "type": "number"
                }
            }
        }
 },
 "type": "object",
    "properties": {
        "employee": {
            "$ref": "#/definitions/loanapplication"
        }
    }
}

Ou téléchargez le schéma JSON sur le système de fichiers local.

Exemple de schéma JSON de demande de prêt

Obtenir le fichier

Pour plus d’informations sur l’utilisation du schéma JSON comme modèle de formulaire dans les formulaires adaptatifs, consultez Créer des formulaires adaptatifs à l’aide du schéma JSON.

Générer des formulaires adaptatifs sans liaison de données

Utilisez le service de conversion automatisée de formulaires pour convertir le formulaire de demande de prêt en formulaire adaptatif sans liaison de données. Assurez-vous de cocher la case Generate adaptive form(s) without data bindings (Générer un ou plusieurs formulaires adaptatifs sans liaison de données) afin de générer un formulaire adaptatif sans liaison de données.

Formulaire adaptatif sans liaison de données

Après avoir généré un formulaire adaptatif sans liaison de données, sélectionnez une source de données pour le formulaire adaptatif :

REMARQUE

Si le formulaire adaptatif que vous convertissez à l’aide du service de conversion automatisée de formulaires contient plusieurs champs portant le même nom, assurez-vous que ces champs sont liés aux entités de source de données pour éviter une éventuelle perte de données lors de l’envoi.

Utiliser la base de données, OData, ou tout autre service tiers comme source de données

Cas d’utilisation : vous générez un formulaire adaptatif sans liaison de données à l’aide du service de conversion automatisée de formulaires et configurez la base de données MYSQL comme source de données. Vous liez manuellement les champs de formulaire adaptatif aux entités de modèle de données de formulaire et utilisez l’option Form Data Model Prefill Service (Service de préremplissage de modèle de données de formulaire) pour préremplir les valeurs de champ. Vous utilisez l’option Submit using Form Data Model (Envoyer à l’aide du modèle de données de formulaire) pour envoyer le formulaire adaptatif.

Avant de mettre en pratique le cas d’utilisation, procédez aux étapes suivantes :

En fonction du cas d’utilisation, créez le modèle de données de formulaire loanapplication et liez l’argument de service de lecture à une valeur Literal. La valeur littérale du numéro de téléphone doit correspondre à l’un des enregistrements configurés dans le schéma applicant de la base de données MySQL. Les services utilisent la valeur comme argument pour extraire les détails de la source de données. Vous pouvez également sélectionner User Profile Attribute or Request Attribute (Attribut de profil utilisateur ou attribut de requête) dans la liste déroulante Binding To (Liaison à).

Configurer un modèle de données de formulaire

REMARQUE

Veillez à ajouter les services get (obtenir) et insert (insérer) au modèle de données de formulaire ainsi qu’à les configurer et les tester avant la mise en pratique du cas d’utilisation.

Procédez comme suit :

  1. Sélectionnez l’exemple de formulaire de demande de prêt converti disponible dans le dossier output (sortie) et appuyez sur Properties (Propriétés).

  2. Appuyez sur l’onglet Form Model (Modèle de formulaire), sélectionnez Form Data Model (Modèle de données de formulaire) dans la liste déroulante Select From (Sélectionner dans) et appuyez sur Select Form Data Model (Sélectionner un modèle de données de formulaire) pour sélectionner le modèle de données de formulaire loanapplication. Appuyez sur Save & Close (Enregistrer et fermer) pour enregistrer le formulaire.

  3. Sélectionnez l’exemple de formulaire de demande de prêt et appuyez sur Edit (Modifier).

  4. Dans l’onglet Content (Contenu), appuyez sur l’icône de configuration :

    configurer le conteneur de formulaires

    1. Dans la section Basic (De base), sélectionnez Form Data Model Prefill service (Service de préremplissage de modèle de données de formulaire) dans la liste déroulante Prefill Service (Service de préremplissage).

    2. Dans la section Submission (Envoi), sélectionnez Submit using Form Data Model (Envoyer à l’aide du modèle de données de formulaire) dans la liste déroulante Submit Action (Action d’envoi).

    3. Sélectionnez le modèle de données à l’aide du champ Data Model to submit (Modèle de données à envoyer).

    4. Appuyez sur icône terminé pour enregistrer les propriétés.

  5. Appuyez sur la zone de texte Applicant Name (Nom du demandeur) et sélectionnez icône de configuration (Configurer).

    1. Dans le champ Bind Reference (Référence de liaison), sélectionnez Applicant (Demandeur) > Name (Nom), puis appuyez sur icône terminé pour enregistrer les propriétés. De même, créez une liaison de données pour les champs Address (Adresse), Phone Number (Numéro de téléphone), E-mail (Adresse électronique), Occupation (Profession), Annual Salary (in dollars) (Salaire annuel (en dollars)) et No. of dependent family members (Nombre de personnes à charge) avec les entités de modèle de données de formulaire.

    Lier les références

  6. Appuyez sur Preview (Aperçu) pour afficher les valeurs de champs de formulaires adaptatifs préremplies.

  7. Si nécessaire, modifiez les valeurs de champ et envoyez le formulaire adaptatif. Les valeurs de champ sont envoyées à la base de données MySQL. Vous pouvez actualiser le tableau applicant dans la base de données pour afficher les valeurs mises à jour dans le tableau.

Cas d’utilisation : vous générez un formulaire adaptatif sans liaison de données à l’aide du service de conversion automatisée de formulaires et configurez la base de données MYSQL comme source de données. Vous liez les champs de formulaire adaptatif à l’aide de l’éditeur de règles pour préremplir les valeurs de champs. Si nécessaire, modifiez les valeurs de champ et envoyez les données au référentiel crx-repository.

Exécutez les étapes suivantes pour utiliser l’éditeur de règles afin d’amener le service de modèle de données de formulaire à lier les champs et à préremplir les valeurs dans un formulaire adaptatif :

  1. Sélectionnez l’exemple de formulaire de demande de prêt dans le dossier output (sortie) et appuyez sur Edit (Modifier).

  2. Dans l’onglet Content (Contenu), appuyez sur l’icône de configuration :

    configurer le conteneur de formulaires

    Dans la section Basic (De base), sélectionnez Form Data Model Prefill service (Service de préremplissage de modèle de données de formulaire) dans la liste déroulante Prefill Service (Service de préremplissage).

  3. Appuyez sur la zone de texte Applicant Name (Nom du demandeur) et appuyez sur Edit Rules (Modifier les règles).

    Modifier les règles pour créer une liaison de données

  4. Appuyez sur Create (Créer) sur la page Rule Editor (Éditeur de règles).

  5. Sur la page Rule Editor (Éditeur de règles) :

    1. Sélectionnez un état pour la zone de texte Applicant Name (Nom du demandeur). Par exemple, is initialized (est initialisé), ce qui entraîne l’exécution de la condition Then (Alors) lorsque vous affichez le formulaire en mode Preview (Aperçu).

    2. Dans la section Then (Alors), sélectionnez Invoke Service (Appeler un service) dans la liste déroulante Select Action (Sélectionner une action). Tous les services de votre instance de formulaires s’affichent dans la liste déroulante.

    3. Sélectionnez un service Get (Obtenir) dans la section répertoriant les modèles de données de formulaire. Le champ de saisie affiche phonenumber (numéro de téléphone), qui est la clé primaire définie pour le modèle de données applicant (demandeur). Le système récupère et préremplit les valeurs du formulaire adaptatif pour les champs de la section Output (Sortie) selon ce champ.

    4. Créez une liaison pour les champs de formulaires adaptatifs avec les entités de modèle de données de formulaire à l’aide de la section Output (Sortie). Par exemple, liez le champ de formulaire adaptatif Applicant Name (Nom de demandeur) à l’entité name (nom).

    5. Appuyez sur Done (Terminé). Appuyez à nouveau sur Done (Terminé) sur la page Rule Editor (Éditeur de règles).

    Éditeur de règles pour lier les références

  6. Appuyez sur Preview (Aperçu) pour afficher les valeurs de champs de formulaires adaptatifs préremplies.

    REMARQUE

    Assurez-vous que la propriété Return Array (Revenir au tableau) est désactivée pour la propriété de service get (obtenir) dans le modèle de données de formulaire associé au formulaire adaptatif.

  7. Si nécessaire, modifiez les valeurs de champ et envoyez le formulaire adaptatif. Les données envoyées sont disponibles à l’emplacement suivant dans le référentiel crx-repository :

    http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder

Utiliser le schéma JSON comme source de données

Cas d’utilisation : vous générez un formulaire adaptatif sans liaison de données à l’aide du service de conversion automatisée de formulaires et configurez le schéma JSON comme source de données. Vous liez manuellement les champs de formulaire adaptatif au schéma JSON et utilisez l’option Preview with data (Aperçu avec données) pour préremplir les valeurs de champ. Si nécessaire, modifiez les valeurs de champ et envoyez les données au référentiel crx-repository.

Avant de mettre en pratique le cas d’utilisation, assurez-vous de disposer des éléments suivants :

Procédez comme suit :

  1. Sélectionnez l’exemple de formulaire de demande de prêt converti disponible dans le dossier output (sortie) et appuyez sur Properties (Propriétés).

  2. Appuyez sur l’onglet Form Model (Modèle de formulaire), sélectionnez Schema (Schéma) dans la liste déroulante Select From (Sélectionner dans) et appuyez sur Select Schema (Sélectionner un schéma) pour télécharger le schéma demo.schema JSON enregistré dans le système de fichiers local. Appuyez sur Save & Close (Enregistrer et fermer) pour enregistrer le formulaire.

  3. Sélectionnez l’exemple de formulaire de demande de prêt et appuyez sur Edit (Modifier).

  4. Appuyez sur la zone de texte Applicant Name (Nom du demandeur) et sélectionnez icône de configuration (Configurer).

    Dans le champ Bind Reference (Référence de liaison), sélectionnez Applicant (Demandeur) > Name (Nom), puis appuyez sur icône terminé pour enregistrer les propriétés. De même, créez une liaison de données pour les champs Address (Adresse), Phone Number (Numéro de téléphone), E-mail (Adresse électronique), Occupation (Profession), Annual Salary (in dollars) (Salaire annuel (en dollars)) et No. of dependent family members (Nombre de personnes à charge) avec les entités de schéma JSON.

  5. Sélectionnez à nouveau l’exemple de formulaire de demande de prêt converti disponible dans le dossier output (sortie) et sélectionnez Preview (Aperçu) >Preview with Data (Aperçu avec données).

    Télécharger un exemple de fichier de données

    Obtenir le fichier

  6. Si nécessaire, modifiez les valeurs de champ et envoyez le formulaire adaptatif. Les données envoyées sont disponibles à l’emplacement suivant dans le référentiel crx-repository :

    http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder

Utiliser le schéma XSD comme source de données

Cas d’utilisation : vous générez un formulaire adaptatif sans liaison de données à l’aide du service de conversion automatisée de formulaires et configurez le schéma XSD comme source de données. Vous liez manuellement les champs de formulaire adaptatif au schéma XSD et utilisez l’option Preview with data (Aperçu avec données) pour préremplir les valeurs de champ. Si nécessaire, modifiez les valeurs de champ et envoyez les données au référentiel crx-repository.

Avant de mettre en pratique le cas d’utilisation, assurez-vous de disposer des éléments suivants :

Procédez comme suit :

  1. Sélectionnez l’exemple de formulaire de demande de prêt converti disponible dans le dossier output (sortie) et appuyez sur Properties (Propriétés).

  2. Appuyez sur l’onglet Form Model (Modèle de formulaire), sélectionnez Schema (Schéma) dans la liste déroulante Select From (Sélectionner dans) et appuyez sur Select Schema (Sélectionner un schéma) pour télécharger le schéma XSD loanapplication enregistré dans le système de fichiers local. Sélectionnez l’élément racine pour le schéma XSD et appuyez sur Save & Close (Enregistrer et fermer) pour enregistrer le formulaire.

  3. Sélectionnez l’exemple de formulaire de demande de prêt et appuyez sur Edit (Modifier).

  4. Appuyez sur la zone de texte Applicant Name (Nom du demandeur) et sélectionnez icône de configuration (Configurer).
    Dans le champ Bind Reference (Référence de liaison), sélectionnez Applicant (Demandeur) > Name (Nom), puis appuyez sur icône terminé pour enregistrer les propriétés. De même, créez une liaison de données pour les champs Address (Adresse), Phone Number (Numéro de téléphone), E-mail (Adresse électronique), Occupation (Profession), Annual Salary (in dollars) (Salaire annuel (en dollars)) et No. of dependent family members (Nombre de personnes à charge) avec les entités de schéma XSD.

  5. Sélectionnez à nouveau l’exemple de formulaire de demande de prêt converti disponible dans le dossier output (sortie) et sélectionnez Preview (Aperçu) >Preview with Data (Aperçu avec données).

    Télécharger un exemple de fichier de données

    Obtenir le fichier

  6. Si nécessaire, modifiez les valeurs de champ et envoyez le formulaire adaptatif. Les données envoyées sont disponibles à l’emplacement suivant dans le référentiel crx-repository :

    http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder

Générer des formulaires adaptatifs avec la liaison JSON

Utilisez le service de conversion automatisée de formulaires pour convertir le formulaire de demande de prêt en formulaire adaptatif avec liaison de données. Assurez-vous de ne pas cocher la case Generate adaptive form(s) without data bindings (Générer un ou plusieurs formulaires adaptatifs sans liaison de données) lors de la génération du formulaire adaptatif.

Formulaire adaptatif avec liaison JSON

Utiliser le schéma JSON comme source de données

Cas d’utilisation : vous générez un formulaire adaptatif avec liaison de données JSON à l’aide du service de conversion automatisée de formulaires. Le service de préremplissage et la fonction d’envoi de formulaire fonctionnent sans problème. Aucune étape de configuration n’est nécessaire.

Avant de mettre en pratique le cas d’utilisation, assurez-vous de disposer d’un formulaire adaptatif avec liaison de données.

Procédez comme suit :

  1. Sélectionnez à nouveau l’exemple de formulaire de demande de prêt converti disponible dans le dossier output (sortie) et sélectionnez Preview (Aperçu) >Preview with Data (Aperçu avec données).

    Télécharger un exemple de fichier de données

    Obtenir le fichier

  2. Si nécessaire, modifiez les valeurs de champ et envoyez le formulaire adaptatif. Les données envoyées sont disponibles à l’emplacement suivant dans le référentiel crx-repository :

    http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder

Convertir les données JSON du formulaire adaptatif envoyé au format XML

Lorsque vous saisissez des valeurs dans des champs de formulaire adaptatif et que vous l’envoyez, les données sont disponibles au format JSON dans le référentiel crx-repository. Vous pouvez convertir les données JSON au format XML à l’aide de l’API org.apache.sling.commons.json.xml ou de l’exemple de code suivant :

import org.apache.sling.commons.json.JSONException;
import org.apache.sling.commons.json.JSONObject;
import org.apache.sling.commons.json.xml.XML;
 
public class ConversionUtils {
 
    public static String jsonToXML(String jsonString) throws JSONException {
        //https://sling.apache.org/apidocs/sling5/org/apache/sling/commons/json/xml/XML.html#toString(java.lang.Object)
        //jar - http://maven.ibiblio.org/maven2/org/apache/sling/org.apache.sling.commons.json/2.0.18/
        //Note: Need to extract boundData part before converting to XML
        return XML.toString(new JSONObject(jsonString));
    }
}

Sur cette page