This connector is a good starting point that implements a core set of the service's most common functions. You should expect to extend it by adding functions for the specific endpoints your workflow requires. Additionally, some configuration may be required in Asana to establish a connection with Tulip. Please review our [connectors](/r230/docs/<span translate=)">connector framework to learn more about how to build and modify connectors in Tulip.
To download the app, visit: [connectors](https://tulip.co/library/<span translate=)/asana-connector/">Library
Einführung
Asana ist ein umfassendes Tool für das Arbeitsmanagement, das Einzelpersonen und Teams dabei unterstützt, den Überblick über Aufgaben zu behalten, Verantwortlichkeiten zu delegieren, den Fortschritt zu überwachen und in Echtzeit zu kommunizieren. Durch die Bereitstellung einer zentralen Plattform für die Zusammenarbeit hilft Asana Teams, organisiert und fokussiert zu bleiben, und stellt sicher, dass Projekte termingerecht abgeschlossen werden.
Zweck
Mithilfe des Tulip-Asana-Konnektors können Sie Ihre Asana-Projekte, Aufgaben und Arbeitsbereiche in einer Tulip-Anwendung effektiv im Blick behalten. Darüber hinaus können Sie relevante Aufgabeninformationen bearbeiten oder sogar neue Karten direkt aus einer Tulip-App heraus erstellen.
API-Dokumentation
Die folgenden in diesem Dokument hervorgehobenen „ Connector Function “ basieren auf der Asana-API-Dokumentation.
Voraussetzungen
-
Erstellen Sie ein Konto bei Asana.com.
-
Entscheiden Sie, welche Authentifizierungsmethode für Sie am besten geeignet ist:
- Persönliches Zugriffstoken
- Dienstkonto
- OAuth
- OpenID Connect
-
Für diesen Anwendungsfall haben wir ein persönliches Zugriffstoken vorbereitet. Generieren Sie daher unter diesem Link ein PAT.
Tulip-Verbindungsdetails
Die folgenden Informationen müssen im HTTP-Konnektor von Tulip konfiguriert werden.
Ausgeführt auf: Cloud-Konnektor Host: app.asana.com Port: 443 TLS: Ja Authentifizierung: OAuth 2.0 (Bearer-Token) Präfix: Bearer Token: Geben Sie den im vorherigen Schritt generierten persönlichen Zugriffstoken ein.
Beispiel für einen vorgefertigten Connector Functions
GET – Projekte in einem Workspace auflisten
Gibt die kompakten Projekteinträge für eine gefilterte Auswahl von Projekten zurück. Verwenden Sie einen oder mehrere der bereitgestellten Parameter, um die zurückgegebenen Projekte zu filtern.
GET – Arbeitsbereiche auflisten
Gibt die kompakten Datensätze für alle Arbeitsbereiche zurück, die für den autorisierten Benutzer sichtbar sind.
GET – Mehrere Aufgaben nach Projekt-ID
Gibt die kompakten Aufgabendatensätze für alle Aufgaben innerhalb des angegebenen Projekts zurück, sortiert nach ihrer Priorität innerhalb des Projekts. Aufgaben können gleichzeitig in mehr als einem Projekt vorhanden sein.
GET – Informationen zu einem einzelnen Projekt
Gibt den vollständigen Projekteintrag für ein einzelnes Projekt zurück.
GET – Einzelne Aufgabe nach ID
Gibt den vollständigen Aufgabendatensatz für eine einzelne Aufgabe zurück.
GET – Teams nach Benutzer
Gibt die kompakten Datensätze aller Teams zurück, denen der angegebene Benutzer zugeordnet ist.
POST – Neue Aufgabe erstellen
Das Anlegen einer neuen Aufgabe ist ganz einfach: Senden Sie einen POST-Request an den Endpunkt /tasks mit einem Datenblock, der die Felder enthält, die Sie für die Aufgabe festlegen möchten. Nicht angegebene Felder erhalten Standardwerte.
Jede Aufgabe muss in einem bestimmten Arbeitsbereich erstellt werden, und dieser Arbeitsbereich kann nach der Festlegung nicht mehr geändert werden. Der Arbeitsbereich muss nicht explizit festgelegt werden, wenn Sie stattdessen Projekte oder eine übergeordnete Aufgabe angeben.
PUT – Aufgabenstatus auf „abgeschlossen“ ändern
Eine bestimmte, bereits vorhandene Aufgabe kann durch eine PUT-Anfrage an die URL dieser Aufgabe aktualisiert werden. Es werden nur die im Datenblock angegebenen Felder aktualisiert; nicht angegebene Felder bleiben unverändert.
Bei Verwendung dieser Methode sollten Sie am besten nur die Felder angeben, die Sie ändern möchten, da Sie sonst möglicherweise Änderungen überschreiben, die ein anderer Benutzer seit Ihrem letzten Abruf der Aufgabe vorgenommen hat.