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

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

Intégration de données

Experience Manager Forms L’ intégration de données vous permet de configurer des sources de données disparates et de vous y connecter. La prise en charge est assurée par défaut pour les types suivants :

  • Bases de données relationnelles : MySQL, Microsoft® SQL Server, IBM® DB2®, postgreSQL et Oracle RDBMS
  • Services web RESTful
  • Services web SOAP
  • Services OData (version 4.0)
  • Microsoft® Dynamics
  • SalesForce
  • Stockage d’objets blob Microsoft® Azure.

L’intégration de données prend en charge l’authentification OAuth2.0, (Code d’autorisation, Informations d’identification client), l’authentification de base ou l’authentification par clé API (prêtes à l’emploi). Elle 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 Experience Manager as a Cloud Service, JDBC pour les bases de données relationnelles et le connecteur pour le profil utilisateur Experience Manager sont configurés dans la console web Experience Manager.

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

Prérequis

Avant de configurer des bases de données relationnelles à l’aide de la Configuration de la console web Experience Manager, il est obligatoire d’effectuer les actions suivantes :

Etapes de configuration d'une base de données relationnelle

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

  1. Accédez à la console web Experience Manager à l’adresse https://server:host/system/console/configMgr.

  2. Localisez la configuration des Pools de connexions JDBC Day Commons. Sélectionnez pour ouvrir la configuration en mode édition.

    Pool de connecteurs JDBC .

  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 classe Java™ pour le pilote JDBC.

    • URI de connexion JDBC

    • Nom d’utilisateur et mot de passe pour établir la connexion au pilote JDBC

    • Spécifiez une requête SQL SELECT dans le champ Requête de validation pour valider les connexions du pool. La requête doit renvoyer au moins une ligne. En fonction de votre base de données, définissez l’une des options suivantes :

      • SELECT 1 (MySQL et MS® SQL)
      • SELECT 1 from dual (Oracle)
    • Nom de la source de données

    Exemples de chaînes pour configurer une base de données relationnelle :

    code language-text
       "datasource.name": "sqldatasourcename-mysql",
       "jdbc.driver.class": "com.mysql.jdbc.Driver",
       "jdbc.connection.uri": "jdbc:mysql://$[env:AEM_PROXY_HOST;default=proxy.tunnel]:30001/sqldatasourcename"
    
    note note
    NOTE
    Consultez Connexions SQL à l’aide de JDBC DataSourcePool pour plus d’informations.
  4. Sélectionnez Enregistrer pour enregistrer la configuration.

Vous pouvez désormais utiliser la base de données relationnelle configurée avec votre modèle de données de formulaire (FDM).

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

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 services cloud dans Experience Manager sont consolidées dans le dossier /conf du référentiel Experience Manager. 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 choisissez Propriétés.

    2. Dans la boîte de dialogue Propriétés de configuration, activez Configurations cloud.

    3. Sélectionnez Enregistrer et fermer pour enregistrer la configuration et fermer la boîte de dialogue.

  3. Dans le Navigateur de configuration, sélectionnez Créer.

  4. Dans la boîte de dialogue Créer une configuration, indiquez un titre pour le dossier et activez les Configurations cloud.

  5. Sélectionnez Créer pour créer le dossier activé pour les configurations de service cloud.

Configurer des services web RESTful configure-restful-web-services

Les services Web RESTful peuvent être décrits à l’aide des spécifications Swagger au format JSON ou YAML dans un fichier de définition Swagger. Pour configurer le service web RESTful dans Experience Manager as a Cloud Service, vérifiez que le fichier Swagger (Swagger Version 2.0) ou le fichier Swagger (Swagger Version 3.0) est présent dans votre système de fichiers ou l’URL où le fichier est hébergé.

Configurez les services RESTful pour la version 2.0 de la spécification Open API. configure-restful-services-open-api-2.0

  1. Accédez à Outils > Services Cloud > Sources de données. Sélectionnez 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. Sélectionnez Créer pour ouvrir l’Assistant de création d’une configuration de source de données. Indiquez un nom et éventuellement un titre pour la configuration, sélectionnez Service RESTful dans la liste déroulante Type de service, recherchez et sélectionnez éventuellement une image miniature pour la configuration, puis sélectionnez Suivant.

  3. Spécifiez les informations suivantes pour le service RESTful :

    • Sélectionnez une URL ou un fichier dans la liste déroulante Swagger Source et spécifiez Swagger URL dans le fichier de définition ​ Swagger ou téléchargez le fichier Swagger depuis votre système de fichiers local.

    • En fonction de l’entrée source ​ Swagger, les champs suivants sont préremplis avec des valeurs :

      • Schéma : protocoles de transfert utilisés par l’API REST. Le nombre de types de schémas qui s’affichent dans la liste déroulante dépend des schémas définis dans la source Swagger.
      • Hôte : nom de domaine ou adresse IP de l’hôte qui sert l’API REST. Ce champ est obligatoire.
      • Chemin d’accès de base : le préfixe d’URL de tous les chemins d’API. Ce champ est facultatif.
        Si nécessaire, modifiez les valeurs prérenseignées pour ces champs.
    • Sélectionnez le type d’authentification : aucune, OAuth2.0 (code d’authentification, informations d’identification client), authentification de base, clé API ou authentification personnalisée pour accéder au service RESTful et spécifiez les détails de l’authentification.

    Si vous sélectionnez Clé API comme type d’authentification, spécifiez la valeur de la clé API. La clé API peut être envoyée en tant qu’en-tête de requête ou en tant que paramètre de requête. Sélectionnez l’une de ces options dans la liste déroulante Emplacement et indiquez le nom de l’en-tête ou du paramètre de requête dans le champ Nom du paramètre.

  4. Sélectionnez Créer pour créer la configuration cloud pour le service RESTful.

Configurez les services RESTful pour la version 3.0 de la spécification Open API. configure-restful-services-open-api-3.0

  1. Accédez à Outils > Services Cloud > Sources de données. Sélectionnez 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. Sélectionnez Créer pour ouvrir l’Assistant de création d’une configuration de source de données. Indiquez un nom et éventuellement un titre pour la configuration, sélectionnez Service RESTful dans la liste déroulante Type de service, recherchez et sélectionnez éventuellement une image miniature pour la configuration, puis sélectionnez Suivant.

  3. Spécifiez les informations suivantes pour le service RESTful :

    • Sélectionnez une URL ou un fichier dans la liste déroulante Swagger Source et spécifiez Swagger 3.0 URL dans le fichier de définition ​ Swagger ou téléchargez le fichier Swagger depuis votre système de fichiers local.
    • En fonction de l’entrée source ​ Swagger, les informations de connexion au serveur cible s’affichent.
    • Sélectionnez le type d’authentification : aucune, OAuth2.0 (code d’authentification, informations d’identification client), authentification de base, clé API ou authentification personnalisée pour accéder au service RESTful et spécifiez les détails de l’authentification.

    Si vous sélectionnez Clé API comme type d’authentification, spécifiez la valeur de la clé API. La clé API peut être envoyée en tant qu’en-tête de requête ou en tant que paramètre de requête. Sélectionnez l’une de ces options dans la liste déroulante Emplacement et indiquez le nom de l’en-tête ou du paramètre de requête dans le champ Nom du paramètre.

  4. Sélectionnez Créer pour créer la configuration cloud pour le service RESTful.

Voici quelques-unes des opérations non prises en charge par la version 3.0 de la spécification Open API des services RESTful :

  • Les rappels.
  • l’un de/l’un des.
  • Référence à distance.
  • Liens
  • Différents corps de requête pour différents types MIME pour une seule opération.

Consultez Spécification OpenAPI 3.0 pour plus d’informations.

Configuration du client HTTP de modèle de données de formulaire (FDM) pour optimiser les performances fdm-http-client-configuration

Experience Manager Forms forme un modèle de données lors de l’intégration aux services web RESTful en tant que source de données ; inclut des configurations de client HTTP pour l’optimisation des performances.

Définissez les propriétés suivantes de la Configuration du client HTTP du modèle de données de formulaire pour la source de données REST pour spécifier l’expression régulière :

  • Utilisez la propriété http.connection.max.per.route pour définir le nombre maximal de connexions autorisées entre le modèle de données de formulaire (FDM) et les services Web RESTful. La valeur par défaut est de 20 connexions.

  • Utilisez la propriété http.connection.max pour spécifier le nombre maximal de connexions autorisées pour chaque itinéraire. La valeur par défaut est de 40 connexions.

  • Utilisez la propriété http.connection.keep.alive.duration pour spécifier la durée pour laquelle une connexion HTTP persistante est maintenue active. La valeur par défaut est de 15 secondes.

  • Utilisez la propriété http.connection.timeout pour spécifier la durée pendant laquelle la propriété Experience Manager Forms attend qu’une connexion soit établie. La valeur par défaut est de 10 secondes.

  • Utilisez la propriété http.socket.timeout pour spécifier la période maximale d’inactivité entre deux paquets de données. La valeur par défaut est de 30 secondes.

Le fichier JSON suivant affiche un exemple :

{
   "http.connection.keep.alive.duration":"15",
   "http.connection.max.per.route":"20",
   "http.connection.timeout":"10",
   "http.socket.timeout":"30",
   "http.connection.idle.connection.timeout":"15",
   "http.connection.max":"40"
}
  1. Sélectionnez Form Data Model HTTP Client Configuration for REST data source.

  2. Dans la boîte de dialogue Configuration du client HTTP du modèle de données de formulaire pour la source de données REST :

    • Indiquez le nombre maximal de connexions autorisées entre le modèle de données de formulaire (FDM) et les services Web RESTful dans le champ Limite de connexion au total . La valeur par défaut est de 20 connexions.

    • Spécifiez le nombre maximal de connexions autorisées pour chaque itinéraire dans le champ Limite de connexion par itinéraire. La valeur par défaut est « deux connexions ».

    • Indiquez la durée pendant laquelle une connexion HTTP persistante est maintenue en vie, dans le champ Maintenir en vie. La valeur par défaut est de 15 secondes.

    • Indiquez la durée pendant laquelle le serveur Experience Manager Forms attend qu’une connexion soit établie, dans le champ Délai d’attente de connexion. La valeur par défaut est de 10 secondes.

    • Spécifiez la période maximale d’inactivité entre deux paquets de données dans le champ Délai d’attente du socket. La valeur par défaut est de 30 secondes.

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). Experience Manager Forms ne prend pas en charge le modèle WSDL de style RPC.

Pour configurer le service Web SOAP dans Experience Manager as a Cloud Service, vérifiez que vous disposez de l’URL WSDL pour le service web et procédez comme suit :

  1. Accédez à Outils > Services Cloud > Sources de données. Sélectionnez 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. Sélectionnez Créer pour ouvrir l’assistant Créer une configuration de source de données. Indiquez un nom et éventuellement un titre pour la configuration, sélectionnez Service Web SOAP dans la liste déroulante Type de service, recherchez et sélectionnez une image miniature pour la configuration si vous le souhaitez, puis sélectionnez 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 : aucune, OAuth2.0 (code d’autorisation, informations d’identification client), authentification de base ou authentification personnalisée pour accéder au service SOAP et fournissez en conséquence les détails de l’authentification.

  4. Sélectionnez Créer pour créer la configuration cloud pour le service web SOAP.

Activez l’utilisation des instructions d’importation dans le WSDL des services web SOAP enable-import-statements

Vous pouvez spécifier une expression régulière qui sert de filtre pour les URL absolues autorisées comme instructions d’importation dans le WSDL des services web SOAP. Par défaut, ce champ ne contient aucune valeur. Par conséquent, Experience Manager bloque toutes les instructions d’importation disponibles dans le WSDL. Si vous spécifiez .* comme valeur dans ce champ, Experience Manager autorise toutes les instructions d’importation.

Définissez la propriété importAllowlistPattern de la configuration de la Liste autorisée d’importation des services Web SOAP du Modèle de données de formulaire pour spécifier l’expression régulière. Le fichier JSON suivant affiche un exemple :

{
  "importAllowlistPattern": ".*"
}

Pour définir les valeurs d’une configuration, générez des configurations OSGi à l’aide du SDK AEM et déployez la configuration sur votre instance de Cloud Service.

Configuration des services OData config-odata

Un service OData est identifié par son URL racine de service. Pour configurer un service OData dans Experience Manager as a Cloud Service, vérifiez que vous disposez de l’URL racine du service et procédez comme suit :

NOTE
Le modèle de données de formulaire (FDM) prend en charge OData version 4.
Pour obtenir un guide détaillé sur la configuration de Microsoft®® Dynamics 365 en ligne ou sur site, voir Microsoft® Dynamics Configuration OData.
  1. Accédez à Outils > Services Cloud > Sources de données. Sélectionnez 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. Sélectionnez Créer pour ouvrir l’assistant 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, recherchez et sélectionnez éventuellement une image miniature pour la configuration, puis appuyez sur Suivant.

  3. Spécifiez les informations suivantes pour le service OData :

    • URL racine du service pour le service OData à configurer.
    • Sélectionnez le type d’authentification : aucune, OAuth2.0 (code d’autorisation, informations d’identification client), authentification de base, clé API ou authentification personnalisée pour accéder au service OData et fournissez en conséquence les détails de l’authentification.

    Si vous sélectionnez Clé API comme type d’authentification, spécifiez la valeur de la clé API. La clé API peut être envoyée en tant qu’en-tête de requête ou en tant que paramètre de requête. Sélectionnez l’une de ces options dans la liste déroulante Emplacement et indiquez le nom de l’en-tête ou du paramètre de requête dans le champ Nom du paramètre.

    note note
    NOTE
    Sélectionnez le type d’authentification OAuth 2.0 pour vous connecter aux services Microsoft®® Dynamics à l’aide du point d’entrée OData comme racine du service.
  4. Sélectionnez Créer pour créer la configuration cloud pour le service OData.

Étapes suivantes next-steps

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

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