DocumentationAEM GuidesDocumentation d’AEM Guides

Configuration d’un connecteur de source de données

Dernière mise à jour : 12 juillet 2024
  • Rubriques :
  • Configuration de Web Editor

Créé pour :

  • Expérimenté
  • Administration

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 en tant que 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 en tant que 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 en tant que 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 en tant que 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 en tant que 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 en tant que 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 en tant que 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 en tant que 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 en tant que 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 en tant que 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 en tant que commerce.json.

Personnalisation de la configuration d’un connecteur

AEM Guides vous permet de personnaliser certaines valeurs du fichier de configuration pour répondre aux besoins de l’utilisateur.

Nom de la propriété
Description
configName
L’utilisateur peut spécifier un nom de configuration pour identifier le connecteur.
templateFolders
Liste des dossiers à partir desquels les modèles seront récupérés

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, consultez la section API REST pour enregistrer un connecteur de source de données dans la référence d’API pour Adobe Experience Manager Guides.

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.

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178