Verbindungsdetails für monday.com

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 23.0.8804 des Connectors.

Erste Schritte

Unterstützung für die Montagsversion

Der Connector nutzt die Monday-API, um einen bidirektionalen Zugriff auf Monday zu ermöglichen.

Herstellen einer Verbindung

Verbinde dich mit Monday

Montag AuditLog API

Die Monday AuditLog API unterstützt nur die Authentifizierung über API Token.

So generieren Sie das API Token für das Prüfprotokoll:

1. Melden Sie sich bei Ihrem Monday-Konto an.
2. Rufen Sie den Admin-Bereich auf.
3. Navigieren Sie zu Security.
4. Klicken Sie auf die Tab „Audit“.
5. Klicken Sie auf Monitor by API. Montag zeigt das API Token an.

Nachdem Sie das API Token abgerufen haben, legen Sie die folgenden Verbindungseigenschaften fest:

• Schema=AuditLog
• AuthScheme=Token
• APIToken=Das Audit-Log API Token, das Sie gerade erhalten haben
• ** Domain**=https://yourdomain.monday.com

Sie können jetzt eine Verbindung zur Monday AuditLog API herstellen.

Montag GraphQL API

Die Monday GraphQL API unterstützt die Authentifizierung entweder über API Token oder den OAuth-Standard.

API Token

Um eine Verbindung zum Connector über ein API Token herzustellen, setzen Sie das AuthScheme Zu Token und erhalten Sie die APIToken wie folgt:

1. Melden Sie sich bei Ihrem Monday-Konto an.
2. Navigieren Sie zu Manage Applications im linken Bereich. Monday zeigt eine Liste der zu verwaltenden Anwendungen an.
3. Wählen Sie die Anwendung aus, für die Sie ein Token erstellen möchten. Möglicherweise müssen Sie zuerst eine Anwendung erstellen.
4. Um ein zu generieren APIToken, klick Create token.

OAuth

Monday unterstützt nur die OAuth-Authentifizierung. Um diese Authentifizierung für alle OAuth-Flows zu aktivieren, müssen Sie festlegen AuthScheme Zu OAuth, und Sie müssen eine benutzerdefinierte OAuth-Anwendung erstellen.

Die folgenden Unterabschnitte beschreiben, wie Sie sich bei Monday über drei gängige Authentifizierungsabläufe authentifizieren:

• Desktop: eine Verbindung zu einem Server auf dem lokalen Computer des Benutzers, die häufig zum Testen und Prototyping verwendet wird.
• Web: Zugriff auf Daten über eine gemeinsam genutzte Website.
• Headless Server: ein dedizierter Computer, der anderen Computern und ihren Benutzern Dienste zur Verfügung stellt und so konfiguriert ist, dass er ohne Monitor und Tastatur funktioniert.

Informationen zum Erstellen einer benutzerdefinierten OAuth-Anwendung finden Sie unter Erstellen einer benutzerdefinierten OAuth-Anwendung.

Eine vollständige Liste der in Monday verfügbaren Verbindungszeichenfolgeneigenschaften finden Sie unter Connection.

Desktop-Anwendungen

Um sich mit den Anmeldeinformationen für eine benutzerdefinierte OAuth-Anwendung zu authentifizieren, müssen Sie das OAuth-Zugriffstoken abrufen und aktualisieren. Danach können Sie eine Verbindung herstellen.

OAuth-Zugriffstoken abrufen und aktualisieren:

• InitiateOAuth = GETANDREFRESH. Wird verwendet, um automatisch die abzurufen und zu aktualisieren OAuthAccessToken.
• OAuthClientId = die Client-ID, die Ihnen bei der Registrierung Ihrer Anwendung zugewiesen wurde.
• OAuthClientSecret = das Client-Geheimnis, das Ihnen bei der Registrierung Ihrer Anwendung zugewiesen wurde.
• CallbackURL = die Umleitungs-URI, die bei der Registrierung Ihrer Anwendung definiert wurde.

Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint von Monday in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen.

Nachdem Sie der Anwendung Berechtigungen erteilt haben, schließt der Connector den OAuth-Prozess ab:

1. Der Connector erhält einen Zugriffstoken von Monday und verwendet ihn, um Daten anzufordern.
2. Die OAuth-Werte werden im in angegebenen Pfad gespeichert OAuthSettingsLocation. Diese Werte bleiben über Verbindungen hinweg bestehen.

Wenn das Zugriffstoken abläuft, aktualisiert der Connector es automatisch.

Automatische Aktualisierung des OAuth-Zugriffstokens:

Damit der Connector das OAuth-Zugriffstoken automatisch aktualisiert, gehen Sie wie folgt vor:

1. Wenn Sie zum ersten Mal eine Verbindung zu Daten herstellen, legen Sie die folgenden Verbindungsparameter fest:
   • InitiateOAuth = REFRESH.
   • OAuthClientId = die Client-ID in Ihren Anwendungseinstellungen.
   • OAuthClientSecret = das Client-Geheimnis in Ihren Anwendungseinstellungen.
   • OAuthAccessToken = der von zurückgegebene Zugriffstoken.
   • OAuthSettingsLocation = der Pfad, in dem der Connector die OAuth-Werte speichern soll, die über Verbindungen hinweg bestehen bleiben.
2. Legen Sie bei nachfolgenden Datenverbindungen Folgendes fest:
   • InitiateOAuth
   • OAuthSettingsLocation

Erstellen einer benutzerdefinierten OAuth-Anwendung

So erstellen Sie eine benutzerdefinierte OAuth-Anwendung zur Verwendung in Monday:

1. Melden Sie sich beim Dashboard Ihres Monday-Kontos an.
2. Klicken Sie auf das Avatar-Symbol und wählen Sie Developers.
3. Klicken Sie in „Meine Apps“ auf Create App.
4. Notieren Sie im Abschnitt „Grundlegende Informationen“ der neuen Anwendung die OAuthClientId Und OAuthClientSecret.
5. Aktivieren Sie im OAuth-Abschnitt der neuen Anwendung die folgenden Bereiche:
   • Bretter:lesen
   • Arbeitsbereiche: lesen
   • Benutzer:lesen
   • Konto:gelesen
   • Aktualisierungen:gelesen
   • Vermögenswerte: lesen
   • Tags: lesen
   • Teams:lesen
6. Wenn dies eine Desktop-App sein soll, geben Sie eine Weiterleitungs-URL von an http://localhost:3333.

GraphQL Einschränkungen

Jede GraphQL API hat ihre eigenen Einschränkungen und wir können nicht beliebig viele Knoten Abfrage, da jede Abfrage Kosten verursacht und die API einen Fehler zurückgibt, wenn der Connector die maximalen Kosten überschreitet. Die Abfrage ist direkt von den Seitengrößen abhängig. Der Connector verwendet seine eigenen Algorithmen zum Ermitteln der Seitengrößen, gibt Ihnen aber auch die Freiheit, diese nach Ihren Bedürfnissen anzupassen. Es gibt zwei Möglichkeiten, dieses Verhalten zu erreichen:

• Geben Sie benutzerdefinierte Seitengrößengewichte an, indem Sie einschließen "other:pageSizeWeights" Attribut. Nehmen wir an, wir haben eine Tabelle „Kunden“, die zwei verschachtelte GraphQl-Verbindungen hat, Unternehmen und Kunden. Wenn Sie ein bestimmtes Verhältnis zwischen diesen beiden Entitäten pro Abfrage wünschen, sagen wir 200 Kunden pro 1 Unternehmen, sollten Sie im entsprechenden Script„other:pageSizeWeights=1:200“ angeben. Der Vorteil dieses Attributs besteht darin, dass Sie unsere Logik zum Finden der optimalen Seitengröße basierend auf den Abfrage nicht umgehen.
• Geben Sie benutzerdefinierte Seitengrößen an, indem Sie einfügen "other:pageSizes" Attribut. Durch die Angabe dieses Attributs umgehen Sie jede Prüfung, die wir für die Abfrage durchführen. Seien Sie also vorsichtig, da es zu API Fehlern kommt, wenn Sie die maximalen Kosten pro Abfrage überschreiten. Beispiel: „other:pageSizeWeights=10,30“, ruft maximal 10 Unternehmen und maximal 30 Kunden pro Unternehmen in einer Abfrage ab.

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 Monday-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 die Verarbeitung der SELECT-Anweisung so weit wie möglich auf Montag und verarbeitet dann den Rest der Abfrage im Speicher (clientseitig).

Benutzerdefinierte Ansichten

Mit dem Jitterbit Connector für Monday 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 Invoices 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.

Datenmodell

Der Jitterbit Connector für Monday modelliert Monday-Objekte als relationale Tabellen und Ansichten. Ein Monday-Objekt hat Beziehungen zu anderen Objekten; in den Tabellen werden diese Beziehungen durch Fremdschlüssel ausgedrückt. Die folgenden Abschnitte zeigen die verfügbaren API Objekte und bieten weitere Informationen zum Ausführen von SQL für Monday APIs.

Schemas für die meisten Datenbankobjekte werden in einfachen, textbasierten Konfigurationsdateien definiert.

GraphQL API verwenden

Siehe GraphQL Datenmodell für die verfügbaren Entitäten in der GraphQL API.

Verwenden der AuditLog-API

Siehe AuditLog-Datenmodell für die verfügbaren Entitäten in der AuditLog-API.

GraphQL Datenmodell

Übersicht

Der Jitterbit Connector für Monday modelliert Monday-Objekte als relationale Tabellen und Ansichten.

Ein Monday-Objekt hat Beziehungen zu anderen Objekten in den Tabellen. Diese Beziehungen werden durch Fremdschlüssel ausgedrückt. Die folgenden Abschnitte zeigen die verfügbaren API Objekte und bieten weitere Informationen zur Ausführung von SQL für Monday-APIs.

Schemas für die meisten Datenbankobjekte werden in einfachen, textbasierten Konfigurationsdateien definiert.

Ansichten

Ansichten beschreibt die verfügbaren Ansichten. Ansichten werden statisch definiert, um Konten, Kunden, Produkte und mehr 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.

Jitterbit-Connector für Monday Views

Aktivitätsprotokolle

Das Board protokolliert Ereignisse.

Tabellenspezifische Informationen

Der Connector verwendet die Monday API, um einige der Filter zu verarbeiten. Der Connector verarbeitet andere Filter clientseitig innerhalb des Connectors. Sie können die clientseitige Ausführung der Abfrage deaktivieren, indem Sie SupportEnhancedSQL auf „false“ setzen. In diesem Fall führen alle Suchkriterien, die auf andere Spalten verweisen, zu inkonsistenten Daten.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet.

• BoardId unterstützt die Operatoren '=, IN'.
• UserId unterstützt die Operatoren '=, IN'.
• ColumnId unterstützt die Operatoren '=, IN'.
• GroupId unterstützt die Operatoren '=, IN'.
• ItemId unterstützt die Operatoren '=, IN'.
• CreatedAt unterstützt die Operatoren '=, >, >=, <, <='.

AUSWÄHLEN

SELECT * FROM ActivityLogs WHERE BoardId IN ('2307103055', '2182296646')
SELECT * FROM ActivityLogs WHERE UserId IN ('27278379', '28087608')
SELECT * FROM ActivityLogs WHERE ColumnId IN ('27278379', '28087608')
SELECT * FROM ActivityLogs WHERE GroupId IN ('27278379', '28087608')
SELECT * FROM ActivityLogs WHERE ItemId IN ('27278379', '28087608')
SELECT * FROM ActivityLogs WHERE CreatedAt > '2022-02-17 05:12:04.419' AND CreatedAt < '2022-02-17 05:12:04.861'

SELECT * FROM ActivityLogs WHERE CreatedAt >= '2022-02-17 05:12:04.419' AND CreatedAt <= '2022-02-17 05:12:04.861'

Spalten

Vermögenswerte

Erhalten Sie eine Sammlung von Assets nach IDs.

Tabellenspezifische Informationen

Der Connector verwendet die Monday API, um einige der Filter zu verarbeiten. Der Connector verarbeitet andere Filter clientseitig innerhalb des Connectors. Sie können die clientseitige Ausführung der Abfrage deaktivieren, indem Sie SupportEnhancedSQL auf „false“ setzen. In diesem Fall führen alle Suchkriterien, die auf andere Spalten verweisen, zu inkonsistenten Daten. Die folgenden Abfragen werden beispielsweise serverseitig verarbeitet.

• Id unterstützt die Operatoren '=, IN'.

SELECT

SELECT * FROM Assets WHERE Id = '397532775'

SELECT * FROM Assets WHERE ID IN ('397532775', '397532776')

Spalten

BoardItemsIntern

Holen Sie sich eine Sammlung von Board- und Artikel-IDs. Diese Ansicht ist nur für den internen Gebrauch bestimmt.

Spalten

Bretter

Holen Sie sich eine Sammlung von Boards.

Tabellenspezifische Informationen

Der Connector verwendet die Monday API, um einige der Filter zu verarbeiten. Der Connector verarbeitet andere Filter clientseitig innerhalb des Connectors. Sie können die clientseitige Ausführung der Abfrage deaktivieren, indem Sie SupportEnhancedSQL auf „false“ setzen. In diesem Fall führen alle Suchkriterien, die auf andere Spalten verweisen, zu inkonsistenten Daten.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet.

• Id unterstützt die Operatoren '=, IN'.
• BoardKind unterstützt die '='-Operatoren.

AUSWÄHLEN

SELECT * FROM Boards WHERE Id = '2182296646'
SELECT * FROM Boards WHERE Id IN ('2307103055', '2182296646', '2181960030')
SELECT * FROM Boards WHERE Id IN ('2307103055', '2182296646', '2181960030') AND BoardKind = 'public'

SELECT * FROM Boards WHERE BoardKind = 'public'

Spalten

BoardViews

Die Ansichten des Vorstands.

Tabellenspezifische Informationen

Der Connector verwendet die Monday API, um einige der Filter zu verarbeiten. Der Connector verarbeitet andere Filter clientseitig innerhalb des Connectors. Sie können die clientseitige Ausführung der Abfrage deaktivieren, indem Sie SupportEnhancedSQL auf „false“ setzen. In diesem Fall führen alle Suchkriterien, die auf andere Spalten verweisen, zu inkonsistenten Daten. Die folgenden Abfragen werden beispielsweise serverseitig verarbeitet.

• BoardId unterstützt die Operatoren '=, IN'.
• Type unterstützt die = Operator.

AUSWÄHLEN

SELECT * FROM BoardViews WHERE BoardId = '2182296646'
SELECT * FROM BoardViews WHERE Type = 'Chart'

SELECT * FROM BoardViews WHERE BoardId IN ('2182296646', '2181960030')

Spalten

Spalten

Die sichtbaren Spalten des Boards.

Tabellenspezifische Informationen

Der Connector verwendet die Monday API, um einige der Filter zu verarbeiten. Der Connector verarbeitet andere Filter clientseitig innerhalb des Connectors. Sie können die clientseitige Ausführung der Abfrage deaktivieren, indem Sie SupportEnhancedSQL auf „false“ setzen. In diesem Fall führen alle Suchkriterien, die auf andere Spalten verweisen, zu inkonsistenten Daten.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet.

• ID unterstützt die Operatoren '=, IN'.
• BoardId unterstützt die Operatoren '=, IN'.

SELECT

SELECT * FROM Columns WHERE ID = 'name'
SELECT * FROM Columns WHERE ID IN ('name', 'person')
SELECT * FROM Columns WHERE BoardId = '2182296646'

SELECT * FROM Columns BoardId IN ('2182296646', '2181960030')

Spalten

Spaltenwerte

Die Spaltenwerte des Artikels.

Tabellenspezifische Informationen

Der Connector verwendet die Monday API, um einige der Filter zu verarbeiten. Der Connector verarbeitet andere Filter clientseitig innerhalb des Connectors. Sie können die clientseitige Ausführung der Abfrage deaktivieren, indem Sie SupportEnhancedSQL auf „false“ setzen. In diesem Fall führen alle Suchkriterien, die auf andere Spalten verweisen, zu inkonsistenten Daten. Die folgenden Abfragen werden beispielsweise serverseitig verarbeitet.

• Id unterstützt die Operatoren '=, IN'.
• ItemId unterstützt die Operatoren '=, IN'.

SELECT

SELECT * FROM ColumnValues WHERE Id = 'person'
SELECT * FROM ColumnValues WHERE Id IN ('person', 'status')
SELECT * FROM ColumnValues WHERE ItemId IN ('2181853162', '2181853151')
SELECT * FROM ColumnValues WHERE ItemId = '2181853162'

SELECT * FROM ColumnValues WHERE ItemId = '2181853162' AND ID = 'status'

Spalten

Gruppen

Die sichtbaren Gruppen des Boards.

Tabellenspezifische Informationen

Der Connector verwendet die Monday API, um einige der Filter zu verarbeiten. Der Connector verarbeitet andere Filter clientseitig innerhalb des Connectors. Sie können die clientseitige Ausführung der Abfrage deaktivieren, indem Sie SupportEnhancedSQL auf „false“ setzen. In diesem Fall führen alle Suchkriterien, die auf andere Spalten verweisen, zu inkonsistenten Daten.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet.

• Id unterstützt die Operatoren '=, IN'.
• BoardId unterstützt die Operatoren '=, IN'.

SELECT

SELECT * FROM Groups WHERE Id = 'topics'
SELECT * FROM Groups WHERE Id IN ('topics', 'group_title')
SELECT * FROM Groups WHERE BoardId IN ('2182296646', '21822966')

SELECT * FROM Groups WHERE BoardId = '2182296646' AND ID = 'topics'

Spalten

Artikel

Holen Sie sich eine Sammlung von Artikeln.

Tabellenspezifische Informationen

Der Connector verwendet die Monday API, um einige der Filter zu verarbeiten. Der Connector verarbeitet andere Filter clientseitig innerhalb des Connectors. Sie können die clientseitige Ausführung der Abfrage deaktivieren, indem Sie SupportEnhancedSQL auf „false“ setzen. In diesem Fall führen alle Suchkriterien, die auf andere Spalten verweisen, zu inkonsistenten Daten.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet.

• Id unterstützt die '='-Operatoren.
• BoardId unterstützt die '='-Operatoren.
• ColumnId unterstützt die '='-Operatoren.
• ColumnValue unterstützt die Operatoren '=, IN'.

SELECT

SELECT * FROM Items ORDER BY CreatedAt DESC
SELECT * FROM Items WHERE Id = 2181917692
SELECT * FROM Items WHERE BoardId = '2181917679' AND ColumnId = 'text' AND ColumnValue = 'test'

SELECT * FROM Items WHERE BoardId = '2181917679' AND ColumnId = 'text' AND ColumnValue IN ('Working on it', 'test')

Spalten

Schlagwörter

Holen Sie sich eine Sammlung von Tags.

Tabellenspezifische Informationen

Der Connector verwendet die Monday API, um einige der Filter zu verarbeiten. Der Connector verarbeitet andere Filter clientseitig innerhalb des Connectors. Sie können die clientseitige Ausführung der Abfrage deaktivieren, indem Sie SupportEnhancedSQL auf „false“ setzen. In diesem Fall führen alle Suchkriterien, die auf andere Spalten verweisen, zu inkonsistenten Daten. Die folgenden Abfragen werden beispielsweise serverseitig verarbeitet.

• ID unterstützt die Operatoren '=, IN'.
• IsPrivate unterstützt die = Operator.

AUSWÄHLEN

SELECT * FROM Tags WHERE IsPrivate = true
SELECT * FROM Tags WHERE IsPrivate = false
SELECT * FROM Tags WHERE ID = '13327214'

SELECT * FROM Tags WHERE ID IN ('13327214', '13327217')

Spalten

Teams

Holen Sie sich eine Sammlung von Teams.

Tabellenspezifische Informationen

Der Connector verwendet die Monday API, um einige der Filter zu verarbeiten. Der Connector verarbeitet andere Filter clientseitig innerhalb des Connectors. Sie können die clientseitige Ausführung der Abfrage deaktivieren, indem Sie SupportEnhancedSQL auf „false“ setzen. In diesem Fall führen alle Suchkriterien, die auf andere Spalten verweisen, zu inkonsistenten Daten.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet.

• Id unterstützt die Operatoren '=, IN'.

SELECT

SELECT * FROM Teams WHERE Id = '565332'

SELECT * FROM Teams WHERE ID IN ('565332, 565333')

Spalten

Aktualisierungen

Holen Sie sich eine Sammlung von Updates.

Tabellenspezifische Informationen

Der Connector verwendet die Monday API, um einige der Filter zu verarbeiten. Der Connector verarbeitet andere Filter clientseitig innerhalb des Connectors. Sie können die clientseitige Ausführung der Abfrage deaktivieren, indem Sie SupportEnhancedSQL auf „false“ setzen. In diesem Fall führen alle Suchkriterien, die auf andere Spalten verweisen, zu inkonsistenten Daten. Die folgenden Abfragen werden beispielsweise serverseitig verarbeitet.

WÄHLEN

SELECT * FROM Updates

Spalten

Benutzer

Holen Sie sich eine Sammlung von Benutzern.

Tabellenspezifische Informationen

Der Connector verwendet die Monday API, um einige der Filter zu verarbeiten. Der Connector verarbeitet andere Filter clientseitig innerhalb des Connectors. Sie können die clientseitige Ausführung der Abfrage deaktivieren, indem Sie SupportEnhancedSQL auf „false“ setzen. In diesem Fall führen alle Suchkriterien, die auf andere Spalten verweisen, zu inkonsistenten Daten. Die folgenden Abfragen werden beispielsweise serverseitig verarbeitet.

• ID unterstützt die Operatoren '=, IN'.
• IsPending unterstützt die '='-Operatoren.
• IsGuest unterstützt die '='-Operatoren.
• Email unterstützt die Operatoren '=, IN'.

SELECT

SELECT * FROM Users ORDER BY CreatedAt DESC
SELECT * FROM Users WHERE IsPending = true
SELECT * FROM Users WHERE IsGuest = true
SELECT * FROM Users WHERE ID = '27278379'
SELECT * FROM Users WHERE ID IN ('27278379', '27278377')
SELECT * FROM Users WHERE Email = 'test@cdata.com'

SELECT * FROM Users WHERE Email IN ('test@cdata.com', 'test@gmail.com')

Spalten

Gespeicherte Prozeduren

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

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

Jitterbit-Connector für gespeicherte Prozeduren am Montag

GetOAuthAccessToken

Ruft den OAuth-Zugriffstoken von GitHub ab.

Eingang

Ergebnissatzspalten

GetOAuthAuthorizationURL

Ruft die GitHub Autorisierungs URL ab. Greifen Sie in einem Webbrowser auf die in der Ausgabe zurückgegebene URL zu. Dadurch wird das Zugriffstoken angefordert, das als Teil der Verbindungszeichenfolge zu GitHub verwendet werden kann.

Eingang

Ergebnissatzspalten

AuditLog-Datenmodell

Übersicht

Der Jitterbit Connector für Monday modelliert Monday-Objekte als relationale Tabellen und Ansichten.

Ein Monday-Objekt hat Beziehungen zu anderen Objekten in den Tabellen. Diese Beziehungen werden durch Fremdschlüssel ausgedrückt. Die folgenden Abschnitte zeigen die verfügbaren API Objekte und bieten weitere Informationen zur Ausführung von SQL für Monday-APIs.

Schemas für die meisten Datenbankobjekte werden in einfachen, textbasierten Konfigurationsdateien definiert.

Ansichten

Ansichten beschreibt die verfügbaren Ansichten. Ansichten werden statisch definiert, um AuditLogs 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.

Jitterbit-Connector für Monday Views

Prüfprotokolle

Das Board überwacht die Ereignisse im Protokoll.

Tabellenspezifische Informationen

Der Connector verwendet die Monday API, um einige der Filter zu verarbeiten. Der Connector verarbeitet andere Filter clientseitig innerhalb des Connectors. Sie können die clientseitige Ausführung der Abfrage deaktivieren, indem Sie SupportEnhancedSQL auf „false“ setzen. In diesem Fall führen alle Suchkriterien, die auf andere Spalten verweisen, zu inkonsistenten Daten.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet.

• Timestamp unterstützt die Operatoren '=, >, >=, <, <='.
• UserId unterstützt die = Betreiber.
• IpAddress unterstützt die = Betreiber.
• Event unterstützt die Operatoren '=, IN'.

Alle verfügbaren Werte für den Ereignisfilter sind unten aufgeführt und erklärt:

• export-board-activity-log: Logs Board Aktivitätsprotokoll-Export durch Benutzer
• export-account-data: Protokolliert den Export von Kontodaten durch Administratoren
• download-attachment: Protokolliert Dateidownloads von Benutzern
• export-board: Protokolliert Boardexporte von Benutzern
• export-dashboard: Protokolliert Dashboard-Exporte von Benutzern
• export-content-directory: Protokolliert Inhaltsverzeichnisexporte durch Administratoren
• login: Protokolliert die Anmeldungen der Benutzer am System
• forgot-password: Protokolliert „Passwort vergessen?“-Klicks der Benutzer auf der Anmeldeseite
• logout: Protokolliert die Abmeldungen der Benutzer vom System
• failed-login: Protokolliert fehlgeschlagene Anmeldeversuche der Benutzer
• user-reactivated: Protokolliert die Reaktivierung von Benutzern durch Administratoren
• user-deactivated: Protokolliert die Deaktivierung von Benutzern durch Administratoren
• user-details-deleted: Protokolliert die Löschung von Benutzern durch Administratoren
• user-invite: Protokolliert Benutzereinladungen aus dem System heraus
• cancel-user-invite: Protokolliert abgebrochene Benutzereinladungen aus dem System heraus
• user-role-change: Protokolliert Benutzertypänderungen durch Administratoren
• delete-board: Protokolliert das Löschen von Boards durch Benutzer
• delete-workspace: Protokolliert das Löschen von Arbeitsbereichen durch Benutzer
• create-team: Protokolliert die Teamerstellung durch Benutzer
• delete-team: Protokolliert die Teamlöschung durch Benutzer
• security-settings-change: Protokolliert Änderungen der Sicherheitseinstellungen durch Administratoren
• board-broadcast-enabled: Protokolliert die Aktivierung von Board-Übertragungen durch Benutzer
• add-user-to-team: Protokolliert die Hinzufügung von Benutzern zu Teams durch Benutzer
• remove-user-from-team: Protokolliert die Entfernung von Benutzern aus Teams durch Benutzer
• add-user-to-product: Protokolliert das Hinzufügen von Benutzern zu Work OS-Produkten
• remove-user-from-product: Protokolliert die Entfernung von Benutzern aus Work OS-Produkten
• add-team-to-product: Protokolliert die Hinzufügung von Teams zu Work OS-Produkten
• remove-team-from-product: Protokolliert die Entfernung von Teams aus Work OS-Produkten
• api-complexity-breach-over-time: Protokolliert API-Aufrufe, die das Kontolimit erreichen

AUSWÄHLEN

Die folgenden Abfragen werden serverseitig ausgeführt:

SELECT * FROM AuditLogs WHERE Timestamp >= '2022-01-01T07:30:00Z' AND Timestamp <= '2022-01-02T07:30:00Z'
SELECT * FROM AuditLogs WHERE Event IN ('export-board-activity-log', 'delete-board')
SELECT * FROM AuditLogs WHERE Timestamp >= '2022-01-01T07:30:00Z' AND Timestamp <= '2022-01-02T07:30:00Z' AND Event = 'delete-board' AND UserId = 27 AND IpAddress = '123.123'

Spalten

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 Montag 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 Tabelle „Rechnungen“ zurück:

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

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 SampleProcedure zurück:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='SampleProcedure' 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 Tabelle „Rechnungen“ ab:

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

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:monday: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 der 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; siehe 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

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

OAuth

SSL

Schema

Verschiedenes

Authentifizierung

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

Schema

Gibt an, welche Monday-API verwendet werden soll.

Mögliche Werte

GraphQL, AuditLog

Datentyp

string

Standardwert

GraphQL

Hinweise

Die verfügbaren Werte sind GraphQL und AuditLog.

AuthScheme

Die Art der Authentifizierung, die bei der Verbindung mit Monday verwendet werden soll.

Mögliche Werte

Token

Datentyp

string

Standardwert

Token

Hinweise

• Token: Legen Sie dies fest, um die Token-Authentifizierung am Montag durchzuführen.

• OAuth: Legen Sie dies fest, um die OAuth-Authentifizierung am Montag durchzuführen.

APIToken

Das API Token, das Sie von Ihrem Monday-Konto erhalten haben.

Datentyp

string

Standardwert

""

Hinweise

Registerkarte „Admin“

Wenn Sie ein Administratorbenutzer Ihres monday.com-Kontos sind, können Sie mit den folgenden Schritten über die Tab „Administrator“ auf Ihre API Token zugreifen:

1. Melden Sie sich bei Ihrem monday.com-Konto an.
2. Klicken Sie unten links auf Ihrem Bildschirm auf Ihren Avatar (Bildsymbol).
3. Wählen Sie im angezeigten Menü „Admin“ aus (hierfür benötigen Sie Administratorrechte).
4. Gehen Sie zum API Bereich.
5. Generieren Sie ein „API v2 Token“
6. Kopieren Sie Ihr Token.

Registerkarte „Entwickler“

Wenn Sie ein Mitgliedsbenutzer Ihres monday.com-Kontos sind, können Sie mit den folgenden Schritten über die Tab „Entwickler“ auf Ihre API Token zugreifen:

1. Melden Sie sich bei Ihrem monday.com-Konto an.
2. Klicken Sie unten links auf Ihrem Bildschirm auf Ihren Avatar (Bildsymbol).
3. Wählen Sie im angezeigten Menü „Entwickler“ aus.
4. Klicken Sie im oberen Menü auf das Dropdown-Menü „Entwickler“.
5. Wählen Sie im Dropdown-Menü die erste Option mit dem Titel „Meine Zugriffstoken“.
6. Klicken Sie auf die blaue Schaltfläche „Anzeigen“, um Ihr API Token anzuzeigen und zu kopieren.

Domain

Geben Sie die Domäne Ihres Monday-Kontos an. Nur erforderlich, wenn das AuditLog-Schema verwendet wird. Beispiel: https://yourdomain.monday.com.

Datentyp

string

Standardwert

""

Hinweise

Geben Sie die Domäne Ihres Monday-Kontos an. Nur erforderlich, wenn das AuditLog-Schema verwendet wird. Beispiel: https://yourdomain.monday.com

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.

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 über 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.

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 behalten, indem Sie einen Wert angeben, der mit beginnt 'memory://'.

Datentyp

string

Standardwert

%APPDATA%\Monday 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 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_props Systemtabelle. Wenn mehrere Verbindungen mit denselben Anmeldeinformationen bestehen, werden die Eigenschaften aus der zuvor geschlossenen Verbindung gelesen.

Der Standardspeicherort ist „%APPDATA%\Monday 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:

Rückruf-URL

Die OAuth-Rückruf URL, zu der bei der Authentifizierung zurückgekehrt werden soll. Dieser Wert muss mit der Rückruf-URL übereinstimmen, die Sie in Ihren App-Einstellungen angeben.

Datentyp

string

Standardwert

""

Hinweise

Während des Authentifizierungsprozesses leitet der OAuth-Autorisierungsserver den Benutzer an diese URL weiter. Dieser Wert muss mit der Rückruf URL übereinstimmen, die Sie in Ihren App-Einstellungen angeben.

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.

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%\Monday 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-Eigenschaft wird nur benötigt, wenn Sie Definitionen anpassen möchten (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%\Monday 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.

MaxPunkteProAnruf

Gibt an, wie viele Punkte ein Anruf kostet.

Datentyp

string

Standardwert

1000000

Hinweise

Die Gesamtkosten Ihrer Abfragen dürfen zu keinem Zeitpunkt 5.000.000 Punkte überschreiten.

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

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. „*=*“.

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 Invoices WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Verwenden Sie 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.