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 projekteURL webu, e-mail účtu, API token, kľúč projektu, typ úlohy
Linearúloha v tímeAPI kľúč, ID tímu
Asanaúloha v projekteosobný prístupový token, ID projektu
Trellokarta v zoznamekľúč, token, ID zoznamu
GitHubúloha v repozitáriosobný 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
GitLabhostiteľa, ID projektu a token – funguje aj vlastný GitLab
Azure DevOpsorganizáciu, projekt, typ pracovnej položky a PAT
ClickUpID 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.