Jira Handleiding. DEVENTit - Implementatieplan Blad 1/10

Transcriptie

1 Jira Handleiding DEVENTit - Implementatieplan Blad 1/10

2 Inhoudsopgave 1. Handleiding Jira Het Dashboard Pie Chart Filter Results: Alles Filter Results: Prio Highest Filter Results: Prio High Filter Results: Prio Medium Filter Results: Prio Low Filter Results: Waiting Filter Results: Resolved Issues aanmaken Issue type Priority Summary Description Attachment Overige velden Een issue opzoeken Weergave zoekresultaten Issue Detailweergave Status Resolution Fix Version Assignee Watchers Comments Gebruikersprofiel DEVENTit BV Blad 2

3 1. HANDLEIDING JIRA Jira is het systeem dat we gebruiken om meldingen betreffende het Atlantis systeem te registreren en te volgen. Deze meldingen, issues genoemd, lopen uiteen van vragen tot meldingen van fouten in het systeem. Als de status van een issue veranderd, bijvoorbeeld omdat er een opmerking - comment binnen Jira- geplaatst wordt of omdat de issue is opgelost, dan wordt er automatisch een gestuurd naar het adres van de gebruiker. Op deze manier is goed bij te houden wat de status van een gedane melding is. 2. HET DASHBOARD Het eerste scherm dat u ziet na inloggen in Jira is het System Dashboard. Dit scherm geeft een overzicht van uw project. DEVENTit BV Blad 3

4 2.1 Pie Chart De Pie Chart geeft het aantal issues per status aan. De verschillende statussen worden verderop in dit document uitgelegd. Door op een taartpunt te klikken worden alle issues met de betreffende status in een lijst getoond. 2.2 Filter Results: Alles Deze lijst bevat alle gemaakte issues van het project, gesorteerd op issue code. De hoogste code, dus laatst gemaakte issue, staat bovenaan. 2.3 Filter Results: Prio Highest Hier staan alle nog niet opgeloste issues met de hoogste prioriteit. 2.4 Filter Results: Prio High Hier staan alle nog niet opgeloste issues met hoge prioriteit. 2.5 Filter Results: Prio Medium Hier staan alle nog niet opgeloste issues met gemiddelde prioriteit. 2.6 Filter Results: Prio Low Hier staan alle nog niet opgeloste issues met de laagste prioriteit. 2.7 Filter Results: Waiting Hier staan alle issues die de status Waiting hebben. Deze issues wachten op antwoord van u. 2.8 Filter Results: Resolved Hier staan alle issues met de status Resolved. Deze issues zijn opgelost, maar de oplossing is nog niet beschikbaar. 3. ISSUES AANMAKEN Vanuit het System Dashboard is gemakkelijk een nieuwe issue aan te maken door bovenin op Create issue te klikken. Deze functionaliteit is ook beschikbaar in het menu onder Issues->Create Issues. Dit opent het volgende scherm: DEVENTit BV Blad 4

5 DEVENTit BV Blad 5

6 3.1 Issue type We kennen een aantal verschillende issue types: Bug: Improvement: Foutmeldingen en meldingen van niet werkende functionaliteit krijgen dit type. Dit is voor een verbetering van een al bestaande functie binnen Atlantis. New Feature: Question: Task: Dit is voor een toevoeging van nieuwe functionaliteit in Atlantis. In de meeste gevallen zal hier een offerte voor worden opgesteld. Dit is voor een vraag over de werking van Atlantis. Dit is voor het uitvoeren van een taak, bijvoorbeeld het aanpassen van configuratie. 3.2 Priority In dit veld wordt de prioriteit van een issue aangegeven. We kennen hier 4 niveaus: Highest: High: Medium: Wanneer een probleem voor ernstige belemmering zorgt voor het werken in Atlantis dan krijgt deze de hoogste prioriteit. Issues met deze status krijgen voorrang op alle andere issues. Dit wordt gebruikt voor fouten die niet productie belemmerd zijn, maar wel erg vervelend of vertragend. Deze status is bedoeld voor foutmeldingen die niet storen, vragen, verbeteringen en taken. Ook testresultaten krijgen de status Medium. Low: In het geval dat een issue helemaal geen haast heeft, dan kan deze prioriteit Low krijgen. 3.3 Summary Bij summary wordt een korte beschrijving van het probleem gezet. Zorg dat deze duidelijk en overzichtelijk is, zodat gemakkelijk in het dashboard herkenbaar is waar de issue over gaat. 3.4 Description Hier kan een uitgebreidere beschrijving van het probleem geplaats worden. Probeer issues zoveel mogelijk te beperkten tot één melding per issue. Door meldingen uit te splitsen in verschillende issues, ook als deze gerelateerd zijn, kunnen er meerdere mensen tegelijkertijd aan werken. Ook is zo de status per melding beter bij te houden. Zorg dat de beschrijving zo uitgebreid en duidelijk mogelijk is. Vermeld bij een fout altijd de gedane acties die tot de foutmelding hebben geleid, eventueel met een url naar de betreffende pagina in Atlantis. Hoe sneller wij het probleem kunnen vinden en reproduceren, hoe sneller we tot een oplossing kunnen komen. DEVENTit BV Blad 6

7 3.5 Attachment Via de tab attachment is er een multimediabestand te koppelen aan de issue, zoals een screenshot of een word of pdf bestand. Als u na het aanmaken van een issue alsnog een attachment wilt toevoegen dan kan dat door in het detailscherm te klikken op More->Attach Files. 3.6 Overige velden De overige velden hoeven niet ingevuld te worden. Deze gebruiken wij tijdens het afhandelen van de issue. Voor de volledigheid zullen we deze wel even toelichten: Getest door klant: Sprint: Dit veld kan ingevuld worden om aan te geven wie binnen de organisatie het probleem heeft geconstateerd en/of om aan te geven wie dit na oplevering heeft hertest. Dit is een veld dat DeventIt intern gebruikt voor planning. Deze zal bij normale issues nooit gevuld zijn. Helptekst bijwerken: Branch: Fix on: Soms wijzigt de functionaliteit van schermen in Atlantis. In dat geval moet de helptekst bijgewerkt worden. Met dit veld houden wij bij of dit nog uitgevoerd moet worden. Dit veld helpt ons om bij te houden in welke code Branch een issue is opgelost. Als er meerdere omgevingen beschikbaar zijn, bijvoorbeeld een testomgeving en een productieomgeving, dan kan hier gemeld worden op welke omgeving(en) de issue is opgelost. 4. EEN ISSUE OPZOEKEN Via Quick Search in het System Dashboard is er te zoeken naar aangemaakte issues. Dit kan door de issue-code in te vullen, of een woord dat voorkomt in de issue. Een uitgebreidere zoekfunctie is te vinden onder Issues->Search for issues. Bovenin dit scherm is de volgende balk zichtbaar: Hier is te filteren op type issue en status, eventueel met een specifieke tekst. Door op het vergrootglas te drukken wordt de zoekvraag uitgevoerd en worden onder de zoekbalk de resultaten weergegeven. DEVENTit BV Blad 7

8 4.1 Weergave zoekresultaten Standaard worden de gevonden resultaten als twee kolommen weergegeven; aan de linkerkant staat issue-code en summary, aan de rechterkant de beschrijving en status van de geselecteerde issue. Door op het icoon aan de rechterkant van de zoekbalk te klikken en te kiezen voor List view in plaats van Detail view kunt u het zoekresultaat aanpassen zodat de issues iets compacter in de lijst worden getoond. 5. ISSUE DETAILWEERGAVE In de detailweergave van een issue is de status bij te houden en is het mogelijk om extra opmerkingen te plaatsen. Het scherm zal er als volgt uit zien: DEVENTit BV Blad 8

9 In het detail zullen de gegevens staat die bij het aanmaken zijn ingevuld, echter zijn hier ook een aantal andere velden zichtbaar die we verder zullen toelichten. 5.1 Status Aan de status is de huidige status van de issue te zien. Registered en Open issues moeten nog bekeken worden of zijn in behandeling 5.2 Resolution Bij een Waiting status hebben wij een vraag gesteld aan u en wachten wij op een antwoord. Daar kunt u dan op antwoorden met een comment. Daarna kunt de issue weer op Open zetten door op Open issue te klikken. Als een issue Resolved is, dan hebben wij de issue opgelost, maar is het resultaat nog niet voor u zichtbaar. Dit kan bijvoorbeeld komen omdat er eerst nog een nieuwe versie geplaatst moet worden, of omdat er een indexering afgerond moet worden. Als een issue closed is dan is het probleem opgelost en de oplossing beschikbaar, is de vraag beantwoord of is de taak uitgevoerd en indexering afgerond. Mocht een closed issue toch niet naar tevredenheid zijn opgelost dan kan deze met Reopen Issue opnieuw geopend worden. Deze issue krijgt dan de status Reopend mee en komt automatisch op Priority Highest te staan. Een issue heeft een resolution. Deze resolution is voornamelijk belangrijk bij de status closed omdat deze nog extra informatie over het sluiten van een issue kan bevatten. Unresolved: Een Unresolved issue is nog niet gesloten. Fixed: Won t fix: Duplicate: Incomplete: Cannot reproduce: Done De issue is opgelost of beantwoord. De issue zal niet opgelost worden. Dit kan bijvoorbeeld komen omdat een gevraagde aanpassing ongewenste effecten voor de standaard werking van Atlantis zou hebben of omdat het om nieuwe functionaliteit gaat en er geen interesse is in een offerte. De issue meldt hetzelfde als een eerder aangemaakt issue en is daarom gesloten als duplicaat. Als de issue dusdanig weinig informatie bevat dat we deze niet kunnen behandelen dan wordt deze gesloten met status Incomplete. Als een foutmelding niet gereproduceerd kan worden dan is het vinden van een oorzaak, en dus oplossing, vaak bijna onmogelijk. Als ook na navraag het niet mogelijk blijkt om tot reproduceerbare stappen te komen, dan wordt de issue gesloten met status Cannot reproduce. Vergelijkbaar met resolution Fixed; de issue is Klaar. DEVENTit BV Blad 9

10 5.3 Fix Version Als een issue gesloten wordt dan krijgt deze een Fix version mee. Aan deze versie is te zien vanaf welke versie van Atlantis het probleem is opgelost. Als de Fix version aangeeft Geen versie dan is de oplossing niet versie gebonden. Dit is zo bijvoorbeeld bij configuratie aanpassingen, maar ook bij een beantwoorde vraag. Om binnen Atlantis te kijken welke versie geïnstalleerd staat klikt u, na inloggen, op de grote tekst bovenin het scherm. Er opent dan een pop-up waarin het huidige versienummer vermeld staat. Als het versienummer in de issue hoger is dan dit nummer, dan is de oplossing nog niet beschikbaar. Als het versienummer lager of gelijk is dan wel. Om uit te zoeken precies welke issues in welke versie opgelost zijn geweest, gaat u in het System Dashboard naar Projects->[project] en klikt u vervolgens links op Versions. Door daar op een versienummer te klikken wordt de versie geopend. Vervolgens kunt u bij Issues de betreffende issues opvragen. 5.4 Assignee Bij assignee kunt u zien aan wie de issue is toegewezen. 5.5 Watchers Aan de Reporter (melder) van de issue worden s verstuurd als de status veranderd. Het kan zijn dat er meerdere Jira gebruikers aan één project gekoppeld zijn. Als de issue is aangemaakt door een collega, maar u toch graag ook van de status op de hoogte gehouden wilt worden, dan kunt u zich aanmelden als Watcher. U ontvangt dan ook de status- s. Dit is eenvoudig te doen door achter 'Watchers' te klikken op Start watching this issue. Mocht u de s niet meer willen ontvangen dan kunt u klikken op Stop watching this issue. 5.6 Comments Onder de description van de issue staan de comments. Deze bevatten vragen, verduidelijkingen of opmerkingen. U kunt zelf een Comment toevoegen door onderin op de Comment knop te drukken. Het plaatsen van comments stuurt, net als een statusverandering, automatisch een GEBRUIKERSPROFIEL U kunt uw gebruikersprofiel aanpassen door, na inloggen, op het icoon rechts bovenin te klikken en daar te kiezen voor Profile. Door op Change password te drukken kunt u uw wachtwoord aanpassen. Aan de rechterkant is uw activity stream zichtbaar. Hier kunt u uw laatst gedane acties terugzien. DEVENTit BV Blad 10