Jegy eszközök

Áttekintés

A Jegyek eszközkategória egyetlen eszközt ad, a manage_ticket-et, amely mindent lefed, amit egy jegyen a vezérlőpultban is megtennél. Létrehozhatsz jegyeket, oszlopok közti mozgatással megváltoztathatod az állapotukat, átadhatod őket egy kollégának, felcímkézheted, belső jegyzetet írhatsz, amit csak a csapatod lát, és e-mailben válaszolhatsz annak az ügyfélnek, aki a problémát bejelentette.

Alapfogalmak

Két dolgot érdemes megérteni a táblákról, mielőtt használnád az eszközt, mert ez magyarázza a viselkedésének nagy részét.

Az oszlop maga az állapot

A tábla oszlopai maguk az állapotok — „Új”, „Folyamatban”, „Kész”, vagy amit a táblád meghatároz. Nincs külön állapotmező: egy jegy állapotát úgy változtatod meg, hogy áthelyezed egy másik oszlopba.

Az archiválás azt jelenti: „egyik oszlopban sincs”

Az a jegy, amelyik egyáltalán nincs oszlopban, archiválva van. Ez a teljes mechanizmus. Az archiválás leveszi a jegyet a tábláról, de megtartja, és ha egy archivált jegyet bármelyik oszlopba visszateszel, azzal kikerül az archívumból.

manage_ticket

Létrehoz egy jegyet, vagy módosít, archivál, illetve töröl egy meglévőt — és ugyanabban a hívásban megjegyzést is fűzhet hozzá, valamint e-mailt küldhet a bejelentőnek.

Paraméterek

Hogyan működik

Jegy létrehozása — hagyd el az id-t. A boardId és a title kötelező. A jegy a tábla első oszlopának aljára kerül, hacsak nem adsz meg boardColId-t. MEDIUM prioritással, olvasatlanul indul, és nem tartozik hozzá bejelentő, mert senki nem űrlapon keresztül küldte be — te kérted.

Jegy módosítása — add meg az id-t. Csak azok a mezők változnak, amelyeket ténylegesen átadsz; minden más érintetlen marad.

Archiválás — az action: "archive" leveszi a jegyet a tábláról, de megtartja az előzményeivel együtt. Nem kombinálható a boardColId-val: az archiválás azt jelenti, hogy „egyik oszlopban sincs”, tehát egy oszlop megnevezése ellentmond ennek, ezért elutasítjuk ahelyett, hogy csendben figyelmen kívül hagynánk. Egy archivált jegy visszahozásához egyszerűen állítsd be a boardColId-t arra az oszlopra, ahová szeretnéd.

Törlés — az action: "delete" végleges, és a jegy megjegyzéseit is eltávolítja. Önmagában kell elküldeni; bármilyen más mező ugyanabban a hívásban elutasításra kerül, mert egy olyan jegyzet vagy e-mail, amit egy hamarosan eltűnő jegyhez rögzítenénk, egyszerűen elveszne. Inkább archiválj, hacsak nem vagy biztos a dolgodban.

Több dolog egyszerre — mezőmódosítások, egy megjegyzés és egy e-mail mind belefér egyetlen hívásba, és ebben a sorrendben hajtódnak végre. Egy jegy lezárása így egyetlen kérés: áthelyezed a Kész oszlopba, belsőleg feljegyzed, miért, és értesíted az ügyfelet.

Jegy áthelyezése másik táblára

Az oszlopok és a címkék egy konkrét táblához tartoznak, ezért az áthelyezésnek mindkettőt kezelnie kell:

• A jegy a céltábla első oszlopába kerül, vagy abba, amit boardColId-ként megadsz — ezt a céltáblához ellenőrizzük, nem ahhoz, ahonnan jött.
• A címkéi törlődnek, hacsak nem adsz meg labelIds értékeket az új tábla palettájáról.

E nélkül az áthelyezett jegy vagy mindkét tábláról eltűnne, vagy olyan címkéket vinne magával, amelyek semmiként jelennek meg.

Mit ellenőrzünk

Mindent ellenőrzünk, amit átadsz, még mielőtt bármi mentésre kerülne, így egy hibás azonosító érthető magyarázattal hiúsul meg ahelyett, hogy félig alkalmazódna:

• A hozzárendelt személynek a szervezeted aktív tagjának kell lennie.
• A címkéknek létezniük kell azon a táblán, ahová a jegy kerül.
• Az oszlopnak ugyanahhoz a táblához kell tartoznia.

Megjegyzések

A comment belső jegyzetet ad hozzá. Csak a csapatod látja — a jegyet bejelentő személy soha. A jegyzetek ahhoz kötődnek, aki éppen be van jelentkezve, és azonnal megjelennek a kolléga megnyitott jegypaneljén anélkül, hogy frissítenie kellene.

E-mail a bejelentőnek

Az email objektum annak a személynek ír, aki a jegyet bejelentette, és visszaidézi neki az eredeti beküldését. A megjegyzéssel ellentétben ezt látja az ügyfél.

• Ha nem állítod be a senderEmail-t, vagy a cím nincs ellenőrizve a szervezetedhez, az e-mail az alapértelmezett Yaplet feladóról megy ki.
• Az ezzel az eszközzel létrehozott jegyhez nem tartozik bejelentő, ezért ott külön meg kell adnod a to mezőt.
• A küldés óránként legfeljebb 30 jegy e-mailre van korlátozva szervezetenként.
• Ha a kézbesítés meghiúsul, hibát kapsz, és semmi nem kerül rögzítésre a jegyen — egy sikertelen küldés soha nem néz ki sikeresnek.

Példa utasítások

• „Hozz létre egy magas prioritású jegyet a Hibák táblán: a fizetés nem működik Safariban.”
• „Tedd át ezt a jegyet a Kész oszlopba.”
• „Rendeld hozzá ezt a jegyet Sarah-hoz.”
• „Szüntesd meg a hozzárendelést, hogy más is felvehesse.”
• „Címkézd ezt a jegyet regresszióként.”
• „Archiváld azokat a jegyeket, amiket ezen a héten befejeztünk.”
• „Hozd vissza azt az archivált jegyet a Folyamatban oszlopba.”
• „Írj a jegyhez egy jegyzetet: várunk a fizetési szolgáltató visszaigazolására.”
• „Zárd le ezt a jegyet, és írd meg a bejelentőnek, hogy a 2.4.1-ben javítva lett.”
• „Töröld ezt a duplikált jegyet.”

Gyakori munkafolyamatok

Tábla átnézése

1. Keresd meg a táblát → list_records, table: "boards"
2. Ismerd meg az oszlopait, címkéit és a személyeket → get_record, table: "boards"
3. Listázd az élő jegyeket → list_records, table: "tickets", archived: false
4. Mozgasd, rendeld hozzá és priorizáld → manage_ticket

Példa utasítás: „Mutasd meg mindent a Hibák tábláról, ami nincs archiválva, és tedd át a fizetéssel kapcsolatosakat a Folyamatban oszlopba hozzám rendelve.”

Jegy lezárása

Egyetlen hívás elvégzi a lezárás mindhárom részét — az állapotváltást, a belső feljegyzést és az ügyfélnek küldött választ:

Példa utasítás: „Tedd át ezt a jegyet a Kész oszlopba, jegyezd fel belsőleg, hogy a 2.4.1-gyel ment ki, és írd meg a bejelentőnek, hogy javítva lett.”

Munka áthelyezése táblák között

1. Kérdezd le a céltáblát → get_record, table: "boards" (az oszlopaiért és címkéiért)
2. Helyezd át a jegyet → manage_ticket a boardId, boardColId és labelIds mezőkkel

Példa utasítás: „Tedd át ezt a fejlesztési kérést a Hibák tábláról a Roadmap táblára, a Tervezett oszlopba, és címkézd fejlesztésként.”

Utánkövetés az ügyfelek bejelentéseire

1. Keresd meg a jegyeket → list_records, table: "tickets"
2. Olvass el egyet teljesen, a bejelentővel együtt → get_record, table: "tickets"
3. Válaszolj nekik → manage_ticket az email mezővel

Példa utasítás: „Keresd meg a nyitott hibabejelentéseket ezen a táblán, mutasd meg, ki jelentette be őket, és írj mindenkinek, aki még válaszra vár.”