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
Wprowadzenie
Asana to kompleksowe narzędzie do zarządzania pracą, zaprojektowane, aby pomagać osobom indywidualnym i zespołom w śledzeniu zadań, delegowaniu obowiązków, monitorowaniu postępów oraz komunikacji w czasie rzeczywistym. Zapewniając scentralizowaną platformę do współpracy, Asana pomaga zespołom zachować porządek i skupienie, gwarantując terminową realizację projektów.
Cel
Za pomocą łącznika Tulip – Asana możesz skutecznie śledzić swoje projekty, zadania i obszary robocze w Asanie w aplikacji Tulip. Ponadto możesz modyfikować wszelkie istotne informacje o zadaniach, a nawet tworzyć nowe karty z poziomu aplikacji Tulip.
Dokumentacja API
Następujące dokumenty Connector Function, o których mowa w niniejszym dokumencie, opierają się na dokumentacji API Asany.
Wymagania wstępne
-
Załóż konto na stronie Asana.com.
-
Zdecyduj, która metoda uwierzytelniania najbardziej Ci odpowiada:
- Osobisty token dostępu
- Konto usługowe
- OAuth
- OpenID Connect
-
W tym przypadku przygotowaliśmy osobisty token dostępu, dlatego wygeneruj PAT pod tym linkiem.
Szczegóły połączenia z Tulip
W łączniku HTTP Tulip należy skonfigurować następujące informacje.
Działa na: Cloud Connector HostHost: app.asana.comPort: 443TLS: TakUwierzytelnianie: OAuth 2.0 (token Bearer)Prefiks: BearerToken: Wprowadź osobisty token dostępu wygenerowany w poprzednim kroku.
Przykład gotowego kodu Connector Functions
GET — lista projektów w obszarze roboczym
Zwraca skrócone rekordy projektów dla określonego, przefiltrowanego zestawu projektów. Użyj jednego lub więcej z podanych parametrów, aby filtrować zwracane projekty.
GET — lista obszarów roboczych
Zwraca skrócone rekordy wszystkich przestrzeni roboczych widocznych dla autoryzowanego użytkownika.
GET — wiele zadań według identyfikatora projektu
Zwraca skrócone rekordy zadań dla wszystkich zadań w ramach danego projektu, uporządkowane według ich priorytetu w projekcie. Zadania mogą występować jednocześnie w więcej niż jednym projekcie.
GET — Informacje o pojedynczym projekcie
Zwraca pełny rekord projektu dla jednego projektu.
GET — pojedyncze zadanie według identyfikatora
Zwraca pełny rekord zadania dla pojedynczego zadania.
GET — zespoły według użytkownika
Zwraca skrócone rekordy wszystkich zespołów, do których przypisany jest dany użytkownik.
POST — Utwórz nowe zadanie
Utworzenie nowego zadania jest tak proste, jak wysłanie żądania POST do punktu końcowego /tasks wraz z blokiem danych zawierającym pola, które chcesz ustawić dla zadania. Wszelkie nieokreślone pola przyjmą wartości domyślne.
Każde zadanie musi zostać utworzone w konkretnym obszarze roboczym, a obszaru tego nie można zmienić po jego ustaleniu. Nie ma potrzeby wyraźnego określania obszaru roboczego, jeśli zamiast tego podasz projekty lub zadanie nadrzędne.
PUT – Zmiana statusu zadania na „zakończone”
Konkretne, istniejące zadanie można zaktualizować, wysyłając żądanie PUT na adres URL tego zadania. Zaktualizowane zostaną tylko pola podane w bloku danych; wszelkie nieokreślone pola pozostaną niezmienione.
Korzystając z tej metody, najlepiej jest określić tylko te pola, które chcesz zmienić, w przeciwnym razie możesz nadpisać zmiany wprowadzone przez innego użytkownika od czasu ostatniego pobrania zadania.
Kolejne kroki
- Dowiedz się więcej o Asanie tutaj.
- Dowiedz się więcej o łącznikach tutaj