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
Bevezetés
Az Asana egy átfogó munkakezelő eszköz, amelyet úgy terveztek, hogy segítse az egyéneket és a csapatokat a feladatok nyomon követésében, a felelősségek delegálásában, az előrehaladás figyelemmel kísérésében és a valós idejű kommunikációban. Az Asana egy központi együttműködési platformot biztosít, amely segít a csapatoknak a szervezettség és a koncentráció fenntartásában, így biztosítva a projektek határidőre történő befejezését.
Cél
A Tulip–Asana-összekötő segítségével hatékonyan nyomon követheti Asana-projekteit, feladatait és munkaterületeit egy Tulip-alkalmazásban. Ezen felül módosíthatja a releváns feladatinformációkat, vagy akár új kártyákat is létrehozhat a Tulip-alkalmazásból.
API-dokumentáció
A dokumentumban kiemelt következő Connector Function az Asana API-dokumentációját használja .
Előfeltételek
-
Regisztráljon az Asana.com oldalon.
-
Döntse el, melyik hitelesítési módszer felel meg leginkább az Ön igényeinek:
- Személyes hozzáférési token
- Szolgáltatási fiók
- OAuth
- OpenID Connect
-
Ehhez az alkalmazási esethez személyes hozzáférési tokent készítettünk elő, ezért kérjük, generáljon egy PAT-ot ezen a linken.
Tulip-kapcsolat adatai
A következő információkat kell beállítani a Tulip HTTP-csatlakozóján.
Futtatási környezet: Cloud Connector HostHost: app.asana.comPort: 443TLS: IgenHitelesítés: OAuth 2.0 (Bearer Token)Előtag: BearerToken: Írja be az előző lépésben generált személyes hozzáférési tokent.
Előre elkészített példa Connector Functions
GET – Projektek listája egy munkaterületen
Visszaadja a szűrt projektek csoportjának tömörített projektrekordjait. A visszaadott projektek szűréséhez használja a megadott paraméterek közül egyet vagy többet.
GET – Munkaterületek listája
Visszaadja az engedélyezett felhasználó számára látható összes munkaterület rövidített rekordjait.
GET – Több feladat projektazonosító szerint
Visszaadja az adott projekten belüli összes feladat rövidített rekordjait, a projekten belüli prioritásuk szerint rendezve. Egy feladat egyszerre több projektben is szerepelhet.
GET – Egyetlen projekt adatai
Visszaad egy adott projekt teljes projektrekordját.
GET – Egyetlen feladat azonosító alapján
Visszaadja egy adott feladat teljes rekordját.
GET – Csapatok felhasználónként
Visszaadja az összes olyan csapat rövidített adatait, amelyekhez a megadott felhasználó hozzárendelve van.
POST – Új feladat létrehozása
Új feladat létrehozása egyszerű: csak el kell küldeni egy POST kérés a /tasks végponthoz egy adata blokkkal, amely tartalmazza a feladatnál beállítani kívánt mezőket. A meg nem adott mezők alapértelmezett értékeket kapnak.
Minden feladatot egy adott munkaterületen kell létrehozni, és ez a munkaterület a beállítás után nem módosítható. A munkaterületet nem szükséges kifejezetten megadni, ha helyette projekteket vagy egy szülőfeladatot jelöl meg.
PUT – Feladat állapotának módosítása „befejezett”-re
Egy adott, már létező feladat frissíthető úgy, hogy PUT-kérést küldünk a feladat URL-jére. Csak az adata blokkban megadott mezők frissülnek; a meg nem adott mezők változatlanok maradnak.
Ennek a módszernek a használatakor célszerű csak azokat a mezőket megadni, amelyeket módosítani szeretne, különben felülírhatja azokat a változásokat, amelyeket egy másik felhasználó hajtott végre azóta, hogy utoljára lekérdezte a feladatot.