Linear
Sådan virker Linear-eksporten, fra at forbinde til at løse problemer.
Forbind
Tryk på “Opret forbindelse” ved siden af Linear under “Sky” på Exporters startside. Log ind med Apple; din browser åbner Linears side, hvor du trykker på “Authorize”. Exporter beder kun Linear om at læse. Vælg derefter i Exporter, hvor filerne skal gemmes, og tryk på “Brug denne mappe”.
Linears token bliver forseglet på Exporters server. Din Mac logger ind på den server og har aldrig tokenet.
Vælg emner
Valgsiden viser hver opgave, hvert projekt og dokument, alle markeret, med tre faner: Opgaver, Projekter og Dokumenter. Fjern markeringen fra det, du ikke vil have; dets fil holdes ude.
Hvor filerne havner
En mappe direkte i din hjemmemappe, som ~/Documents, får en linear-export-mappe indeni; en dybere mappe bruges, som den er.
- Opgaver: en mappe pr. team, én fil pr. opgave, navngivet efter opgavens id og titel:
Northwind/NW-142 Invite flow.md - Projekter:
Projects/Q4 launch.md - Dokumenter:
Documents/<project or team>/<title>.md
Filen
En opgaves front matter indeholder id, team, state, priority, assignee, creator, labels, project, cycle, parent, estimate, due og datoerne, med source_url, der åbner den i Linear. Derefter titlen, beskrivelsen og hver kommentar, den ældste først. Et projekt har sin status, ansvarlige, teams og datoer; et dokument sit projekt, team og sin opretter. Tider er i UTC.
Synkronisering
Linear fortæller Exporters server om hver ændring. Serveren skriver filen igen med det samme og siger det til din Mac, som henter den, så en ændring når frem på få sekunder, højst et minut. En omdøbt opgave flytter sin fil; en, du arkiverer, kasserer eller sletter, mister den. “Synkroniser nu” spørger serveren først; “Fuld ny synkronisering” skriver hver fil igen.
Exporter Cloud
De første 7 dage fra din første forbindelse er gratis. Derefter er Exporter Cloud et abonnement i App Store: Linear alene eller All Cloud for alle cloudkilder, vi tilføjer, månedligt eller årligt. Når en plan udløber, stopper synkroniseringen, og dine filer bliver. Tredive dage senere sletter serveren sine kopier og tokenet.
Konto
Indstillinger › Konto viser den e-mailadresse, du loggede ind med. “Log ud” beholder forbindelsen, til du logger ind igen. “Slet konto…” afbryder hvert arbejdsområde og sletter alt, serveren har om dig. Filerne på din Mac bliver.
Kommandolinje
exporter export --source linear --dest <folder> skriver arbejdsområdets filer til en mappe, der har fået adgang på kortet Kommandolinje. Se kommandolinjen.
Problemer og løsninger
- Kortet siger “Opret forbindelse igen…”: Linear accepterer ikke længere forbindelsen, ofte fordi appen blev fjernet i Linears indstillinger. Tryk på det, og godkend igen.
- Kortet siger “Log ind…”: sessionen er udløbet. Log ind med den samme Apple-konto, så fortsætter synkroniseringen.
- En opgave mangler: tjek, at den er markeret, og tryk så på “Synkroniser nu”. Arkiverede opgaver eksporteres ikke.