Configuration des sources de données

Intégration de données

L’intégration de données Experience Manager Forms permet de configurer des sources de données disparates et de s’y connecter. La prise en charge est assurée par défaut pour les types suivants. Toutefois, avec peu de personnalisation, vous pouvez intégrer d’autres sources de données.

  • 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. Les services RESTful, SOAP et OData sont configurés dans Experience Manager as a Cloud Service et le connecteur pour le profil utilisateur Experience Manager est configuré dans la console web Experience Manager.

REMARQUE

Experience Manager Forms ne prend pas en charge les bases de données relationnelles.

Configurer le dossier pour les configurations de service cloud

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 appuyez sur Propriétés.

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

    3. Appuyez sur Enregistrer et fermer pour enregistrer la configuration et fermer la boîte de dialogue.

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

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

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

Configuration des services web RESTful

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 Experience Manager as a Cloud Service, vérifiez que le fichier Swagger est présent dans 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. Appuyez sur 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 RESTful 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 RESTful :

    • Sélectionnez l’URL ou le fichier dans la liste déroulante Source Swagger et spécifiez l’Swagger URL vers le fichier de définition du Swagger ou chargez le fichier Swagger à partir de votre système de fichiers local.

    • En fonction de l’entrée de la source Swagger, les champs suivants sont prérenseignés 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 (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.

    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. Appuyez sur Créer pour créer la configuration cloud pour le service RESTful.

Configuration des services web SOAP

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 > 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. Appuyez sur 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, sélectionnez et sélectionnez une image miniature pour la configuration, puis appuyez sur Suivant.

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

    • URL WSDL pour le 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 ou Authentification personnalisée - pour accéder au service SOAP et fournir en conséquence les détails de l’authentification.

  4. Appuyez sur 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

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

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 :

REMARQUE

Pour obtenir un guide pas à pas sur la configuration de Microsoft Dynamics 365, en ligne ou sur site, voir Microsoft Dynamics Configuration OData.

  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. Appuyez sur 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, cherchez et sélectionnez éventuellement une vignette 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 - Aucun, OAuth2.0, Authentification de base, Clé API ou Authentification personnalisée - pour accéder au service OData et fournir 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.

    REMARQUE

    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

Vous avez configuré la source de données. Vous pouvez ensuite créer un modèle de données de formulaire ou, si vous en avez déjà créé un 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.

Sur cette page