Configurare un connettore di origine dati
AEM Guides fornisce connettori predefiniti per database JIRA e SQL (MySQL, PostgreSQL, SQL Server, SQLite). È inoltre possibile aggiungere altri connettori estendendo le interfacce predefinite. La seguente configurazione consente di aggiungere facilmente le varie origini dati. Una volta aggiunte, è possibile visualizzare le origini dati nell’Editor web.
Per configurare un connettore di origine dati e utilizzarlo dall'editor Web, eseguire la procedura seguente:
Configurare un connettore
Puoi configurare un connettore preconfigurato caricando un file JSON. È possibile utilizzare i seguenti file di installazione di esempio per impostare i connettori per i database Jira e SQL (MySQL, PostgreSQL, SQL Server, SQLite).
Esempio di file di configurazione per l’autenticazione di base di Jira con nome utente e password:
{
"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.BasicAuthRestConfig",
"configData": {
"username": "jirausername",
"password": "jirapassword",
"url": "https://jira.corp.adobe.com/rest/api/latest/search"
}
}
}
Ad esempio, salvare come jira.json.
Esempio di file di configurazione per l’autenticazione di base di Jira con token:
{
"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.BasicAuthRestConfig",
"configData": {
"token": "jiraauthtoken",
"url": "https://jira.corp.adobe.com/rest/api/latest/search"
}
}
}
Ad esempio, salvare come jira.json.
Un esempio di file di configurazione per l’autenticazione di base di Jira con il token contenente la parola chiave "Basic":
{
"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.BasicAuthRestConfig",
"configData": {
"token": "Basic jiraauthtoken",
"url": "https://jira.corp.adobe.com/rest/api/latest/search"
}
}
}
Ad esempio, salvare come jira.json.
Esempio di file di installazione per l'autenticazione di base di 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"
}
}
}
Ad esempio, salvare come mysql.json.
Esempio di file di installazione per l'autenticazione di base di 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"
}
}
}
Ad esempio, salvare come postgres.json.
Esempio di file di installazione per l'autenticazione di base di MS 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"
}
}
}
Ad esempio, salvare come mssqlserver.json.
Esempio di file di installazione per l'autenticazione di base di 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"
}
}
}
Ad esempio, salvare come sqqlite.json.
Personalizzare una configurazione di connettore
AEM Guides consente di personalizzare alcuni valori nel file di configurazione in base alle esigenze dell’utente.
Altri campi vengono personalizzati in base alla classe di configurazione selezionata per eseguire il connettore.
Carica il file in una posizione in AEM
Carica il file in una posizione specifica in AEM Assets.
Ad esempio, /content/dam/jira.json
Creare una configurazione tramite API REST
Puoi registrare la configurazione utilizzando l’API REST. Per ulteriori dettagli, visualizzare la sezione API REST per registrare un connettore origine dati nella documentazione di riferimento API per Adobe Experience Manager Guides.
Dopo aver configurato l’origine dati, il connettore viene elencato nel pannello Origini dati dell’Editor web. È quindi possibile connettersi all'origine dati e inserire uno snippet di contenuto negli argomenti. Per ulteriori dettagli, visualizzare Inserire uno snippet di contenuto dall'origine dati.