Issuetrackers
Maak van een sessie een ticket terwijl u kijkt: één knop in de speler, uw eigen beschrijving en de afspeellink al toegevoegd.
1. Waarom dit handmatig werkt
Elke andere koppeling in MousePlayer wordt vanzelf geactiveerd. Deze niet, en dat is precies de bedoeling.
Een ticket betekent werk voor een persoon. Als we er voor elke woedeklik een zouden openen, zou uw bord vol raken met onbeoordeelde items. Binnen een week zou uw team die wegfilteren, waarna ook de echte problemen verdwijnen.
Daarom bent u de trigger. U bekijkt een sessie, ziet het probleem, drukt op de knop en schrijft op wat u zag. De opnamelink staat al in de beschrijving; u voegt het oordeel toe.
De knop verschijnt alleen voor eigenaren en beheerders, nooit bij weergave via een gedeelde link. Iemand naar wie u een opname stuurt, moet geen tickets in uw tracker kunnen openen.
2. De vijf trackers en wat ze nodig hebben
| Waar het terechtkomt | U geeft op | |
|---|---|---|
| Jira | een issue in een project | site-URL, e-mailadres van het account, API-token, projectsleutel en issuetype |
| Linear | een issue in een team | API-sleutel en team-ID |
| Asana | een taak in een project | persoonlijk toegangstoken en project-ID |
| Trello | een kaart in een lijst | sleutel, token en lijst-ID |
| GitHub | een issue in een repository | persoonlijk toegangstoken en owner/repo |
Eén tegel, met telkens één geselecteerde aanbieder. Later een tweede tracker toevoegen betekent een andere selectie maken, geen migratie uitvoeren.
Waar de identificaties vandaan komen
De team-ID van Linear en de project-ID van Asana staan in de URL wanneer u het team of project in een browser opent. De lijst-ID van Trello is het lastigst: voeg .json toe aan de URL van een bord en zoek de gewenste lijst. De projectsleutel van Jira is het voorvoegsel voor elk issuenummer: ACME in ACME-1234.
3. Onze server stelt de link in het ticket samen
De beschrijving die u typt is van u. De afspeellink wordt door ons samengesteld op basis van de sessie die u daadwerkelijk bekeek; het formulier kan die niet beïnvloeden.
Dat is belangrijk omdat andere mensen op een ticket klikken. Als de link uit de browser kwam, zou een gemanipuleerd verzoek elk willekeurig adres aan uw team kunnen voorleggen binnen iets dat op uw eigen gereedschap lijkt.
HTTP 200 betekent niet dat het ticket bestaat
Linear antwoordt via GraphQL, en GraphQL retourneert 200 OK met een array errors als het verzoek wordt geweigerd. Een koppeling die alleen naar de statuscode kijkt, zou succes melden voor een ticket dat nooit is aangemaakt. We lezen de antwoordtekst.
Als een tracker de identificatie van het nieuwe issue terugstuurt, nemen we die op in de bevestiging. Zo kunt u controleren of het issue echt bestaat, in plaats van op een groene melding te vertrouwen.
4. Wat hier bewust niet in zit
Geen automatische tickets
Zie hierboven. Als u automatisering wilt, kan de webhookkoppeling frustratiesignalen naar Zapier of Make sturen. Daar bepaalt u wat een ticket verdient.
Geen tweerichtingssynchronisatie
Het sluiten van het ticket verandert niets in MousePlayer, en niets in MousePlayer opent het opnieuw. Een synchronisatie die maar anderhalve richting op werkt, is slechter dan geen, omdat mensen erop gaan vertrouwen.
Geen bijlagen
De opname blijft bij ons en wordt bij ons bekeken. Een video naar een tracker exporteren zou persoonsgegevens verplaatsen naar een systeem met andere bewaartermijnen dan u met uw bezoekers hebt afgesproken.
Het token wordt met AES-256-GCM versleuteld opgeslagen en nooit meer getoond. Het komt ook nooit in de interne wachtrij: deze aanroep vindt plaats terwijl u wacht, rechtstreeks vanuit het verzoek.
5. GitLab, Azure DevOps en ClickUp
Nog drie trackers, dezelfde knop en dezelfde handmatige activering.
| U geeft op | |
|---|---|
| GitLab | host, project-ID en een token; uw eigen GitLab werkt ook |
| Azure DevOps | organisatie, project, type werkitem en een PAT |
| ClickUp | lijst-ID en een persoonlijk token |
GitLab vraagt om een host omdat die van u kan zijn
Anders dan de andere wordt GitLab vaak zelf gehost. Daarom is de host een veld in plaats van een vaste waarde. Plak gitlab.com als u die host gebruikt.
Azure DevOps heeft twee bijzonderheden tegelijk
De inhoud is een JSON Patch-document in plaats van een object, en het inhoudstype moet application/json-patch+json zijn; iets anders levert 415 op. Het dollarteken voor het type werkitem in de URL is onderdeel van het adres, geen tijdelijke aanduiding die we vergeten zijn in te vullen.
ClickUp wil alleen het token
Zonder Bearer ervoor. Een token met dat woord ervoor wordt met 401 geweigerd, wat er precies uitziet als een onjuist token.
Alle genoemde handelsmerken zijn eigendom van hun respectieve eigenaren. MousePlayer heeft geen zakelijke relatie met deze aanbieders.