Sledovanie úloh
Premeňte reláciu na úlohu už počas sledovania – jedným tlačidlom v prehrávači, s vlastným opisom a už pripojeným odkazom na prehrávanie.
1. Prečo je táto integrácia ručná
Každý iný most v MousePlayer sa spúšťa sám. Tento nie a práve tak je navrhnutý.
Úloha znamená prácu pre človeka. Keby sme ju otvárali pri každom zúrivom kliknutí, vaša nástenka by sa zaplnila neprefiltrovanými položkami a tím by ich do týždňa začal ignorovať – spolu s tými skutočne dôležitými.
Preto ste spúšťačom vy. Sledujete reláciu, vidíte problém, stlačíte tlačidlo a napíšete, čo ste videli. Odkaz na záznam už je v opise; vy dodávate posúdenie.
Tlačidlo sa zobrazuje iba vlastníkom a administrátorom, nikdy pri zobrazení cez zdieľaný odkaz. Človek, ktorému ste poslali záznam, by nemal môcť otvárať úlohy vo vašom systéme.
2. Päť systémov a čo každý potrebuje
| Čo sa vytvorí | Zadávate | |
|---|---|---|
| Jira | úloha v projekte | URL webu, e-mail účtu, API token, kľúč projektu, typ úlohy |
| Linear | úloha v tíme | API kľúč, ID tímu |
| Asana | úloha v projekte | osobný prístupový token, ID projektu |
| Trello | karta v zozname | kľúč, token, ID zoznamu |
| GitHub | úloha v repozitári | osobný prístupový token, vlastník/repozitár |
Jedna dlaždica, vždy jeden vybraný poskytovateľ. Pridanie druhého systému neskôr znamená zmenu výberu, nie migráciu.
Odkiaľ pochádzajú identifikátory
ID tímu Linear a ID projektu Asana sú viditeľné v URL pri otvorení tímu alebo projektu v prehliadači. ID zoznamu Trello je z tejto pätice najťažšie získať: pripojte .json k URL nástenky a vyhľadajte požadovaný zoznam. Kľúč projektu Jira je predpona pred každým číslom úlohy – ACME v ACME-1234.
3. Odkaz v úlohe zostavuje náš server
Opis píšete vy. Odkaz na prehrávanie nie – zostavuje sa na našej strane z relácie, ktorú ste skutočne sledovali, a formulár ho nemôže ovplyvniť.
Je to dôležité, pretože na úlohu klikajú iní ľudia. Ak by odkaz pochádzal z prehliadača, upravená požiadavka by mohla pred váš tím vložiť ľubovoľnú adresu do niečoho, čo vyzerá ako vaše vlastné nástroje.
HTTP 200 neznamená, že úloha existuje
Linear odpovedá cez GraphQL a GraphQL odpovedá 200 OK s poľom errors pri odmietnutí. Most, ktorý kontroluje iba stavový kód, by hlásil úspech úlohy, ktorá nikdy nevznikla. Čítame telo.
Keď systém vráti identifikátor novej úlohy, vložíme ho do potvrdenia – aby ste mohli overiť jej existenciu namiesto dôverovania zelenému hláseniu.
4. Čo tu zámerne nie je
Žiadne automatické úlohy
Pozrite vyššie. Ak chcete automatizáciu, most webhookov môže posielať signály frustrácie do Zapier alebo Make a tam rozhodnete, čo si zaslúži úlohu.
Žiadna obojsmerná synchronizácia
Zatvorenie úlohy nič nemení v MousePlayer a nič v MousePlayer ju znovu neotvára. Synchronizácia fungujúca len čiastočne obojsmerne je horšia než žiadna, pretože sa na ňu ľudia začnú spoliehať.
Žiadne prílohy
Záznam zostáva u nás a sleduje sa u nás. Export videa do systému úloh by presunul osobné údaje do systému s inými pravidlami uchovávania, než aké ste dohodli s návštevníkmi.
Token sa ukladá šifrovaný pomocou AES-256-GCM a už sa nezobrazuje. Nikdy sa nevkladá ani do interného frontu – toto volanie prebieha priamo z požiadavky, kým čakáte.
5. GitLab, Azure DevOps a ClickUp
Tri ďalšie systémy, rovnaké tlačidlo, rovnaké ručné spustenie.
| Zadávate | |
|---|---|
| GitLab | hostiteľa, ID projektu a token – funguje aj vlastný GitLab |
| Azure DevOps | organizáciu, projekt, typ pracovnej položky a PAT |
| ClickUp | ID zoznamu a osobný token |
GitLab žiada hostiteľa, pretože môže byť váš
Na rozdiel od ostatných je GitLab často prevádzkovaný na vlastnom serveri, preto je hostiteľ poľom, nie konštantou. Vložte gitlab.com, ak ho používate tam.
Azure DevOps má hneď dve zvláštnosti
Jeho telo je dokument JSON Patch namiesto objektu a typ obsahu musí byť application/json-patch+json – čokoľvek iné vracia 415. Znak dolára pred typom pracovnej položky v URL je súčasťou adresy, nie zástupný symbol, ktorý sme zabudli vyplniť.
ClickUp chce samotný token
Bez Bearer pred tokenom. Token s týmto slovom na začiatku sa odmietne chybou 401, ktorá vyzerá presne ako nesprávny token.
Všetky uvedené ochranné známky patria príslušným vlastníkom. MousePlayer nemá s týmito poskytovateľmi obchodný vzťah.