Kattavan JIRA-tiketin tekeminen
Aloita katsomalla seuraavan listan videot:
Atlassian JIRA on SKJ Systems Ltd:n käyttämä työnohjausjärjestelmä. Kaikki ohjelmistoon liittyvät asiat käsitellään lähtökohtaisesti Jiran kautta. JIRA on ollut SKJ:n käytössä 27.3.2014 lähtien.
JIRA tiketti sisältää YHDEN virheen tai toiveen. Tee siis jokaisesta yksittäisestä asiasta eri tiketti, johon kuvaat alla olevien kohtien perusteella kattavasti aiheen sisällön. Jos asiakokonaisuus on suuri, määrittely on parempi tehdä suoraan JIRA:n kautta ja SKJ:n avustuksella.
Ennen kuin teet SKJ Jiraan tiketin, luethan seuraavat kohdat huolella. Tarkistathan haun avulla, ettei samasta aiheesta ole jo tehty ilmoitusta.
Lähtökohtaisesti tiketti luodaan aina SE-projektiin!
Ohjelmistovirheiden ilmoittaminen
4.3 Virheilmoituksen yhteydessä asiakkaan on ilmoitettava ja ylläpitopalvelua tehtäessä pyydettäessä osoitettava tai kuvattava, miten virhe ilmenee. Toimittajan pyynnöstä asiakkaan edustajan on oltava tavoitettavissa ylläpitopalvelua tehtäessä.
HUOM! Tee aluksi tämä.
Ensimmäisenä askeleena virheen korjaamiseen on virheen toistaminen uusimmalla ohjelmistoversiolla.
Mahdollisessa virhetilanteessa tulee aina ensimmäiseksi käydä läpi seuraavat kohdat:
- SKJ Ohjelmistoversio
- Toistuuko virhe uusimmalla ohjelmistoversiolla omissa testeissä?
- Toistuuko virhe muulla, kuin asiakkaan varmuuskopiolla tai asiakkaan ympäristössä?
- Jirasta ei löydy tietoa kyseisestä asiasta?
- Yksiselitteinen kaava virheen toistamiseen
- Virheilmoitus
- Pervasiven versio
- Asiakkaan kannan varmuuskopio
- Ohjelmistossa käytettävä käyttäjä
- Ohjelmassa tai sen osassa käytettävät asetukset / parametrit
- Virhetiedostot (*.elf) kokonaisuudessaan ohjelmahakemistosta, mikäli sellainen on muodostunut (ei sisälly varmuuskopioon)
- Lokitiedostot, mikäli ne eivät sisälly varmuuskopioon (/wiki/spaces/SK/pages/1411776722 / sisältyy varmuuskopioon)
- Järjestelmäympäristön kuvaus, onko kyseessä
- Virtuaalipalvelin
- Kassa
- Taustakone
- Ketjuympäristö
- Verkkokauppa
- Järjestelmäkokoonpanon kuvaus (laitteet ja niiden tekniset tiedot)
Mikäli edellä mainitut asiat on käyty läpi ja virhe toistuu edelleen, kirjataan siitä Jiraan tiketti.
- Sinulla täytyy olla tunnukset Jiraan
- Mene osoitteeseen https://jira.skj.fi ja kirjaudu sisään
- Paina ylhäältä Create ja valitse projektiksi SKJ Eteinen (SE)
- Seuraa tarkasti alla olevia ohjeita ja luo kattava tiketti
JIRA:n virhetiketin kuvaukseen tulee kirjata seuraavat asiat:
- Summary - Kirjoita virhettä hyvin kuvaava otsikko. (Mitä tapahtuu, missä ja miten)
- Issue type - Tiketin tyyppi. Ohjelmistovirheen tyyppi on bug, parannusehdotuksen tyyppi improvement ja uuden ominaisuuden tyyppi new feature
- Description - Mitä tapahtuu? (kaatuuko ohjelma, tuleeko poikkeusilmoitus, meneekö laskenta väärin jne.)
- Onko ohjelma aikaisemmin toiminut oikein? Missä versiossa?
- Kuinka ohjelman tulisi mielestäsi toimia?
- Description - Voiko ongelman toistaa ja jos voi niin kuinka se tapahtuu? Kerro toimintakaava askel askeleelta.
- Components - Mikä sovellus on kyseessä (winskj, ostotilaus, myyntitilaus jne.)
- Affects version - Mikä versio ohjelmasta on käytössä?
- Päivämäärä ja aika, jolloin virhe ilmeni.
- Attachments - Jos toimintaketjuun liittyy asetuksia tai parametreja, ota ruudunkaappaus asetuksista, kirjoita ne ylös tai toimita ne jollain muulla tavalla.
- Labels - Mahdollinen asiakkuus ja muita tarvittavia tukisanoja.
- Reporter / Description - Allekirjoitus, vähintään nimi ja sähköposti.
- Watchers - Lisää tikettiin henkilöt, joiden tulee saada informaatiota kyseiseen asian käsittelyyn liittyen.
- Ole valmis toimittamaan varmuuskopio datoista niin pyydettäessä.
- Liitä tikettiin virheestä muodostunut lokitiedosto (*.elf) tai muu /wiki/spaces/SK/pages/1411776722, mitä SKJ kirjoittaa. Pelkkä kuva virheilmoituksesta ei riitä, vaan mukaan tarvitaan koko Call Stack. Kopioi siis teksti, tai liitä mukaan koko *.elf.
Yleensä tilannetta selkeyttää paljon ruutuvideo tilanteesta. Työkalu ruutuvideon tallennukseen esimerkiksi http://www.screenpresso.com/
tai .gif animaation tekemiseen http://www.cockos.com/licecap/
Vahvennettuna on kirjoitettu Jiran kentät, joihin tiedot tulee laittaa tikettiä tehtäessä. Jos kenttää ei ole määritelty, kirjoitetaan asiat descriptioniin.
Ominaisuustoiveen ilmoittaminen
Lue ensin tämä: Ominaisuustoiveiden toteutus
Ennen tiketin kirjoittamista, mieti ominaisuutta seuraavien kysymyksien pohjalta:
- Ollaanko ominaisuudesta valmiita maksamaan?
- Mitä hyötyjä ominaisuus tuo?
- Kenelle ominaisuudesta on hyötyä?
- Mihin ohjelman osiin ominaisuus täytyy toteuttaa?
- Mihin ohjelman osiin ominaisuus vaikuttaa ja voi vaikuttaa?
- Tuoko ominaisuus toistettavaa hyötyä?
- Onko ominaisuus monistettava?
- Voidaanko sitä käyttää useammalla toimialalla?
- Voidaanko sitä käyttää eri tarkoituksiin?
- Onko ominaisuus oikeasti tärkeä vai vain kiva ominaisuus, jota ilmankin pärjätään?
- Kuinka suuri ominaisuus on työmäärältään verrattuna saatuun hyötyyn?
- Voiko asian ratkaista jo olemassa olevilla ominaisuuksilla?
- Voiko asian ratkaista jollain muulla tavalla, kuin ohjelmistomuutoksella?
- Kuinka saisin ominaisuudesta mahdollisimman yksinkertaisen?
- Voiko ominaisuusmuutos estää jonkun muun toiminnon tai muuttaa jonkun muun toiminnon toiminnallisuuksia?
Jos olet vastannut mielessäsi edellä oleviin kysymyksiin kattavasti, luo tiketti:
- Kirjoita ominaisuutta hyvin kuvaava otsikko.
- Perustele miksi ominaisuus olisi hyvä olla ja kenelle siitä on hyötyä.
- Mihin ohjelman osaan ominaisuus tulisi.
- Mihin ohjelman osiin ominaisuus vaikuttaa.
- Kerro monipuolisesti ja laajasti mitä halutaan tapahtuvan, missä ja miten.
- Kuvaa ja kerro ominaisuuteen liittyvä toiminnallisuus kattavasti.
- Allekirjoitus, vähintään nimi ja sähköposti.
Ole valmis vastaamaan sinulle esitettyihin lisäkysymyksiin sekä muuten edistämään asian etenemistä.
Hyvin määritellyn asian käsittely etenee nopeammin.