Saksverktøy
Gjør en økt om til en sak mens du ser den — én knapp i avspilleren, dine egne ord i beskrivelsen, og avspillingslenken er allerede lagt ved.
1. Hvorfor dette gjøres manuelt
Alle andre broer i MousePlayer utløses automatisk. Denne gjør ikke det, helt etter planen.
En sak er arbeid for en person. Åpnet vi en sak for hvert raseriklikk, ville tavlen blitt fylt med saker ingen hadde vurdert, og innen en uke ville teamet filtrert dem bort — og da ville også de reelle sakene forsvunnet.
Derfor er du utløseren. Du ser en økt, oppdager noe, trykker på knappen og skriver hva du så. Opptakslenken er allerede i beskrivelsen; du bidrar med vurderingen.
Knappen vises bare for eiere og administratorer, og aldri ved visning via delt lenke. Noen du har sendt et opptak til, skal ikke kunne åpne saker i saksverktøyet ditt.
2. De fem verktøyene og hva hvert av dem trenger
| Hvor det legges | Du oppgir | |
|---|---|---|
| Jira | en sak i et prosjekt | nettsteds-URL, kontoens e-postadresse, API-token, prosjektnøkkel, sakstype |
| Linear | en sak i et team | API-nøkkel, team-ID |
| Asana | en oppgave i et prosjekt | personlig tilgangstoken, prosjekt-ID |
| Trello | et kort i en liste | nøkkel, token, liste-ID |
| GitHub | en sak i et kodelager | personlig tilgangstoken, eier/kodelager |
Én rute, én valgt leverandør om gangen. Å legge til et annet saksverktøy senere er et nytt valg, ikke en migrering.
Hvor identifikatorene kommer fra
Team-ID-en i Linear og prosjekt-ID-en i Asana er synlige i URL-en når du åpner teamet eller prosjektet i en nettleser. Liste-ID-en i Trello er vanskeligst av de fem: legg til .json i tavlens URL og finn listen du ønsker. Prosjektnøkkelen i Jira er prefikset foran hvert saksnummer — ACME i ACME-1234.
3. Lenken i saken bygges av serveren vår
Beskrivelsen du skriver, er din. Avspillingslenken er ikke det — den settes sammen hos oss fra økten du faktisk så på, og skjemaet kan ikke påvirke den.
Det betyr noe, fordi andre klikker på saker. Kom lenken fra nettleseren, kunne en manipulert forespørsel presentert en vilkårlig adresse for teamet i noe som ser ut som deres eget verktøy.
HTTP 200 betyr ikke at saken finnes
Linear svarer via GraphQL, og GraphQL svarer 200 OK med et errors-array når det avviser. En bro som bare ser på statuskoden, ville rapportert suksess for en sak som aldri ble opprettet. Vi leser innholdet.
Når et saksverktøy returnerer ID-en til den nye saken, viser vi den i bekreftelsen — så du kan kontrollere at saken faktisk finnes i stedet for å stole på en grønn melding.
4. Hva som bevisst ikke finnes her
Ingen automatiske saker
Se ovenfor. Ønsker du automatisering, kan webhook-broen sende frustrasjonssignaler til Zapier eller Make, og der bestemmer du hva som fortjener en sak.
Ingen toveis synkronisering
Å lukke saken endrer ingenting i MousePlayer, og ingenting i MousePlayer åpner den igjen. Synkronisering som virker halvannen vei, er verre enn ingen, fordi folk begynner å stole på den.
Ingen vedlegg
Opptaket blir hos oss og vises hos oss. Å eksportere en video til et saksverktøy ville sendt personopplysninger til et system med andre oppbevaringsregler enn dem du avtalte med besøkende.
Tokenet lagres AES-256-GCM-kryptert og vises aldri igjen. Det legges heller aldri i den interne køen — dette kallet skjer mens du venter, direkte fra forespørselen.
5. GitLab, Azure DevOps og ClickUp
Tre saksverktøy til, samme knapp, samme manuelle utløser.
| Du oppgir | |
|---|---|
| GitLab | vert, prosjekt-ID og et token — din egen GitLab virker også |
| Azure DevOps | organisasjon, prosjekt, arbeidselementtype og et PAT |
| ClickUp | liste-ID og et personlig token |
GitLab spør om vert fordi du kan eie den selv
I motsetning til de andre driftes GitLab ofte på egen server, så verten er et felt i stedet for en konstant. Lim inn gitlab.com hvis det er der du holder til.
Azure DevOps har to særegenheter samtidig
Innholdet er et JSON Patch-dokument i stedet for et objekt, og innholdstypen må være application/json-patch+json — alt annet gir 415. Dollartegnet foran arbeidselementtypen i URL-en er en del av adressen, ikke en plassholder vi glemte å fylle ut.
ClickUp vil ha tokenet alene
Ingen Bearer foran det. Et token med ordet foran avvises med 401, som ser nøyaktig ut som et feil token.
Alle nevnte varemerker tilhører sine respektive eiere. MousePlayer har ingen forretningsforbindelse med disse leverandørene.