Show Menu
SUJETS×

Configurer les sources de données

L’intégration de données AEM 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.
  • 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 des données prend en charge OAuth2.0, l’authentification de base et les types d’authentification de clé d’API prêts à l’emploi et permet l’implémentation de l’authentification personnalisée pour l’accès 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

Vous pouvez configurer des bases de données relationnelles à l’aide de la configuration de la console Web AEM. Procédez comme suit :
  1. Accédez à AEM console Web à l’adresse https://server:host/system/console/configMgr.
  2. Recherchez la configuration Apache Sling Connection Pooled DataSource . 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é de 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 avec le pilote JDBC
    Veillez à chiffrer les informations sensibles telles que les mots de passe avant de configurer la source de données. Pour chiffrer :
    1. Go to https://' # : # '/system/console/crypto.
    2. In the Plain Text field, specify the password or any string to encrypt and tap 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 lors du renvoi pour spécifier que les objets sont validés avant d’être empruntés ou retournés depuis et vers le pool, respectivement.
  5. 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)
  6. Tap Save to save the configuration.

Configurer le profil utilisateur AEM

Vous pouvez configurer le profil utilisateur AEM à l’aide de la configuration User Profile Connector dans AEM Web Console. Procédez comme suit :
  1. Go to AEM web console at https://' # : # 'system/console/configMgr.
  2. Look for AEM Forms Data Integrations - User Profile Connector Configuration and tap to open the configuration in edit mode.
  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 pourront ê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
    The * in the above example denotes all nodes under the profile/empLocation/ node in AEM user profile in CRXDE structure. It means that the form data model can access the city property of type string present in any node under the profile/empLocation/ node. Toutefois, les nœuds qui contiennent la propriété spécifiée doivent suivre une structure cohérente.
  4. Tap Save to save the configuration.

Configuration du dossier pour les configurations de service cloud

La configuration du dossier des services cloud est requise pour la configuration des services cloud pour les services RESTful, SOAP et OData.
All cloud service configurations in AEM are consolidated in the /conf folder in AEM repository. 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. Go to Tools > General > Configuration Browser .
  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. Tap Create to create the folder enabled for cloud service configurations.

Configurer les services Web RESTful

RESTful web service can be described using Swagger specifications in JSON or YAML format in a Swagger definition file. Pour configurer le service Web RESTful dans les services cloud AEM, veillez à disposer du fichier Swagger sur votre système de fichiers ou de l’URL d’hébergement du fichier.
Procédez comme suit pour configurer les services RESTful :
  1. Accédez à Outils > Services cloud > Sources de données . Appuyez sur pour sélectionner le dossier dans lequel vous souhaitez créer une configuration de cloud.
    See Configure folder for cloud service configurations for information about creating and configuring a folder for cloud service configurations.
  2. Tap Create to open the Create Data Source Configuration wizard . 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 URL ou Fichier dans la liste déroulante Source Swagger et, en conséquence, spécifiez l’URL Swagger vers 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érenseignés avec des valeurs :
      • Schéma : Protocoles de transfert utilisés par l’API REST. Le nombre de types de schéma affichés 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 diffuse l’API REST. Ce champ est obligatoire.
      • Chemin d’accès de base : Préfixe d’URL pour 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é d’API, Authentification personnalisée ou Authentification mutuelle — pour accéder au service RESTful et, en conséquence, fournir des détails pour l’authentification.
    Si vous sélectionnez Clé ​d'API comme type d'authentification, spécifiez la valeur de la clé d'API. La clé d'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 en conséquence.
    Si vous sélectionnez l’authentification ​mutuelle comme type d’authentification, voir Authentification mutuelle basée sur des certificats pour les services Web RESTful et SOAP.
  4. Appuyez sur Créer pour créer la configuration cloud pour le service RESTful.

Configurer les services Web SOAP

Les services Web basés sur 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 pour le service Web et procédez comme suit :
  1. Accédez à Outils > Services cloud > Sources de données . Appuyez sur pour sélectionner le dossier dans lequel vous souhaitez créer une configuration de cloud.
    See Configure folder for cloud service configurations for information about creating and configuring a folder for cloud service configurations.
  2. Tap Create to open the Create Data Source Configuration wizard . 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 de fin du service. Spécifiez une valeur dans ce champ pour remplacer le point de terminaison de service mentionné dans WSDL.
    • Sélectionnez le type d’authentification : Aucun, OAuth2.0, Authentification de base, Authentification personnalisée, Jeton X509 ou Authentification mutuelle, pour accéder au service SOAP et, par conséquent, fournir 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 Configuration des certificats . Spécifiez l’alias KeyStore pour le certificat X509 dans le champ Key Alias (Alias de clé). Spécifiez la durée, en secondes, jusqu’à ce que 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 ou les deux.
      Si vous sélectionnez l’authentification ​mutuelle comme type d’authentification, voir Authentification mutuelle basée sur des certificats pour les services Web RESTful et SOAP.
  4. Appuyez sur Créer pour créer la configuration cloud pour le service Web SOAP.

Configurer les services 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 :
Pour obtenir un guide pas à pas sur la configuration de Microsoft Dynamics 365, en ligne ou sur site, voir Configuration OData de Microsoft Dynamics .
  1. Accédez à Outils > Services cloud > Sources de données . Appuyez sur pour sélectionner le dossier dans lequel vous souhaitez créer une configuration de cloud.
    See Configure folder for cloud service configurations for information about creating and configuring a folder for cloud service configurations.
  2. Tap Create to open the Create Data Source Configuration wizard . 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 — Aucun, OAuth2.0, Authentification de base ou Authentification personnalisée — pour accéder au service OData et, par conséquent, fournir les détails de l’authentification.
    Vous devez sélectionner le type d’authentification OAuth 2.0 pour vous connecter aux services Microsoft Dynamics à l’aide du point de terminaison OData en tant que racine du service.
  4. Tap Create to create the cloud configuration for the OData service.

Authentification mutuelle basée sur des certificats pour les services Web RESTful et SOAP

Lorsque vous activez l’authentification mutuelle pour le modèle de données de formulaire, la source de données et AEM serveur exécutant le modèle de données de formulaire authentifient l’identité de chacun avant de partager des données. Vous pouvez utiliser l’authentification mutuelle pour les connexions REST et SOAP (sources de données). Pour configurer l’authentification mutuelle pour un modèle de données de formulaire sur votre environnement AEM Forms :
  1. Téléchargez la clé privée (certificat) sur AEM Forms le serveur. Pour télécharger la clé privée :
    1. Connectez-vous à votre AEM Forms serveur en tant qu’administrateur.
    2. Navigate to Tools > Security > Users . Sélectionnez l’ fd-cloudservice utilisateur et appuyez sur Propriétés .
    3. Ouvrez l'onglet Keystore , développez l'option Ajouter la clé privée à partir du fichier KeyStore, téléchargez le fichier KeyStore, spécifiez les alias, mots de passe et appuyez sur Envoyer . Le certificat est téléchargé. L’alias de clé privée est mentionné dans le certificat et défini lors de la création du certificat.
  2. Téléchargez le certificat d’approbation vers le Trust Store global. Pour télécharger le certificat :
    1. Accédez à Outils > Sécurité > Trust Store .
    2. Développez l’option Ajouter le certificat à partir du fichier CER, appuyez sur Sélectionner un fichier de certificat, téléchargez le certificat et appuyez sur Envoyer .
  3. Configurez les services Web SOAP ou RESTful comme source de données et sélectionnez l’authentification ​mutuelle comme type d’authentification. Si vous configurez plusieurs certificats auto-signés pour fd-cloudservice l’utilisateur, spécifiez le nom de l’alias de clé pour le certificat.

É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 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. See Create form data model for details.