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

Version
Lien de l’article
AEM 6.5
Cliquez ici
AEM as a Cloud Service
Cet article

Intégration de données

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 :

  • Utilisation de sources de données préconfigurées: si vous avez configuré des sources de données comme décrit dans la section Configuration 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é..

NOTE
Vous devez être membre des deux fdm-author et forms-user groupes pour pouvoir créer et utiliser le modèle de données de formulaire (FDM). Contactez votre administrateur Experience Manager pour devenir membre des groupes.

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 prévoyez 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 :

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

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

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

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

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

Configurations basées sur le contexte pour des modes d’exécution spécifiques runmode-specific-context-aware-config

Modèle de données de formulaire (FDM) 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 (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, dans 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 (FDM) 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 (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é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, 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).
      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.
  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 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.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab