Utilisation d’un modèle de données de formulaire use-form-data-model

L’intégration de données AEM Forms vous permet d’utiliser des sources de données principales disparates pour créer un modèle de données de formulaire que vous pouvez utiliser comme schéma dans divers formulaires adaptatifs et processus de communication interactive. 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 create-af

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

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.

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 de métadonnées et la liaison avec les propriétés de l’objet de modèle de données. La liaison permet de s’assurer que les valeurs de champ sont mises à jour dans les sources de données correspondantes lors de l’envoi du formulaire et préremplies lors de la génération du formulaire.

Créer des communications interactives create-ic

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 la communication interactive avec des données provenant de sources de données configurées. En outre, les blocs de création d’une communication interactive, tels que les fragments de texte, de liste et de condition, peuvent être basés 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 présente l’onglet Général de la boîte de dialogue Créer une communication interactive.

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

Pour en savoir plus, voir:

Création d’une communication interactive

Texte dans les communications interactives

Conditions dans les communications interactives

Fragments de liste

Aperçu avec des exemples de données preview-ic

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 de formulaire.

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

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

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éremplissage à l’aide du service de modèle de données de formulaire prefill

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ées sur le modèle de données de formulaire. Le service de préremplissage interroge les sources de données pour les objets de modèle de données dans le formulaire adaptatif et la communication interactive et préremplit en conséquence les données 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 formulaires adaptatifs et sélectionnez Service de préremplissage de modèle de données de formulaire de la Service de préremplissage menu déroulant dans l’accordéon De base . Ensuite, enregistrez les propriétés.

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.

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

Écrire les données de formulaire adaptatif envoyées dans les sources de données write-af

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 Action d’envoi du modèle de données de formulaire, disponible en standard 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.

Pour configurer l’action d’envoi de modèle de données de formulaire, ouvrez les propriétés du conteneur de formulaires adaptatifs et sélectionnez Envoyer à l’aide du modèle de données de formulaire dans la liste déroulante Action d’envoi sous l’accordéon Envoi. 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 du formulaire, les données de l’objet de modèle de données configuré sont écrites dans la source de données correspondante.

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 :

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

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. L’opération Appeler des services dans une règle répertorie tous les services disponibles dans le modèle de données de formulaire et vous permet de sélectionner des champs d’entrée et de sortie pour le service. Vous pouvez également utiliser la variable Définir la valeur type de règle 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.

En outre, vous pouvez utiliser l’API guidelib.dataIntegrationUtils.executeOperation pour écrire un code JavaScript dans l’éditeur de code pour l’éditeur de règles. Pour plus de détails sur l’API, voir API pour appeler le service de modèle de données.