Créer un modèle de données de formulaire (FDM) create-form-data-model
L’intégration de données Experience Manager Forms fournit une interface utilisateur intuitive permettant de créer et d’utiliser des modèles de données de formulaire. Un modèle de données de formulaire (FDM) repose sur des sources de données pour l’exchange de données. Cependant, vous pouvez créer un modèle de données de formulaire (FDM) avec ou sans source de données. Il existe deux approches de création d’un modèle de données de formulaire, selon que vous avez ou non configuré les sources de données :
-
À l’aide de sources de données préconfigurées : si vous avez configuré des sources de données comme décrit dans la section Configurer des sources de données, vous pouvez les sélectionner lors de la création d’un modèle de données de formulaire (FDM). Elle apporte tous les objets, propriétés et services de modèle de données des sources de données sélectionnées, disponibles pour utilisation dans le modèle de données de formulaire (FDM).
-
Sans sources de données : si vous n’avez pas configuré de sources de données pour votre modèle de données de formulaire (FDM), vous pouvez toujours le créer sans sources de données. Vous pouvez utiliser le modèle de données de formulaire (FDM) pour créer un Forms adaptatif et les tester à l’aide de données d’exemple. Lorsque des sources de données sont disponibles, vous pouvez lier le modèle de données de formulaire (FDM) aux sources de données, qui se reflètent automatiquement dans le Forms adaptatif associé.
Créer un modèle de données de formulaire (FDM) data-sources
Assurez-vous d’avoir configuré les sources de données que vous avez l’intention d’utiliser dans le modèle de données de formulaire (FDM) comme décrit dans la section Configuration des sources de données. Procédez comme suit pour créer un modèle de données de formulaire (FDM) basé sur des sources de données configurées :
-
Dans l’instance d’auteur Experience Manager, accédez à Formulaires > Intégrations de données.
-
Sélectionner Créer > Modèle de données de formulaire.
-
Dans la boîte de dialogue Créer un modèle de données de formulaire :
- Spécifiez un nom pour le modèle de données de formulaire (FDM).
- (Facultatif) Spécifiez le titre, la description et les balises du modèle de données de formulaire (FDM).
- (Facultatif et applicable uniquement si les sources de données sont configurées) Sélectionnez l’icône en forme de coche en regard du champ Configuration des sources de données et sélectionnez le nœud de configuration où résident les services cloud pour les sources de données que vous souhaitez utiliser. Cela limite la liste des sources de données disponibles pour sélection sur la page suivante à celles disponibles dans le nœud de configuration sélectionné. Cependant, toutes les sources de données des profils d’utilisateurs Experience Manager sont répertoriées par défaut. Si vous ne sélectionnez pas de nœud de configuration, les sources de données de tous les nœuds de configuration sont répertoriées.
-
Sélectionnez Suivant.
-
(Applicable uniquement si les sources de données sont configurées) L’écran Sélectionner la source de données répertorie les sources de données disponibles, le cas échéant. Sélectionnez les sources de données à utiliser dans le modèle de données de formulaire.
-
Sélectionnez Créer et, dans la boîte de dialogue de confirmation, sélectionnez Ouvrir pour ouvrir l’éditeur de modèle de données de formulaire.
Passons en revue les différents composants de l’interface utilisateur de l’éditeur de modèle de données de formulaire.
A. Sources de données Répertorie les sources de données dans un modèle de données de formulaire. Développez une source de données pour afficher ses objets et services de modèle de données.
B. Actualiser les définitions de sources de données Récupère tous les changements dans les définitions de sources de données à partir des sources de données configurées et les met à jour dans l’onglet Sources de données de l’éditeur de modèle de données de formulaire.
C. Modèle Zone de contenu dans laquelle les objets de modèle de données ajoutés apparaissent.
D. Services Zone de contenu dans laquelle les opérations ou services de source de données ajoutés s’affichent.
E. Barre d’outils Outils pour travailler avec le modèle de données de formulaire (FDM) . La barre d’outils affiche d’autres options en fonction de l’objet sélectionné dans le modèle de données de formulaire (FDM).
F. Ajouter la sélection Ajoute les objets et les services de modèle de données sélectionnés au modèle de données de formulaire.
Pour plus d’informations sur l’éditeur de modèle de données de formulaire et sur la manière dont vous pouvez l’utiliser pour modifier et configurer le modèle de données de formulaire (FDM), voir Utilisation du modèle de données de formulaire.
Mise à jour des sources de données update
Procédez comme suit pour ajouter ou mettre à jour des sources de données à un modèle de données de formulaire (FDM) existant.
-
Accédez à Forms > Intégrations de données, sélectionnez le modèle de données de formulaire (FDM) dans lequel vous souhaitez ajouter ou mettre à jour des sources de données, puis sélectionnez Propriétés.
-
Dans les propriétés du modèle de données de formulaire, accédez à l’onglet Mettre à jour la source.
Dans l’onglet Mettre à jour la source :
-
Sélectionnez l’icône de navigation dans le champ Configuration tenant compte du contexte et sélectionnez un nœud de configuration où se trouve la configuration cloud de la source de données que vous voulez utiliser. Si vous ne sélectionnez pas de nœud, les configurations cloud qui se trouvent uniquement dans le nœud
global
sont répertoriées lorsque vous sélectionnez Ajouter des sources. -
Pour ajouter une nouvelle source de données, sélectionnez Ajouter des sources et sélectionnez les sources de données à ajouter au modèle de données de formulaire (FDM). Toutes les sources de données configurées en
global
et le nœud de configuration sélectionné, le cas échéant, s’affichent. -
Pour remplacer une source de données existante par une autre source de données du même type, sélectionnez l’icône Modifier de la source de données et sélectionnez-en une dans la liste des sources de données disponibles.
-
Pour supprimer une source de données existante, sélectionnez l’icône Supprimer de la source de données. L’icône Supprimer est désactivée si un objet de modèle de données de la source de données est ajouté au modèle de données de formulaire (FDM).
-
-
Sélectionnez Enregistrer et fermer pour enregistrer les mises à jour.
Configurations basées sur le contexte pour des modes d’exécution spécifiques runmode-specific-context-aware-config
Le modèle de données de formulaire (FDM) utilise les configurations basées sur le contexte Sling pour prendre en charge différents paramètres de source de données afin de se connecter aux sources de données pour différents modes d’exécution Experience Manager.
Lorsque Form Data Model (FDM) utilise des configurations cloud pour stocker des paramètres qui, lorsqu’ils sont archivés et déployés par le biais du contrôle de code source (référentiel GIT Cloud-Manager), créent une configuration cloud avec les mêmes paramètres pour tous les modes d’exécution (développement, évaluation et production). Cependant, pour les cas d’utilisation où il est nécessaire d’avoir des jeux de données différents pour les environnements de test et de production, nous utilisons les paramètres de source de données (par exemple, l’URL de la source de données) pour différents modes d’exécution Experience Manager.
Pour ce faire, vous devez créer une configuration OSGi contenant des paires paramètres-valeur de source de données. Cela remplace la même paire de la configuration de cloud Form Data Model (FDM) au moment de l’exécution. Comme les configurations OSGi prennent en charge ces modes d’exécution par défaut, vous pouvez remplacer un paramètre de source de données par des valeurs différentes en fonction du mode d’exécution.
Pour activer les configurations cloud spécifiques au déploiement dans Form Data Model (FDM) :
-
créez une configuration cloud sur l’instance de développement locale. Pour obtenir des instructions détaillées, consultez Comment configurer des sources de données.
-
Stockez votre configuration cloud sur le système de fichiers.
- Créez un package avec le filtre
/conf/{foldername}/settings/cloudconfigs/fdm
. Utilisez le même{foldername}
que dans l’étape 1. Et remplacezfdm
parazurestorage
pour la configuration du stockage Azure. - Générez et téléchargez le package. Pour plus d’informations, consultez les actions de package.
- Créez un package avec le filtre
-
Intégration de la configuration cloud dans le projet d’archétype d’Experience Manager.
- Décompressez le package téléchargé.
- Copiez le dossier
jcr_root
et placez-le dans votreui.content
>src
>main
>content
. - Mettez à jour le chemin
ui.content
>src
>main
>content
>META-INF
>vault
>filter.xml
pour contenir le filtre/conf/{foldername}/settings/cloudconfigs/fdm
. Pour plus d’informations, consultez le module ui.content du projet d’archétype d’AEM. Lorsque ce projet d’archétype est déployé sur le pipeline CM, la même configuration cloud est installée sur tous les environnements (ou tous les modes d’exécution). Pour modifier la valeur des champs (comme l’URL) des configurations cloud basées sur l’environnement, utilisez la configuration OSGi décrite à l’étape suivante.
-
Créez une configuration basée sur le contexte Apache Sling. Pour créer la configuration OSGi :
-
Configurez les fichiers de configuration OSGi dans le projet d’archétype d’Experience Manager.
Créez des fichiers de configuration d’usine OSGi avec le PIDorg.apache.sling.caconfig.impl.override.OsgiConfigurationOverrideProvider
. Créez un fichier portant le même nom sous chaque dossier de mode d’exécution où les valeurs doivent être modifiées par mode d’exécution. Pour plus d’informations, consultez la Configuration de l’OSGi pour Adobe Experience Manager. -
Configurez le fichier json de configuration OSGI. Pour utiliser le fournisseur de remplacement de configuration prenant en compte le contexte Apache Sling :
- Sur l’instance de développement locale
/system/console/configMgr
, sélectionnez la configuration OSGi d’usine avec le nom Fournisseur de remplacement de configuration prenant en compte le contexte Apache Sling : configuration OSGi. - Fournissez une description.
- Sélectionnez activé.
- Sous Remplacements, renseignez les champs qui doivent être modifiés en fonction de l’environnement dans la syntaxe de remplacement sling. Pour plus d’informations, consultez Configuration tenant compte du contexte Apache Sling - Remplacement. Par exemple,
cloudconfigs/fdm/{configName}/url="newURL"
.
Vous pouvez ajouter plusieurs remplacements en sélectionnant +. - Sélectionnez Enregistrer.
- Pour obtenir le fichier JSON de configuration OSGi, suivez les étapes de la rubrique Génération de configurations OSGi à l’aide du SDK de démarrage rapide d’AEM.
- Placez le JSON dans les fichiers de configuration OSGi d’usine créés à l’étape précédente.
- Modifiez la valeur de
newURL
selon l’environnement (ou le mode d’exécution). - Pour modifier une valeur secrète en fonction du mode d’exécution, une variable secrète peut être créée à l’aide de l’API Cloud Manager et plus tard peuvent être référencés dans la Configuration OSGi.
Lorsque ce projet d’archétype est déployé via un pipeline CM, le remplacement fournit des valeurs différentes pour différents environnements (ou mode d’exécution).
note note NOTE Les utilisateurs d’Adobe Managed Service peuvent chiffrer les valeurs secrètes à l’aide de la prise en charge du chiffrement (pour plus d’informations, consultez les instructions de prise en charge du chiffrement des propriétés de configuration et placez du texte chiffré dans la valeur après les configurations basées sur le contexte disponibles dans le Service Pack 6.5.13.0. - Sur l’instance de développement locale
-
-
Actualisez les définitions de source de données à l’aide de l’option permettant d’actualiser les définitions de source de données dans la section Éditeur de modèle de données de formulaire pour actualiser le cache FDM via l’interface utilisateur FDM et obtenir la configuration la plus récente.
Étapes suivantes next-steps
Vous disposez désormais d’un modèle de données de formulaire (FDM) auquel sont ajoutées des sources de données. Ensuite, vous pouvez modifier le modèle de données de formulaire (FDM) pour ajouter et configurer des objets et des services de modèle de données, ajouter des associations entre des objets de modèle de données, modifier des propriétés, ajouter des objets et des propriétés de modèle de données personnalisés, générer des données d’exemple, etc.
Pour plus d’informations, reportez-vous à la section Utilisation d’un modèle de données de formulaire.