Confluence-Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 23.0.8895 des Connectors.

Erste Schritte

Confluence Versionsunterstützung

Der Connector nutzt die Confluence API v2, um bidirektionalen Zugriff auf Confluence zu ermöglichen.

Herstellen einer Verbindung

Mit Confluence verbinden

Sie können eine Verbindung zu jedem Confluence Cloud-Konto oder Confluence Server-Instanz herstellen. Um eine Verbindung herzustellen, setzen Sie die URL Verbindungseigenschaft. Beispiel: https://yoursitename.atlassian.net.

Authentifizieren bei Confluence

Confluence unterstützt die folgenden Authentifizierungsmethoden: Basisauthentifizierung, standardmäßige OAuth2.0-Authentifizierung und SSO.

Grundlegende Authentifizierung

Confluence Cloud-Konto

Erwerben Sie ein Token

Für die Kontoauthentifizierung ist ein API Token erforderlich. Um einen zu generieren, melden Sie sich bei Ihrem Atlassian-Konto an und wählen Sie API tokens > Create API token. Das generierte Token wird angezeigt.

Authentifizierung mit dem Token

Um sich bei einem Cloud-Konto zu authentifizieren, geben Sie Folgendes ein (Hinweis: Password wurde für die Verbindung mit einem Cloud-Konto verworfen und wird jetzt nur noch für die Verbindung mit einer Serverinstanz verwendet.):

• AuthScheme: Stellen Sie dies auf „Einfach“ ein.
• User: Der Benutzer, der zur Authentifizierung beim Confluence-Server verwendet werden soll.
• APIToken: Das API Token, das dem aktuell authentifizierten Benutzer zugeordnet ist.
• URL: Die mit Ihrem Jira Endpoint verknüpfte URL. Beispiel: https://yoursitename.atlassian.net.

Confluence-Serverinstanz

Um sich bei einer Serverinstanz zu authentifizieren, geben Sie Folgendes an:

• AuthScheme: Setzen Sie dies auf Basic.
• User: Der Benutzer, der zur Authentifizierung bei der Confluence-Instanz verwendet werden soll.
• Password: Das Passwort, das zur Authentifizierung beim Confluence-Server verwendet wird.
• URL: Die mit Ihrem Jira Endpoint verknüpfte URL. Beispiel: https://yoursitename.atlassian.net.

OAuth

In jedem Fall müssen Sie setzen AuthScheme Zu OAuth Und Scope auf den Wert, den Sie aus Ihren Anwendungseinstellungen erhalten haben. In allen unten beschriebenen Abläufen wird davon ausgegangen, dass Sie dies getan haben.

Desktop-Anwendungen

In diesem Abschnitt wird die Desktop-Authentifizierung mithilfe der Anmeldeinformationen für Ihre benutzerdefinierte OAuth-App beschrieben. Siehe Erstellen einer benutzerdefinierten OAuth-App für weitere Informationen.

Holen Sie sich ein OAuth-Zugriffstoken

Nachdem Sie Folgendes festgelegt haben, können Sie eine Verbindung herstellen:

• OAuthClientId: In Ihren App-Einstellungen auf die Client-ID einstellen.
• OAuthClientSecret: Stellen Sie das Client-Geheimnis in Ihren App-Einstellungen ein.
• CallbackURL: Stellen Sie die Weiterleitungs URL in Ihren App-Einstellungen ein.
• OAuthVersion: Auf setzen 2.0.
• URL: Die URL zu Ihrem Confluence Endpoint; zum Beispiel https://yoursitename.atlassian.net.
• InitiateOAuth: Auf setzen GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Festlegen der zu vermeiden OAuthAccessToken.

Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen. Der Connector führt dann den folgenden OAuth-Prozess aus:

1. Extrahiert das Zugriffstoken aus der Rückruf URL und authentifiziert Anfragen.
2. Erhält einen neuen Zugriffstoken, wenn der alte abläuft.
3. Speichert OAuth-Werte in OAuthSettingsLocation. Diese Werte bleiben über Verbindungen hinweg bestehen.

Menge

Setzen Sie die AuthScheme Zu Crowd. Die folgenden Verbindungseigenschaften werden zur Verbindung mit Crowd verwendet:

• User: Das CROWD-Benutzerkonto.
• Password: Das mit dem Crowd-Konto verknüpfte Passwort.
• SSOLoginURL: Die mit dem Crowd-Konto verknüpfte Anmelde URL. Sie finden die IDP- URL, indem Sie zu navigieren your application -> SSO -> SSO information -> Identity provider single sign-on URL.
• SSOAppName: Der Name der Anwendung, in der SSO aktiviert ist.
• SSOAppPassword: Das Passwort der Anwendung, in der SSO aktiviert ist.
• SSOExchangeUrl: Die URL, die zum Austausch des SAML -Tokens gegen Confluence-Cookies verwendet wurde. Diese URL kann die folgenden Formate haben:
  • https://<authority der Confluence Instanz>/plugins/servlet/samlconsumer
  • https://<authority der Confluence Instanz>/plugins/servlet/samlsso

Nachfolgend sehen Sie ein Beispiel für eine Verbindungszeichenfolge:

AuthScheme=Crowd;Url=https://yoursitename.atlassian.net;SSOLoginURL='https://<authority>/crowd/console/secure/saml/sso.action';User=crowdUserName;Password=crowdPassword;SSOExchangeUrl=https://<authority of Confluence instance>/plugins/servlet/samlconsumer;SSOAppName=CrowdAppName;SSOAppPassword=CrowdAppPassword;

Okta

Um eine Verbindung mit Okta herzustellen, setzen Sie die AuthScheme Zu Okta, und legen Sie diese Eigenschaften fest:

• User: Der Okta Benutzer.
• Password: Das Passwort des Okta Benutzers.
• SSOLoginURL: Die Login URL des SSO-Anbieters.
• SSOExchangeUrl: Die URL, die zum Austausch des SAML -Tokens gegen Confluence-Cookies verwendet wurde. Diese URL kann die folgenden Formate haben:
  • https://<authority der Confluence Instanz>/plugins/servlet/samlconsumer
  • https://<authority der Confluence Instanz>/plugins/servlet/samlsso

Wenn Sie eine vertrauenswürdige Anwendung oder einen Proxy verwenden, der die Okta Clientanforderung überschreibt, ODER MFA konfigurieren, müssen Sie Kombinationen aus verwenden SSOProperties zur Authentifizierung mit Okta. Legen Sie je nach Bedarf die folgenden Optionen fest:

• APIToken: Wenn Sie einen Benutzer über eine vertrauenswürdige Anwendung oder einen Proxy authentifizieren, der den Anforderungskontext des Okta Clients überschreibt, legen Sie dies auf das API Token fest, das der Kunde aus der Okta-Organisation erstellt hat.

• MFAType: Wenn Sie den MFA-Flow konfiguriert haben, legen Sie ihn auf einen der folgenden unterstützten Typen fest: OktaVerify, Email, oder SMS.

• MFAPassCode: Wenn Sie den MFA-Flow konfiguriert haben, legen Sie hier einen gültigen Passcode fest.

  Wenn Sie dies auf leer oder einen ungültigen Wert setzen, sendet der Connector eine Einmalkennwort-Abfrage an Ihr Gerät oder Email. Nachdem der Passcode empfangen wurde, öffnen Sie die Verbindung erneut, wobei der abgerufene Einmalkennwortwert auf die Verbindungseigenschaft MFAPassCode gesetzt wird.

• MFARememberDevice: True standardmäßig. Okta unterstützt das Speichern von Geräten, wenn MFA erforderlich ist. Wenn das Speichern von Geräten gemäß den konfigurierten Authentifizierungsrichtlinien zulässig ist, sendet der Connector ein Gerätetoken, um die Lebensdauer der MFA-Authentifizierung zu verlängern. Wenn Sie nicht möchten, dass MFA gespeichert wird, setzen Sie diese Variable auf False.

Beispiel-Verbindungszeichenfolge:

AuthScheme=Okta;Url=https://yoursitename.atlassian.net;SSOLoginURL='https://example.okta.com/home/appType/0bg4ivz6cJRZgCz5d6/46';User=oktaUserName;Password=oktaPassword;SSOExchangeUrl=https://<authority of Confluence instance>/plugins/servlet/samlconsumer;

Erstellen einer benutzerdefinierten OAuth-App

Wenn Sie keinen Zugriff auf den Benutzernamen und das API Token haben oder diese nicht benötigen, können Sie die OAuth-Authentifizierung verwenden. Confluence verwendet den OAuth-Authentifizierungsstandard, der erfordert, dass der authentifizierende Benutzer über den Browser mit Confluence interagiert. Bitte beachten Sie, dass OAuth 2.0 nur für Confluence Cloud unterstützt wird.

Erstellen einer OAuth-App

So erhalten Sie die OAuth-Clientanmeldeinformationen, den Consumer-Schlüssel und das Consumer-Geheimnis:

1. Melden Sie sich bei Ihrer Confluence Cloud-Site an.
2. Navigieren Sie zu Ihrem Bewerbungsmanagement (https://developer.atlassian.com/apps/).
3. Wählen Sie Create new app, dann benennen Sie die Anwendung. Die Anwendung wird erstellt.
4. Falls sie fehlt, fügen Sie Ihrer Anwendung OAuth 2.0-Funktionalität hinzu, indem Sie zu APIS UND FUNKTIONEN > + Hinzufügen > OAuth 2.0 hinzufügen (3LO) navigieren.
5. Von APIS AND FEATURES > + Add, fügen Sie hinzu Confluence platform REST API zu Ihrer Anwendung. Bitte beachten Sie, dass Sie auch die Confluence-Anwendung hinzufügen müssen, um alle Funktionen des Treiber zu erhalten.
6. Ab APIS AND FEATURES > + Confluence platform REST API, fügen Sie Ihrer Anwendung die gewünschten Bereiche hinzu.
7. Sie müssen auch Ihre Rückruf-URL festlegen. Navigieren Sie zu APIS AND FEATURES > OAuth 2.0 (3LO). Geben Sie eine URL ein, auf die Ihre Anwendung zugreifen kann, und speichern Sie die Änderungen.

Optimieren des Datenzugriffs

Optimieren des Datenzugriffs

Sie können die folgenden Eigenschaften verwenden, um mehr Kontrolle über die von Confluence zurückgegebenen Daten zu erhalten:

• IncludeArchivedSpaces: Inhalte aus archivierten Spaces in das Ergebnis einschließen. Standardmäßig ist dies „false“.
• SpaceKey: Suchergebnisse zeigen nur Inhalte aus dem angegebenen Bereich an.
• Timezone: Die Zeitzone der Confluence-Instanz. Die entsprechenden Datums-/Uhrzeitfilter werden verwendet, um Ergebnisse entsprechend der angegebenen Zeitzone abzurufen.

Wichtige Hinweise

Konfigurationsdateien und ihre Pfade

• Alle Verweise auf das Hinzufügen von Konfigurationsdateien und deren Pfaden beziehen sich auf Dateien und Speicherorte auf dem Jitterbit-Agenten, auf dem der Connector installiert ist. Diese Pfade sind je nach Agent und Operationssystem entsprechend anzupassen. Wenn mehrere Agenten in einer Agentengruppe verwendet werden, werden auf jedem Agenten identische Dateien benötigt.

Erweiterte Funktionen

In diesem Abschnitt wird eine Auswahl erweiterter Funktionen des Confluence-Connectors beschrieben.

Benutzerdefinierte Ansichten

Der Connector ermöglicht Ihnen die Definition virtueller Tabellen, sogenannter benutzerdefinierter Ansichten, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese Ansichten sind nützlich, wenn Sie die an die Treiber gesendeten Abfragen nicht direkt steuern können. Siehe Benutzerdefinierte Ansichten für einen Überblick über das Erstellen und Konfigurieren benutzerdefinierter Ansichten.

SSL-Konfiguration

Verwenden Sie SSL-Konfiguration, um anzupassen, wie der Connector TLS/SSL-Zertifikatsverhandlungen handhabt. Sie können aus verschiedenen Zertifikatsformaten wählen; siehe SSLServerCert-Eigenschaft unter „Verbindungszeichenfolgenoptionen“ für weitere Informationen.

Proxy

So konfigurieren Sie den Connector mit privaten Agent-Proxy-Einstellungen, wählen Sie die Use Proxy Settings Kontrollkästchen auf dem Verbindungskonfigurationsbildschirm.

Abfrageverarbeitung

Der Connector verlagert möglichst viel der Verarbeitung der SELECT-Anweisung auf Confluence und verarbeitet dann den Rest der Abfrage im Speicher (clientseitig).

Siehe Abfrageverarbeitung für weitere Informationen.

Benutzerdefinierte Ansichten

Mit dem Confluence-Connector können Sie eine virtuelle Tabelle definieren, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese werden als benutzerdefinierte Ansichten bezeichnet und sind in Situationen nützlich, in denen Sie die an den Treiber gesendete Abfrage nicht direkt steuern können, z. B. wenn Sie den Treiber von Jitterbit verwenden. Die benutzerdefinierten Ansichten können verwendet werden, um Prädikate zu definieren, die immer angewendet werden. Wenn Sie in der Abfrage an die Ansicht zusätzliche Prädikate angeben, werden diese mit der bereits als Teil der Ansicht definierten Abfrage kombiniert.

Es gibt zwei Möglichkeiten, benutzerdefinierte Ansichten zu erstellen:

• Erstellen Sie eine Konfigurationsdatei im JSON-Format, die die gewünschten Ansichten definiert.
• DDL-Anweisungen.

Definieren von Ansichten mithilfe einer Konfigurationsdatei

Benutzerdefinierte Ansichten werden in einer JSON-formatierten Konfigurationsdatei namens UserDefinedViews.json. Der Connector erkennt die in dieser Datei angegebenen Ansichten automatisch.

Sie können auch mehrere Ansichtsdefinitionen haben und diese mit steuern UserDefinedViews Verbindungseigenschaft. Wenn Sie diese Eigenschaft verwenden, werden vom Connector nur die angegebenen Ansichten angezeigt.

Diese Konfigurationsdatei für benutzerdefinierte Ansichten ist wie folgt formatiert:

• Jedes Stammelement definiert den Namen einer Ansicht.
• Jedes Stammelement enthält ein untergeordnetes Element namens query, das die benutzerdefinierte SQL- Abfrage für die Ansicht enthält.

Zum Beispiel:

{
    "MyView": {
        "query": "SELECT * FROM Pages WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Verwenden Sie die UserDefinedViews Verbindungseigenschaft, um den Speicherort Ihrer JSON-Konfigurationsdatei anzugeben. Beispiel:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Definieren von Ansichten mit DDL-Anweisungen

Der Connector kann das Schema auch über DDL-Anweisungen wie CREATE LOCAL VIEW, ALTER LOCAL VIEW und DROP LOCAL VIEW erstellen und ändern.

Erstellen einer Ansicht

Um eine neue Ansicht mit DDL-Anweisungen zu erstellen, geben Sie den Ansichtsnamen und die Abfrage wie folgt an:

CREATE LOCAL VIEW`[MeinAnsichtsname] `AS SELECT * FROM Customers LIMIT 20;

Wenn keine JSON-Datei vorhanden ist, erstellt der obige Code eine. Die Ansicht wird dann in der JSON-Konfigurationsdatei erstellt und ist nun erkennbar. Der Speicherort der JSON-Datei wird durch angegeben UserDefinedViews Verbindungseigenschaft.

Ändern einer Ansicht

Um eine vorhandene Ansicht zu ändern, geben Sie den Namen der vorhandenen Ansicht zusammen mit der neuen Abfrage an, die Sie stattdessen verwenden möchten:

ALTER LOCAL VIEW`[MeinAnsichtsname] `AS SELECT * FROM Customers WHERE TimeModified > '3/1/2020';

Die Ansicht wird dann in der JSON-Konfigurationsdatei aktualisiert.

Löschen einer Ansicht

Um eine vorhandene Ansicht zu löschen, geben Sie den Namen eines vorhandenen Schema neben der neuen Abfrage an, die Sie stattdessen verwenden möchten.

DROP LOCAL VIEW [MyViewName]

Dadurch wird die Ansicht aus der JSON-Konfigurationsdatei entfernt. Sie kann nicht mehr abgefragt werden.

Schema für benutzerdefinierte Ansichten

Benutzerdefinierte Ansichten werden im angezeigt UserViews Schema standardmäßig. Dies geschieht, um zu vermeiden, dass der Name der Ansicht mit einer tatsächlichen Entität im Datenmodell kollidiert. Sie können den Namen des für UserViews verwendeten Schema ändern, indem Sie festlegen UserViewsSchemaName Eigentum.

Arbeiten mit benutzerdefinierten Ansichten

Beispielsweise eine SQL-Anweisung mit einer benutzerdefinierten Ansicht namens UserViews.RCustomers listet nur Kunden in Raleigh auf:

SELECT * FROM Customers WHERE City = 'Raleigh';

Ein Beispiel für eine Abfrage an den Treiber:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Daraus ergibt sich die effektive Abfrage an die Quelle:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Dies ist ein sehr einfaches Beispiel für eine Abfrage an eine benutzerdefinierte Ansicht, die tatsächlich eine Kombination aus der Abfrage und der Ansichtsdefinition ist. Es ist möglich, diese Abfragen in viel komplexeren Mustern zusammenzustellen. Alle SQL-Operationen sind in beiden Abfragen zulässig und werden bei Bedarf kombiniert.

SSL-Konfiguration

Anpassen der SSL-Konfiguration

Standardmäßig versucht der Connector, SSL/TLS auszuhandeln, indem er das Zertifikat des Servers mit dem vertrauenswürdigen Zertifikatspeicher des Systems vergleicht.

Um ein anderes Zertifikat anzugeben, siehe SSLServerCert Eigenschaft für die verfügbaren Formate, um dies zu tun.

Client-SSL-Zertifikate

Der Confluence-Connector unterstützt auch das Festlegen von Client-Zertifikaten. Legen Sie Folgendes fest, um eine Verbindung mithilfe eines Client-Zertifikats herzustellen.

• SSLClientCert: Der Name des Zertifikatspeichers für das Client-Zertifikat.
• SSLClientCertType: Der Typ des Schlüsselspeichers, der das TLS/SSL-Clientzertifikat enthält.
• SSLClientCertPassword: Das Passwort für das TLS/SSL-Client-Zertifikat.
• SSLClientCertSubject: Der Betreff des TLS/SSL-Client-Zertifikats.

Confluence Cloud-Datenmodell

Überblick

Dieser Abschnitt zeigt die verfügbaren API Objekte und bietet weitere Informationen zur Ausführung von SQL für Confluence APIs.

Hauptmerkmale

• Der Connector modelliert Confluence Entitäten wie Seiten, Blogbeiträge, Kommentare, Anhänge, Bereiche, Prüfdatensätze und Benutzer als relationale Ansichten, sodass Sie SQL schreiben können, um Confluence Daten Abfrage.
• Die Live-Konnektivität zu diesen Objekten bedeutet, dass alle Änderungen an Ihrem Confluence-Konto bei Verwendung des Connectors sofort berücksichtigt werden.

Ansichten

Ansichten beschreibt die verfügbaren Ansichten. Ansichten werden statisch definiert, um AuditRecords, Seiten, Blogposts, Kommentare, Anhänge, Mitwirkende, Labels, Spaces und Benutzer zu modellieren.

Ansichten

Ansichten ähneln Tabellen in der Art und Weise, wie Daten dargestellt werden; Ansichten sind jedoch schreibgeschützt.

Abfragen können für eine Ansicht ausgeführt werden, als wäre sie eine normale Tabelle.

Confluence Connector-Ansichten

Anlagen

Informationen zu einem bestimmten Anhang erhalten.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Confluence API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Sie können auch mit CQL (Confluence Query Language) nach Anhängen suchen.

• Id unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• Type unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• Title unterstützt die Vergleiche '=,!=,LIKE,NOT LIKE,IN,NOT IN'.
• SpaceKey unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• SpaceType unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• CreatedByUserName unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• CreatedDate unterstützt die Vergleiche '=,!=,>,>=,<,<='.
• LastUpdatedDatetime unterstützt die Vergleiche '=,!=,>,>=,<,<='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SQL

SELECT * FROM Attachments WHERE Id = '1234'

SELECT * FROM Attachments WHERE Id IN ('1234', '2345')

SELECT * FROM Attachments WHERE Id = '294922' OR Type = 'attachment'

SELECT * FROM Attachments WHERE CreatedDate <= '2019/03/29 15:00' AND Id IN ('1234', '2345')

Zusätzlich können die Spalten Id, Type, Title, CreatedDate, CreatedByUserName und LastUpdatedDatetime in der ORDER BY-Klausel wie folgt verwendet werden:

SELECT * FROM Attachments ORDER BY Id DESC

SELECT * FROM Attachments ORDER BY CreatedByUserName ASC

CQL

Hinweis: Das Filtern mit CQL hat die höchste Priorität und alle anderen Filter außer „Auszug“ werden ignoriert, wenn in der Abfrage ein CQL-Filter vorhanden ist.

SELECT * FROM Attachments WHERE CQL = 'creator = currentUser() AND content = "1234" OR space.type = "global"'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Prüfaufzeichnungen

Rufen Sie eine paginierte Liste von AuditRecord-Instanzen ab, die bis zu einem bestimmten Zeitpunkt zurückreichen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Confluence API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• SearchString unterstützt die '='-Vergleiche.
• StartDate unterstützt die '='-Vergleiche.
• EndDate unterstützt die '='-Vergleiche.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM AuditRecords WHERE SearchString = 'your search string'

SELECT * FROM AuditRecords WHERE StartDate = '2019-08-12'

SELECT * FROM AuditRecords WHERE EndDate = '2019-08-15'

Spalten

Blogbeiträge

Erhalten Sie Informationen zu einem bestimmten Blogbeitrag.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Confluence API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Sie können auch mit CQL (Confluence Query Language) nach Anhängen suchen.

• Id unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• Type unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• Title unterstützt die Vergleiche '=,!=,LIKE,NOT LIKE,IN,NOT IN'.
• SpaceKey unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• SpaceType unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• CreatedByUserName unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• CreatedDate unterstützt die Vergleiche '=,!=,>,>=,<,<='.
• LastUpdatedDatetime unterstützt die Vergleiche '=,!=,>,>=,<,<='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SQL

SELECT * FROM Blogposts WHERE Id = '1234'

SELECT * FROM Blogposts WHERE Id IN ('1234', '2345')

SELECT * FROM Blogposts WHERE Id = '123458' AND Type = 'blogpost'


SELECT * FROM Blogposts WHERE CreatedDate <= '2019/03/29 15:00' AND ID IN ('1234', '2345')

Zusätzlich können die Spalten Id, Type, Title, CreatedDate, CreatedByUserName und LastUpdatedDatetime in der ORDER BY-Klausel wie folgt verwendet werden:

SELECT * FROM Blogposts ORDER BY Id DESC

SELECT * FROM Blogposts ORDER BY CreatedByUserName ASC

CQL

Hinweis: Das Filtern mit CQL hat die höchste Priorität und alle anderen Filter außer „Auszug“ werden ignoriert, wenn in der Abfrage ein CQL-Filter vorhanden ist.

SELECT * FROM Blogposts WHERE CQL = 'creator = currentUser() AND content = "1234" OR space.type = "global"'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Kommentare

Erhalten Sie Informationen zu einem bestimmten Kommentar.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Confluence API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Sie können auch mit CQL (Confluence Query Language) nach Anhängen suchen.

• Id unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• Type unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• Title unterstützt die Vergleiche '=,!=,LIKE,NOT LIKE,IN,NOT IN'.
• SpaceKey unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• SpaceType unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• CreatedByUserName unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• CreatedDate unterstützt die Vergleiche '=,!=,>,>=,<,<='.
• LastUpdatedDatetime unterstützt die Vergleiche '=,!=,>,>=,<,<='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SQL

SELECT * FROM Comments WHERE Id = '1234'

SELECT * FROM Comments WHERE Id IN ('1234', '2345')

SELECT * FROM Comments WHERE Id = '294922' OR Type = 'comment'



SELECT * FROM Comments WHERE CreatedDate <= '2019/03/29 15:00' AND ID IN ('1234', '2345')

Zusätzlich können die Spalten Id, Type, Title, CreatedDate, CreatedByUserName und LastUpdatedDatetime in der ORDER BY-Klausel wie folgt verwendet werden:

SELECT * FROM Comments ORDER BY Id DESC

SELECT * FROM Comments ORDER BY CreatedByUserName ASC

CQL

Hinweis: Das Filtern mit CQL hat die höchste Priorität und alle anderen Filter außer „Auszug“ werden ignoriert, wenn in der Abfrage ein CQL-Filter vorhanden ist.

SELECT * FROM Comments WHERE CQL = 'creator = currentUser() AND content = "1234" OR space.type = "global"'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Mitwirkende

Erhalten Sie Informationen über die Benutzer, die zum Inhalt beigetragen haben.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Confluence API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

Hinweis: ContentId ist erforderlich, um die Ansicht „Mitwirkende“ Abfrage.

• ContentId unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• AccountId unterstützt die Vergleiche '=,!=,IN,NOT IN'.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Contributors WHERE ContentId = '1234'

SELECT * FROM Contributors WHERE ContentId! = '1234'

SELECT * FROM Contributors WHERE ContentId IN ('1234', '2345')

SELECT * FROM Contributors WHERE ContentId NOT IN ('1234', '2345')

SELECT * FROM Contributors WHERE AccountId = '12345678'

SELECT * FROM Contributors WHERE AccountId! = '12345678'

SELECT * FROM Contributors WHERE AccountId IN ('12345678', '23456789')

SELECT * FROM Contributors WHERE AccountId NOT IN ('12345678', '23456789')

Zusätzlich kann die Spalte ContentId in der ORDER BY-Klausel wie folgt verwendet werden:

SELECT * FROM Contributors ORDER BY ContentId DESC

Spalten

Gruppenmitglieder

Benutzer einer bestimmten Gruppe abrufen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Confluence API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Name unterstützt die '='-Vergleiche.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM GroupMembers WHERE Name = 'test1'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Gruppen

Erhalten Sie Informationen zu einer bestimmten Gruppe.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Confluence API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Name unterstützt die '=,IN'-Vergleiche.
• Id unterstützt die '='-Vergleiche.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Groups WHERE Name = 'test'

SELECT * FROM Groups WHERE Name IN ('test1', 'test2')

SELECT * FROM Groups WHERE ID = 'ef75d879-6b69-4260-942a-ff5231e08be0'

Spalten

Labels

Erhalten Sie Informationen zu den Labels, die ein bestimmter Inhalt hat.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Confluence API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

Hinweis: ContentId ist erforderlich, um die Ansicht „Labels“ Abfrage.

• ContentId unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• LabelName unterstützt die Vergleiche '=,!=,IN,NOT IN'.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Labels WHERE ContentId = '1234'

SELECT * FROM Labels WHERE ContentId! = '1234'

SELECT * FROM Labels WHERE ContentId IN ('1234', '2345')

SELECT * FROM Labels WHERE ContentId NOT IN ('1234', '2345')

SELECT * FROM Labels WHERE LabelName = 'test'

SELECT * FROM Labels WHERE LabelName != 'test'

SELECT * FROM Labels WHERE LabelName IN ('test1', 'test2')

SELECT * FROM Labels WHERE LabelName NOT IN ('test1', 'test2')

Zusätzlich kann die Spalte ContentId in der ORDER BY-Klausel wie folgt verwendet werden:

SELECT * FROM Labels ORDER BY ContentId DESC

Spalten

SeiteVorfahren

Um eine Seitenhierarchie anzuzeigen, einschließlich der Angabe, wer die übergeordnete Seite ist.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Confluence API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden.

Hinweis: PageId ist erforderlich, um die PageAncestors-Ansicht Abfrage.

• PageId unterstützt den '='-Vergleich.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM PageAncestors WHERE PageId = '33106'
SELECT * FROM PageAncestors WHERE PageId IN ('163902', '33106')

Spalten

SeiteKinder

Um eine Seitenhierarchie anzuzeigen, einschließlich der Angabe, wer die untergeordnete Seite ist.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Confluence API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden.

Hinweis: PageId wird benötigt, um die PageChildrens-Ansicht Abfrage.

• PageId unterstützt den '='-Vergleich.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM PageChildrens WHERE PageId = '33106'
SELECT * FROM PageChildrens WHERE PageId IN ('163902', '33106')

Spalten

SeiteKommentare

Sehen Sie sich Kommentare speziell zu einer Seite an.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Confluence API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden.

Hinweis: PageId ist erforderlich, um die PageComments-Ansicht Abfrage.

• PageId unterstützt den '='-Vergleich.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM PageComments WHERE PageId = '163902'
SELECT * FROM PageComments WHERE PageId IN ('163902', '33106')

Spalten

Seiteninhalte

Inhalt von der Seite abrufen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Confluence API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden.

Hinweis: PageId wird benötigt, um die Seiteninhaltsansicht Abfrage.

• PageId unterstützt den '='-Vergleich.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM PageContents WHERE PageId = '163902'
SELECT * FROM PageContents WHERE PageId IN ('163902', '33106')

Spalten

Seiten

Informationen zu einer bestimmten Seite erhalten.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Confluence API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Sie können auch mit CQL (Confluence Query Language) nach Anhängen suchen.

• Id unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• Type unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• Title unterstützt die Vergleiche '=,!=,LIKE,NOT LIKE,IN,NOT IN'.
• SpaceKey unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• SpaceType unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• CreatedByUserName unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• CreatedDate unterstützt die Vergleiche '=,!=,>,>=,<,<='.
• LastUpdatedDatetime unterstützt die Vergleiche '=,!=,>,>=,<,<='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SQL

SELECT * FROM Pages WHERE Id = '1234'

SELECT * FROM Pages WHERE Id IN ('1234', '2345')

SELECT * FROM Pages WHERE Id = '294922' OR Type = 'page'


SELECT * FROM Pages WHERE CreatedDate <= '2019/03/29 15:00' AND ID IN ('1234', '2345')

Zusätzlich können die Spalten Id, Type, Title, CreatedDate, CreatedByUserName und LastUpdatedDatetime in der ORDER BY-Klausel wie folgt verwendet werden:

SELECT * FROM Pages ORDER BY Id DESC

SELECT * FROM Pages ORDER BY CreatedByUserName ASC

CQL

Hinweis: Das Filtern mit CQL hat die höchste Priorität und alle anderen Filter außer „Auszug“ werden ignoriert, wenn in der Abfrage ein CQL-Filter vorhanden ist.

SELECT * FROM Pages WHERE CQL = 'creator = currentUser() AND content = "1234" OR space.type = "global"'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Gemeinsam genutzte Bereiche

Gibt Informationen über eine Anzahl von Leerzeichen zurück.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Confluence API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Sie können auch mit CQL (Confluence Query Language) nach Anhängen suchen.

• Key unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• Name unterstützt die Vergleiche '=,LIKE,NOT LIKE'.
• Type unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• Excerpt unterstützt die '='-Vergleiche.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SQL

SELECT * FROM Spaces WHERE Key = 'abc'

SELECT * FROM Spaces WHERE Name IN ('name1', 'name2')

SELECT * FROM Spaces WHERE Excerpt = 'driver development'


SELECT * FROM Spaces WHERE Key = 'abc' AND Type = 'global'

CQL

Hinweis: Das Filtern mit CQL hat die höchste Priorität und alle anderen Filter außer „Auszug“ werden ignoriert, wenn in der Abfrage ein CQL-Filter vorhanden ist.

SELECT * FROM Spaces WHERE CQL = 'type = space AND space.title~"Driver Development"' AND Excerpt = 'indexed'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Aufgaben

Erhalten Sie Informationen zu Aufgaben.

Spalten

Benutzer

Informationen zu einem identifizierten Benutzer erhalten.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Confluence API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt. Sie können auch mit CQL (Confluence Query Language) nach Anhängen suchen.

• AccountId unterstützt die Vergleiche '=,!=,IN,NOT IN'.
• PublicName unterstützt die Vergleiche '=,LIKE,NOT LIKE'.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SQL

SELECT * FROM Users WHERE AccountId = '1234'

SELECT * FROM Users WHERE AccountId IN ('1234', '2345')


SELECT * FROM Users WHERE PublicName = 'confluenceuser'

CQL

Hinweis: Das Filtern mit CQL hat die höchste Priorität und alle anderen Filter außer „Auszug“ werden ignoriert, wenn in der Abfrage ein CQL-Filter vorhanden ist.

SELECT * FROM Users WHERE CQL = 'user.userKey = "4028d6096b696826016b696960860000" AND type = user' AND UserName = 'currentUser()'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

ZuschauerAnalyse

Ermitteln Sie die Gesamtzahl der unterschiedlichen Zuschauer eines Inhalts.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Confluence API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden.

• FromDate unterstützt den '='-Vergleich.
• ContentId unterstützt die Vergleiche '=,IN'.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ViewersAnalytics WHERE FromDate = '2023-01-02'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

AnsichtenAnalytics

Ermitteln Sie die Gesamtzahl der Aufrufe eines Inhalts.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Confluence API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden.

• FromDate unterstützt den '='-Vergleich.
• ContentId unterstützt die Vergleiche '=,IN'.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ViewsAnalytics WHERE FromDate = '2023-01-02'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen, die die Funktionalität des Connectors über einfache SELECT-Operationen mit Confluence hinaus erweitern.

Gespeicherte Prozeduren akzeptieren eine Liste von Parametern, führen ihre beabsichtigte Funktion aus und geben dann alle relevanten Antwortdaten von Confluence zurück, zusammen mit einer Angabe, ob die Prozedur erfolgreich war oder fehlgeschlagen ist.

Gespeicherte Prozeduren im Confluence Connector

Anhang herunterladen

Laden Sie den Anhang herunter, indem Sie seine ID angeben.

Eingang

Ergebnissatzspalten

GetOAuthAccessToken

Ruft ein Authentifizierungstoken von Confluence ab.

Eingang

Ergebnissatzspalten

GetOAuthAuthorizationURL

Ruft die Autorisierungs URL ab, die vom Benutzer separat geöffnet werden muss, um Zugriff auf Ihre Anwendung zu gewähren. Wird nur bei der Entwicklung von Web-Apps benötigt. Sie fordern das Authentifizierungstoken von dieser URL an.

Eingang

Ergebnissatzspalten

Aktualisieren Sie das OAuthAccessToken

Aktualisiert den OAuth-Zugriffstoken, der für die Authentifizierung bei Confluence verwendet wird.

Eingang

Ergebnissatzspalten

Systemtabellen

Sie können die in diesem Abschnitt beschriebenen Systemtabellen Abfrage, um auf Schema, Informationen zur Datenquellenfunktionalität und Statistiken zu Operation Charge.

Schematabellen

Die folgenden Tabellen geben Datenbankmetadaten für Confluence zurück:

• sys_catalogs: Listet die verfügbaren Datenbanken auf.
• sys_schemas: Listet die verfügbaren Schemata auf.
• sys_tables: Listet die verfügbaren Tabellen und Ansichten auf.
• sys_tablecolumns: Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.
• sys_procedures: Beschreibt die verfügbaren gespeicherten Prozeduren.
• sys_procedureparameters: Beschreibt Parameter gespeicherter Prozeduren.
• sys_keycolumns: Beschreibt die Primär- und Fremdschlüssel.
• sys_indexes: Beschreibt die verfügbaren Indizes.

Datenquellentabellen

Die folgenden Tabellen enthalten Informationen dazu, wie eine Verbindung zur Datenquelle hergestellt und diese Abfrage wird:

• sys_connection_props: Gibt Informationen zu den verfügbaren Verbindungseigenschaften zurück.
• sys_sqlinfo: Beschreibt die SELECT-Abfragen, die der Connector an die Datenquelle auslagern kann.

Abfrageinformationstabellen

Die folgende Tabelle gibt Abfrage für Datenänderungsabfragen zurück:

• Systemidentität: Gibt Informationen zu Charge oder einzelnen Updates zurück.

Sys_catalogs

Listet die verfügbaren Datenbanken auf.

Die folgende Abfrage ruft alle durch die Verbindungszeichenfolge ermittelten Datenbanken ab:

SELECT * FROM sys_catalogs

Spalten

Sys_schemas

Listet die verfügbaren Schemas auf.

Die folgende Abfrage ruft alle verfügbaren Schemata ab:

SELECT * FROM sys_schemas

Spalten

Sys_tables

Listet die verfügbaren Tabellen auf.

Die folgende Abfrage ruft die verfügbaren Tabellen und Ansichten ab:

SELECT * FROM sys_tables

Spalten

Sys_tablecolumns

Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.

Die folgende Abfrage gibt die Spalten und Datentypen für die Pages-Tabelle zurück:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Pages'

Spalten

Sys_procedures

Listet die verfügbaren gespeicherten Prozeduren auf.

Die folgende Abfrage ruft die verfügbaren gespeicherten Prozeduren ab:

SELECT * FROM sys_procedures

Spalten

Sys_procedureparameters

Beschreibt Parameter gespeicherter Prozeduren.

Die folgende Abfrage gibt Informationen zu allen Eingabeparametern für die gespeicherte Prozedur SelectEntries zurück:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='SelectEntries' AND Direction=1 OR Direction=2

Spalten

Sys_keycolumns

Beschreibt die Primär- und Fremdschlüssel.

Die folgende Abfrage ruft den Primärschlüssel für die Pages-Tabelle ab:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Pages'

Spalten

Sys_foreignkeys

Beschreibt die Fremdschlüssel.

Die folgende Abfrage ruft alle Fremdschlüssel ab, die auf andere Tabellen verweisen:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Spalten

Sys_primarykeys

Beschreibt die Primärschlüssel.

Die folgende Abfrage ruft die Primärschlüssel aus allen Tabellen und Ansichten ab:

SELECT * FROM sys_primarykeys

Spalten

Sys_indexes

Beschreibt die verfügbaren Indizes. Durch das Filtern nach Indizes können Sie selektivere Abfragen mit schnelleren Abfrage schreiben.

Die folgende Abfrage ruft alle Indizes ab, die keine Primärschlüssel sind:

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Spalten

Sys_connection_props

Gibt Informationen zu den verfügbaren Verbindungseigenschaften und den in der Verbindungszeichenfolge festgelegten Eigenschaften zurück.

Bei der Abfrage dieser Tabelle sollte die Konfigurationsverbindungszeichenfolge verwendet werden:

jdbc:cdata:confluence:config:

Mit dieser Verbindungszeichenfolge können Sie diese Tabelle ohne eine gültige Verbindung Abfrage.

Die folgende Abfrage ruft alle Verbindungseigenschaften ab, die in der Verbindungszeichenfolge festgelegt oder über einen Standardwert gesetzt wurden:

SELECT * FROM sys_connection_props WHERE Value <> ''

Spalten

Sys_sqlinfo

Beschreibt die SELECT- Abfrage, die der Connector an die Datenquelle auslagern kann.

Entdecken Sie die SELECT-Funktionen der Datenquelle

Nachfolgend sehen Sie einen Beispieldatensatz mit SQL-Funktionen. Einige Aspekte der SELECT-Funktionalität werden in einer durch Kommas getrennten Liste zurückgegeben, sofern sie unterstützt werden. Andernfalls enthält die Spalte NO.

Die folgende Abfrage ruft die Operatoren ab, die in der WHERE-Klausel verwendet werden können:

SELECT * FROM sys_sqlinfo WHERE Name = 'SUPPORTED_OPERATORS'

Beachten Sie, dass einzelne Tabellen unterschiedliche Einschränkungen oder Anforderungen an die WHERE-Klausel haben können; weitere Informationen finden Sie im Confluence Cloud-Datenmodell Abschnitt für weitere Informationen.

Spalten

Systemidentität

Gibt Informationen zu versuchten Änderungen zurück.

Die folgende Abfrage ruft die IDs der geänderten Zeilen in einer Operation Charge:

SELECT * FROM sys_identity

Spalten

Systeminformationen

Beschreibt die verfügbaren Systeminformationen.

Die folgende Abfrage ruft alle Spalten ab:

SELECT * FROM sys_information

Spalten

Erweiterte Konfigurationseigenschaften

Die erweiterten Konfigurationseigenschaften sind die verschiedenen Optionen, die zum Herstellen einer Verbindung verwendet werden können. Dieser Abschnitt enthält eine vollständige Liste der Optionen, die Sie konfigurieren können. Klicken Sie auf die Links, um weitere Einzelheiten zu erfahren.

Authentifizierung

SSO

OAuth

SSL

Schema

Verschiedenes

Authentifizierung

Dieser Abschnitt enthält eine vollständige Liste der Authentifizierungseigenschaften, die Sie konfigurieren können.

AuthScheme

Der bei der Verbindung mit Confluence zu verwendende Authentifizierungstyp.

Mögliche Werte

Auto, OAuth, Basic, APIToken, Crowd, OKTA

Datentyp

string

Standardwert

Auto

Hinweise

• Automatisch: Lässt den Treiber automatisch basierend auf den anderen von Ihnen festgelegten Verbindungseigenschaften entscheiden.
• OAuth: Legen Sie diese Option fest, um eine OAuth-Authentifizierung durchzuführen.
• Basic: Legen Sie diese Option fest, um die grundlegende Benutzer-/Passwort-Authentifizierung für Serverinstanzen zu verwenden.
• APIToken: Legen Sie dies fest, um die grundlegende Benutzer-/APIToken-Authentifizierung für Cloud-Instanzen zu verwenden.
• Crowd: Legen Sie dies fest, um eine Crowd-SSO-Authentifizierung durchzuführen.
• OKTA: Legen Sie dies fest, um eine OKTA SSO-Authentifizierung durchzuführen.

URL

Die URL zu Ihrem JIRA- Endpoint.

Datentyp

string

Standardwert

""

Hinweise

Die URL zu Ihrem JIRA- Endpoint, beispielsweise https://yoursitename.atlassian.net.

CloudId

Die Cloud-ID für die autorisierte Atlassian-Site.

Datentyp

string

Standardwert

""

Hinweise

Dies wird während der OAuth 2.0-Authentifizierung automatisch ermittelt und von der gespeicherten Prozedur GetOAuthAccessToken zurückgegeben. Legen Sie bei Verwendung von InitiateOAuth keinen Wert für CloudId fest.

Benutzer

Das zur Authentifizierung verwendete Confluence Benutzerkonto.

Datentyp

string

Standardwert

""

Hinweise

Zusammen mit Passwort, wird dieses Feld zur Authentifizierung gegenüber dem Confluence-Server verwendet.

Passwort

Das zur Authentifizierung des Benutzers verwendete Passwort.

Datentyp

string

Standardwert

""

Hinweise

Der Benutzer Und Password werden zusammen zur Authentifizierung beim Server verwendet.

APIToken

APIToken des aktuell authentifizierten Benutzers.

Datentyp

string

Standardwert

""

Hinweise

APIToken des aktuell authentifizierten Benutzers.

Zeitzone

Geben Sie die Zeitzone der Confluence-Instanz an, um die Datums-/Uhrzeitfilter entsprechend zu verwenden und die Ergebnisse entsprechend Ihrer Zeitzone abzurufen. Ein Beispiel für eine Zeitzone wäre America/New_York.

Datentyp

string

Standardwert

""

Hinweise

Hinweis: Sie können die Zeitzone in Ihrem Confluence-Server finden, indem Sie zu navigieren Settings -> General Configuration und dann im linken Bereich auf Systeminformationen klicken. In Ihrer Confluence Cloud sollte die Zeitzone eingestellt sein. Um sie einzustellen, navigieren Sie zu User Profile Symbol in der unteren linken Ecke und klicken Sie auf Settings. In diesem Abschnitt können Sie die Zeitzone einstellen, indem Sie auf klicken Edit Taste.

SSO

Dieser Abschnitt enthält eine vollständige Liste der SSO-Eigenschaften, die Sie konfigurieren können.

SSOLoginURL

Die Anmelde-URL des Identitätsanbieters.

Datentyp

string

Standardwert

""

Hinweise

Die Anmelde-URL des Identitätsanbieters.

SSO-Eigenschaften

Zusätzliche Eigenschaften, die für die Verbindung mit dem Identitätsanbieter erforderlich sind, in einer durch Semikolon getrennten Liste.

Datentyp

string

Standardwert

""

Hinweise

Zusätzliche Eigenschaften, die für die Verbindung mit dem Identitätsanbieter erforderlich sind, in einer durch Semikolon getrennten Liste. wird in Verbindung mit der SSOLoginURL verwendet.

Die SSO-Konfiguration wird weiter unten erläutert.

SSOExchangeUrl

Die URL, die zum Verwenden der SAML -Antwort und zum Austauschen gegen dienstspezifische Anmeldeinformationen verwendet wird.

Datentyp

string

Standardwert

""

Hinweise

Der Confluence-Connector verwendet die hier angegebene URL, um eine SAML -Antwort abzurufen und sie gegen dienstspezifische Anmeldeinformationen auszutauschen. Die abgerufenen Anmeldeinformationen sind das letzte Stück während der SSO-Verbindung, das zur Kommunikation mit Confluence verwendet wird.

SSOAppName

App-Name, der mit SSO für IdPs verwendet wird, die dies erfordern.

Datentyp

string

Standardwert

""

Hinweise

Zusammen mit SSOAppPassword, kann zur Identifizierung und Authentifizierung gegenüber Ihrer im SSO-IdP konfigurierten App angegeben werden. Derzeit wird dies nur von Crowd unterstützt.

SSOAppPassword

App-Passwort, das mit SSO für IdPs verwendet wird, die es benötigen.

Datentyp

string

Standardwert

""

Hinweise

Zusammen mit SSOAppName, kann zur Identifizierung und Authentifizierung gegenüber Ihrer im SSO-IdP konfigurierten App angegeben werden. Derzeit wird dies nur von Crowd unterstützt.

OAuth

Dieser Abschnitt enthält eine vollständige Liste der OAuth-Eigenschaften, die Sie konfigurieren können.

OAuth initiieren

Legen Sie diese Eigenschaft fest, um den Prozess zum Abrufen oder Aktualisieren des OAuth-Zugriffstokens beim Herstellen einer Verbindung zu starten.

Mögliche Werte

OFF, GETANDREFRESH, REFRESH

Datentyp

string

Standardwert

OFF

Hinweise

Folgende Optionen stehen zur Verfügung:

1. OFF: Gibt an, dass der OAuth-Flow vollständig vom Benutzer gehandhabt wird. Zur Authentifizierung ist ein OAuthAccessToken erforderlich.
2. GETANDREFRESH: Gibt an, dass der gesamte OAuth-Flow vom Connector verarbeitet wird. Wenn derzeit kein Token vorhanden ist, wird es durch eine entsprechende Aufforderung an den Benutzer über den Browser abgerufen. Wenn ein Token vorhanden ist, wird es bei Bedarf aktualisiert.
3. REFRESH: Gibt an, dass der Connector nur das Aktualisieren des OAuthAccessToken übernimmt. Der Benutzer wird vom Connector nie aufgefordert, sich über den Browser zu authentifizieren. Der Benutzer muss zunächst das Abrufen des OAuthAccessToken und des OAuthRefreshToken übernehmen.

OAuthVersion

Die verwendete OAuth-Version.

Mögliche Werte

1.0, 2.0

Datentyp

string

Standardwert

2.0

Hinweise

Die verwendete OAuth-Version. Folgende Optionen sind verfügbar: 1.0,2.0

OAuthClientId

Die Client-ID, die zugewiesen wird, wenn Sie Ihre Anwendung bei einem OAuth-Autorisierungsserver registrieren.

Datentyp

string

Standardwert

""

Hinweise

Im Rahmen der Registrierung einer OAuth-Anwendung erhalten Sie die OAuthClientId-Wert, manchmal auch Consumer-Schlüssel genannt, und ein Client-Geheimnis, das OAuthClientSecret.

OAuthClientSecret

Das Client-Geheimnis, das zugewiesen wird, wenn Sie Ihre Anwendung bei einem OAuth-Autorisierungsserver registrieren.

Datentyp

string

Standardwert

""

Hinweise

Im Rahmen der Registrierung einer OAuth-Anwendung erhalten Sie die OAuthClientId, auch Consumer-Schlüssel genannt. Sie erhalten außerdem ein Client-Geheimnis, auch Consumer-Geheimnis genannt. Legen Sie das Client-Geheimnis im OAuthClientSecret Eigentum.

OAuth-Zugriffstoken

Der Zugriffstoken für die Verbindung per OAuth.

Datentyp

string

Standardwert

""

Hinweise

Der OAuthAccessToken Eigenschaft wird für die Verbindung per OAuth verwendet. Die OAuthAccessToken wird im Rahmen des Authentifizierungsprozesses vom OAuth-Server abgerufen. Es hat ein serverabhängiges Timeout und kann zwischen Anfragen wiederverwendet werden.

Das Zugriffstoken wird anstelle Ihres Benutzernamens und Passworts verwendet. Das Zugriffstoken schützt Ihre Anmeldeinformationen, indem es sie auf dem Server speichert.

Umfang

Dadurch werden die Bereiche bestimmt, die die OAuth-Anwendung von Confluence anfordert.

Datentyp

string

Standardwert

read:content:confluence read:content-details:confluence read:space-details:confluence read:analytics.content:confluence read:audit-log:confluence read:configuration:confluence read:page:confluence read:blogpost:confluence read:custom-content:confluence read:attachment:confluence read:comment:confluence read:template:confluence read:label:confluence read:content.permission:confluence read:content.property:confluence read:content.restriction:confluence read:content.metadata:confluence read:watcher:confluence read:group:confluence read:inlinetask:confluence read:relation:confluence read:space:confluence read:space.permission:confluence read:space.property:confluence read:space.setting:confluence read:user:confluence offline_access

Hinweise

Geben Sie den Umfang an, um den ersten Zugriff und das Aktualisierungstoken zu erhalten.

Standardmäßig fordert der Connector den Benutzer auf, alle erforderlichen Bereiche zu autorisieren. Wenn Sie dies überschreiben möchten, können Sie diese Eigenschaft auf eine durch Leerzeichen getrennte Liste von OAuth-Bereichen setzen. Bitte stellen Sie sicher, dass die OAuth-App-Einstellungen auch diese Bereiche haben.

OAuthSettingsLocation

Der Speicherort der Einstellungsdatei, in der OAuth-Werte gespeichert werden, wenn InitiateOAuth auf GETANDREFRESH oder REFRESH eingestellt ist. Alternativ können Sie diesen Speicherort im Speicher halten, indem Sie einen Wert angeben, der mit beginnt 'memory://'.

Datentyp

string

Standardwert

%APPDATA%\Confluence Data Provider\OAuthSettings.txt

Hinweise

Wenn InitiateOAuth ist auf gesetzt GETANDREFRESH oder REFRESH, der Connector speichert OAuth-Werte, damit der Benutzer die OAuth-Verbindungseigenschaften nicht manuell eingeben muss und die Anmeldeinformationen über Verbindungen oder Prozesse hinweg gemeinsam genutzt werden können.

Anstatt einen Dateipfad anzugeben, können Sie den Speicher verwenden. Speicherorte werden durch einen Wert angegeben, der mit beginnt 'memory://' gefolgt von einer eindeutigen Kennung für diesen Satz von Anmeldeinformationen (z. B. memory://user1). Die Kennung können Sie frei wählen, sie sollte jedoch für den Benutzer eindeutig sein. Im Gegensatz zur dateibasierten Speicherung, bei der die Anmeldeinformationen über Verbindungen hinweg bestehen bleiben, werden die Anmeldeinformationen bei der Speicherspeicherung in den statischen Speicher geladen und die Anmeldeinformationen werden für die Dauer des Prozesses unter Verwendung derselben Kennung zwischen Verbindungen geteilt. Um die Anmeldeinformationen außerhalb des aktuellen Prozesses beizubehalten, müssen Sie die Anmeldeinformationen vor dem Schließen der Verbindung manuell speichern. Auf diese Weise können Sie sie in der Verbindung festlegen, wenn der Prozess erneut gestartet wird. Sie können OAuth-Eigenschaftswerte mit einer Abfrage an abrufen sys_connection_propsSystemtabelle. Wenn mehrere Verbindungen mit denselben Anmeldeinformationen bestehen, werden die Eigenschaften aus der zuvor geschlossenen Verbindung gelesen.

Der Standardspeicherort ist „%APPDATA%\ Confluence Data Provider\OAuthSettings.txt“ mit %APPDATA% auf das Konfigurationsverzeichnis des Benutzers gesetzt. Die Standardwerte sind

• Windows: "register://%DSN"
• Unix: "%AppData%..."
• Mac: "%AppData%..."

wobei DSN der Name des aktuellen DSN ist, der in der offenen Verbindung verwendet wird.

Die folgende Tabelle listet den Wert von auf %APPDATA% nach Operationssystem:

Zertifikatsspeicher

Der für die Confluence Authentifizierung verwendete Zertifikatsspeicher.

Datentyp

string

Standardwert

""

Hinweise

Der Speicherort des Zertifikatspeichers für das Client-Zertifikat, das bei der Confluence Anwendungsauthentifizierung verwendet wird.

CertificateStorePassword

Das Kennwort des mit der Confluence-Authentifizierung verwendeten Zertifikatsspeichers.

Datentyp

string

Standardwert

""

Hinweise

Wenn der Zertifikatspeicher von einem Typ ist, der ein Passwort erfordert, wird diese Eigenschaft verwendet, um dieses Passwort anzugeben, damit der Zertifikatspeicher geöffnet werden kann.

Zertifikatsthema

Der Betreff des Zertifikats, das mit der Confluence Private Application-Authentifizierung verwendet wird.

Datentyp

string

Standardwert

""

Hinweise

Der Betreff des Client-Zertifikats, das bei der privaten Anwendungsauthentifizierung von Confluence verwendet wird.

Informationen zum Confluence Client SSL Auth Flow

Die private Anwendungsauthentifizierung von Confluence verwendet eine SSL-Client-Authentifizierung mit digitalen Zertifikaten.

Laden eines Zertifikats

Beim Laden eines Zertifikats wird das Betreff verwendet, um das Zertifikat im Speicher zu finden.

• Wenn keine genaue Übereinstimmung gefunden wird, wird der Speicher nach Betreffs durchsucht, die den Wert der Eigenschaft enthalten.
• Wenn immer noch keine Übereinstimmung gefunden wird, wird kein Zertifikat ausgewählt.
• Der spezielle Wert „*“ wählt das erste Zertifikat im Zertifikatspeicher aus.

Angeben des Betreffs

Der Zertifikatsbetreff ist eine durch Kommas getrennte Liste von Distinguished Name-Feldern und-Werten. Zum Beispiel „CN=www.server.com, OU=test, C=US, E=example@jbexample.com“. Allgemeine Felder und ihre Bedeutungen werden unten angezeigt.

Hinweis: Wenn ein Feldwert ein Komma enthält, muss es in Anführungszeichen gesetzt werden.

Zusätzliche Verbindungseigenschaften

Um das private Zertifikat anzugeben, müssen Sie festlegen CertificateSubject und die folgenden zusätzlichen Eigenschaften:

• CertificateStore
• Zertifikatsspeichertyp
• Zertifikatsspeicherkennwort

Zertifikatspeichertyp

Der Typ des Zertifikatspeichers, der mit der Confluence Private Application-Authentifizierung verwendet wird.

Mögliche Werte

USER, MACHINE, PFXFILE, PFXBLOB, JKSFILE, JKSBLOB, PEMKEY_FILE, PUBLIC_KEY_FILE, PUBLIC_KEY_BLOB, SSHPUBLIC_KEY_BLOB, P10BFILE, SSHPUBLIC_KEY_FILE, PPKFILE, XMLFILE, XMLBLOB

Datentyp

string

Standardwert

USER

Hinweise

Der Name des Zertifikatspeichers für das Client-Zertifikat, das bei der privaten Confluence-Anwendungsauthentifizierung verwendet wird. Die private Confluence-Anwendungsauthentifizierung verwendet eine SSL-Client-Authentifizierung mit digitalen Zertifikaten.

Angeben des Zertifikatspeichertyps

Der CertificateStoreType Eigenschaft kann einen der folgenden Werte annehmen:

Zugehörige Verbindungseigenschaften

Um das private Zertifikat anzugeben, müssen Sie möglicherweise zusätzlich zu die folgenden Eigenschaften festlegen CertificateStoreType:

• Zertifikatsspeicher: Legen Sie hier den Namen des Zertifikatspeichers fest. Beispielsweise „MY“ für einen Windows Zertifikatspeicher oder den Dateinamen eines Dateispeichers.
• Zertifikatspeicherkennwort: Wenn der Store passwortgeschützt ist, geben Sie hier das Passwort ein.
• CertificateSubject: Legen Sie dies auf den Betreff des Zertifikats fest. Um das Zertifikat im Speicher zu finden, führt der Connector eine Suche basierend auf dem angegebenen Betreff durch. Weitere Informationen finden Sie unter CertificateSubject-Feld für Einzelheiten.

OAuthVerifier

Der von der OAuth-Autorisierungs URL zurückgegebene Prüfcode.

Datentyp

string

Standardwert

""

Hinweise

Der von der OAuth-Autorisierungs URL zurückgegebene Prüfcode. Dieser kann auf Systemen verwendet werden, auf denen kein Browser gestartet werden kann, z. B. auf Headless-Systemen.

Authentifizierung auf Headless-Maschinen

Siehe, um die zu erhalten OAuthVerifier Wert.

OAuthSettingsLocation festlegen zusammen mit OAuthVerifier. Beim Verbinden tauscht der Connector die OAuthVerifier für die OAuth-Authentifizierungstoken und speichert sie verschlüsselt am angegebenen Speicherort. Setzen Sie InitiateOAuth zu GETANDREFRESH, um den Austausch zu automatisieren.

Sobald die OAuth-Einstellungsdatei generiert wurde, können Sie entfernen OAuthVerifier aus den Verbindungseigenschaften und verbinden Sie sich mit OAuthSettingsLocation festgelegt.

Um die OAuth-Tokenwerte automatisch zu aktualisieren, legen Sie OAuthSettingsLocation fest und setzen Sie zusätzlich InitiateOAuth zum AKTUALISIEREN.

OAuthRefreshToken

Das OAuth-Aktualisierungstoken für das entsprechende OAuth-Zugriffstoken.

Datentyp

string

Standardwert

""

Hinweise

Der OAuthRefreshToken Eigenschaft wird verwendet, um den OAuthAccessToken zu aktualisieren bei Verwendung der OAuth-Authentifizierung.

OAuthLäuftAbIn

Die Lebensdauer des OAuth AccessToken in Sekunden.

Datentyp

string

Standardwert

""

Hinweise

Mit OAuthTokenTimestamp kombinieren, um zu bestimmen, wann der AccessToken abläuft.

OAuthTokenTimestamp

Der Unix-Epochenzeitstempel in Millisekunden, als das aktuelle Zugriffstoken erstellt wurde.

Datentyp

string

Standardwert

""

Hinweise

Kombinieren Sie es mit OAuthExpiresIn, um zu bestimmen, wann das AccessToken abläuft.

SSL

Dieser Abschnitt enthält eine vollständige Liste der SSL-Eigenschaften, die Sie konfigurieren können.

SSLClientCert

Der TLS/SSL-Client-Zertifikatspeicher für die SSL-Client-Authentifizierung (bidirektionales SSL).

Datentyp

string

Standardwert

""

Hinweise

Der Name des Zertifikatspeichers für das Client-Zertifikat.

Der SSLClientCertType Feld gibt den Typ des durch angegebenen Zertifikatspeichers an SSLClientCert. Wenn der Store kennwortgeschützt ist, geben Sie das Kennwort in SSLClientCertPassword an.

SSLClientCert wird in Verbindung mit SSLClientCertSubject verwendet, um Client-Zertifikate anzugeben. Wenn SSLClientCert hat einen Wert und SSLClientCertSubject gesetzt ist, wird eine Suche nach einem Zertifikat eingeleitet. Siehe SSLClientCertSubject für weitere Informationen.

Die Bezeichnungen der Zertifikatsspeicher sind plattformabhängig.

Nachfolgend sind die Bezeichnungen der gebräuchlichsten Benutzer- und Maschinen-Zertifikatspeicher in Windows aufgeführt:

In Java ist der Zertifikatsspeicher normalerweise eine Datei, die Zertifikate und optionale private Schlüssel enthält.

Wenn der Zertifikatsspeichertyp PFXFile ist, muss diese Eigenschaft auf den Namen der Datei gesetzt werden. Wenn der Typ PFXBlob ist, muss die Eigenschaft auf den binären Inhalt einer PFX-Datei gesetzt werden (z. B. PKCS12-Zertifikatsspeicher).

SSLClientCertType

Der Typ des Schlüsselspeichers, der das TLS/SSL-Clientzertifikat enthält.

Mögliche Werte

USER, MACHINE, PFXFILE, PFXBLOB, JKSFILE, JKSBLOB, PEMKEY_FILE, PEMKEY_BLOB, PUBLIC_KEY_FILE, PUBLIC_KEY_BLOB, SSHPUBLIC_KEY_FILE, SSHPUBLIC_KEY_BLOB, P7BFILE, PPKFILE, XMLFILE, XMLBLOB

Datentyp

string

Standardwert

USER

Hinweise

Diese Eigenschaft kann einen der folgenden Werte annehmen:

SSLClientCertPassword

Das Passwort für das TLS/SSL-Client-Zertifikat.

Datentyp

string

Standardwert

""

Hinweise

Wenn der Zertifikatspeicher von einem Typ ist, der ein Passwort erfordert, wird diese Eigenschaft verwendet, um dieses Passwort zum Öffnen des Zertifikatspeichers anzugeben.

SSLClientCertSubject

Der Betreff des TLS/SSL-Client-Zertifikats.

Datentyp

string

Standardwert

*

Hinweise

Beim Laden eines Zertifikats wird der Betreff verwendet, um das Zertifikat im Speicher zu lokalisieren.

Wenn keine genaue Übereinstimmung gefunden wird, wird der Speicher nach Betreffs durchsucht, die den Wert der Eigenschaft enthalten. Wenn immer noch keine Übereinstimmung gefunden wird, wird die Eigenschaft auf eine leere Zeichenfolge gesetzt und kein Zertifikat ausgewählt.

Der spezielle Wert „*“ wählt das erste Zertifikat im Zertifikatspeicher aus.

Der Betreff des Zertifikats ist eine durch Kommas getrennte Liste von Distinguished Name-Feldern und-Werten. Beispiel: „CN=www.server.com, OU=test, C=US, E=support@company.com“. Die allgemeinen Felder und ihre Bedeutungen werden unten angezeigt.

Wenn ein Feldwert ein Komma enthält, muss es in Anführungszeichen gesetzt werden.

SSLServerCert

Das vom Server zu akzeptierende Zertifikat bei einer Verbindung über TLS/SSL.

Datentyp

string

Standardwert

""

Hinweise

Bei Verwendung einer TLS/SSL-Verbindung kann diese Eigenschaft verwendet werden, um das vom Server zu akzeptierende TLS/SSL-Zertifikat anzugeben. Jedes andere Zertifikat, dem der Computer nicht vertraut, wird abgelehnt.

Diese Eigenschaft kann folgende Formen annehmen:

Wenn nicht angegeben, wird jedes vom Computer vertrauenswürdige Zertifikat akzeptiert.

Zertifikate werden vom Computer basierend auf dem Trust Store des Systems als vertrauenswürdig validiert. Der verwendete Trust Store ist der für das System angegebene Wert „javax.net.ssl.trustStore“. Wenn für diese Eigenschaft kein Wert angegeben ist, wird der Standard-Trust Store von Java verwendet (z. B. JAVA_HOME\lib\security\cacerts).

Verwenden Sie „*“, um anzugeben, dass alle Zertifikate akzeptiert werden. Beachten Sie, dass dies aus Sicherheitsgründen nicht empfohlen wird.

Schema

Dieser Abschnitt enthält eine vollständige Liste der Schema, die Sie konfigurieren können.

Standort

Ein Pfad zum Verzeichnis, das die Schema enthält, die Tabellen, Ansichten und gespeicherte Prozeduren definieren.

Datentyp

string

Standardwert

%APPDATA%\Confluence Data Provider\Schema

Hinweise

Der Pfad zu einem Verzeichnis, das die Schema für den Connector enthält (.rsd-Dateien für Tabellen und Ansichten, .rsb-Dateien für gespeicherte Prozeduren). Der Ordnerspeicherort kann ein relativer Pfad vom Speicherort der ausführbaren Datei sein. Der Location Die Eigenschaft wird nur benötigt, wenn Sie Definitionen anpassen (z. B. einen Spaltennamen ändern, eine Spalte ignorieren usw.) oder das Datenmodell mit neuen Tabellen, Ansichten oder gespeicherten Prozeduren erweitern möchten.

Wenn nichts angegeben wird, ist der Standardspeicherort "%APPDATA%\ Confluence Data Provider\Schema" mit %APPDATA% wird auf das Konfigurationsverzeichnis des Benutzers eingestellt:

DurchsuchbareSchemas

Diese Eigenschaft beschränkt die gemeldeten Schemata auf eine Teilmenge der verfügbaren Schemata. Beispiel: BrowsableSchemas=SchemaA,SchemaB,SchemaC.

Datentyp

string

Standardwert

""

Hinweise

Das Auflisten der Schemata aus Datenbanken kann aufwändig sein. Die Bereitstellung einer Liste von Schemata in der Verbindungszeichenfolge verbessert die Leistung.

Tabellen

Diese Eigenschaft beschränkt die gemeldeten Tabellen auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Tabellen=TabelleA,TabelleB,TabelleC.

Datentyp

string

Standardwert

""

Hinweise

Das Auflisten der Tabellen aus einigen Datenbanken kann teuer sein. Die Bereitstellung einer Liste von Tabellen in der Verbindungszeichenfolge verbessert die Leistung des Connectors.

Diese Eigenschaft kann auch als Alternative zum automatischen Auflisten von Ansichten verwendet werden, wenn Sie bereits wissen, mit welchen Sie arbeiten möchten, und es sonst zu viele wären.

Geben Sie die gewünschten Tabellen in einer durch Kommas getrennten Liste an. Jede Tabelle sollte ein gültiger SQL-Bezeichner sein, wobei alle Sonderzeichen mit eckigen Klammern, Anführungszeichen oder Backticks maskiert werden. Beispiel: Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.

Beachten Sie, dass Sie beim Herstellen einer Verbindung zu einer Datenquelle mit mehreren Schemata oder Katalogen den vollqualifizierten Namen der Tabelle in dieser Eigenschaft angeben müssen, wie im letzten Beispiel hier, um Mehrdeutigkeiten zwischen Tabellen zu vermeiden, die in mehreren Katalogen oder Schemata vorhanden sind.

Ansichten

Beschränkt die gemeldeten Ansichten auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Ansichten=AnsichtA,AnsichtB,AnsichtC.

Datentyp

string

Standardwert

""

Hinweise

Das Auflisten der Ansichten aus einigen Datenbanken kann teuer sein. Die Bereitstellung einer Liste von Ansichten in der Verbindungszeichenfolge verbessert die Leistung des Connectors.

Diese Eigenschaft kann auch als Alternative zum automatischen Auflisten von Ansichten verwendet werden, wenn Sie bereits wissen, mit welchen Sie arbeiten möchten, und es sonst zu viele wären.

Geben Sie die gewünschten Ansichten in einer durch Kommas getrennten Liste an. Jede Ansicht sollte ein gültiger SQL-Bezeichner sein, wobei alle Sonderzeichen mit eckigen Klammern, Anführungszeichen oder Backticks maskiert werden. Beispiel: Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.

Beachten Sie, dass Sie beim Herstellen einer Verbindung zu einer Datenquelle mit mehreren Schemata oder Katalogen den vollqualifizierten Namen der Tabelle in dieser Eigenschaft angeben müssen, wie im letzten Beispiel hier, um Mehrdeutigkeiten zwischen Tabellen zu vermeiden, die in mehreren Katalogen oder Schemata vorhanden sind.

Verschiedenes

Dieser Abschnitt enthält eine vollständige Liste verschiedener Eigenschaften, die Sie konfigurieren können.

IncludeArchivedSpaces

Ob Inhalte aus archivierten Bereichen in das Ergebnis einbezogen werden sollen. Der Standardwert ist „false“.

Datentyp

bool

Standardwert

false

Hinweise

Wenn diese Eigenschaft auf „true“ gesetzt ist, werden Inhalte wie Kommentare, Anhänge, Seiten und Blogspots, die zu einem archivierten Bereich gehören, in das Ergebnis aufgenommen.

MaxRows

Begrenzt die Anzahl der zurückgegebenen Zeilen, wenn in der Abfrage keine Aggregation oder GROUP BY verwendet wird. Dies hat Vorrang vor LIMIT-Klauseln.

Datentyp

int

Standardwert

-1

Hinweise

Begrenzt die Anzahl der zurückgegebenen Zeilen, wenn in der Abfrage keine Aggregation oder GROUP BY verwendet wird. Dies hat Vorrang vor LIMIT-Klauseln.

Andere

Diese versteckten Eigenschaften werden nur in bestimmten Anwendungsfällen verwendet.

Datentyp

string

Standardwert

""

Hinweise

Die unten aufgeführten Eigenschaften sind für bestimmte Anwendungsfälle verfügbar. Für normale Anwendungsfälle und Funktionen von Treiber sollten diese Eigenschaften nicht erforderlich sein.

Geben Sie mehrere Eigenschaften in einer durch Semikolon getrennten Liste an.

Integration und Formatierung

Seitengröße

Die maximale Anzahl der Ergebnisse, die pro Seite von Confluence zurückgegeben werden sollen.

Datentyp

int

Standardwert

200

Hinweise

Der Pagesize Die Eigenschaft beeinflusst die maximale Anzahl von Ergebnissen, die pro Seite von Confluence zurückgegeben werden. Das Festlegen eines höheren Wertes kann zu einer besseren Leistung führen, allerdings auf Kosten des zusätzlichen Speichers, der pro verbrauchter Seite zugewiesen wird.

Pseudospalten

Diese Eigenschaft gibt an, ob Pseudospalten als Spalten in die Tabelle aufgenommen werden sollen oder nicht.

Datentyp

string

Standardwert

""

Hinweise

Diese Einstellung ist besonders hilfreich im Entity Framework, da Sie dort keinen Wert für eine Pseudospalte festlegen können, es sei denn, es handelt sich um eine Tabellenspalte. Der Wert dieser Verbindungseinstellung hat das Format „Tabelle1=Spalte1, Tabelle1=Spalte2, Tabelle2=Spalte3“. Sie können das Zeichen „*“ verwenden, um alle Tabellen und alle Spalten einzuschließen, z. B. „*=*“.

Leertaste

Durch Angabe des SpaceKey werden in den Suchergebnissen nur Inhalte aus diesem bestimmten Space angezeigt.

Datentyp

string

Standardwert

""

Hinweise

Wenn SpaceKey sowohl in der SQL- Abfrage als auch in einer Verbindungseigenschaft angegeben ist, hat der Wert in der SQL- Abfrage Vorrang vor der Verbindungseigenschaft.

Zeitüberschreitung

Der Wert in Sekunden, bis der Timeout-Fehler auftritt und der Operation abgebrochen wird.

Datentyp

int

Standardwert

60

Hinweise

Wenn Timeout = 0, Operationen werden nicht abgebrochen. Die Operationen werden ausgeführt, bis sie erfolgreich abgeschlossen sind oder bis ein Fehler auftritt.

Wenn Timeout abläuft und der Operation noch nicht abgeschlossen ist, löst der Connector eine Ausnahme aus.

BenutzerdefinierteAnsichten

Ein Dateipfad, der auf die JSON-Konfigurationsdatei verweist, die Ihre benutzerdefinierten Ansichten enthält.

Datentyp

string

Standardwert

""

Hinweise

Benutzerdefinierte Ansichten werden in einer JSON-formatierten Konfigurationsdatei namens UserDefinedViews.json. Der Connector erkennt die in dieser Datei angegebenen Ansichten automatisch.

Sie können auch mehrere Ansichtsdefinitionen haben und diese mit steuern UserDefinedViews Verbindungseigenschaft. Wenn Sie diese Eigenschaft verwenden, werden vom Connector nur die angegebenen Ansichten angezeigt.

Diese Konfigurationsdatei für benutzerdefinierte Ansichten ist wie folgt formatiert:

• Jedes Stammelement definiert den Namen einer Ansicht.
• Jedes Stammelement enthält ein untergeordnetes Element namens query, das die benutzerdefinierte SQL- Abfrage für die Ansicht enthält.

Zum Beispiel:

{
    "MyView": {
        "query": "SELECT * FROM Pages WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Verwenden Sie die UserDefinedViews Verbindungseigenschaft, um den Speicherort Ihrer JSON-Konfigurationsdatei anzugeben. Beispiel:

"UserDefinedViews", C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json

Beachten Sie, dass der angegebene Pfad nicht in Anführungszeichen steht.