Créer un modèle de données de formulaire (FDM) create-form-data-model

Dans l’instance d’auteur Experience Manager, accédez à Forms > 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 un titre, une description et des balises pour le 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. Par conséquent, la liste des sources de données disponibles à la sélection sur la page suivante est limitée à 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. Sélectionnez les sources de données à utiliser dans le modèle de données de formulaire.

Sélectionnez Créer, puis, dans la boîte de dialogue de confirmation, sélectionnez Ouvrir pour ouvrir l’éditeur de modèle de données de formulaire.

L’interface utilisateur de l’éditeur de modèle de données de formulaire comprend les composants suivants :

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 Source 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. Cela garantit que le modèle reflète l’état actuel des sources de données connectées.

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 plus d’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.

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 Source, vous pouvez sélectionner un contexte de configuration, puis ajouter, remplacer ou supprimer des sources de données :

• Sélectionner un contexte de configuration : 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 souhaitez ajouter. Cela détermine les configurations cloud visibles. 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.

• 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 dans le nœud de configuration sélectionné, le cas échéant, s’affichent. Cela ajoute les sources de données sélectionnées afin que leurs objets de modèle de données soient disponibles pour la liaison dans le modèle.

• Remplacer une source de données existante : 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. Le remplacement par une source du même type conserve la structure du modèle de données existant afin que les liaisons dépendantes restent valides.
  

• Supprimer une source de données existante : 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, car un objet de modèle de données de cette source de données est déjà ajouté et utilisé dans le modèle de données de formulaire (FDM), ce qui empêche la suppression des dépendances encore référencées.

Sélectionnez Enregistrer et fermer pour enregistrer les mises à jour.

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.

1. Créez un package avec le filtre /conf/{foldername}/settings/cloudconfigs/fdm. Utilisez le même {foldername} que dans l’étape 1. Et remplacez fdm par azurestorage pour la configuration du stockage Azure.
2. Générez et téléchargez le package. Pour plus d’informations, consultez les actions de package.

Intégration de la configuration cloud dans le projet d’archétype d’Experience Manager.

1. Décompressez le package téléchargé.
2. Copiez le dossier jcr_root et placez-le dans votre ui.content > src > main > content.
3. 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é via le pipeline Cloud Manager (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 :

1. Configurez les fichiers de configuration OSGi dans le projet d’archétype d’Experience Manager.
   Créez les fichiers de configuration OSGi d’usine avec le PID org.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. Cela permet de s’assurer que chaque mode d’exécution applique ses propres valeurs de remplacement. Pour plus d’informations, consultez la Configuration de l’OSGi pour Adobe Experience Manager.

2. Définissez la configuration OSGi JSON. Configurez le fournisseur de remplacement de configuration prenant en compte le contexte Apache Sling pour que les valeurs spécifiques à un environnement soient automatiquement appliquées au déploiement. Pour utiliser le fournisseur de remplacement de configuration prenant en compte le contexte Apache Sling :

   1. Sur votre /system/console/configMgr d’instance de développement locale, sélectionnez la configuration OSGi d’usine avec le nom Fournisseur de remplacement de configuration prenant en compte le contexte Apache Sling : configuration OSGi.
   2. Fournissez une description.
   3. Sélectionnez activé.
   4. Sous Remplacements, indiquez 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".
      Ajoutez plusieurs remplacements en sélectionnant +.
   5. Sélectionnez Enregistrer.
   6. Pour obtenir le fichier JSON de configuration OSGi, suivez les étapes de la section Génération de configurations OSGi à l’aide du démarrage rapide d’AEM SDK.
   7. Placez le fichier JSON dans les fichiers de configuration d’usine OSGi créés à l’étape précédente.
   8. Remplacez la valeur de newURL dans la configuration de remplacement par la valeur cible appropriée pour chaque environnement (ou mode d’exécution), de sorte que chaque environnement soit résolu sur sa propre URL.
   9. Pour modifier une valeur secrète en fonction du mode d’exécution, créez une variable secrète à l’aide de l’API Cloud Manager (CM) puis référencez-la ultérieurement dans la Configuration OSGi.
      Lorsque ce projet d’archétype est déployé via le pipeline Cloud Manager (CM), le remplacement fournit des valeurs différentes pour différents environnements (ou modes d’exécution). Par conséquent, une seule base de code est résolue au moment de l’exécution sur une configuration spécifique à l’environnement. Cela permet de s’assurer que les instances de développement, d’évaluation et de production reçoivent chacune les valeurs d’URL et secrètes correctes sans modification manuelle du code.

   note
   NOTE
   Adobe Managed Service utilisateurs peuvent chiffrer les valeurs secrètes à l’aide de la prise en charge du chiffrement. Pour plus d’informations, consultez prise en charge du chiffrement des propriétés de configuration et placez le texte chiffré dans la valeur après les configurations basées sur le contexte sont disponibles dans le pack de services 6.5.13.0.

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 l’éditeur de modèle de données de formulaire pour actualiser le cache du modèle de données de formulaire (FDM) via l’interface utilisateur de FDM et obtenir la configuration la plus récente. Cela permet de s’assurer que le cache FDM reflète les valeurs de remplacement nouvellement appliquées.