Ärendehanterare
Gör en session till ett ärende medan du ser den: en knapp i spelaren, dina egna ord i beskrivningen och uppspelningslänken redan bifogad.
1. Varför detta görs manuellt
Alla andra bryggor i MousePlayer utlöses automatiskt. Den här gör inte det, och det är hela poängen.
Ett ärende innebär arbete för en person. Om vi öppnade ett för varje raseriklick skulle tavlan fyllas med poster som ingen prioriterat. Inom en vecka skulle teamet filtrera bort dem, och då försvinner även de verkliga problemen.
Därför är du utlösaren. Du ser en session, upptäcker problemet, trycker på knappen och skriver vad du såg. Inspelningslänken finns redan i beskrivningen. Du står för bedömningen.
Knappen visas bara för ägare och administratörer, aldrig via en delningslänk. Någon du skickat en inspelning till ska inte kunna öppna ärenden i ditt system.
2. De fem ärendehanterarna och vad var och en behöver
| Var det hamnar | Du anger | |
|---|---|---|
| Jira | ett ärende i ett projekt | webbplats-URL, kontots e-postadress, API-token, projektnyckel, ärendetyp |
| Linear | ett ärende i ett team | API-nyckel, team-ID |
| Asana | en uppgift i ett projekt | personlig åtkomsttoken, projekt-ID |
| Trello | ett kort i en lista | nyckel, token, list-ID |
| GitHub | ett ärende i ett kodarkiv | personlig åtkomsttoken, owner/repo |
En ruta med en vald leverantör åt gången. Att lägga till en annan ärendehanterare senare innebär att byta val, inte att migrera.
Var identifierarna finns
Linears team-ID och Asanas projekt-ID syns i URL:en när du öppnar teamet eller projektet i webbläsaren. Trellos list-ID är svårast av de fem: lägg till .json i en tavlas URL och leta efter listan du vill ha. Jiras projektnyckel är prefixet före varje ärendenummer: ACME i ACME-1234.
3. Länken i ärendet byggs av vår server
Beskrivningen du skriver är din. Uppspelningslänken är det inte. Den byggs på vår sida från sessionen du faktiskt tittade på och kan inte påverkas av formuläret.
Det spelar roll eftersom andra klickar på ärenden. Om länken kom från webbläsaren skulle en manipulerad begäran kunna visa vilken adress som helst för teamet inuti något som ser ut som era egna verktyg.
HTTP 200 betyder inte att ärendet finns
Linear svarar via GraphQL och GraphQL svarar 200 OK med listan errors när anropet avvisas. En brygga som bara läser statuskoden skulle rapportera framgång för ett ärende som aldrig skapades. Vi läser innehållet.
När en ärendehanterare returnerar det nya ärendets identifierare visar vi den i bekräftelsen. Då kan du kontrollera att ärendet finns i stället för att lita på ett grönt meddelande.
4. Vad som avsiktligt saknas
Inga automatiska ärenden
Se ovan. Om du vill automatisera kan webhook-bryggan skicka frustrationssignaler till Zapier eller Make. Där bestämmer du vad som förtjänar ett ärende.
Ingen dubbelriktad synkronisering
Att stänga ärendet ändrar ingenting i MousePlayer och inget i MousePlayer öppnar det igen. En synkronisering som fungerar i en och en halv riktning är sämre än ingen eftersom människor börjar lita på den.
Inga bilagor
Inspelningen stannar hos oss och ses hos oss. Att exportera en video till en ärendehanterare skulle föra personuppgifter till ett system med andra lagringsregler än dem du avtalat med besökarna.
Token lagras krypterad med AES-256-GCM och visas aldrig igen. Den läggs inte heller i den interna kön. Anropet görs medan du väntar, direkt från begäran.
5. GitLab, Azure DevOps och ClickUp
Tre ärendehanterare till, samma knapp och samma manuella utlösare.
| Du anger | |
|---|---|
| GitLab | värd, projekt-ID och token. Din egen GitLab fungerar också |
| Azure DevOps | organisation, projekt, arbetsobjektstyp och en PAT |
| ClickUp | list-ID och personlig token |
GitLab frågar efter värd eftersom den kan vara din egen
Till skillnad från de andra körs GitLab ofta i egen drift. Därför är värden ett fält och ingen konstant. Klistra in gitlab.com om det är där din instans finns.
Azure DevOps har två egenheter samtidigt
Innehållet är ett JSON Patch-dokument i stället för ett objekt och innehållstypen måste vara application/json-patch+json – allt annat ger 415. Dollartecknet före arbetsobjektstypen i URL:en är en del av adressen, ingen platshållare vi glömt fylla i.
ClickUp vill ha enbart token
Inget Bearer före den. En token med ordet framför avvisas med 401, precis som en felaktig token.
Alla nämnda varumärken tillhör respektive ägare. MousePlayer har ingen affärsrelation med leverantörerna.