Configuration d’un connecteur de source de données
AEM Guides fournit des connecteurs prêts à l’emploi pour les bases de données JIRA, SQL (MySQL, PostgreSQL, Microsoft SQL Server, SQLite, MariaDB, H2DB), AdobeCommerce et Elasticsearch. Vous pouvez également ajouter d’autres connecteurs en étendant les interfaces par défaut. La configuration suivante vous permet d’ajouter facilement les différentes sources de données. Une fois ajoutées, vous pouvez afficher les sources de données dans l’éditeur web.
Effectuez les étapes suivantes pour configurer un connecteur de source de données, puis utilisez-le à partir de l’éditeur web :
Configurer un connecteur
Vous pouvez configurer un connecteur d’usine en chargeant un fichier JSON. Vous pouvez utiliser les exemples de fichiers de configuration suivants pour configurer des connecteurs pour des bases de données JIRA, SQL (MySQL, PostgreSQL, Microsoft SQL Server, SQLite, MariaDB, H2DB), AdobeCommerce et Elasticsearch.
Exemple de fichier de configuration pour l’authentification de base de Jira avec nom d’utilisateur et mot de passe :
{
"connectorClazz": "com.adobe.guides.konnect.definitions.ootb.connector.rest.JiraConnector",
"configName": "Jira",
"templateFolders": ["/content/dam/dita-templates/konnect/jira"],
"connectionConfig": {
"configClazz": "com.adobe.guides.konnect.definitions.ootb.config.rest.BasicAuthUserNamePasswordRestConfig",
"configData": {
"username": "jirausername",
"password": "jirapassword",
"url": "https://jira.corp.adobe.com/rest/api/latest/search"
}
}
}
Par exemple, enregistrez sous jira.json.
Exemple de fichier de configuration pour l’authentification de base de Jira avec jeton :
{
"connectorClazz": "com.adobe.guides.konnect.definitions.ootb.connector.rest.JiraConnector",
"configName": "Jira",
"templateFolders": ["/content/dam/dita-templates/konnect/jira"],
"connectionConfig": {
"configClazz": "com.adobe.guides.konnect.definitions.ootb.config.rest.BasicAuthTokenRestConfig",
"configData": {
"token": "jiraauthtoken",
"url": "https://jira.corp.adobe.com/rest/api/latest/search"
}
}
}
Par exemple, enregistrez sous jira.json.
Exemple de fichier de configuration pour l’authentification de base de Jira avec le jeton qui contient le mot-clé "De base" :
{
"connectorClazz": "com.adobe.guides.konnect.definitions.ootb.connector.rest.JiraConnector",
"configName": "Jira",
"templateFolders": ["/content/dam/dita-templates/konnect/jira"],
"connectionConfig": {
"configClazz": "com.adobe.guides.konnect.definitions.ootb.config.rest.BasicAuthTokenRestConfig",
"configData": {
"token": "Basic jiraauthtoken",
"url": "https://jira.corp.adobe.com/rest/api/latest/search"
}
}
}
Par exemple, enregistrez sous jira.json.
Exemple de fichier de configuration pour l’authentification de base de MySql :
{
"connectorClazz": "com.adobe.guides.konnect.definitions.ootb.connector.sql.MySqlConnector",
"configName": "MySQL",
"templateFolders": ["/content/dam/dita-templates/konnect/sql"],
"connectionConfig": {
"configClazz": "com.adobe.guides.konnect.definitions.ootb.config.sql.UserPassSqlConfig",
"configData": {
"username": "admin",
"password": "admin",
"driver": "com.mysql.jdbc.Driver",
"connectionString": "jdbc:mysql://host.corp.adobe.com:3306/plm"
}
}
}
Par exemple, enregistrez sous mysql.json.
Exemple de fichier de configuration pour l'authentification de base de PostgreSQL :
{
"connectorClazz": "com.adobe.guides.konnect.definitions.ootb.connector.sql.PostgreSqlConnector",
"configName": "PostgreSQL",
"templateFolders": ["/content/dam/dita-templates/konnect/sql"],
"connectionConfig": {
"configClazz": "com.adobe.guides.konnect.definitions.ootb.config.sql.UserPassSqlConfig",
"configData": {
"username": "admin",
"password": "admin",
"driver": "org.postgresql.Driver",
"connectionString": "jdbc:postgresql://host:port/database"
}
}
}
Par exemple, enregistrez sous postgres.json.
Exemple de fichier de configuration pour l’authentification de base de Microsoft SQL Server :
{
"connectorClazz": "com.adobe.guides.konnect.definitions.ootb.connector.sql.MsSqlServerConnector",
"configName": "MSSQLServer",
"templateFolders": ["/content/dam/dita-templates/konnect/sql"],
"connectionConfig": {
"configClazz": "com.adobe.guides.konnect.definitions.ootb.config.sql.UserPassSqlConfig",
"configData": {
"username": "admin",
"password": "admin",
"driver": "com.microsoft.sqlserver.jdbc.SQLServerDriver",
"connectionString": "jdbc:sqlserver://10.10.10.10\\SQLEXPRESS01:1433;database=TutorialDB;encrypt=false;trustServerCertificate=true"
}
}
}
Par exemple, enregistrez sous mssqlserver.json.
Exemple de fichier de configuration pour l’authentification de base de SQLite :
{
"connectorClazz": "com.adobe.guides.konnect.definitions.ootb.connector.sql.SqliteConnector",
"configName": "SQLiteServer",
"templateFolders": ["/content/dam/dita-templates/konnect/sql"],
"connectionConfig": {
"configClazz": "com.adobe.guides.konnect.definitions.ootb.config.sql.UserPassSqlConfig",
"configData": {
"username": "admin",
"password": "admin",
"driver": "org.sqlite.JDBC",
"connectionString": "jdbc:sqlite:sample.db"
}
}
}
Par exemple, enregistrez sous sqqlite.json.
Exemple de fichier de configuration pour H2DB :
{
"connectorClazz": "com.adobe.guides.konnect.definitions.ootb.connector.sql.H2DBConnector",
"configName": "H2DBConnector",
"templateFolders": ["/content/dam/dita-templates/konnect/sql"],
"connectionConfig": {
"configClazz": "com.adobe.guides.konnect.definitions.ootb.config.sql.UserPassSqlConfig",
"configData": {
"username": "admin",
"password": "admin",
"driver": "org.h2.Driver",
"connectionString": "jdbc:h2:file:D:/h2db/db"
}
}
}
Par exemple, enregistrez sous sqqlite.json.
Exemple de fichier de configuration pour l’authentification de base de MariaDb :
{
"connectorClazz": "com.adobe.guides.sample.konnect.connector.MariaDBConnector",
"configName": "SampleMariaDbConnector",
"templateFolders": ["/content/dam/dita-templates/konnect/sql"],
"connectionConfig": {
"configClazz": "com.adobe.guides.konnect.definitions.ootb.config.sql.UserPassSqlConfig",
"configData": {
"username": "admin",
"password": "admin",
"driver": "org.mariadb.jdbc.Driver",
"connectionString": "jdbc:mariadb://no1010042073107.corp.adobe.com:3308/mysql"
}
}
}
Par exemple, enregistrez sous mariadb.json.
Exemple de fichier de configuration pour l’authentification de base de l’Elasticsearch :
{
"connectorClazz": "com.adobe.guides.konnect.definitions.ootb.connector.rest.ElasticsearchConnector",
"configName": "SampleES",
"templateFolders": ["/content/dam/dita-templates/konnect/sql"],
"connectionConfig": {
"configClazz": "com.adobe.guides.konnect.definitions.ootb.config.rest.BasicAuthUserNamePasswordRestConfig",
"configData": {
"username": "admin",
"password": "admin",
"url": "https://testsearch-1370045986.us-east-1.bonsaisearch.net:443" }
}
}
Par exemple, enregistrez sous ES.json.
La requête pour la recherche adaptative doit inclure l’index et la requête :
{
"index": "kibana_sample_data_ecommerce",
"queryString":{
"query": {
"match_all": {}
}
}
}
Exemple de fichier de configuration pour AdobeCommerce NoAuth :
{
"connectorClazz": "com.adobe.guides.konnect.definitions.ootb.connector.graphql.AdobeCommerceConnector",
"configName": "SampleCommerce",
"templateFolders": ["/content/dam/dita-templates/konnect"],
"connectionConfig": { "configClazz": "com.adobe.guides.konnect.definitions.ootb.config.rest.NoAuthRestConfig",
"configData": {
"url": "http://host/graphql"
}
}
}
Par exemple, enregistrez sous commerce.json.
Personnalisation de la configuration d’un connecteur
AEM Guides vous permet de personnaliser certaines valeurs du fichier de configuration en fonction des besoins de l’utilisateur.
Les autres champs sont personnalisés en fonction de la classe de configuration sélectionnée pour exécuter le connecteur.
Téléchargez le fichier vers un emplacement dans AEM
Téléchargez le fichier vers un emplacement spécifique dans AEM Assets.
Par exemple : /content/dam/jira.json
Créer une configuration à l’aide de l’API REST
Vous pouvez enregistrer la configuration à l’aide de l’API REST. Pour plus d’informations, voir la API REST pour enregistrer un connecteur de source de données dans la section Référence d’API pour les guides Adobe Experience Manager.
Une fois la source de données configurée, 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.