Créer un modèle de données de formulaire (FDM)

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 Configurer les sources de données. Pour créer un modèle de données de formulaire (FDM) 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. Sélectionner 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 :

    • Spécifiez un nom pour le modèle de données de formulaire (FDM).
    • (Facultatif) Spécifiez le titre, la description et les 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. 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.
  4. Sélectionnez Suivant.

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

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

    Passons en revue les différents composants de l’interface utilisateur de l’éditeur de modèle de données de formulaire.

    Modèle de données de formulaire avec trois sources de données : un service RESTful, un profil utilisateur Experience Manager et un système RDBMS

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

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 (FDM), consultez la section Utiliser 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 (FDM) existant, procédez comme suit.

  1. Accédez à Forms > Intégrations de données, sélectionnez le modèle de données de formulaire (FDM) dans lequel ajouter ou mettre à jour des sources de données, puis sélectionnez 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  :

    • 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 dans la source de données est ajouté au modèle de données de formulaire (FDM).

      fdm-properties

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

REMARQUE
Une fois que vous avez ajouté de nouvelles sources de données ou mis à jour les sources de données existantes dans un modèle de données de formulaire (FDM), assurez-vous de mettre à jour les références de liaison, le cas échéant, dans le Forms adaptatif qui utilise le modèle de données de formulaire (FDM) mis à jour.

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

Le modèle de données de formulaire (FDM) utilise des 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 modes d’exécution de Experience Manager.

Lorsque le modèle de données de formulaire (FDM) 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). Cependant, pour les cas d’utilisation où des jeux de données différents sont nécessaires pour les environnements d’évaluation 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 modes d’exécution de Experience Manager.

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 la configuration cloud Modèle de données de formulaire (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 Modèle de données de formulaire (FDM) :

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

  2. 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.
  3. 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é 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.
  4. 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. Pour plus d’informations, consultez la Configuration de l’OSGi pour Adobe Experience Manager.

    2. Configurez 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électionnez activé.
      4. 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 +.
      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 SDK de démarrage rapide d’AEM.
      7. Placez le JSON dans les fichiers de configuration OSGi d’usine créés à l’étape précédente.
      8. Modifiez 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 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).
      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, consultez 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 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.