Ajout d’informations issues de données utilisateur aux métadonnées d’envoi de formulaire adding-information-from-user-data-to-form-submission-metadata

CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

Vous pouvez utiliser des valeurs saisies dans un élément de votre formulaire pour calculer les champs de métadonnées d’un brouillon ou d’un envoi de formulaire. Les métadonnées vous permettent de filtrer le contenu en fonction des données utilisateur. Par exemple, un utilisateur saisit John Doe dans le champ de nom de votre formulaire. Vous pouvez utiliser ces informations pour calculer les métadonnées qui peuvent classer cet envoi sous les initiales JD.

Pour calculer les champs de métadonnées avec des valeurs saisies par l’utilisateur, ajoutez les éléments de votre formulaire aux métadonnées. Lorsqu’un utilisateur entre une valeur dans cet élément, un script utilise la valeur pour calculer les informations. Ces informations sont ajoutées dans les métadonnées. Lorsque vous ajoutez un élément sous la forme d’un champ de métadonnées, vous fournissez la clé correspondante. La clé est ajoutée en tant que champ dans les métadonnées et les informations calculées sont enregistrées en fonction de celle-ci.

Par exemple, une compagnie d’assurance maladie publie un formulaire. Dans ce formulaire, un champ capture l’âge des utilisateurs finaux. Le client souhaite vérifier tous les envois dans une tranche d’âge spécifique après qu’un certain nombre d’utilisateurs ont envoyé le formulaire. Plutôt que de parcourir toutes les données qui deviennent complexes à mesure que le nombre de formulaires augmente, des métadonnées supplémentaires aident le client. L’auteur du formulaire peut configurer quelles propriétés/données remplies par l’utilisateur final sont stockées au niveau supérieur afin de faciliter la recherche. Les métadonnées supplémentaires sont des informations remplies par l’utilisateur stockées au niveau supérieur du noeud de métadonnées, tel que l’auteur les a configurées.

Prenons un autre exemple de formulaire qui capture l’ID de courrier électronique et le numéro de téléphone. Lorsqu’un utilisateur visite ce formulaire de manière anonyme et abandonne le formulaire, l’auteur peut configurer le formulaire afin que l’ID d’adresse électronique et le numéro de téléphone soient automatiquement enregistrés. Ce formulaire est enregistré automatiquement et le numéro de téléphone et l’ID d’adresse électronique sont stockés dans le nœud de métadonnées du brouillon. Le tableau de bord de la gestion des leads est un cas d’utilisation de cette configuration.

Ajout d’éléments de formulaire aux métadonnées adding-form-elements-to-metadata

Effectuez les étapes suivantes pour ajouter un élément aux métadonnées :

  1. Ouvrez votre formulaire adaptatif en mode d’édition.

    Pour ouvrir le formulaire en mode d’édition, dans Forms Manager, sélectionnez le formulaire, puis appuyez sur Ouvrir.

  2. En mode d’édition, sélectionnez un composant, puis appuyez sur field-level > Conteneur de formulaires adaptatifs, puis appuyez sur cmppr .

  3. Dans la barre latérale, cliquez sur Métadonnées.

  4. Dans la section Métadonnées, cliquez sur Ajouter.

  5. Utilisez le champ Valeur de l’onglet Métadonnées pour ajouter des scripts. Les scripts que vous ajoutez collectent des données à partir d’éléments sur le formulaire et calculent les valeurs qui sont ajoutées aux métadonnées.

    Par exemple, la valeur true est enregistrée dans les métadonnées si l’âge entré est supérieur à 21, et la valeur false est enregistrée s’il est inférieur à 21. Vous entrez le script suivant dans l’onglet Métadonnées :

    (agebox.value >= 21) ? true : false

    Script de métadonnées
    Figure : Script saisi dans l’onglet Métadonnées

  6. Cliquez sur OK.

Une fois qu’un utilisateur a saisi des données dans l’élément sélectionné comme champ de métadonnées, les informations calculées sont enregistrées dans les métadonnées. Vous pouvez afficher les métadonnées dans le référentiel que vous avez configuré pour stocker les métadonnées.

Affichage des métadonnées d’envoi de formulaire mises à jour : seeing-updated-form-nbsp-submission-metadata

Pour l’exemple ci-dessus, les métadonnées sont stockées dans le référentiel CRX. Les métadonnées présentent l’aspect suivant :

entrée de métadonnées

Si vous ajoutez un élément de case à cocher dans les métadonnées, les valeurs sélectionnées sont stockées sous forme de chaîne séparée par des virgules. Par exemple, vous ajoutez un composant de case à cocher dans votre formulaire, puis indiquez son nom : checkbox1. Dans les propriétés du composant de case à cocher, vous ajoutez les éléments Permis de conduire, Numéro de sécurité sociale et Passeport pour les valeurs 0, 1 et 2.

Stockage de plusieurs valeurs à partir d’une case à cocher

Vous sélectionnez le conteneur de formulaires adaptatifs et dans les propriétés du formulaire vous ajoutez une clé de métadonnées cb1 qui stocke checkbox1.value, puis vous publiez le formulaire. Lorsqu’un client remplit le formulaire, il sélectionne les options Passeport et Numéro de sécurité sociale dans le champ de case à cocher. Les valeurs 1 et 2 sont stockées sous la forme 1, 2 dans le champ cb1 des métadonnées d’envoi.

Entrée de métadonnées pour plusieurs valeurs sélectionnées dans un champ de case à cocher

NOTE
L’exemple ci-dessus est fourni uniquement à des fins d’apprentissage. Assurez-vous de rechercher les métadonnées à l’emplacement correct configuré dans votre mise en oeuvre AEM Forms.
recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da