Utilisation du modèle de données de formulaire (FDM) use-form-data-model
L’intégration de données Experience Manager Forms vous permet d’utiliser des sources de données principales disparates pour créer un modèle de données de formulaire (FDM) que vous pouvez utiliser comme schéma dans divers processus Adaptive Forms . Elle nécessite la configuration des sources de données et la création d’un modèle de données de formulaire (FDM) basé sur les objets de modèle de données et les services disponibles dans les sources de données. Pour plus d’informations, consultez les sections suivantes :
Un modèle de données de formulaire (FDM) est une extension du schéma JSON que vous pouvez utiliser pour :
Création de formulaires adaptatifs et de fragments create-af
Vous pouvez créer des Forms adaptatif et des fragments de formulaire adaptatif en fonction d’un modèle de données de formulaire (FDM). Procédez comme suit pour utiliser un modèle de données de formulaire (FDM) lors de la création d’un formulaire adaptatif ou d’un fragment de formulaire adaptatif :
-
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.
-
Cliquez pour développer Sélectionner le modèle de données de formulaire. Tous les modèles de données de formulaire disponibles (FDM) sont répertoriés.
Sélectionnez un modèle de données de formulaire.
-
(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 (FDM). Développez la liste déroulante Définitions de modèle de données de formulaire. Il répertorie tous les objets de modèle de données dans le modèle de données de formulaire spécifié (FDM). Sélectionnez un objet de modèle de données dans la liste.
Une fois le formulaire adaptatif ou le fragment de formulaire adaptatif basé sur un modèle de données de formulaire (FDM) créé, les objets de modèle de données de formulaire apparaissent dans l’onglet Sources de données du navigateur de contenu dans l’éditeur de formulaire adaptatif.
note note NOTE Pour un fragment de formulaire adaptatif, seul l’objet de modèle de données sélectionné au moment de la création et ses objets de modèle de données associés apparaissent dans l’onglet Objets de modèle de données. Vous pouvez effectuer un 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.
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 (FDM). Vous pouvez utiliser ces données pour prévisualiser et tester 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 un formulaire adaptatif avec des données d’exemple, ouvrez le formulaire adaptatif en mode création et sélectionnez Aperçu.
Préremplissage à l’aide du service de modèle de données de formulaire prefill
Experience Manager Forms fournit un service de préremplissage de modèle de données de formulaire prêt à l’emploi que vous pouvez activer pour le Forms adaptatif en fonction du modèle de données de formulaire (FDM). 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 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 formulaires adaptatifs 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.
Écriture des données de formulaires adaptatifs envoyés dans les sources de données write-af
Lorsqu’un utilisateur envoie un formulaire basé sur un modèle de données de formulaire (FDM), 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, Experience Manager Forms fournissez l’ action d’envoi de modèle de données de formulaire, disponible en standard uniquement pour Forms adaptatif basé sur un modèle de données de formulaire (FDM). 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 du modèle de données de formulaire :
-
Ouvrez l’explorateur de contenu, puis sélectionnez le composant Conteneur de guide de votre formulaire adaptatif.
-
Cliquez sur l’icône des propriétés du conteneur de guide . La fenêtre du conteneur de formulaires adaptatifs s’ouvre.
-
Cliquez sur l’onglet Envoi.
-
Dans la liste déroulante Submit Action , sélectionnez Submit using Form Data Model.
-
Spécifiez le modèle de données à envoyer.
-
Cliquez sur Terminé
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. En outre, vous pouvez envoyer une pièce jointe de formulaire à l’aide d’un modèle de données de formulaire (FDM) et d’un document d’enregistrement (DoR) à la source de données. Pour plus d’informations sur le modèle de données de formulaire (FDM), voir AEM Forms Intégration 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 :
-
Ajoutez un objet de modèle de données qui inclut une propriété binaire au modèle de données de formulaire (FDM).
-
Dans le formulaire adaptatif, faites glisser le composant Pièce jointe depuis l’explorateur Composants vers le formulaire adaptatif.
-
Sélectionnez le composant ajouté, puis sélectionnez pour ouvrir l’explorateur de propriétés du composant.
-
Dans le champ Bind Reference (Référence de liaison), sélectionnez et accédez à la propriété binaire que vous avez ajoutée dans le modèle de données de formulaire (FDM). Configurez d’autres propriétés en fonction de vos besoins.
Sélectionnez pour enregistrer les propriétés. Le champ de pièce jointe est désormais lié à la propriété binaire du modèle de données de formulaire (FDM).
-
Dans la section Envoi des propriétés du conteneur de formulaires adaptatifs, activez l’option Envoyer les pièces jointes de formulaire. Cela permet d’envoyer la pièce jointe dans le champ de propriété binaire à la source de données lors de l’envoi du formulaire.
Appel 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 (FDM), vous pouvez créer des règles pour appeler les services configurés dans le modèle de données de formulaire (FDM). L’opération Invoke Services d’une règle répertorie tous les services disponibles dans le modèle de données de formulaire (FDM) et vous permet de sélectionner les champs d’entrée et de sortie pour le 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.
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.
Appeler un modèle de données de formulaire (FDM) à l’aide de fonctions personnalisées invoke-form-data-model-using-custom-functions
Vous pouvez appeler un modèle de données de formulaire à partir de l’éditeur de règles à l’aide de fonctions personnalisées. Pour appeler le modèle de données de formulaire (FDM), ajoutez un modèle de données de formulaire à la liste autorisée. Pour ajouter un modèle de données de formulaire à une liste autorisée :
- Accédez à la console web Experience Manager à l’adresse
https://server:host/system/console/configMgr
. - Localisez la liste blanche adaptative de niveau formulaire du modèle de données de formulaire pour l’appel de service - Fabrique de configuration.
- Cliquez sur l’icône pour ajouter la configuration.
- Ajoutez Modèle de chemin d’accès au contenu pour spécifier l’emplacement de votre Forms adaptatif. Par défaut, la valeur est
/content/forms/af/(.*)
, ce qui inclut toutes les Forms adaptatives. Vous pouvez également spécifier le chemin d’accès d’un formulaire adaptatif spécifique. - Ajoutez le modèle de chemin d’accès de modèle de données de formulaire pour spécifier l’emplacement du modèle de données de formulaire (FDM). Par défaut, la valeur est
/content/dams/formsanddocuments-fdm/(.*)
, ce qui inclut tous les modèles de données de formulaire (FDM). Vous pouvez également spécifier le chemin d’accès d’un modèle de données de formulaire (FDM) spécifique. - Enregistrez les paramètres.
La configuration ajoutée est enregistrée sous l’option Liste blanche adaptative de niveau formulaire du modèle de données de formulaire pour l’appel de service - Fabrique de configuration .
- Créez un fichier de configuration.
- Définissez les propriétés de getContentPathPattern et getFormDataModelPathPattern.
- Déployez le projet.
Articles connexes
- Envoyer un e-mail
- Envoyer à SharePoint
- Envoyer à l’aide du modèle de données de formulaire
- Envoyer au stockage Blob Azure
- Envoyer vers le point d’entrée REST
- Envoyer à OneDrive
- Appeler un workflow AEM
- Envoyer à Power Automate
- Envoyer vers Workfront Fusion
- Connecter un formulaire adaptatif à l’application Salesforce
- Connecter un formulaire adaptatif à Microsoft
- Création d’une action d’envoi personnalisée