Užduočių sekimo sistemos
Paverskite seansą užduotimi jį žiūrėdami: vienas mygtukas leistuvėje, aprašas jūsų žodžiais ir jau pridėta atkūrimo nuoroda.
1. Kodėl ši integracija valdoma rankiniu būdu
Visi kiti MousePlayer tiltai suveikia patys. Šis ne, ir būtent taip jis suprojektuotas.
Užduotis yra darbas žmogui. Jei kurtume ją po kiekvieno įnirtingo paspaudimo, lenta prisipildytų niekieno neatrinktų įrašų, ir po savaitės komanda juos filtruotų; tuomet būtų išfiltruojami ir tikrieji.
Todėl suveikimo iniciatorius esate jūs. Žiūrite seansą, pastebite problemą, paspaudžiate mygtuką ir aprašote, ką matėte. Įrašo nuoroda jau yra apraše; vertinimą pateikiate jūs.
Mygtukas rodomas tik savininkams ir administratoriams, niekada bendrinimo nuorodos rodinyje. Asmuo, kuriam nusiuntėte įrašą, neturi galėti kurti užduočių jūsų sistemoje.
2. Penkios sistemos ir ko reikia kiekvienai
| Kur patenka | Pateikiate | |
|---|---|---|
| Jira | užduotis projekte | svetainės URL, paskyros el. paštą, API žetoną, projekto raktą, užduoties tipą |
| Linear | užduotis komandoje | API raktą, komandos ID |
| Asana | užduotis projekte | asmeninį prieigos žetoną, projekto ID |
| Trello | kortelė sąraše | raktą, žetoną, sąrašo ID |
| GitHub | užduotis saugykloje | asmeninį prieigos žetoną, owner/repo |
Viena kortelė, vienu metu pasirinktas vienas teikėjas. Vėliau pridėti antrą sistemą reiškia pakeisti pasirinkimą, o ne atlikti migraciją.
Iš kur gaunami identifikatoriai
Linear komandos ID ir Asana projekto ID matomi URL, atidarius komandą ar projektą naršyklėje. Trello sąrašo ID rasti sunkiausia iš penkių: prie lentos URL pridėkite .json ir raskite reikiamą sąrašą. Jira projekto raktas yra prefiksas prieš kiekvieną užduoties numerį: ACME pavyzdyje ACME-1234.
3. Nuorodą užduotyje sukuria mūsų serveris
Jūsų įvestas aprašas priklauso jums. Atkūrimo nuoroda ne: ją mūsų pusėje sudarome pagal seansą, kurį iš tikrųjų žiūrėjote; forma jos pakeisti negali.
Tai svarbu, nes užduoties nuorodas spaudžia kiti žmonės. Jei nuoroda būtų gaunama iš naršyklės, specialiai parengta užklausa galėtų komandai pateikti bet kokį adresą tarp to, kas atrodo kaip jūsų įrankiai.
HTTP 200 nereiškia, kad užduotis egzistuoja
Linear atsako per GraphQL, o GraphQL atsako 200 OK su masyvu errors, kai atsisako. Vien būsenos kodą tikrinantis tiltas praneštų apie sėkmę niekada nesukurtai užduočiai. Skaitome turinį.
Kai sistema grąžina naujos užduoties identifikatorių, įtraukiame jį į patvirtinimą, kad galėtumėte patikrinti tikrą jos buvimą, o ne pasitikėti žaliu pranešimu.
4. Ko čia sąmoningai nėra
Jokių automatinių užduočių
Žr. pirmiau. Jei norite automatizavimo, Webhook tiltas gali siųsti nusivylimo signalus į Zapier ar Make, o ten spręsite, kam kurti užduotį.
Jokio dvikrypčio sinchronizavimo
Uždarius užduotį MousePlayer niekas nesikeičia, o MousePlayer niekas jos neatidaro iš naujo. Pusantros krypties sinchronizavimas blogesnis už jokį, nes žmonės pradeda juo pasikliauti.
Jokių priedų
Įrašas lieka pas mus ir žiūrimas pas mus. Eksportuojant vaizdą į užduočių sistemą asmens duomenys patektų į sistemą su kitokiomis saugojimo taisyklėmis, nei sutarta su lankytojais.
Žetonas saugomas užšifruotas naudojant AES-256-GCM ir daugiau nerodomas. Jis niekada neįtraukiamas ir į vidinę eilę: kvietimas vykdomas jums laukiant, tiesiai iš užklausos.
5. GitLab, Azure DevOps ir ClickUp
Dar trys sistemos, tas pats mygtukas ir tas pats rankinis paleidimas.
| Pateikiate | |
|---|---|
| GitLab | serverio adresą, projekto ID ir žetoną; veikia ir jūsų nuosava GitLab |
| Azure DevOps | organizaciją, projektą, darbo elemento tipą ir PAT |
| ClickUp | sąrašo ID ir asmeninį žetoną |
GitLab prašo serverio adreso, nes jis gali priklausyti jums
Skirtingai nuo kitų, GitLab dažnai talpinamas savo įrangoje, todėl serverio adresas yra laukas, o ne konstanta. Įklijuokite gitlab.com, jei naudojate jį.
Azure DevOps turi dvi ypatybes iš karto
Turinys yra JSON Patch dokumentas, o ne objektas, ir jo turinio tipas turi būti application/json-patch+json; kitaip grąžinama 415. Dolerio ženklas prieš darbo elemento tipą URL yra adreso dalis, o ne pamirštas užpildyti vietaženklis.
ClickUp reikia gryno žetono
Be Bearer prieš jį. Žetonas su pridėtu žodžiu atmetamas su 401, lyg būtų neteisingas.
Visi čia paminėti prekių ženklai priklauso jų savininkams. MousePlayer su šiais teikėjais neturi verslo ryšių.