Ajout d’informations issues de données utilisateur aux métadonnées d’envoi de formulaire

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 entre John Doe dans le champ de nom du formulaire. Vous pouvez utiliser ces informations pour calculer les métadonnées pouvant classer cet envoi par catégorie 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 saisit une valeur dans cet élément, un script utilise cette 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 cette clé.

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 correspondant à une tranche d’âge spécifique après qu’un certain nombre d’utilisateurs a 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 nœud de métadonnées, tel que configuré par l’auteur.

Prenons un autre exemple d’un formulaire qui capture l’ID d’adresse é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. Un cas illustrant cette configuration est le tableau de bord de gestion des prospects.

Ajout d’éléments de formulaire aux métadonnées

Pour ajouter un élément aux métadonnées, procédez comme suit :

  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. In the edit mode, select a component, tap field-level > Adaptive Form Container, and then tap 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.

    For example, true is logged in the metadata if age entered is greater than 21, and false is logged if it is less than 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.

Seeing updated form submission metadata:

Pour l’exemple ci-dessus, les métadonnées sont conservé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

Remarque

L’exemple ci-dessus est fourni uniquement à des fins d’apprentissage. Assurez-vous que vous recherchez des métadonnées à l’emplacement correct, tel que configuré dans votre implémentation AEM Forms.

Sur cette page