JIRA bij Smals. Gebruikershandleiding

Transcriptie

1 JIRA bij Smals Gebruikershandleiding Beschrijving In dit dcument wrden de basisbeginselen van het gebruik van JIRA bij Smals tegelicht. Het beschrijft he een gebruiker van buiten Smals bugs en aanvragen van verbeteringen, nieuwe functinaliteiten f taken kan signaleren en pvlgen. Dit dcument stelt k de gd practices vr die zuden meten wrden tegepast in het kader van het gebruik van Jira in samenwerking met Smals.

2 Inhudstafel 1 INLEIDING JIRA Functinaliteiten Bug VS incident3 1.4 Andere aanvragen 4 2 ALGEMEEN Inlggen Uw wachtwrd wijzigen 6 3 DE ISSUES BEHEREN Een issue aanmaken Een bestand tevegen Een schermafbeelding tevegen De issues pvlgen Wrkflw 14 4 GOOD PRACTICES

3 1 INLEIDING 1.1 JIRA Jira is de tl die Smals gebruikt m bugs en aanvragen van verbeteringen, nieuwe functinaliteiten f taken te signaleren en p te vlgen. Met die tl kunnen alle issues en/f alle taken die uitgeverd meten wrden p het vlak van de ntwikkeling eenvudig en efficiënt pgevlgd wrden aan de hand van één interface. 1.2 Functinaliteiten Met Jira kunt u: Signaleren: Bugs Aanvragen van verbeteringen Aanvragen van nieuwe functinaliteiten Aanvragen van taken De vruitgang pvlgen van de aanvragen die ingeverd werden in de tl 1.3 Bug VS incident Hewel JIRA de mgelijkheid biedt m bugs te signaleren f aanvragen vr verbeteringen, nieuwe functinaliteiten f taken in te veren, mag deze tepassing niet verward wrden met een tl vr incident reprting. Het is immers belangrijk m het nderscheid te maken tussen een incident en een bug in een tepassing. Wat is een bug? Een bug is een fut in het ntwerp van een sftware die u ter beschikking wrdt gesteld en zij ligt aan de rsprng van een functiestrnis. De ernst van die strnis kan variëren van triviaal (bijvrbeeld een kleine fut bij de weergave) tt blkkerend (bijvrbeeld een belangrijke functinaliteit van de tepassing die niet werkt). Een bug is dus een fut die gemaakt werd tijdens de ntwikkeling van de tepassing en die ervr zrgt dat een functinaliteit geheel f gedeeltelijk nbruikbaar wrdt. Enkele vrbeelden van bugs: Smmige gegevens wrden niet f niet meer cherent weergegeven

4 Na het drukken p een actieknp gebeurt er niets fwel iets nverwacht. Een futief gegeven wrdt aanvaard dr het systeem. Een technische fut wrdt gesignaleerd bij het gebruik van een bepaalde functinaliteit in een precieze cntext. Bugs meten aangegeven wrden in de tepassing JIRA. Wat is een incident? Een incident is een nverwachte en ngebruikelijke string van de diensten die zrgen vr de gede werking van de tepassing, typisch in de prductiemgeving. Dit betekent dat een tepassing die gewnlijk beschikbaar is en functineert in een bepaalde mgeving gedeeltelijk f vlledig nbruikbaar wrdt na een incident. Enkele vrbeelden van incidenten: Een tepassing die gewnlijk beschikbaar is, is plts ntegankelijk. Een ngewne futmelding geeft aan dat een dienst f een functinaliteit nbeschikbaar is. Incidenten meten gesignaleerd wrden aan de dienst die aangesteld werd vr uw rganisatie: Supervisie Smals, het cntactcenter (ehealth), uw helpdesk f cntactcenter, 1.4 Andere aanvragen In JIRA kunnen niet alleen bugs ingeverd wrden maar k andere srten aanvragen. Of u JIRA kunt gebruiken vr die aanvragen, hangt af van wat uw prjectverantwrdelijke u aanbeveelt. Het is mgelijk dat u gevraagd wrdt m JIRA alleen te gebruiken m bugs te signaleren die wrden vastgesteld in uw tepassing. Verbeteringsaanvraag Een verbeteringsaanvraag kan ingeverd wrden m aan het ntwikkelteam te melden dat een functinaliteit verbeterd kan wrden en p welke manier. Enkele vrbeelden van verbeteringsaanvragen: Een scherm dat de velden nverzichtelijk weergeeft, met herzien wrden dr de analisten m ze p een meer intuïtieve manier te hergreperen. Een scherm bevat spellingfuten en er wrdt een verbetering gevraagd. De verbeteringsaanvragen in JIRA hebben bij vrkeur betrekking p kleine verbeteringen znder belangrijke impact p de basiswerking van de tepassing. Vr belangrijkere verbeteringsaanvragen wrdt aangeraden rechtstreeks cntact p te nemen met de verantwrdelijke(n) van het prject

5 Aanvraag van een nieuwe functinaliteit Een aanvraag m een nieuwe functinaliteit te te vegen, kan ingeverd wrden m het ntwikkelteam te laten weten dat een nieuwe functinaliteit gewenst is en wat het met implementeren. Enkele vrbeelden van nieuwe functinaliteiten: Teveging van een zekfunctie p een scherm dat een lijst aanbiedt. Teveging van een functie m gegevens te exprteren in het CSV-frmaat. Net als vr de verbeteringsaanvragen wrdt in JIRA bij vrkeur alleen de teveging aangevraagd van beperkte nieuwe functinaliteiten znder belangrijke impact p de basiswerking van de tepassing. Om belangrijkere functinaliteiten te laten tevegen, wrdt aangeraden rechtstreeks cntact p te nemen met de verantwrdelijke(n) van het prject. Aanvraag m een taak uit te veren JIRA kan k gebruikt wrden m taken te beheren in het kader van de pvlging van bepaalde prjecten. Daarvr kunt u een aanvraag vr de realisatie van een taak inveren die dan uitgeverd zal wrden dr het ntwikkelteam. Enkele vrbeelden van aanvragen m taken uit te veren: Extractie van gegevens uit de database. Onderzek naar de cherentie van gegevens die beschikbaar zijn in de tepassing

6 2 ALGEMEEN 2.1 Inlggen De tepassing is tegankelijk p het adres: U zal een mail ntvangen met uw Username en met een link m de eerste keer in te lggen p de tepassing en uw wachtwrd te kiezen. 2.2 Uw wachtwrd wijzigen Om uw wachtwrd te wijzigen, klikt u p het pijltje naast uw naam bvenaan rechts p het scherm. Daarna klikt u p "Prfile". Klik dan p "Change passwrd"

7 In het vlgende scherm geeft u uw ude wachtwrd in vraleer u uw nieuwe wachtwrd twee keer na elkaar invert. Tt slt klikt u p "Update"

8 3 DE ISSUES BEHEREN 3.1 Een issue aanmaken Om een issue aan te maken, klikt u p "Create issue" bvenaan rechts p het scherm. Selecteer dan het prject en het type issue en klik p "Create". Verschillende types issues zijn beschikbaar bij de creatie. Alleen bepaalde types zullen gebruikt wrden in het kader van het gebruik van JIRA bij Smals: Bug Imprvement (verbetering) New Feature (nieuwe functinaliteit) Task (taak) Deze verschillende types wrden beschreven in het hfdstuk "Inleiding". Met het g p een efficiënte verwerking met vr elke bug f aanvraag een apart issue aangemaakt wrden. Een issue mag dus alleen de beschrijving bevatten van één bug f één aanvraag. Issues die meerdere bugs f meerdere aanvragen beschrijven, zullen verwrpen wrden dr uw prjectverantwrdelijke bij Smals

9 Ver dan de gevraagde gegevens in en klik p "Create": Summary * (verplicht veld) In dit veld kunt u een krte beschrijving (1 regel) van het issue inveren. Pririty * (verplicht veld) In dit veld kunt u de belangrijkheid f de ernst van het issue aangeven. De mgelijke waarden zijn: Blcker: de hgste pririteit. Deze waarde geeft aan dat het issue blkkerend is en verwerkt met wrden vr alle andere. Critical: geeft aan dat het aangemaakte issue een prbleem is en een dringende interventie vraagt

10 Majr (standaard): geeft aan dat het issue een belangrijke impact heeft. Minr: geeft aan dat het issue een beperkte impact heeft. Trivial: de laagste pririteit. Deze waarde geeft aan dat het issue weinig f geen impact heeft. Cmpnent/s (facultatief veld) In dit veld kunt u aangeven p welke cmpnent van de tepassing het issue een impact heeft. Affects versin/s (facultatief veld) In dit veld kunt u aangeven p welke versie van de tepassing het issue een impact heeft. Envirnment * (verplicht veld) In dit veld kunt u aangeven in welke mgeving (Acceptatie f Prductie) het issue gedetecteerd werd. Descriptin * (verplicht veld) In dit veld kunt u het issue beschrijven. Om het issue sneller te kunnen verwerken en nndige uitwisselingen zveel mgelijk te beperken, met de beschrijving van het issue z gedetailleerd en vlledig mgelijk zijn. Nadat het issue is aangemaakt, kunt u k bijlagen tevegen: Een bestand Een printscreen Een bestand tevegen Nadat het issue is aangemaakt, wrden de details ervan weergegeven. U kunt dan een bestand tevegen dr te klikken p "Attach File". In het vlgende scherm selecteert u het bestand dr te klikken p "Brwse " en vert u een cmmentaar in m uit te leggen wat het bestand bevat. Dan klikt u p "Attach"

11 3.1.2 Een schermafbeelding tevegen Om een schermafbeelding te te vegen aan het issue, met u eerst de afbeelding maken. Klik hiervr p de tets "Print", "Scrn", "prt sc" f "Impr écran Syst" van uw klavier wanneer het scherm getnd wrdt dat u wilt delen met het ntwikkelteam. Nadat u de schermafbeelding hebt gemaakt, klikt u eerst p "Mre Actins" en dan p "Attach Screensht" in het detailscherm van het issue. In het vlgende scherm klikt u p "Paste" m de eerder gemaakte schermafbeelding te plakken. Typ dan een naam in het veld "Filename", indien ndig een cmmentaar in het veld "Update cmment" en klik p "Attach". Schermafbeeldingen zijn het hulpmiddel bij uitstek m een snelle identificatie van de ingeverde aanvragen mgelijk te maken. In de mate van het mgelijke meten zij aan de issues wrden tegevegd

12 3.2 De issues pvlgen Alle issues die in JIRA ingeverd werden, zijn permanent tegankelijk p verschillende manieren. U kunt aan uw prjectverantwrdelijke bij Smals altijd vragen m u een gepersnaliseerd dashbard aan te maken waarmee u snel de JIRA-issues kunt terugvinden die u interesseren

13 Via het tabblad Prjects U kunt de issues cnsulteren dr te klikken p het tabblad "Prjects" bvenaan rechts en dan p uw prject. In het detailscherm van het prject klikt u p "Issues" m een samenvatting van de issues te krijgen. Via het tabblad Issues U kunt de issues k cnsulteren dr te klikken p het tabblad "Issues" bvenaan het scherm. Dan hebt u de vlgende mgelijkheden: Zeken p basis van de laatste pzeking (Current filter) Direct naar de recente issues gaan (Recent issues) Issues pzeken (Search fr issues) Een issue aanmaken (Create issue)

14 Via de Issue Navigatr Met de Issue Navigatr kunt u issues pzeken aan de hand van verschillende criteria. U kunt de Issue Navigatr penen dr te klikken p het tabblad "Issues" en daarna p "Search Issue". Om issues p te zeken, selecteert u links de gewenste parameter(s) en klikt u vervlgens p de knp "View". Selecteer altijd het prject waarbij u betrkken bent m het aantal resultaten te beperken. U kunt een issue p elk mment cnsulteren dr gewn te klikken p de identificatie ervan. 3.3 Wrkflw Nadat ze ingeverd zijn, kunnen de issues verwerkt wrden dr een grt aantal medewerkers. Daarm werd een wrkflw uitgewerkt zdat iedereen permanent kan pvlgen wat de status van een issue is. Zdra het issue ingeverd is, krijgt het de status "New". De prjectverantwrdelijke zal het dan kunnen valideren m aan het ntwikkelteam te laten weten dat de verwerking kan beginnen. Zdra het issue vlledig verwerkt is dr het ntwikkelteam, zal het de status "Verified" krijgen. U zult het dan kunnen afsluiten als de plssing ervan vldet aan uw verwachtingen. U kunt het k pnieuw penen als de vrgestelde plssing niet de verwachte plssing is

15 De vlledige wrkflw wrdt hiernder beschreven: De mgelijke statussen zijn de vlgende: New: het issue werd in het systeem ingeverd dr de klant f dr een analist. Open: het issue werd gevalideerd dr de prjectverantwrdelijke m verwerkt te wrden dr het ntwikkelteam. In Prgress: het issue wrdt nderzcht/verbeterd. Reslved: het issue werd verwerkt dr het ntwikkelteam. Verified: de prjectverantwrdelijke f de tester heeft geverifieerd f de plssing aan de verwachtingen vldet. Clsed: de klant f de verantwrdelijke heeft het issue afgeslten na verificatie. Repened: het issue werd pnieuw gepend. On hld: het issue blijft in het systeem staan maar wrdt mmenteel niet verwerkt. Rejected: het issue werd verwrpen want het werd verkeerd f nvlledig ingeverd. De status van het issue kan permanent gecnsulteerd wrden in het detailscherm van het issue

16 Om de status van het issue te wijzigen, klikt u p de actieknp die vereenstemt met de gewenste status. 4 GOOD PRACTICES Om te kmen tt de best mgelijke samenwerking met het ntwikkelteam van uw prject en z de plssing van de issues efficiënter te laten verlpen, geven wij hiernder een krte samenvatting van de gd practices die zuden meten wrden tegepast bij het gebruik van de JIRA-tl: Uw lgin en wachtwrd zijn persnlijk. Deel ze met niemand. Vraag aan uw prjectverantwrdelijke m u een gepersnaliseerd dashbard aan te maken waarmee u de issues die u interesseren snel kunt terugvinden. Bij de creatie van een issue: Verifieer f er ng geen issue bestaat vr de bug f de aanvraag die u wilt inveren. Vergeet de 4 verplichte velden niet in te vullen/aan te duiden (Summary, Pririty, Envirnment en Descriptin). Ver een z duidelijk mgelijke Summary in. Geef aan in welke mgeving het issue gedetecteerd werd (Acceptatie f Prductie). Stel een gedetailleerde en vlledige beschrijving p. Veg een bestand te indien ndig. Veg in de mate van het mgelijke een schermafbeelding te. Nadat uw prjectverantwrdelijke de issues geverifieerd heeft, verifieert u het resultaat en sluit u de issues af waarvr de plssing aan uw verwachtingen vldet. Anders pent u ze pnieuw