Jira

In LaunchCal kan een lancering de Jira-epic, of welk issue dan ook, volgen waarin haar werk wordt bijgehouden. Haar status verandert als die van het issue verandert, ze toont hoeveel onderliggende issues van een epic afgerond zijn, en de opmerkingen bij het issue verschijnen bij de lancering.

Een heel Jira-project heeft geen eigen status, dus een link ernaartoe blijft een gewone link: link een van de epics of issues ervan om het te volgen.

Taktoria leest alleen uit Jira (issues met hun status, onderliggende issues en opmerkingen, en de namen van de mensen die ze schreven): het maakt daar nooit iets aan, wijzigt niets en plaatst geen opmerkingen.

Alleen een eigenaar of beheerder van de workspace kan Jira koppelen.

1. Open Instellingen → Integraties.
2. Kies onder Ticketsystemen de optie Jira koppelen.
3. Log in bij Atlassian, kies de Jira-sites die je wilt koppelen, en keur het goed.

Taktoria leest Jira als het Atlassian-account dat het koppelt. Elk issue dat dat account kan zien, kan aan een lancering worden gelinkt, met de opmerkingen erbij, door iedereen die de lancering kan bewerken, ook door iemand die het issue in Jira niet kan openen. Koppel Jira daarom niet met je eigen account, maar met een account dat voor Taktoria is bedoeld en alleen de projecten ziet die je lanceringen volgen. Een koppeling met het account van een persoon stopt bovendien met synchroniseren als die persoon vertrekt of de toegang verliest.

Iedereen die een lancering kan bewerken, kan haar linken, synchroniseren of de link verwijderen.

1. Open het tabblad Details van de lancering.
2. Plak onder Ticketproject het adres van de epic of het issue in Projectlink: de eigen pagina ervan, of een bord of lijst waarin het openstaat.
3. Kies Project linken.

Het issue moet op een gekoppelde Jira-site staan, en het account dat koppelde moet het kunnen zien. Het synchroniseert meteen. Een link die is geplakt voordat Jira gekoppeld was, blijft als gewone link bewaard en begint te synchroniseren zodra Jira gekoppeld is.

Een AI-assistent die aan LaunchCal is gekoppeld, en de REST API, kunnen een lancering ook linken, synchroniseren en de link verwijderen, volgens dezelfde regels.

Een gelinkte lancering wordt eenmaal per dag gesynchroniseerd tot ze gelanceerd is, en telkens wanneer iemand Nu synchroniseren kiest.

• Status: als de status van het issue verandert, volgt die van de lancering: te doen wordt Afbakening, in uitvoering wordt In ontwikkeling (een lancering die al in Ontwerp of Testen staat, blijft daar), en een issue dat is afgesloten als “wordt niet gedaan” of duplicaat wordt Gepauzeerd. Een status die je in LaunchCal kiest, blijft staan tot die van het issue weer verandert.
• Voortgang: het aandeel afgeronde onderliggende issues van de epic.
• Opmerkingen: elke opmerking bij het issue wordt een opmerking op het tabblad Activiteit van de lancering, gemarkeerd met Uit Jira en een link ernaartoe. Een opmerking die in Jira beperkt is tot bepaalde mensen, wordt nooit binnengehaald. Bewerk er een in Jira en de volgende synchronisatie brengt de wijziging.
• Voltooid: als het issue klaar is, meldt de lancering dat ze klaar is en horen de eigenaren het.

Wat een synchronisatie wijzigt, staat op naam van Jira, in de geschiedenis van de lancering, in wat de eigenaren ontvangen en in het auditlogboek. Het auditlogboek legt vast dat een opmerking binnenkwam of veranderde, nooit wat erin staat of wie erin genoemd wordt.

• Het lanceert nooit iets. Een afgerond issue maakt de lancering klaar; iemand kiest nog steeds zelf Druk om te lanceren! zodra over de verplichte beoordelingen is besloten.
• Het wijzigt nooit een lancering die al gelanceerd is.
• Het schrijft nooit naar Jira.
• Het haalt nooit een opmerking binnen die beperkt is tot bepaalde mensen.
• Het draait nooit een status terug die je in LaunchCal hebt gekozen, tenzij de status van het issue weer verandert.

Link verwijderen, op het tabblad Details van de lancering, stopt het synchroniseren van die lancering; wat al binnengehaald is, blijft.

Ontkoppelen, in Instellingen → Integraties, stopt het synchroniseren van alle lanceringen vanuit Jira. Lanceringen houden wat ze linken en alles wat tot dan toe is gesynchroniseerd, en gaan verder zodra Jira weer gekoppeld is. Jira ontkoppelen verwijdert ook de namen van Jira-gebruikers uit de opmerkingen die zijn binnengehaald, zoals Atlassian vereist: een opmerking houdt haar tekst maar niet de naam van wie haar schreef, en een vermelding luidt dan @someone. Hetzelfde gebeurt met de namen van één persoon wanneer Atlassian meldt dat diens account is opgeheven.

Atlassian geeft Taktoria geen manier om zijn eigen toegang tot Jira in te trekken: verwijder Taktoria dus ook uit de gekoppelde apps in je Atlassian-account om die toegang helemaal weg te halen.

• Het issue is niet gevonden: het is verwijderd, verplaatst, of staat ergens waar het account dat koppelde niet bij kan. Geef dat account toegang tot het project ervan, of link het huidige adres.
• Jira heeft de koppeling geweigerd: een eigenaar of beheerder van de workspace koppelt Jira opnieuw in Instellingen → Integraties. Dit gebeurt als het account dat het koppelde vertrekt of de toegang verliest.
• Jira gaf geen antwoord bij de laatste synchronisatie: de volgende synchronisatie probeert het opnieuw, of kies later Nu synchroniseren.
• Een heel project wordt niet gesynchroniseerd: het heeft geen eigen status. Link in plaats daarvan een van de epics of issues ervan.
• Er ontbreekt een opmerking: opmerkingen die in Jira beperkt zijn tot bepaalde mensen, worden nooit binnengehaald.