DocumentationAEM 6.4Guide de Forms

Configuration des sources de données configure-data-sources

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • User
CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

Découvrez comment configurer différents types de sources de données et utiliser pour créer des modèles de données de formulaire.

L’intégration de données AEM Forms permet de configurer des sources de données disparates et de s’y connecter. Les types suivants sont pris en charge par défaut. Toutefois, avec peu de personnalisation, vous pouvez intégrer d’autres sources de données.

  • Bases de données relationnelles : MySQL, Microsoft SQL Server, IBM DB2 et Oracle RDBMS
  • Profil utilisateur AEM
  • Services web RESTful
  • Services web SOAP
  • Services OData

L’intégration de données prend en charge l’authentification OAuth2.0, de base ou par clé API par défaut, et permet de mettre en œuvre une authentification personnalisée pour accéder aux services web. Alors que les services RESTful, SOAP et OData sont configurés dans les services cloud AEM, JDBC pour les bases de données relationnelles et Connector pour le profil utilisateur AEM sont configurés dans la console Web AEM.

Configurer la base de données relationnelle configure-relational-database

Vous pouvez configurer des bases de données relationnelles à l’aide de la configuration de la console Web d’AEM. Procédez comme suit :

  1. Accédez à la console web AEM à l’adresse https://[server]:[host]/system/console/configMgr.

  2. Rechercher Source de données en pool de la connexion Apache Sling configuration. Appuyez pour ouvrir la configuration en mode édition.

  3. Dans la boîte de dialogue de configuration, spécifiez les détails de la base de données que vous souhaitez configurer, tels que :

    • Nom de la source de données
    • Propriété du service de source de données qui stocke le nom de la source de données
    • Nom de classe Java pour le pilote JDBC
    • URI de connexion JDBC
    • Nom d’utilisateur et mot de passe pour établir la connexion au pilote JDBC
    note note
    NOTE
    Assurez-vous de chiffrer les informations sensibles telles que les mots de passe avant de configurer la source de données. Pour chiffrer :
    1. Accédez à https://[server]:[port]/system/console/crypto.
    2. Dans le Texte brut , indiquez le mot de passe ou toute chaîne à chiffrer et cliquez sur Protect.
    Le texte chiffré apparaît dans le champ Texte protégé que vous pouvez spécifier dans la configuration.

  4. Activer Test lors de l’emprunt ou Test en retour pour indiquer que les objets sont validés avant d’être empruntés ou renvoyés respectivement à et au pool.

  5. Spécifier une requête SQL SELECT dans la variable Requête de validation pour valider les connexions à partir du pool. La requête doit renvoyer au moins une ligne. En fonction de votre base de données, indiquez l’une des options suivantes :

    • SELECT 1 (MySQL et MS SQL)
    • SELECT 1 from dual (Oracle)

  6. Appuyez sur Enregistrer pour enregistrer la configuration.

Configuration d’AEM profil utilisateur configure-aem-user-profile

Vous pouvez configurer AEM profil utilisateur à l’aide de la configuration du connecteur de profil utilisateur dans AEM console web. Procédez comme suit :

  1. Accédez à la console web AEM à l’adresse https://[server]:[host]/system/console/configMgr.

  2. Recherchez Intégrations de données AEM Forms - Configuration du connecteur de profil utilisateur et appuyez pour ouvrir la configuration en mode édition.

  3. Dans la boîte de dialogue Configuration du connecteur de profil utilisateur, vous pouvez ajouter, supprimer ou mettre à jour les propriétés du profil utilisateur. Les propriétés spécifiées peuvent être utilisées dans le modèle de données de formulaire. Utilisez le format suivant pour spécifier les propriétés du profil utilisateur :

    name=[property_name_with_location_in_user_profile],type=[property_type]

    Exemples :

    • name=profile/phoneNumber,type=string
    • name=profile/empLocation/*/city,type=string
    note note
    NOTE
    Le * dans l’exemple ci-dessus, indique tous les noeuds sous la balise profile/empLocation/ noeud dans AEM profil utilisateur dans la structure CRXDE. Cela signifie que le modèle de données du formulaire peut accéder à la propriété city de type string présente dans n’importe quel nœud sous le nœud profile/empLocation/. Toutefois, les nœuds qui contiennent la propriété spécifiée doivent suivre une structure cohérente.

  4. Appuyez sur Enregistrer pour sauvegarder la configuration.

Configurer le dossier pour les configurations de service cloud cloud-folder

NOTE
La configuration du dossier de services cloud est requise pour la configuration des services cloud pour les services RESTful, SOAP et OData.

Toutes les configurations de service cloud dans AEM sont consolidées dans le dossier /conf du référentiel AEM. Par défaut, le dossier conf contient le dossier global dans lequel vous pouvez créer des configurations de service cloud. Toutefois, vous devez l’activer manuellement pour les configurations cloud. Vous pouvez également créer des dossiers supplémentaires dans conf pour créer et organiser des configurations de service cloud.

Pour configurer le dossier pour les configurations de service cloud :

  1. Accédez à Outils > Général > Navigateur de configuration.

  2. Procédez comme suit pour activer le dossier global pour les configurations cloud ou ignorez cette étape pour créer et configurer un autre dossier pour les configurations de service cloud.

    1. Dans le navigateur de configuration, sélectionnez le dossier global et appuyez sur Propriétés.
    2. Dans le Propriétés de configuration boîte de dialogue, activer Configurations du cloud.
    3. Appuyez sur Enregistrer et fermer pour enregistrer la configuration et fermer la boîte de dialogue.

  3. Dans le Explorateur de configuration, appuyez sur Créer.

  4. Dans le Créer une configuration , spécifiez un titre pour le dossier et activez Configurations du cloud.

  5. Appuyez sur Créer pour créer le dossier activé pour les configurations de service cloud.

Configuration des services web RESTful configure-restful-web-services

Le service web RESTful peut être décrit en utilisant les spécifications Swagger au format JSON ou YAML dans un fichier de définition Swagger. Pour configurer le service Web RESTful dans les services cloud AEM, assurez-vous que le fichier Swagger se trouve sur votre système de fichiers ou l’URL où le fichier est hébergé.

Procédez comme suit pour configurer les services RESTful :

  1. Accédez à Outils > Cloud Services > Sources de données. Appuyez pour sélectionner le dossier dans lequel vous souhaitez créer une configuration cloud.

    Pour plus d’informations sur la création et la configuration d’un dossier pour les configurations de service cloud, voir Configurer le dossier pour les configurations de service cloud.

  2. Appuyer Créer pour ouvrir le Boîte de dialogue Créer une configuration de source de données. Indiquez un nom et éventuellement un titre pour la configuration, puis sélectionnez Service RESTful de la Type de service , recherchez et sélectionnez éventuellement une miniature pour la configuration, puis appuyez sur Suivant.

  3. Spécifiez les détails suivants pour le service RESTful :

    • Sélectionnez URL ou Fichier dans la liste déroulante Source Swagger et spécifiez l’URL Swagger vers le fichier de définition Swagger ou chargez le fichier Swagger à partir de votre système de fichiers local.
    • Sélectionnez le type d’authentification (Aucun, OAuth2.0, Authentification de base, Clé API ou Authentification personnalisée) pour accéder au service RESTful et spécifiez les détails de l’authentification.

  4. Appuyez sur Créer pour créer la configuration cloud pour le service RESTful.

Configuration des services web SOAP configure-soap-web-services

Les services web SOAP sont décrits à l’aide des spécifications WSDL (Web Services Description Language). Pour configurer le service Web SOAP dans les services cloud AEM, vérifiez que vous disposez de l’URL WSDL du service Web et procédez comme suit :

  1. Accédez à Outils > Cloud Services > Sources de données. Appuyez pour sélectionner le dossier dans lequel vous souhaitez créer une configuration cloud.

    Pour plus d’informations sur la création et la configuration d’un dossier pour les configurations de service cloud, voir Configurer le dossier pour les configurations de service cloud.

  2. Appuyer Créer pour ouvrir le Boîte de dialogue Créer une configuration de source de données. Indiquez un nom et éventuellement un titre pour la configuration, puis sélectionnez Service Web SOAP de la Type de service , recherchez et sélectionnez éventuellement une miniature pour la configuration, puis appuyez sur Suivant.

  3. Spécifiez les éléments suivants pour le service Web SOAP :

    • URL WSDL du service Web.

    • Point d’entrée du service. Spécifiez une valeur dans ce champ pour remplacer le point d’entrée du service mentionné dans WSDL.

    • Sélectionnez le type d’authentification — Aucun, OAuth2.0, Authentification de base, Authentification personnalisée ou Jeton X509 — pour accéder au service SOAP et fournir en conséquence les détails de l’authentification.

      Si vous sélectionnez Jeton X509 comme type d’authentification, configurez le certificat X509. Pour plus d’informations, voir Configurer des certificats.
      Indiquez l’alias KeyStore du certificat X509 dans le champ Alias Key. Indiquez la durée, en secondes, pendant laquelle la demande d’authentification reste valide, dans le champ Durée de vie. Vous pouvez également choisir de signer le corps du message ou l’en-tête d’horodatage, voire les deux.

  4. Appuyez sur Créer pour créer la configuration cloud pour le service web SOAP.

Configuration des services OData config-odata

Un service OData est identifié par son URL racine de service. Pour configurer un service OData dans les services cloud AEM, vérifiez que vous disposez de l’URL racine du service et procédez comme suit :

NOTE
Pour obtenir un guide détaillé sur la configuration de Microsoft Dynamics 365, en ligne ou sur site, voir Configuration OData de Microsoft Dynamics.

  1. Accédez à Outils > Cloud Services > Sources de données. Appuyez pour sélectionner le dossier dans lequel vous souhaitez créer une configuration cloud.

    Pour plus d’informations sur la création et la configuration d’un dossier pour les configurations de service cloud, voir Configurer le dossier pour les configurations de service cloud.

  2. Appuyer Créer pour ouvrir le Boîte de dialogue Créer une configuration de source de données. Indiquez un nom et éventuellement un titre pour la configuration, sélectionnez Service OData dans la liste déroulante Type de service, cherchez et sélectionnez éventuellement une vignette pour la configuration, puis appuyez sur Suivant.

  3. Spécifiez les détails suivants pour le service OData :

    • URL racine du service pour le service OData à configurer.
    • Sélectionnez le type d’authentification - Aucun, OAuth2.0, authentification de base ou Authentification personnalisée - pour accéder au service OData et fournir en conséquence les détails de l’authentification.
    note note
    NOTE
    Vous devez sélectionner le type d’authentification OAuth 2.0 pour vous connecter aux services Microsoft Dynamics à l’aide du point d’entrée OData en tant que racine du service.

  4. Appuyez sur Créer pour créer la configuration de cloud pour le service OData.

Étapes suivantes next-steps

Vous avez configuré la source de données. Vous pouvez ensuite créer un modèle de données de formulaire ou, si vous avez déjà créé un modèle de données de formulaire sans source de données, vous pouvez l’associer aux sources de données que vous venez de configurer. Voir Création d’un modèle de données de formulaire pour plus de détails.

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da