Utilisation d’un modèle de données de formulaire

L’intégration de données d’AEM Forms vous permet d’utiliser des sources de données backend pour créer un modèle de données de formulaire que vous pouvez utiliser comme schéma dans divers processus de formulaires adaptatifs et de communications interactives. Elle nécessite la configuration des sources de données et la création d’un modèle de données de formulaire basé sur les objets et services de modèle de données disponibles dans les sources de données. Pour plus d’informations, consultez les sections suivantes :

Un modèle de données de formulaire est une extension du schéma JSON que vous pouvez utiliser pour :

Créer des formulaires adaptatifs et des fragments

Vous pouvez créer des formulaires adaptatifs et des fragments de formulaire adaptatif en fonction du modèle de données de formulaire. Procédez comme suit pour utiliser un modèle de données du formulaire lors de la création d’un formulaire adaptatif ou d’un fragment de formulaire adaptatif :

  1. Dans l’onglet Modèle de formulaire de l’écran Ajouter des propriétés, sélectionnez Modèle de données de formulaire dans la liste déroulante Sélectionner à partir de.

    create-af-1

  2. Appuyez pour développer le modèle de données de formulaire sélectionné. Tous les modèles de données de formulaire disponibles sont répertoriés.

    Sélectionnez un modèle de données de formulaire.

    create-af-2

  3. (Fragments de formulaire adaptatif uniquement) Vous pouvez créer un fragment de formulaire adaptatif basé sur un seul objet de modèle de données dans un modèle de données de formulaire. Développez la liste déroulante Définitions de modèle de données de formulaire. Elle répertorie tous les objets de modèle de données dans le modèle de données de formulaire spécifié. Sélectionnez un objet de modèle de données dans la liste.

    create-af-3

Une fois le formulaire adaptatif ou le fragment de formulaire adaptatif basé sur un modèle de données de formulaire créé, les objets de modèle de données de formulaire apparaissent dans l’onglet Objets de modèle de données de l’explorateur de contenu dans l’éditeur de formulaires adaptatifs.

Remarque

Pour un fragment de formulaire adaptatif, seul l’objet de modèle de données sélectionné au moment de la création et les objets de modèle de données associés apparaissent dans l’onglet Objets de modèle de données.

data-model-objets-tab

Vous pouvez glisser-déposer des objets de modèle de données sur le formulaire adaptatif ou le fragment pour ajouter des champs de formulaire. Les champs de formulaire ajoutés conservent les propriétés des métadonnées et la liaison avec les propriétés de l’objet de modèle de données. La liaison garantit que les valeurs de champ sont mises à jour dans les sources de données correspondantes lors de l’envoi du formulaire et préremplies lorsque le formulaire est rendu.

Créer des communications interactives

Vous pouvez créer une communication interactive basée sur un modèle de données de formulaire que vous pouvez utiliser pour préremplir une communication interactive avec des données provenant de sources de données configurées. En outre, les blocs de construction d’une communication interactive, tels que les fragments de texte, de liste et de condition, peuvent se baser sur un modèle de données de formulaire.

Vous pouvez choisir un modèle de données de formulaire lors de la création d’une communication interactive ou d’un fragment de document. L’image suivante représente l’onglet Général de la boîte de dialogue Créer une communication interactive.

create-ic

Onglet Général de la boîte de dialogue Créer une communication interactive

Pour en savoir plus, voir:

Créer une communication interactive

Texte dans les communications interactives

Conditions dans les communications interactives

Fragments de liste

Aperçu contenant des exemples de données

L’éditeur de modèle de données de formulaire vous permet de générer et de modifier des exemples de données pour les objets de modèle de données dans le modèle de données de formulaire. Vous pouvez utiliser ces données pour prévisualiser et tester les communications interactives et les formulaires adaptatifs. Vous devez générer les exemples de données avant la prévisualisation, comme décrit dans la section Utilisation d’un modèle de données du formulaire.

Pour prévisualiser une communication interactive avec des exemples de données du modèle de données de formulaire :

  1. Dans l’instance d’auteur AEM, accédez à Formulaires > Formulaires et documents.
  2. Sélectionnez une communication interactive et appuyez sur Aperçu dans la barre d’outils pour sélectionner Canal web, Canal d’impression ou Les deux canaux pour prévisualiser la communication interactive.
  3. In the Preview [channel] dialog, ensure that Test Data of Form Data Model is selected and tap Preview.

La communication interactive s’ouvre avec des exemples de données préremplies.

prévisualisation Web

De même, pour prévisualiser un formulaire adaptatif avec des exemples de données, ouvrez le formulaire adaptatif en mode création et appuyez sur Aperçu.

Pré-remplir à l’aide du service de modèle de données de formulaire

AEM Forms fournit un service de préremplissage de modèle de données de formulaire prêt à l’emploi que vous pouvez activer pour les formulaires adaptatifs et les communications interactives basé(e)s sur un modèle de données de formulaire. Le service de préremplissage récupère les sources de données des objets de modèle de données dans le formulaire adaptatif et la communication interactive et préremplit les données en conséquence lors du rendu du formulaire ou de la communication.

Pour activer le service de préremplissage de modèle de données de formulaire pour un formulaire adaptatif, ouvrez les propriétés du conteneur de formulaire adaptatif et sélectionnez Service de préremplissage de modèle de données de formulaire dans la liste déroulante Service de préfiltrage de l’accordéon De base. Ensuite, enregistrez les propriétés.

préremplissage-service

Pour configurer le service de préremplissage du modèle de données de formulaire dans une communication interactive, vous pouvez sélectionner le Service de préremplissage de modèle de données de formulaire dans le menu déroulant Service de préremplissage lors de sa création ou par la suite, en modifiant les propriétés.

edit-ic-props

Boîte de dialogue Modifier les propriétés pour une communication interactive

Écrire les données de formulaires adaptatifs envoyés dans les sources de données

Lorsqu’un utilisateur envoie un formulaire basé sur un modèle de données de formulaire, vous pouvez configurer le formulaire pour écrire les données envoyées pour un objet de modèle de données dans ses sources de données. Pour réaliser ce cas d’utilisation, AEM Forms fournit une action d’envoi de modèle de données de formulaire, disponible par défaut uniquement pour les formulaires adaptatifs basés sur un modèle de données de formulaire. Elle écrit les données envoyées pour un objet de modèle de données dans sa source de données.

To configure the Form Data Model submit action, open Adaptive Form Container properties and select Submit using Form Data Model from the Submit Action drop-down under the Submission accordion. Ensuite, recherchez et sélectionnez un objet de modèle de données dans la liste Nom de l’objet de modèle de données à envoyer Enregistrez les propriétés.

Lors de l’envoi d’un formulaire, les données de l’objet de modèle de données configuré sont écrites dans la source de données respectives.

envoi de données

Vous pouvez également envoyer des pièces jointes de formulaire à une source de données à l’aide de la propriété d’objet de modèle de données binaire. Procédez comme suit pour envoyer des pièces jointes à une source de données JDBC :

  1. Ajoutez un objet de modèle de données qui inclut une propriété binaire dans le modèle de données de formulaire.

  2. In the adaptive form, drag-drop the File Attachment component from the Components browser onto the adaptive form.

  3. Tap to select the added component and tap settings_icon to open the Properties browser for the component.

  4. In the Bind Reference field, tap foldersearch_18 and navigate to select the binary property you added in the form data model. Configurez d’autres propriétés en fonction de vos besoins.

    Tap check-button to save the properties. Le champ de pièce jointe est maintenant lié à la propriété binaire du modèle de données de formulaire.

  5. Dans la section Envoi des propriétés du conteneur de formulaire adaptatif, activez l’option Envoyer les pièces jointes de formulaire. Elle permet d’envoyer la pièce jointe du champ de propriété binaire à la source de données lors de l’envoi du formulaire.

Appeler des services dans des formulaires adaptatifs à l’aide de règles

Dans un formulaire adaptatif basé sur un modèle de données de formulaire, vous pouvez créer des règles pour appeler les services configurés dans le modèle de données de formulaire. The Invoke Services operation in a rule lists all available services in the form data model and allows you to select input and output fields for the service. Vous pouvez également utiliser le type de règle Définir la valeur pour appeler un service de modèle de données de formulaire et définir la valeur d’un champ sur la sortie renvoyée par le service.

Par exemple, la règle suivante appelle un service get qui utilise l’ID d’employé comme entrée et les valeurs renvoyées sont renseignées dans les champs ID, Nom, Prénom et Sexe correspondants du formulaire.

invoke-service

In addition, you can use the guidelib.dataIntegrationUtils.executeOperation API to write a JavaScript in the code editor for the rule editor. For API details, see API to invoke form data model service.

Sur cette page