Asana-Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 23.0.8895 des Connectors.

Erste Schritte

Unterstützung für Asana-Versionen

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

Herstellen einer Verbindung

Mit Asana verbinden

Sie können optional Folgendes festlegen, um die von Asana zurückgegebenen Daten zu verfeinern.

• WorkspaceId: Die global eindeutige Kennung (gid), die mit Ihrem Asana-Arbeitsbereich verknüpft ist, um nur Projekte aus dem angegebenen Arbeitsbereich zurückzugeben. Um Ihre Arbeitsbereichs-ID zu erhalten, navigieren Sie zu https://app.asana.com/api/1.0/workspaces während Sie bei Asana angemeldet sind. Dadurch wird ein JSON-Objekt mit Ihrem Workspace-Namen und Ihrer ID angezeigt.
• ProjectId: Die global eindeutige Kennung (gid), die mit Ihrem Asana-Projekt verknüpft ist, um nur Daten zurückzugeben, die dem angegebenen Projekt zugeordnet sind. Projekt-IDs finden Sie in der URL Ihres Projekts Overview Seite. Dies sind die Zahlen direkt nach /0/.

Authentifizieren Sie sich bei Asana

Asana verwendet den OAuth-Authentifizierungsstandard.

Benutzerkonten (OAuth)

AuthScheme muss auf gesetzt werden OAuth in allen Benutzerkonto-Flows.

Desktop-Anwendungen

Es wird eine eingebettete OAuth-Anwendung bereitgestellt, die die OAuth-Desktop-Authentifizierung vereinfacht. Alternativ können Sie eine benutzerdefinierte OAuth-Anwendung erstellen. Siehe Erstellen einer benutzerdefinierten OAuth-App für Informationen zum Erstellen benutzerdefinierter Anwendungen und Gründe dafür.

OAuth-Zugriffstoken abrufen und aktualisieren

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

• InitiateOAuth: GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Festlegen der zu vermeiden OAuthAccessToken.
• OAuthClientId (nur benutzerdefinierte Anwendungen): Die Client-ID, die Ihnen bei der Registrierung Ihrer App zugewiesen wurde.
• OAuthClientSecret (nur benutzerdefinierte Anwendungen): Das Client-Geheimnis, das Ihnen bei der Registrierung Ihrer App zugewiesen wurde.
• CallbackURL (nur benutzerdefinierte Anwendung): Die Umleitungs-URI, die bei der Registrierung Ihrer App definiert wurde. Beispiel: https://localhost:3333

Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint von Asana in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen. Der Connector schließt dann den OAuth-Prozess ab:

1. Der Connector erhält einen Zugriffstoken von Asana und verwendet ihn, um Daten anzufordern.
2. Die OAuth-Werte werden an dem in angegebenen Ort gespeichert OAuthSettingsLocation, um über mehrere Verbindungen hinweg bestehen zu bleiben.

Der Connector aktualisiert das Zugriffstoken automatisch, wenn es abläuft.

Dienstkonten

Um sich mit einem Serverkonto (nur Enterprise) zu authentifizieren, verwenden Sie ein persönliches Zugriffstoken, indem Sie diese Verbindungseigenschaften festlegen:

• InitiateOAuth: OFF.
• OAuthAccessToken: Ihr Zugriffstokenwert.

Weitere Informationen finden Sie in der Asana-Dokumentation für persönliche Zugriffstoken und Dienstkonten.

Erstellen einer benutzerdefinierten OAuth-App

Um ein zu erhalten OAuthClientId, OAuthClientSecret, Und CallbackURL, Sie müssen zuerst eine App erstellen, die mit Ihrem Asana-Konto verknüpft ist.

So erstellen Sie eine App, die mit Ihrem Asana-Konto verknüpft ist:

1. Melden Sie sich bei Ihrem Asana-Konto an.
2. Navigieren Sie zu My profile Settings > Apps > Manage Developer Apps oder https://app.asana.com/0/developer-console.
3. Unter My apps, wählen New app. Geben Sie den App-Namen an und wählen Sie dann Create app.
4. Sobald Ihre App erstellt ist, legen Sie fest Redirect URL Zu http://localhost:33333 (oder einen anderen verfügbaren Port Ihrer Wahl), dann wählen Sie add.

Sobald Sie mit der Erstellung einer neuen App fertig sind, wird diese auf Ihrem Bildschirm angezeigt. Von dort aus können Sie auf klicken View Client ID um die Ihrer neu erstellten App anzuzeigen OAuthClientId Und OAuthClientSecret.

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 Asana-Konnektors 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 Asana und verarbeitet dann den Rest der Abfrage im Speicher (clientseitig).

Siehe Abfrageverarbeitung für weitere Informationen.

Benutzerdefinierte Ansichten

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

Verwenden Sie UserDefinedViews Verbindungseigenschaft zur Angabe des Speicherorts Ihrer JSON-Konfigurationsdatei. 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

Überblick

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

Hauptmerkmale

• Der Connector modelliert Asana-Entitäten als relationale Ansichten, sodass Sie SQL schreiben können, um Asana Daten Abfrage.
• Gespeicherte Prozeduren ermöglichen Ihnen die Ausführung von Vorgängen in Asana, einschließlich des Abrufens und Aktualisierens des Zugriffstokens in OAuth 2.0.
• Die Live-Konnektivität zu diesen Objekten bedeutet, dass alle Änderungen an Ihrem Asana-Konto bei Verwendung des Connectors sofort angezeigt werden.
• IncludeCustomFields Mit der Verbindungseigenschaft können Sie benutzerdefinierte Felder für Aufgaben abrufen Ansicht. Setzen Sie diese Eigenschaft auf True, um diese Funktion zu aktivieren.

Ansichten

Ansichten beschreibt die verfügbaren Ansichten. Ansichten werden statisch definiert, um Projekte, Benutzer, Arbeitsbereiche und mehr zu modellieren.

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen zu Asana. Gespeicherte Prozeduren ermöglichen Ihnen die Ausführung von Vorgängen in Asana, einschließlich des Herunterladens von Dokumenten und des Verschiebens von Umschlägen.

Tabellen

Der Connector modelliert die Daten in Asana als Liste von Tabellen in einer relationalen Datenbank, die mit Standard-SQL-Anweisungen abgefragt werden können.

Asana Connector-Tabellen

Anlagen

Zum Löschen und Abfragen von Anhängen in Aufgaben.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Asana API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Die TaskId oder ID ist erforderlich, um eine Anfrage zu stellen, und der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt den '='-Vergleich.
• TaskId unterstützt den '='-Vergleich.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Attachments WHERE Id = '1134618934491707'

SELECT * FROM Attachments WHERE TaskId = '1128092964672854'

Löschen

Nachfolgend finden Sie ein Beispiel zum Löschen aus der Tabelle „Anhänge“:

DELETE FROM Attachments WHERE ID = '1134618934491707'

Spalten

ZielMitgliedschaft

Zum Erstellen, Löschen und Abfragen von Mitgliedschaften im Ziel.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Asana 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.

• Id unterstützt den '='-Vergleich.
• GoalId unterstützt den '='-Vergleich.
• MemberId unterstützt den '='-Vergleich.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM GoalMembership

SELECT * FROM GoalMembership WHERE Id = '1126938837961834'

SELECT * FROM GoalMembership WHERE MemberId = '1126938837961830'

SELECT * FROM GoalMembership WHERE GoalId = '1126938691750986'

Einfügen

GoalId und MemberId sind obligatorische Spalten zum Einfügen in die GoalMembership-Tabelle. Beispiel:

INSERT INTO GoalMembership (GoalId, MemberId) VALUES ('1161963899354167', '1126938837961830')

Löschen

Nachfolgend finden Sie ein Beispiel zum Löschen aus der GoalMembership-Tabelle:

DELETE FROM GoalMembership WHERE ID = '1161963899354167'

Spalten

Ziele

Zum Erstellen, Aktualisieren, Löschen und Abfragen der Zieltabelle.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Asana 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.

• Id unterstützt den '='-Vergleich.
• IsWorkspaceLevel unterstützt den '='-Vergleich.
• TeamId unterstützt den '='-Vergleich.
• TimeId unterstützt den '='-Vergleich.
• WorkspaceId unterstützt den '='-Vergleich.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Goals

SELECT * FROM Goals WHERE Id = '1126938837961834'

SELECT * FROM Goals WHERE IsWorkspaceLevel = 'false'

SELECT * FROM Goals WHERE TeamId = '122334345323466' AND WorkspaceId = '1126938837961830'

SELECT * FROM Goals WHERE TimeId = '1243436322145547'

SELECT * FROM Goals WHERE WorkspaceId = '1126938837961830'

Einfügen

Benutzer-ID und Ziele sind obligatorische Spalten zum Einfügen in die Tabelle „Ziele“. Beispiel:

INSERT INTO Goals (Name, DueOn, StartOn, IsWorkspaceLevel, liked, WorkspaceId, OwnerId, TimePeriodId) VALUES ('Sample Goal', '2023-10-31', '2023-09-15', 'false', 'false', '1203124527069362', '1203124437606434', '1203124434984659' )

Aktualisieren

Nachfolgend finden Sie ein Beispiel zum Aktualisieren einer Zieltabelle:

UPDATE Goals SET DueOn ='2023-10-20' WHERE ID = '1128092864672888'

Löschen

Nachfolgend finden Sie ein Beispiel zum Löschen aus der Tabelle „Ziele“:

DELETE FROM Goals WHERE ID = '1161963899354167'

Spalten

PortfolioItems

Elemente im Portfolio erstellen, löschen und abfragen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Asana API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Die PortfolioId ist erforderlich, um eine Anfrage zu stellen, und der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

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

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM PortfolioItems WHERE PortfolioId = '1173026173301164'

Einfügen

ProjectId und PortfolioId sind obligatorische Spalten zum Einfügen in die Tabelle PortfolioItems. Beispiel:

INSERT INTO PortfolioItems (ProjectId, PortfolioId) VALUES ('1173023668354420', '1173026173301164')

Löschen

Nachfolgend finden Sie ein Beispiel zum Löschen aus der Tabelle „PortfolioItems“:

DELETE FROM PortfolioItems WHERE ProjectId = '1173023668354420' AND PortfolioId = '1173026173301164'

Spalten

PortfolioMitgliedschaft

Zum Erstellen, Löschen und Abfragen von Mitgliedschaften im Portfolio.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Asana API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Die [WorkspaceId AND UserId] ODER PortfolioId ODER ID ist erforderlich, um eine Anfrage zu stellen, und der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt den '='-Vergleich.
• WorkspaceId unterstützt den '='-Vergleich.
• UserId unterstützt den '='-Vergleich.
• PortfolioId unterstützt den '='-Vergleich.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM PortfolioMembership WHERE WorkspaceId = '1172686716695308' AND UserId = '1172686741877880'

SELECT * FROM PortfolioMembership WHERE PortfolioId = '1172684730399265'

SELECT * FROM PortfolioMembership WHERE ID = '1172684730399266'

Einfügen

PortfolioId und UserId sind obligatorische Spalten zum Einfügen in die PortfolioMembership-Tabelle. Beispiel:

INSERT INTO PortfolioMembership (PortfolioId, UserId) VALUES ('1172684730399265', '1172686741877880')

Löschen

Nachfolgend finden Sie ein Beispiel zum Löschen aus der Tabelle „PortfolioMembership“:

DELETE FROM PortfolioMembership WHERE PortfolioId = '1172684730399265' AND UserId = '1172686741877880'

Spalten

Portfolios

Zum Erstellen, Aktualisieren, Löschen und Abfrage der Portfoliotabelle.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Asana API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Die [WorkspaceId AND OwnerId] ODER ID ist erforderlich, um eine Anfrage zu stellen, und der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt den '='-Vergleich.
• WorkspaceId unterstützt den '='-Vergleich.
• OwnerId unterstützt den '='-Vergleich.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Portfolios WHERE WorkspaceId = '1172686716695308' AND OwnerId = '1172686741877880'

SELECT * FROM Portfolios WHERE Id = '1172684730399265'

Einfügen

WorkspaceId ist eine obligatorische Spalte zum Einfügen in die Portfolios-Tabelle. Beispiel:

INSERT INTO Portfolios (Name, Color, WorkspaceId)  VALUES ('Test', 'dark-pink', '1172686716695308'

Aktualisieren

Nachfolgend finden Sie ein Beispiel zum Aktualisieren einer Portfoliotabelle:

"UPDATE Portfolios SET Name = 'IT-Test' WHERE ID = '1173026173301164'

Löschen

Nachfolgend finden Sie ein Beispiel zum Löschen aus der Tabelle „Portfolios“:

DELETE FROM Portfolios WHERE ID = '1172684730399265'

Spalten

ProjektMitgliedschaft

Zum Erstellen, Löschen und Abfragen von Mitgliedschaften im Projekt.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Asana 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.

• Id unterstützt den '='-Vergleich.
• ProjectId unterstützt den '='-Vergleich.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ProjectMembership WHERE Id = '1127092449876445'

SELECT * FROM ProjectMembership WHERE ProjectId = '1127092449876444'

Einfügen

UserId und ProjectId sind obligatorische Spalten zum Einfügen in die ProjectMembership-Tabelle. Beispiel:

INSERT INTO ProjectMembership (UserId, ProjectId) VALUES ('1161963899354167', '1128092964672848')

Löschen

Nachfolgend finden Sie ein Beispiel zum Löschen aus der ProjectMembership-Tabelle:

DELETE FROM ProjectMembership WHERE UserId = '1161963899354167' AND ProjectId = '1128092964672848'

Spalten

Projekte

So erstellen, aktualisieren, löschen und fragen Sie die Projekttabelle ab.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Asana 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.

• Id unterstützt den '='-Vergleich.
• workspaceId unterstützt den '='-Vergleich.
• TaskId unterstützt den '='-Vergleich.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM projects WHERE workspaceId = '1126938837961830'

SELECT * FROM projects WHERE Id = '1128092864672888'

SELECT * FROM projects WHERE TaskId = '1130092964672468'

Einfügen

WorkspaceId oder TeamId ist eine obligatorische Spalte zum Einfügen in die Projekttabelle. Beispiel:

INSERT INTO Projects (Name, Color, StartOn, WorkspaceId, DueOn, public, UserId) VALUES ('ProjectName', 'dark-pink', '2020-03-01', '1126938837961830', '2020-04-30', false, '1130062547672468')

Aktualisieren

Nachfolgend finden Sie ein Beispiel zum Aktualisieren einer Projekttabelle:

UPDATE Projects SET TeamId = '1129514033997890' WHERE ID = '1128092864672888'

Löschen

Nachfolgend finden Sie ein Beispiel zum Löschen aus der Projekttabelle:

DELETE FROM Projects WHERE ID = '1128092864672888'

Spalten

Projektstatus

Zum Erstellen, Löschen und Abfragen aus der Tabelle „ProjectStatuses“. Ein Projektstatus ist ein Update zum Fortschritt eines bestimmten Projekts und wird nach seiner Erstellung an alle Projektbegleiter gesendet.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Asana 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.

• Id unterstützt den '='-Vergleich.
• ProjectId unterstützt den '='-Vergleich.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ProjectStatuses WHERE Id = '1127092449876445'

SELECT * FROM ProjectStatuses WHERE ProjectId = '1127092449876444'

Einfügen

ProjectId ist eine obligatorische Spalte zum Einfügen in die ProjectStatuses-Tabelle. Beispiel:

INSERT INTO projectstatuses (Color, Title, Text, ProjectId) VALUES ('red', 'Status1', 'StatusNotes', '1127092449876444')

Löschen

Nachfolgend finden Sie ein Beispiel zum Löschen aus der Tabelle „ProjectStatuses“:

DELETE FROM ProjectStatuses WHERE ID = '1127092449876445'

Spalten

Abschnitte

Erstellen, Aktualisieren, Löschen und Abfragen aus der Abschnittstabelle. Ein Abschnitt ist eine Unterteilung eines Projekts, die Aufgaben zusammenfasst.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Asana 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.

• Id unterstützt den '='-Vergleich.
• ProjectId unterstützt den '='-Vergleich.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Sections WHERE Id = '1127092449876457'

SELECT * FROM Sections WHERE ProjectId = '1128092964672848'

Einfügen

ProjectId ist eine obligatorische Spalte zum Einfügen in die Sections-Tabelle. Beispiel:

INSERT INTO Sections (Name, ProjectId) VALUES ('SectionName', '1128092964672848')

Aktualisieren

Nachfolgend finden Sie ein Beispiel zum Aktualisieren einer Abschnittstabelle:

UPDATE Sections SET Name = 'IT-Pending' WHERE ID = '1127092449876457'

Löschen

Nachfolgend finden Sie ein Beispiel zum Löschen aus der Abschnittstabelle:

DELETE FROM Sections WHERE ID = '1127092449876457'

Spalten

Geschichten

Erstellen, Aktualisieren, Löschen und Abfragen aus der Story-Tabelle. Eine Story stellt eine Aktivität dar, die mit einem Objekt im Asana-System verknüpft ist. Storys werden vom System generiert, wenn Benutzer Aktionen ausführen, z. B. Aufgaben erstellen oder zuweisen oder Aufgaben zwischen Projekten verschieben.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Asana API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Die TaskId oder ID ist erforderlich, um eine Anfrage zu stellen, und der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt den '='-Vergleich.
• TaskId unterstützt den '='-Vergleich.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Stories WHERE Id = '1126938691750986'

SELECT * FROM Stories WHERE TaskId = '1129514033997892'

Einfügen

TaskId ist eine obligatorische Spalte zum Einfügen in die Stories-Tabelle. Beispiel:

INSERT INTO Stories (Text, TaskId, IsPinned) VALUES ('InProgress', '1129514033997892', false)

Aktualisieren

Nachfolgend finden Sie ein Beispiel zum Aktualisieren einer Stories-Tabelle:

UPDATE Stories SET Text = 'story line' WHERE ID = '1126938691750986'

Löschen

Nachfolgend finden Sie ein Beispiel zum Löschen aus der Story-Tabelle:

DELETE FROM Stories WHERE ID = '1126938691750986'

Spalten

Unteraufgaben

Zum Erstellen, Aktualisieren, Löschen und Abfrage der SubTasks-Tabelle.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Asana 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.

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

Beispielsweise wird die folgende Abfrage serverseitig verarbeitet und ist ein erforderlicher Filter:

SELECT * FROM SubTasks WHERE ParentTaskId = '1127092449876457'

Eine einfache SELECT Abfrage gibt nur die erste Ebene der Unteraufgaben zurück.

SELECT * FROM SubTasks

Unter einer Aufgabe können bis zu fünf Unteraufgabenebenen vorhanden sein. (Hinweis: Asana empfiehlt nicht die Verwendung von Unter-Unteraufgaben.) Wenn zusätzliche Unteraufgabenebenen erforderlich sind, kann eine Unterabfrage verwendet werden:

SELECT * FROM SubTasks WHERE ParentTaskId IN (SELECT ID FROM SubTasks)

Beim Ausführen einer Abfrage ohne ParentTaskId-Filter werden aufgrund des Asana API -Designs Unteraufgaben nur pro Aufgabe abgerufen. Der Connector Abfrage zuerst den Arbeitsbereich ab, um eine Liste von Projekten abzurufen. Anschließend wird für jedes Projekt eine separate Anfrage gestellt, um alle anwendbaren Aufgaben abzurufen. Für jede Aufgabe wird eine weitere Anfrage gestellt, um alle mit der Aufgabe verknüpften Unteraufgaben abzurufen. Theoretisch ähnelt dies der Ausführung der folgenden Abfrage:

SELECT * FROM SubTasks WHERE ParentTaskId IN (SELECT ID FROM Tasks WHERE ProjectId IN (SELECT ID FROM Projects))

Aufgrund der Anzahl der erforderlichen Anfragen kann die Leistung beeinträchtigt werden.

Einfügen

ParentTaskId ist eine obligatorische Spalte zum Einfügen in die Projekttabelle. Beispiel:

INSERT INTO SubTasks (ParentTaskId, Name, Assignee, AssigneeStatus, startOn, DueOn, Completed, ProjectId, Notes, ApprovalStatus, Followers) VALUES ('1167713816822372', 'subtask1', '1167715005778471', 'later', '2020-03-25', '2020-04-01', false, 1167713816822364, 'SubTask Notes', 'changes_requested', '1167715005778471')

Spalten

Schlagwörter

Zum Erstellen, Aktualisieren und Abfragen aus der Tag-Tabelle. Ein Tag ist eine Bezeichnung, die an jede Aufgabe in Asana angehängt werden kann. Es existiert in einem einzelnen Arbeitsbereich.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Asana 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.

• Id unterstützt den '='-Vergleich.
• WorkspaceId unterstützt den '='-Vergleich.
• TaskId unterstützt den '='-Vergleich.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Tags WHERE Id = '1129517083601713'

SELECT * FROM Tags WHERE WorkspaceId = '1126938837961830'

SELECT * FROM Tags WHERE TaskId = '1128092964672854'

Einfügen

Workspaceid ist eine obligatorische Spalte zum Einfügen in die Tags-Tabelle. Beispiel:

INSERT INTO Tags (Name, Color, WorkspaceId, Notes) VALUES ('TestTag', 'dark-blue', '1126938837961830', 'sample notes')

Aktualisieren

Nachfolgend finden Sie ein Beispiel zum Aktualisieren einer Tags-Tabelle:

UPDATE Tags SET Name = 'IT-1' WHERE ID = '1158271967831255'

Spalten

Aufgaben

Zum Erstellen, Aktualisieren, Löschen und Abfragen der Aufgabentabelle.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Asana 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.

• Id unterstützt den '='-Vergleich.
• ProjectId unterstützt den '='-Vergleich.
• Assignee unterstützt den '='-Vergleich.
• TagId unterstützt den '='-Vergleich.
• SectionId unterstützt den '='-Vergleich.
• UserTaskListId unterstützt den '='-Vergleich.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Tasks WHERE Id = '1127092449876457'

SELECT * FROM Tasks WHERE ProjectId = '1128092964672848'

SELECT * FROM Tasks WHERE Assignee = '1126938691750986' AND WorkspaceId = '1126938837961830'

SELECT * FROM Tasks WHERE Assignee = '1126938691750986'

SELECT * FROM tasks WHERE TagId = '1129517083601713'

SELECT * FROM tasks WHERE SectionId = '1127092449876457'

SELECT * FROM tasks WHERE UserTaskListId = '1126938837961837'

Wenn Sie eine Abfrage ohne einen der oben genannten Filter ausführen, müssen die Aufgaben aufgrund des Asana API -Designs pro Projekt abgerufen werden. Der Connector Abfrage zuerst den Arbeitsbereich ab, um eine Liste der Projekte abzurufen. Anschließend wird für jedes Projekt eine separate Anfrage gestellt, um alle anwendbaren Aufgaben abzurufen. Theoretisch ähnelt dies der Ausführung der folgenden Abfrage:

SELECT * FROM Tasks WHERE ProjectId IN (SELECT ID FROM Projects)

Aufgrund der Anzahl der erforderlichen Anfragen kann die Leistung beeinträchtigt werden. Beachten Sie, dass Aufgaben auch verwaist sein können und nicht zu einem Projekt gehören. Der Connector kann verwaiste Aufgaben nicht abrufen.

Einfügen

ProjectId ist eine obligatorische Spalte zum Einfügen in die Aufgabentabelle. Beispiel:

INSERT INTO Tasks (Name, Assignee, AssigneeStatus, startOn, DueOn, Completed, ProjectId, Notes, ApprovalStatus, Followers) VALUES ('Task1', '1167715005778471', 'later', '2020-03-25', '2020-04-01', false, 1167713816822364, 'TaskNotes', 'changes_requested', '1167715005778471')

Aktualisieren

Nachfolgend finden Sie ein Beispiel zum Aktualisieren einer Aufgabentabelle:

UPDATE Tasks SET Browser = 'ie' WHERE ID = '1167713816822371'

Löschen

Nachfolgend finden Sie ein Beispiel zum Löschen aus der Aufgabentabelle:

DELETE FROM Tasks WHERE ID = '1167713816822371'

Spalten

TeamMitgliedschaft

An stellt die Verbindung eines Benutzers zu einem Team dar.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Asana 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.

• Id unterstützt den '='-Vergleich.
• UserId unterstützt den '='-Vergleich.
• WorkspaceId unterstützt den '='-Vergleich.
• TeamId unterstützt den '='-Vergleich.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM TeamMembership WHERE UserId = '1126938691750986' AND WorkspaceId = '1126938837961830'

SELECT * FROM TeamMembership WHERE TeamId = '1126938837961832'

SELECT * FROM TeamMembership WHERE Id = '1126938837961832'

Einfügen

UserId und TeamId sind obligatorische Spalten zum Einfügen in die TeamMembership-Tabelle. Beispiel:

INSERT INTO TeamMembership (UserId, TeamId) VALUES ('1161963899354167', '1126938837961832')

Löschen

Nachfolgend finden Sie ein Beispiel zum Löschen aus der TeamMembership-Tabelle:

DELETE FROM TeamMembership WHERE UserId = '1161963899354167' AND TeamId = '1126938837961832'

Spalten

Teams

Ein Team dient dazu, verwandte Projekte und Personen innerhalb einer Organisation zusammenzufassen. Jedes Projekt in einer Organisation ist einem Team zugeordnet.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Asana 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.

• Id unterstützt den '='-Vergleich.
• WorkspaceId unterstützt den '='-Vergleich.
• UserId unterstützt den '='-Vergleich.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Teams WHERE Id = '1126938837961832'

SELECT * FROM Teams WHERE WorkspaceId = '1126938837961830'

SELECT * FROM Teams WHERE UserId = '1126938691750986' AND workspaceid = '1126938837961830'

Einfügen

WorkspaceId ist eine obligatorische Spalte zum Einfügen in die Teams-Tabelle. In der WorkspaceId kann nur die Organisations-ID zum Erstellen von Teams verwendet werden. Teams können nicht für Arbeitsbereiche erstellt werden, die nicht Teil einer Organisation sind. Beispiel:

INSERT INTO Teams (Name, Description, HTMLDescrption, WorkspaceId) VALUES ('Salessssk', 'sales developers should be members of this team.', '<body> <em>All</em> developers should be members of this team.</body>', '1126938837961830')

Spalten

Arbeitsbereichsmitgliedschaft

Zum Erstellen, Löschen und Abfragen von Mitgliedschaften im Arbeitsbereich.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Asana 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.

• Id unterstützt den '='-Vergleich.
• UserId unterstützt den '='-Vergleich.
• WorkspaceId unterstützt den '='-Vergleich.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM WorkspaceMembership WHERE WorkspaceId = '1126938837961830'

SELECT * FROM WorkspaceMembership WHERE UserId = '1126938691750986'

SELECT * FROM WorkspaceMembership WHERE ID = '1126938837961834'

Einfügen

UserId und WorkspaceId sind obligatorische Spalten zum Einfügen in die WorkspaceMembership-Tabelle. Beispiel:

INSERT INTO WorkspaceMembership (UserId, WorkspaceId) VALUES ('1161963899354167', '1126938837961830')

Löschen

Nachfolgend finden Sie ein Beispiel zum Löschen aus der WorkspaceMembership-Tabelle:

DELETE FROM WorkspaceMembership WHERE UserId = '1161963899354167' AND WorkspaceId = '1126938837961830'

Spalten

Arbeitsbereiche

Zum Aktualisieren und Abfragen aus der Arbeitsbereichstabelle. Ein Arbeitsbereich ist die Organisationseinheit auf höchster Ebene in Asana. Alle Projekte und Aufgaben haben einen zugeordneten Arbeitsbereich.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Asana 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.

• Id unterstützt den '='-Vergleich.
• UserId unterstützt den '='-Vergleich.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Workspaces WHERE Id = '1126938837961835'

SELECT * FROM Workspaces WHERE UserId = '1126938691750986'

Aktualisieren

Nachfolgend finden Sie ein Beispiel zum Aktualisieren einer Workspaces-Tabelle:

UPDATE Workspaces SET Name = 'IT-Eng' WHERE ID = '1126938837961835'

Spalten

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.

Asana Connector-Ansichten

Benutzerdefinierte Felder

Um die benutzerdefinierten Felder im Projekt anzuzeigen.

Tabellenspezifische Informationen

Wählen

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

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

Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM CustomFields WHERE ProjectId = '1126938691750986'

Spalten

Veranstaltungen

Um die Ereignisse in Projekten und Aufgaben anzuzeigen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Asana API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Die Ressourcen-ID ist entweder die Projekt- oder die Aufgaben-ID. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

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

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Events WHERE ResourceId = '1128092964672854'

Spalten

ProjektFollower

Um die Details des Projekt-Followers anzuzeigen.

Spalten

Projektvorlagen

Um Projektvorlagen im Team oder Arbeitsbereich zu erhalten.

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.

Aufgabenstatus

Erhalten Sie die Aufgabenanzahl eines Projekts.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Asana 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.

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

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM TaskStatuses WHERE ProjectId = '1136437449978157'

Spalten

Benutzer

Um die Benutzerdetails anzuzeigen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Asana 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.

• Id unterstützt den '='-Vergleich.
• WorkspaceId unterstützt den '='-Vergleich.
• TeamId unterstützt den '='-Vergleich.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Users WHERE Id = '1126938691750986'

SELECT * FROM Users WHERE WorkspaceId = '1126938837961835'

SELECT * FROM Users WHERE TeamId = '1129514033997892'

Spalten

Benutzeraufgabenliste

Generierte Schema.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Asana API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Die [UserId und workspaceId] oder ID ist erforderlich, um eine Anfrage zu stellen, und der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt den '='-Vergleich.
• UserId unterstützt den '='-Vergleich.
• workspaceId unterstützt den '='-Vergleich.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM UserTaskList WHERE Id = '1126938837961837'

SELECT * FROM UserTaskList WHERE UserId = '1126938691750986' AND workspaceId = '1126938837961830'

Spalten

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen, die die Funktionalität des Connectors über einfache SELECT/INSERT/UPDATE/DELETE-Operationen mit Asana hinaus erweitern.

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

Gespeicherte Prozeduren im Asana Connector

AddDependenciesToTask

Aufgaben als Abhängigkeiten dieser Aufgabe festlegen, wenn sie nicht bereits Abhängigkeiten sind. Eine Aufgabe kann höchstens 15 Abhängigkeiten haben.

Eingang

Ergebnissatzspalten

AddDependentsToTask

Um abhängige Elemente für die Aufgabe festzulegen oder die Verknüpfung aufzuheben.

Eingang

Ergebnissatzspalten

Follower hinzufügen

Um Follower zu Aufgaben oder Projekten hinzuzufügen.

Eingang

Ergebnissatzspalten

ProjektZuAufgabeHinzufügen

Fügen Sie einer Aufgabe ein Projekt hinzu.

Eingang

Ergebnissatzspalten

TagsZuAufgabe hinzufügen

Um abhängige Elemente für die Aufgabe festzulegen oder die Verknüpfung aufzuheben.

Eingang

Ergebnissatzspalten

Aufgabe zu Abschnitt hinzufügen

Fügen Sie eine Aufgabe zu einem bestimmten, vorhandenen Abschnitt hinzu. Dadurch wird die Aufgabe aus anderen Abschnitten des Projekts entfernt.

Eingang

Anhang herunterladen

So laden Sie einen Anhang herunter.

Eingang

Ergebnissatzspalten

Projekt duplizieren

Um eine Kopie des Projekts zu erstellen.

Eingang

Ergebnissatzspalten

Duplikatsaufgabe

Um Abhängigkeiten zur Aufgabe festzulegen oder aufzuheben.

Eingang

Ergebnissatzspalten

GetOAuthAccessToken

Ruft ein Authentifizierungstoken von Asana 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 den OAuthAccessToken von dieser URL an.

Eingang

Ergebnissatzspalten

Abschnitte im Projekt verschieben

Um den Abschnitt im Projekt neu anzuordnen.

Eingang

Ergebnissatzspalten

Aktualisieren Sie das OAuthAccessToken

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

Eingang

Ergebnissatzspalten

EntfernenAbhängigkeitenAusTask

Um Abhängigkeiten zur Aufgabe festzulegen oder aufzuheben.

Eingang

Ergebnissatzspalten

EntfernenAbhängigevonAufgabe

Um abhängige Elemente für die Aufgabe festzulegen oder die Verknüpfung aufzuheben.

Eingang

Ergebnissatzspalten

Follower entfernen

Um Follower aus Aufgaben oder Projekten zu entfernen.

Eingang

Ergebnissatzspalten

Projekte aus Aufgabe entfernen

Ein Projekt aus einer Aufgabe entfernen.

Eingang

Ergebnissatzspalten

Tags aus der Aufgabe entfernen

Um abhängige Elemente für die Aufgabe festzulegen oder die Verknüpfung aufzuheben.

Eingang

Ergebnissatzspalten

Übergeordneteselementderaufgabesetzen

So legen Sie das übergeordnete Element einer Aufgabe fest.

Eingang

Ergebnissatzspalten

Anhang hochladen

Lädt einen Anhang zu Asana hoch.

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 Asana 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, einschließlich Charge:

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

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

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

SELECT * FROM sys_procedureparameters WHERE ProcedureName='UploadAttachment' 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 Projekttabelle ab:

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

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:asana: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

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.

Verbindung

OAuth

SSL

Schema

Verschiedenes

Verbindung

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

ProjektID

Die global eindeutige Kennung (GID), die Ihrem Asana-Projekt zugeordnet ist.

Datentyp

string

Standardwert

""

Hinweise

Anfragen geben die diesem Projekt zugeordneten Daten zurück.

Arbeitsbereichs-ID

Die global eindeutige Kennung (GID), die Ihrem Asana-Arbeitsbereich zugeordnet ist.

Datentyp

string

Standardwert

""

Hinweise

Anfragen geben die Projekte zurück, die dieser WorkspaceId zugeordnet sind.

Benutzerdefinierte Felder einschließen

Den Tabellen „Aufgaben“, „Unteraufgaben“ und „Portfolioelemente“ können benutzerdefinierte Felder hinzugefügt werden.

Datentyp

bool

Standardwert

false

Hinweise

Wenn auf TRUE gesetzt, können benutzerdefinierte Felder zu den Tabellen Tasks, SubTasks und PortfolioItems hinzugefügt werden. Die WorkspaceId sollte ebenfalls angegeben werden. Benutzerdefinierte Felder beziehen sich auf einen bestimmten Arbeitsbereich. Wenn keine WorkspaceId angegeben ist, wird die erste verfügbare WorkspaceId verwendet.

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

Datentyp

string

Standardwert

%APPDATA%\Asana 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%\ Asana 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

http://localhost:33333

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%\Asana 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%\ Asana 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.

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 projects 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.