Efektiivne nõuete haldamine ja jälgimine Requirements Yogi rakendusega
NB! Juhime tähelepanu, et artiklis välja toodud tooteomadused võivad ajas muutuda.
Requirements Yogi on Confluence ja Jiraga ühilduv rakendus, mis võimaldab nõudeid tõhusalt kirjeldada ja jälgida.
Järgnevas postituses anname ülevaate ja toome näiteid Requirements Yogi pistikprogrammist Confluence Cloud platvormil.
Lisaks avaldab ka Registrite ja Infosüsteemide Keskuse (lühidalt RIK) tugiinfosüsteemide tiimijuht Vesta Laansoo Requirements Yogi kasutuselevõtu põhjuse ning kirjeldab olukordi, kus see nõuete haldamist lihtsustab.
Requirements Yogi koosneb kolmest makrost ja spetsiaalsest nõuete otsingumootorist. Lühidalt öeldes saab rakenduse abil hallata nõudeid süsteemselt tänu järgmistele võimalustele:
- anda igale nõudele individuaalne võti (requirement key);
- kuvada kõik nõudega seotud info selle detailvaates;
- standardiseeritud viisil nõuetele viidata;
- tekitada nõuetevahelisi seoseid;
- luua nõudest erinevaid versioone ja neid võrrelda;
- pärida nõudeid spetsiaalsest otsingumootorist soovitud kriteeriumite kaupa.
Aga milleks ikkagi need makrod ja kuidas see kõik välja näeb? Selgitame lähemalt ja vaatame näiteid!
Nõude kirjeldamise esimene etapp võiks olla sellele võtme omistamine (Requirement Yogi makro).
Võti on nõude unikaalne identifikaator, mis koosneb soovitud tähtedest ja/või numbritest ning sellele klikkimine avab nõude detailvaade.
Joonis 1. Requirements Yogi 3 makrot. Makrode kiireks ja mugavaks lisamiseks trüki klaviatuuril /req.
Võtme abil saab nõuetele dokumentatsioonis standardkujul viidata ning luua nõuete vahel seoseid (Requirement Yogi Link makro).
Et rakendusest maksimum võtta ja nõuetest kokkuvõtlik ülevaade tekitada, on tootjapoolne soovitus nõuded muuhulgas ka tabelisse kirjeldada.
Joonis 2. Nõude detailvaade, kus sellega seotud info on jagatud sektsioonidesse.
Antud tabeli seadistamiseks on kasutatud Requirement Yogi Configuration makrot, mis on vajalik nõuete indekseerimiseks ja veeru parameetrite määramiseks.
Veeru parameeter määrab muuhulgas kuidas ja kus tabelisse sisestatud infot nõude detailvaates kuvatakse.
Joonis 3. Nõuete koondtabel.
Antud Configuration makro seadistustabeli vaates on näha, et veergude „Seotud“ ja „Blokeerib“ tüüpideks märgiti „Dependency“.
See tähendab, et kui mainitud veergudesse lisada Requirements Yogi Link makroga viiteid teistele nõuetele, tekitatakse süsteemi nende vahel seosed.
Joonis 4. Configuration makro seadistustabeli vaade.
Nõude detailvaates kuvatakse seosed Dependencies sektsioonis (vt. joonis 1), kus kuvatakse nii väljaminevaid (<) kui ka sissetulevaid (>) seoseid.
Mis puutub veel Configuration makrosse, siis tasub arvestada, et teatud väärtuste nimesid (nõude detailvaate jaoks) siiski muuta ei saa, mis on makro seadistusvaates pisut ebaintuitiivne.
Seadistustabeli vaates (joonis 4) on näha, et kuigi Column 3 real on märgitud linnuke Description veerule ja lisatud väärtus ka Override name väljale, siis nõude detailvaates (joonis 2) seda nime siiski ei muudeta.
Sama kehtib ka Column 1 rea Requirement veeru puhul, kus Override name väljal on väärtus „Nõue“, kuid detailvaates kuvatakse see „Key“.
Mis teeb nõuete kirjeldamise Requirements Yogi makrodega eriti lahedaks on see, et neid saab spetsiaalsest otsingusüsteemist erinevate kriteeriumite alusel pärida.
Näiteks saab nõudeid pärida:
- Confluence lehe kaudu - page ~ ’Confluence leht’
- Seose tüübi kaudu - „to@Blokeerib = 'REQ-004'“ vasteks nõuded, mis blokeerivad nõudet REQ-004.
- Confluence ruumi kaudu – space = ’CONFLUENCE’
- Lingitud Jira pileti kaudu - jira = 'key-1'
- Mistahes property (näiteks autor või prioriteet) kaudu - @Prioriteet = 'Kõrge' või @Autor = 'Trinidad Atlassian'
- Teksti kaudu - text ~ '% something'
Paar kuud tagasi tehti Requirement Yogi Cloud tootel kättesaadavaks uus funktsionaalsus Variants.
Variants võimaldab nõudest tekitada mitu versiooni (hetkel on versioonide maksimaalne arv 5). Versioonide erisuste jälgimist toetab Modification Matrix, mille abil saab võrrelda nõuetega tehtud muudatusi versioonide kaupa.
Joonis 5. Requirements Yogi nõuete otsingumootor.
Modification Matrix võimaldab muudatusi võrrelda ka vaid konkreetsete väärtuste kaupa - näiteks kuvada ainult Description väljal tehtud muudatusi.
Joonis 6. Requirements Yogi Modification Matrix.