Ä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 hamnarDu anger
Jiraett ärende i ett projektwebbplats-URL, kontots e-postadress, API-token, projektnyckel, ärendetyp
Linearett ärende i ett teamAPI-nyckel, team-ID
Asanaen uppgift i ett projektpersonlig åtkomsttoken, projekt-ID
Trelloett kort i en listanyckel, token, list-ID
GitHubett ärende i ett kodarkivpersonlig å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
GitLabvärd, projekt-ID och token. Din egen GitLab fungerar också
Azure DevOpsorganisation, projekt, arbetsobjektstyp och en PAT
ClickUplist-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.