Orodja za sledenje nalogam

Med gledanjem spremenite sejo v nalogo – en gumb v predvajalniku, vaše besede v opisu in že priložena povezava do posnetka.

1. Zakaj je to ročno

Vsak drug most v MousePlayer se sproži sam. Ta se ne in to je celoten namen zasnove.

Naloga je delo za človeka. Če bi jo odprli za vsak besni klik, bi bila tabla polna nerazvrščenih postavk in ekipa bi jih v enem tednu začela izločati – s tem pa bi izločila tudi prave.

Sprožilec ste torej vi. Gledate sejo, opazite težavo, pritisnete gumb in napišete, kaj ste videli. Povezava do posnetka je že v opisu; vi dodate presojo.

Gumb se prikaže samo lastnikom in administratorjem, nikoli v pogledu deljene povezave. Oseba, ki ste ji poslali posnetek, ne sme odpirati nalog v vašem orodju.

2. Pet orodij in njihove zahteve

Kje se ustvariKaj posredujete
Jiranaloga v projektuURL spletnega mesta, e-pošta računa, API žeton, ključ projekta, vrsta naloge
Linearnaloga v ekipiAPI ključ, ID ekipe
Asanaopravilo v projektuosebni dostopni žeton, ID projekta
Trellokartica na seznamuključ, žeton, ID seznama
GitHubnaloga v repozitorijuosebni dostopni žeton, owner/repo

Ena ploščica, en izbran ponudnik naenkrat. Poznejše dodajanje drugega orodja pomeni spremembo izbire, ne migracije.

Od kod identifikatorji

ID ekipe Linear in ID projekta Asana sta vidna v URL-ju, ko v brskalniku odprete ekipo ali projekt. ID seznama Trello je najtežji od petih: naslovu table dodajte .json in poiščite želeni seznam. Ključ projekta Jira je predpona pred vsako številko naloge – ACME v ACME-1234.

3. Povezavo v nalogi sestavi naš strežnik

Opis, ki ga napišete, je vaš. Povezava do posnetka pa ne – na naši strani jo sestavimo iz seje, ki ste jo dejansko gledali, in obrazec nanjo ne more vplivati.

To je pomembno, ker drugi ljudje klikajo naloge. Če bi povezava prišla iz brskalnika, bi lahko prirejena zahteva pred ekipo postavila poljuben naslov v nečem, kar je videti kot vaše lastno orodje.

HTTP 200 ne pomeni, da naloga obstaja

Linear odgovarja prek GraphQL in GraphQL ob zavrnitvi vrne 200 OK s poljem errors. Most, ki bi preverjal samo kodo stanja, bi poročal o uspehu naloge, ki nikoli ni bila ustvarjena. Beremo telo odgovora.

Če orodje vrne identifikator nove naloge, ga dodamo potrditvi – tako preverite, da res obstaja, namesto da zaupate zelenemu sporočilu.

4. Česa namenoma ni

Brez samodejnih nalog

Glejte zgoraj. Za avtomatizacijo lahko most Webhook pošilja signale frustracije v Zapier ali Make, tam pa odločite, kaj zasluži nalogo.

Brez dvosmerne sinhronizacije

Zaprtje naloge ne spremeni ničesar v MousePlayer in nič v MousePlayer je ne odpre znova. Sinhronizacija, ki deluje v eno in pol smeri, je slabša od nobene, ker se ljudje začnejo zanašati nanjo.

Brez priponk

Posnetek ostane pri nas in se pri nas gleda. Izvoz videa v orodje za naloge bi osebne podatke prenesel v sistem z drugačnimi pravili hrambe od dogovorjenih z obiskovalci.

Žeton se shrani šifrirano z AES-256-GCM in ni več prikazan. Prav tako nikoli ni v interni čakalni vrsti – ta klic se izvede neposredno iz zahteve, medtem ko čakate.

5. GitLab, Azure DevOps in ClickUp

Še tri orodja, isti gumb, isti ročni sprožilec.

Kaj posredujete
GitLabgostitelj, ID projekta in žeton – deluje tudi vaš lastni GitLab
Azure DevOpsorganizacija, projekt, vrsta delovnega elementa in PAT
ClickUpID seznama in osebni žeton

GitLab sprašuje po gostitelju, ker je lahko vaš

V nasprotju z drugimi je GitLab pogosto na lastnem strežniku, zato je gostitelj polje, ne konstanta. Prilepite gitlab.com, če ga uporabljate tam.

Azure DevOps ima dve posebnosti hkrati

Telo je dokument JSON Patch namesto objekta in vrsta vsebine mora biti application/json-patch+json – vse drugo vrne 415. Znak dolarja pred vrsto delovnega elementa v URL-ju je del naslova, ne pozabljen nadomestni označevalec.

ClickUp zahteva goli žeton

Brez Bearer pred njim. Žeton s to besedo na začetku se zavrne z 401, kar je videti natanko kot napačen žeton.

Vse navedene blagovne znamke pripadajo svojim lastnikom. MousePlayer s temi ponudniki nima poslovnega odnosa.