Systémy pro správu požadavků
Proměňte relaci v požadavek přímo při sledování - jedním tlačítkem v přehrávači, s vlastním popisem a už připojeným odkazem na záznam.
1. Proč se tento most spouští ručně
Každý jiný most v MousePlayer se spouští sám. Tento ne a právě v tom spočívá jeho návrh.
Požadavek znamená práci pro člověka. Kdybychom ho otevírali pro každé vzteklé kliknutí, nástěnku by zaplnily položky, které nikdo neposoudil, a tým by je do týdne začal filtrovat - spolu s nimi by pak zmizely i skutečné problémy.
Spouštěčem jste proto vy. Sledujete relaci, vidíte problém, stisknete tlačítko a popíšete své pozorování. Odkaz na záznam už je v popisu; posouzení dodáváte vy.
Tlačítko se zobrazuje jen vlastníkům a správcům, nikdy při zobrazení přes sdílený odkaz. Příjemce vašeho záznamu nemá mít možnost otevírat požadavky ve vašem systému.
2. Pět systémů a jejich požadavky
| Kam se uloží | Zadáte | |
|---|---|---|
| Jira | problém v projektu | adresu URL webu, e-mail účtu, token API, klíč projektu a typ problému |
| Linear | problém v týmu | klíč API a ID týmu |
| Asana | úkol v projektu | osobní přístupový token a ID projektu |
| Trello | karta v seznamu | klíč, token a ID seznamu |
| GitHub | problém v repozitáři | osobní přístupový token a owner/repo |
Jedna dlaždice, vždy jeden vybraný poskytovatel. Pozdější přidání druhého systému znamená změnu výběru, ne migraci.
Odkud získat identifikátory
ID týmu v Linear a ID projektu v Asana jsou vidět v adrese URL po otevření týmu nebo projektu v prohlížeči. ID seznamu v Trello je z pěti možností nejsložitější: připojte .json k adrese URL nástěnky a najděte požadovaný seznam. Klíč projektu v Jira je předpona každého čísla problému - ACME v ACME-1234.
3. Odkaz v požadavku sestavuje náš server
Popis píšete vy. Odkaz na přehrávání však sestavujeme na naší straně podle skutečně sledované relace a formulář ho nemůže ovlivnit.
Je to důležité, protože na požadavek klikají další lidé. Kdyby odkaz pocházel z prohlížeče, upravený požadavek by mohl vašemu týmu podstrčit libovolnou adresu uvnitř něčeho, co vypadá jako vaše vlastní nástroje.
HTTP 200 neznamená, že požadavek existuje
Linear odpovídá přes GraphQL a GraphQL při odmítnutí vrací 200 OK s polem errors . Most, který kontroluje jen stavový kód, by hlásil úspěch u požadavku, který nikdy nevznikl. Čteme tělo odpovědi.
Pokud systém vrátí identifikátor nového problému, uvedeme ho v potvrzení, abyste mohli ověřit jeho skutečnou existenci, nikoli jen důvěřovat zelené zprávě.
4. Co zde záměrně není
Žádné automatické požadavky
Viz výše. Pokud chcete automatizaci, most pro webhooky může odesílat signály frustrace do Zapier nebo Make a tam rozhodnete, co si zaslouží požadavek.
Žádná obousměrná synchronizace
Uzavření požadavku nic nezmění v MousePlayer a nic v MousePlayer ho znovu neotevře. Synchronizace fungující v jednom a půl směru je horší než žádná, protože se na ni lidé začnou spoléhat.
Žádné přílohy
Záznam zůstává u nás a u nás se přehrává. Export videa do systému požadavků by přesunul osobní údaje do prostředí s jinými pravidly uchování, než na jakých jste se dohodli s návštěvníky.
Token se ukládá zašifrovaný pomocí AES-256-GCM a nikdy se znovu nezobrazí. Také se nikdy nevkládá do interní fronty - volání proběhne přímo při zpracování požadavku, zatímco čekáte.
5. GitLab, Azure DevOps a ClickUp
Další tři systémy, stejné tlačítko a stejné ruční spuštění.
| Zadáte | |
|---|---|
| GitLab | hostitele, ID projektu a token - funguje i vlastní GitLab |
| Azure DevOps | organizaci, projekt, typ pracovní položky a PAT |
| ClickUp | ID seznamu a osobní token |
GitLab se ptá na hostitele, protože může patřit vám
Na rozdíl od ostatních bývá GitLab často provozován samostatně, proto je hostitel polem, nikoli konstantou. Vložte gitlab.com , pokud používáte tuto službu.
Azure DevOps má rovnou dvě zvláštnosti
Tělo požadavku je dokument JSON Patch místo objektu a jeho typ obsahu musí být application/json-patch+json - cokoli jiného vrátí 415. Znak dolaru před typem pracovní položky v adrese URL je součástí adresy, nikoli zástupný symbol, který jsme zapomněli vyplnit.
ClickUp chce samotný token
Bez Bearer před tokenem. Token s tímto slovem na začátku bude odmítnut stavem 401, což vypadá úplně stejně jako nesprávný token.
Všechny uvedené ochranné známky patří příslušným vlastníkům. MousePlayer s těmito poskytovateli nemá obchodní vztah.