Configurer un connecteur de source de données à partir de l’interface utilisateur
Experience Manager Guides est fourni avec l’outil Sources de données qui vous aide à configurer des connecteurs prêts à l’emploi pour les sources de données. Vous pouvez configurer les connecteurs client REST JIRA, SQL (MySQL, PostgreSQL, Microsoft SQL Server, SQLite, MariaDB, H2DB), AdobeCommerce, Elasticsearch et générique.
Outre ces connecteurs prêts à l’emploi, Experience Manager Guides fournit les connecteurs pour les sources de données Salsify, Akeneo et Microsoft Azure DevOps (ADO). Vous pouvez télécharger et installer ces connecteurs Open Source à partir du référentiel Maven Central. Les utilisateurs peuvent ensuite configurer ces connecteurs.
Découvrez comment installer un connecteur open source.
Vous pouvez également vous connecter aux fichiers de données JSON à l’aide d’un connecteur de fichier. Téléchargez le fichier JSON sur votre ordinateur ou parcourez-le à partir des ressources Adobe Experience Manager. Créez ensuite des fragments de contenu ou des rubriques à l’aide des générateurs.
Pour configurer un connecteur, procédez comme suit :
-
Sélectionnez le lien Adobe Experience Manager en haut et choisissez Outils.
-
Sélectionnez Guides dans la liste des outils.
-
Sélectionnez la mosaïque Sources de données . La page Sources de données s’affiche. Vous pouvez afficher les sources de données connectées.
Vous pouvez basculer entre le mode Liste ou le mode Mosaïque pour afficher les différentes sources de données connectées sous forme de liste ou de mosaïques.
{width="800"}
Afficher ou créer un connecteur de source de données.
-
Cliquez sur Créer.
-
Sélectionnez la base de données pour laquelle vous souhaitez créer le connecteur. Par exemple, le connecteur Elasticsearch.
note note NOTE Toutes les bases de données d'usine disponibles sont répertoriées. -
Cliquez sur Suivant.
-
Saisissez les détails de configuration et de connexion en fonction de la base de données.
note tip TIP -
Survol
{width="25"}
près du champ pour en afficher plus de détails.
-
Les champs avec * sont obligatoires. Par exemple, vous pouvez saisir les détails suivants pour le connecteur Elasticsearch.
- Nom : saisissez le nom de la source de données.
- Type d’authentification : sélectionnez le type d’authentification dans la liste déroulante. Par exemple, authentification de base nom d’utilisateur-mot de passe
- Nom d’utilisateur : saisissez votre nom d’utilisateur.
- Mot de passe : saisissez votre nom d’utilisateur et votre mot de passe.
- URL : ajoutez l’URL de l’API.
-
-
Sélectionnez l’option Exclure les modèles d’usine pour exclure les modèles d’usine de l’utilisation pour la génération de rubriques et de fragments de code. Ils n’apparaîtront pas dans la liste déroulante Modèle de mappage de données de la boîte de dialogue Ajouter un générateur de fragments de contenu ou Ajouter un générateur de rubrique.
-
Sélectionnez Tester la connexion. Vous pouvez afficher le bouton Tester la connexion activé uniquement après avoir ajouté les détails requis. Affichez un message de réussite si les détails de la connexion sont corrects. Sinon, vous pouvez afficher un message d’erreur.
-
Sélectionnez Enregistrer en haut pour enregistrer le connecteur. Affichez le bouton Enregistrer activé une fois que vous avez rempli tous les détails et que la connexion a réussi.
Si le connecteur est enregistré correctement, vous pouvez afficher la source de données connectée sur la page.
Se connecter à plusieurs ressources
Vous pouvez ajouter ou utiliser plusieurs ressources en fonction de différentes URL pour certains connecteurs tels que Generic REST Client, Salsify, Akeneo et Microsoft Azure DevOps Board (ADO). Ensuite, connectez-vous avec eux pour créer des fragments de contenu ou des rubriques à l’aide des générateurs.
Pour créer une ressource, procédez comme suit :
-
Sélectionnez dans la section de ressource d'URL pour ajouter une ressource pour chaque URL.
-
Configurez tous les détails dans la boîte de dialogue Ajouter une ressource.
-
Cliquez sur Ajouter.
-
Vous pouvez modifier ou supprimer la ressource de la liste des ressources d'URL.
-
Vous pouvez également utiliser les ressources par défaut disponibles pour les sources de données telles que Salsify, Akeneo et Microsoft ADO. Désactivez les options de la ressource que vous ne souhaitez pas configurer pour une source de données.
Vous pouvez ainsi récupérer rapidement des données d’une des ressources d’une source de données spécifique dans un seul fragment de contenu ou une seule rubrique.
Installation d’un connecteur open source install-open-source-connector
Pour publier une dépendance présente sur le référentiel central Maven sur les Cloud Service, vous devez inclure et incorporer la dépendance pour un connecteur open source.
-
Ajoutez la dépendance dans
all/pom.xml
dans le code de votre projet Git de cloud manager. Par exemple, vous pouvez ajouter la dépendance suivante pour le connecteur de source de données des forums de développement Azure de Microsoft.code language-none <dependency> <groupId>com.adobe.aem.addon.guides</groupId> <artifactId>konnect-azure-devops</artifactId> <version>1.0.0</version> <type>jar</type> </dependency>
-
Incorporez la dépendance ajoutée.
code language-none " <embedded> <groupId>com.adobe.aem.addon.guides</groupId> <artifactId>konnect-azure-devops</artifactId> <type>jar</type> <target>/apps/aemdoxonaemcsstageprogram-vendor-packages/content/install</target> </embedded> "
-
Exécutez le pipeline pour appliquer les modifications dans les Cloud Service.
Le connecteur est installé dans votre environnement.
Fonctionnalités disponibles pour un connecteur
- Basculez entre le mode Liste ou le mode Mosaïque pour afficher les diverses sources de données connectées sous forme de liste ou de mosaïques.
- Cochez la case correspondant à un seul connecteur. Cliquez sur Sélectionner tout pour sélectionner tous les connecteurs. Vous pouvez cliquer sur Tout désélectionner lorsque tous les connecteurs sont sélectionnés.
{width="800"}
Modifier, reconnecter, dupliquer ou supprimer un connecteur de source de données.
Vous pouvez utiliser les fonctionnalités suivantes pour le connecteur sur la page Sources de données :
-
Modifier : modifiez les détails de configuration pour le connecteur sélectionné.
-
Reconnecter : reconnectez-vous à un connecteur déconnecté.
-
Dupliquer : créez un nouveau connecteur en double à l’aide du connecteur actuel comme base. Le connecteur en double est créé avec un suffixe (tel que connectorname_1) par défaut. Par exemple, sample-élastique-search_1.
Vous affichez une erreur si le connecteur portant le même nom existe. -
Supprimer : supprimez le connecteur sélectionné.
Une fois que vous avez configuré la source de données, le connecteur est répertorié sous le panneau Sources de données dans l’éditeur web. Vous pouvez ensuite vous connecter à la source de données et insérer un fragment de contenu dans vos rubriques. Pour plus d’informations, voir Insertion d’un fragment de contenu à partir de votre source de données.