Gestors d’incidències
Converteixi una sessió en un tiquet mentre la mira: un botó al reproductor, les seves pròpies paraules a la descripció i l’enllaç de reproducció ja adjunt.
1. Per què aquesta integració és manual
Tots els altres ponts de MousePlayer s’activen sols. Aquest no, i aquest és precisament el disseny.
Un tiquet és feina per a una persona. Si n’obríssim un per cada clic de ràbia, el tauler s’ompliria d’elements sense classificar i, en una setmana, l’equip els filtraria; llavors també es filtrarien els casos reals.
Per això l’activador és vostè. Mira una sessió, veu el problema, prem el botó i escriu què ha vist. L’enllaç de la gravació ja és a la descripció; vostè hi aporta el criteri.
El botó només apareix als propietaris i administradors, mai en una vista d’enllaç compartit. Algú a qui ha enviat una gravació no hauria de poder obrir tiquets al seu gestor.
2. Els cinc gestors i què necessita cadascun
| On apareix | Què cal proporcionar | |
|---|---|---|
| Jira | una incidència en un projecte | URL del lloc, correu electrònic del compte, token d’API, clau de projecte, tipus d’incidència |
| Linear | una incidència en un equip | clau d’API, identificador d’equip |
| Asana | una tasca en un projecte | token d’accés personal, identificador de projecte |
| Trello | una targeta en una llista | clau, token, identificador de llista |
| GitHub | una incidència en un repositori | token d’accés personal, propietari/repositori |
Una targeta, un proveïdor seleccionat cada vegada. Afegir un segon gestor més endavant és canviar la selecció, no fer una migració.
D’on provenen els identificadors
L’identificador d’equip de Linear i el de projecte d’Asana es veuen a l’URL quan obre l’equip o el projecte al navegador. L’identificador de llista de Trello és el més difícil dels cinc: afegeixi .json a l’URL d’un tauler i cerqui la llista que vulgui. La clau de projecte de Jira és el prefix davant de cada número d’incidència: ACME a ACME-1234.
3. L’enllaç del tiquet el construeix el nostre servidor
La descripció que escriu és seva. L’enllaç de reproducció no: el construïm nosaltres a partir de la sessió que realment estava mirant, i el formulari no el pot modificar.
Això importa perquè un tiquet és una cosa en què altres persones fan clic. Si l’enllaç vingués del navegador, una petició manipulada podria posar qualsevol adreça davant del seu equip dins d’una cosa que sembla part de les seves eines.
HTTP 200 no vol dir que el tiquet existeixi
Linear respon mitjançant GraphQL, i GraphQL respon 200 OK amb una matriu errors quan ho rebutja. Un pont que només consultés el codi d’estat indicaria èxit per un tiquet que no s’ha creat mai. Llegim el cos.
Quan un gestor retorna l’identificador de la incidència nova, l’incloem a la confirmació perquè pugui comprovar que realment hi és en lloc de refiar-se d’un missatge verd.
4. Què s’ha exclòs expressament
Cap tiquet automàtic
Vegi més amunt. Si vol automatització, el pont de webhooks pot enviar senyals de frustració a Zapier o Make, i allà pot decidir què mereix un tiquet.
Cap sincronització bidireccional
Tancar el tiquet no canvia res a MousePlayer, i res de MousePlayer no el torna a obrir. Una sincronització que funciona en una direcció i mitja és pitjor que cap, perquè la gent comença a refiar-se’n.
Cap fitxer adjunt
La gravació es queda amb nosaltres i es mira amb nosaltres. Exportar un vídeo a un gestor introduiria dades personals en un sistema amb regles de conservació diferents de les que ha acordat amb els seus visitants.
El token es desa xifrat amb AES-256-GCM i no es torna a mostrar mai. Tampoc no s’inclou mai a la cua interna: aquesta crida es fa mentre vostè espera, directament des de la petició.
5. GitLab, Azure DevOps i ClickUp
Tres gestors més, el mateix botó i el mateix activador manual.
| Què cal proporcionar | |
|---|---|
| GitLab | host, identificador de projecte i un token; també funciona el seu propi GitLab |
| Azure DevOps | organització, projecte, tipus d’element de treball i un PAT |
| ClickUp | identificador de llista i un token personal |
GitLab demana un host perquè pot ser seu
A diferència dels altres, GitLab sovint s’allotja en infraestructura pròpia; per això el host és un camp i no una constant. Enganxi gitlab.com si és on es troba.
Azure DevOps té dues particularitats alhora
El cos és un document JSON Patch en lloc d’un objecte, i el tipus de contingut ha de ser application/json-patch+json perquè qualsevol altre retorna 415. El signe del dòlar davant del tipus d’element de treball a l’URL forma part de l’adreça, no és un marcador que ens hàgim oblidat d’emplenar.
ClickUp vol el token sol
Sense Bearer al davant. Un token precedit d’aquesta paraula es rebutja amb 401, exactament igual que un token incorrecte.
Totes les marques esmentades aquí pertanyen als seus propietaris respectius. MousePlayer no té cap relació comercial amb aquests proveïdors.