Création d’un modèle de données de formulaire

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 se base sur les sources de données pour l’échange des données ; toutefois, vous pouvez créer un modèle de données de formulaire 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 :

• Utilisation de sources de données préconfigurées : si vous avez configuré les sources de données comme décrit dans Configurer les sources de données, vous pouvez les sélectionner lors de la création d’un modèle de données de formulaire. Tous les objets, les services et les propriétés de modèle de données provenant des sources de données sélectionnées sont alors disponibles dans le modèle de données de formulaire.

• Sans sources de données : si vous n’avez pas configuré les sources de données pour votre modèle de données du formulaire, vous pouvez toujours le créer sans sources de données. Vous pouvez utiliser le modèle de données de formulaire pour créer des formulaires adaptatifs et les tester à l’aide des exemples de données. Lorsque des sources de données sont disponibles, vous pouvez lier le modèle de données de formulaire à des sources de données, ce qui se reflète automatiquement dans les formulaires adaptatifs associés.

Création d’un modèle de données de formulaire

Assurez-vous d’avoir configuré les sources de données que vous avez l’intention d’utiliser dans le modèle de formulaire de données, comme décrit dans Configurer les sources de données. Pour créer un modèle de données de formulaire basé sur des sources de données configurées, procédez comme suit :

1. Dans l’instance d’auteur Experience Manager, accédez à Formulaires > Intégrations de données.

2. Appuyez sur Créer > Modèle de données de formulaire.

3. Dans la boîte de dialogue Créer un modèle de données de formulaire :

   • Attribuez un nom au modèle de données de formulaire.
   • (Facultatif) Spécifiez le titre, la description et les balises du modèle de données de formulaire.
   • (Facultatif et applicable uniquement si les sources de données sont configurées) Cochez l’icône en regard du champ Configuration de la source de données et sélectionnez le nœud de configuration où se trouvent les services cloud pour les sources de données que vous voulez utiliser. Ceci restreint la liste des sources de données que vous pouvez sélectionner à la page suivante parmi les sources disponibles dans le nœud de configuration sélectionné. Cependant, toutes les bases de données JDBC et 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.

4. Appuyez sur Suivant.

5. (Applicable uniquement si des 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 que vous souhaitez utiliser dans le modèle de données de formulaire.

6. Appuyez sur Créer et, dans la boîte de dialogue de confirmation, appuyez sur Ouvrir pour lancer 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 l’utilisation d’un modèle de données de formulaire. La barre d’outils affiche plus d’options en fonction de l’objet sélectionné dans le modèle de données de formulaire.

   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 son utilisation en vue de la modification et de la configuration du modèle de données de formulaire, voir Utilisation d’un modèle de données de formulaire.

Mise à jour des sources de données

Pour ajouter ou mettre à jour des sources de données dans un modèle de données de formulaire existant, procédez comme suit.

1. Accédez à Formulaires > Intégrations de données, sélectionnez le modèle de données de formulaire dans lequel vous souhaitez ajouter ou mettre à jour des sources de données et appuyez sur Propriétés.

2. 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 :

   • Appuyez sur 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 appuyez sur Ajouter des sources.

   • Pour ajouter une nouvelle source de données, appuyez sur Ajouter des sources et sélectionnez les sources de données à ajouter au modèle de données de formulaire. 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, appuyez sur 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, appuyez sur 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 dans la source de données est ajouté au modèle de données de formulaire.

     

3. Appuyez sur Enregistrer et fermer pour enregistrer les mises à jour.

Configurations basées sur le contexte pour des modes d’exécution spécifiques

Modèle de données de formulaire utilitaires Configurations basées sur le contexte Sling pour prendre en charge différents paramètres de source de données afin de se connecter à des sources de données pour différents Experience Manager Modes d’exécution.

When Modèle de données de formulaire utilise les configurations cloud pour stocker les 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). Toutefois, pour les cas d’utilisation où des jeux de données différents sont nécessaires pour les environnements de test et de production, nous utilisons des paramètres de source de données (par exemple, l’URL de la source de données) pour différents Experience Manager Modes d’exécution.

Pour ce faire, vous devez créer une configuration OSGi contenant des paires paramètres-valeur de source de données. Cette option remplace la même paire de Modèle de données de formulaire configuration du cloud 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 Modèle de données de formulaire:

1. Créez une configuration cloud sur l’instance de développement locale. Pour obtenir des instructions détaillées, voir Configuration des sources de données.

2. Stockez votre configuration cloud sur le système de fichiers.

   1. Créer un package avec filtre /conf/{foldername}/settings/cloudconfigs/fdm. Utilisez la même {foldername} comme à l’étape 1. Et remplacez fdm avec azurestorage pour la configuration du stockage Azure.
   2. Créez et téléchargez le package. Pour plus d’informations, voir actions de package.

3. Intégration de la configuration cloud dans Experience Manager Projet d’archétype.

   1. Décompressez le package téléchargé.
   2. Copier jcr_root et placez-le ui.content > src > main > content.
   3. Mettre à jour ui.content > src > main > content > META-INF > vault > filter.xml pour contenir le filtre /conf/{foldername}/settings/cloudconfigs/fdm. Pour plus d’informations, voir Module ui.content de l’AEM Project Archetype. Lorsque ce projet d’archétype est déployé via le pipeline CM, la même configuration de cloud est installée sur tous les environnements (ou 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.

4. Créez une configuration basée sur le contexte Apache Sling. Pour créer la configuration OSGi :

   1. Configuration des fichiers de configuration OSGi dans Experience Manager Projet d’archétype.
      Création de fichiers de configuration d’usine OSGi avec 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. Pour plus d’informations, voir Configuration d’OSGi pour Adobe Experience Manager.

   2. Définissez le fichier json de configuration OSGI. Pour utiliser le fournisseur de remplacement de configuration prenant en compte le contexte Apache Sling :

      1. 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.
      2. Fournissez une description.
      3. Sélectionner enabled.
      4. Sous overrides, fournissez les champs qui doivent être modifiés en fonction de l’environnement dans la syntaxe de remplacement sling. Pour plus d’informations, voir Configuration tenant compte du contexte Apache Sling - Remplacement. Par exemple, cloudconfigs/fdm/{configName}/url="newURL".
         Vous pouvez ajouter plusieurs remplacements en sélectionnant +.
      5. Sélectionnez Enregistrer.
      6. Pour obtenir le fichier JSON de configuration OSGi, suivez les étapes de la rubrique Génération de configurations OSGi à l’aide du démarrage rapide AEM SDK.
      7. Placez JSON dans les fichiers de configuration d’usine OSGi créés à l’étape précédente.
      8. Modifier la valeur de newURL selon l’environnement (ou le mode d’exécution).
      9. Pour modifier une valeur secrète en fonction du mode d’exécution, une variable secrète peut être créée à l’aide de API de gestion de cloud et plus tard peuvent être référencés dans la variable Configuration OSGi.
         Lorsque ce projet d’archétype est déployé via un pipeline CM, le remplacement fournit des valeurs différentes sur différents environnements (ou mode d’exécution).
      REMARQUE

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

5. 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

Vous disposez maintenant d’un modèle de données de formulaire auquel des sources de données ont été ajoutées. Vous pouvez ensuite modifier le modèle de données de formulaire pour ajouter et configurer des objets et services de modèle de données, ajouter des associations entre les objets de modèle de données, modifier les propriétés, ajouter des objets et propriétés de modèle de données personnalisés, générer des exemples de données, etc.

Pour plus d’informations, reportez-vous à la section Utilisation d’un modèle de données de formulaire.