Haluatko toteuttaa villeimmät Jira-ideasi? Katso, mitä kaikkea ScriptRunner for Jira mahdollistaa!

ScriptRunner soveltuu erinomaisesti monimutkaisempien käyttötapausten toteuttamiseen, sillä sen avulla järjestelmänvalvojat voivat laajentaa Jiran toiminnallisuuksia Groovy-ohjelmointikielellä kirjoitettujen skriptien avulla.

Jira Data Centerissä ScriptRunner-skriptit pääsevät hyödyntämään koko Jiran kehittäjille tarjoamaa API-rajapintaa. Käytännössä tämä mahdollistaa lähes rajattomat mukautukset – aivan kuin tekisi ”päivityksen Matrixissa”.

Suuri valta tuo kuitenkin mukanaan suuren vastuun, joten suosittelemme etenemään harkiten.

Jos Jiran järjestelmänvalvojasi on vasta tutustumassa ScriptRunnerin skriptien tarjoamiin mahdollisuuksiin, valmiit skriptit (built-in scripts)  (opens in a new tab) voivat olla hyvä lähtökohta.

Valmiit skriptit (Built-in scripts)

Valmiit skriptit on suunnattu käyttäjille, joilla on vain vähän kokemusta Groovy-ohjelmointikielestä. Niiden avulla voit toteuttaa haluamasi toiminnot nopeasti ilman, että sinun tarvitsee kirjoittaa Groovy-koodia alusta alkaen.

Valmiita skriptejä on kehitetty ScriptRunnerin yleisimpiin käyttötarkoituksiin. Niiden avulla voit esimerkiksi:

• muokata useiden tikettien ratkaisuarvoa (Resolution) kerralla Bulk Fix Resolutions -skriptillä
• kopioida projekteja
• kopioida kentän arvon toiseen kenttään Jira-ympäristössäsi Copy Field Values -skriptillä
• siivota Jira-ympäristöä poistamalla työnkulkujen toimintoja, jotka ovat jääneet jäljelle poistetuista tai käytöstä poistetuista sovelluksista.

Skriptikonsoli (Script Console)

Jos valmiit skriptit eivät täysin vastaa tarpeitasi, voit siirtyä Script Console -työkaluun. Se on kuin tyhjä piirustuspohja, joka tarjoaa erinomaiset mahdollisuudet toteuttaa kunnianhimoisimmatkin Jira-ideasi.

Käyttötapaus: Haluat saada kattavan kokonaiskuvan Epic-tiketille kirjatuista työtunneista, mukaan lukien kaikkien siihen liittyvien alitehtävien tunnit.

Projektinhallinnan näkökulmasta on tärkeää pystyä seuraamaan kattavasti kunkin Epic-tiketin resurssien käyttöä.

Tämä voidaan toteuttaa usealla tavalla. Seuraavassa esimerkissä näytämme, miten se onnistuu yhdistämällä Jira Automation ja ScriptRunner.

Vaikka automaation käynnistysehdot voidaan määritellä suoraan skriptissä, Jira Automationin käyttöliittymä voi tarjota intuitiivisemman ja tehokkaamman tavan niiden määrittelyyn. Tämä on erityisen hyödyllistä silloin, kun ehtoja on useita tai Groovy-skriptaustaidot ovat vielä kehittymässä.

Seuraavaksi automaatioon lisätään ScriptRunnerin ”Run a script” -toiminto. Sen avulla skripti hakee kaikki Epic-tikettiin liittyvien alitehtävien työajanseurantakenttien arvot, laskee ne yhteen ja tallentaa summan määritettyyn mukautettuun kenttään.

Skripti laskee tehokkaasti kirjattujen työtuntien kokonaismäärän ja päivittää automaattisesti vastaavan Epic-tiketin. Näin saat tarkan ja keskitetyn kokonaiskuvan koko Epic-hierarkiaan kirjatuista työtunneista.

Käyttötapaus: Tarvitset automaation, joka kopioi mukautettujen kenttien arvot ylätason tiketiltä sen alitason tiketeille.

Jiran omassa automaatiossa jokainen tarvittava mukautettu kenttä on yleensä lisättävä automaatiosääntöön manuaalisesti.

ScriptRunner puolestaan yksinkertaistaa tätä prosessia huomattavasti vertailemalla automaattisesti ylätason ja alitason tikettien kenttiä.

Kun vastaavat kentät löytyvät, ScriptRunnerin automaatio kopioi tarvittavat arvot tehokkaasti ylätason tiketiltä siihen liittyville alitason tiketeille.

Tämä lähestymistapa vähentää hallinnollista työtä, sillä jokaista kenttää ei tarvitse määrittää erikseen. Samalla se varmistaa, että mukautettujen kenttien arvot siirtyvät ylätason tiketiltä alitason tiketeille johdonmukaisesti ja oikein.

ScriptRunner tarjoaa tehokkaita mukautettuja ja valmiita työnkulkutoimintoja, kuten jälkitoimintoja (post functions), validaattoreita (validators) ja ehtoja (conditions).

Kuvitellaan, että haluamme lisätä ehdollista logiikkaa työnkulun tilasiirtymiin. Ehtojen (conditions) avulla voidaan varmistaa, että tietty vaatimus täyttyy ennen kuin tiketti voidaan siirtää seuraavaan tilaan.

Ehdollisia tilasiirtymiä voidaan toteuttaa tiketin eri ominaisuuksien, kuten tilan, prioriteetin tai mukautettujen kenttien, perusteella.

Käyttötapaus: Haluat toteuttaa ehdollisen tilasiirtymän, jossa tiketti voidaan siirtää "In Progress" -tilasta "Review" -tilaan vain, jos mukautetulla "Review Approver" -kentällä on tietty arvo.

Lisäksi tilasiirtymän suorittavan käyttäjän on oltava sama henkilö, joka on määritetty "Review Approver" -kentässä.

Tässä tapauksessa ScriptRunnerin avulla voidaan kirjoittaa mukautettu ehtoskripti, joka tarkistaa sekä mukautetun kentän arvon että tilasiirtymän suorittavan käyttäjän.

Jälkitoimintojen (post functions) avulla voidaan suorittaa automaattisia toimintoja sen jälkeen, kun tiketti on siirtynyt uuteen tilaan.

Käyttötapaus: Haluat arkistoida tiketin, kun se siirtyy lopulliseen tilaan ja sen ratkaisuksi (Resolution) on määritetty "Duplicate".

Vanhentuneiden tai tarpeettomien tikettien arkistointi on hyödyllistä sekä käyttäjien että Jiran hallinnan näkökulmasta.

Vaikka arkistointi voidaan toteuttaa myös tikettihaun Bulk Change -toiminnolla, se edellyttää ylimääräistä manuaalista työtä.

Vaikka Jiran kenttämäärityksissä voidaan määrittää kenttiä pakollisiksi tai valinnaisiksi sekä piilottaa tai näyttää niitä, kenttien yksityiskohtaisemmassa mukauttamisessa on rajoituksia.

ScriptRunner tuo kuitenkin Jiraan erinomaisen Behaviours-toiminnon, joka tarjoaa monipuolisia mahdollisuuksia laajentaa kenttien vakiomäärityksiä.

Behaviours-toiminnon avulla voit mukauttaa kenttien käyttäytymistä. Voit esimerkiksi:

• määrittää kentän pakolliseksi muiden tikettinäkymään syötettyjen tietojen perusteella
• tehdä kentästä vain luku -tilassa olevan käyttäjän roolin tai ryhmän perusteella
• näyttää tai piilottaa lisäkenttiä, kun tietty vaihtoehto valitaan
• muokata kenttien kuvauksia
• rajoittaa eri käyttäjäryhmille saatavilla olevia tikettityyppejä.

Käyttötapaus: Projektipäällikkönä haluat hallita täysin sitä, mitkä tiketit voidaan lisätä sprinttiin.

Tässä tilanteessa Behaviours-toiminnon avulla voit määrittää Sprint-kentän vain luku -tilaan kaikille muille paitsi Project Managers -rooliin kuuluville käyttäjille. Näin varmistat, että vain projektipäälliköt voivat lisätä tikettejä sprintteihin.

Lisäksi Behaviours-toiminnolla voit piilottaa ja poistaa käytöstä näkymän välilehtiä (mikä on hyödyllistä, jos haluat piilottaa useita kenttiä kerralla) sekä luoda valintalistoja, joissa on ”Other” (Muu) -vaihtoehto.

Valintalista, jossa on ”Other” (Muu) -vaihtoehto, on hyödyllinen silloin, kun käyttäjä ei löydä sopivaa vaihtoehtoa ennalta määritetystä luettelosta.

Kun käyttäjä valitsee ”Other” (Muu) -vaihtoehdon, näkyviin tulee vapaa tekstikenttä, johon hän voi syöttää tarvittavat tiedot. Näin varmistetaan, ettei arvokasta tietoa jää tallentamatta.

ScriptRunner mahdollistaa saumattomat integraatiot erilaisten Jira-sovellusten ja ulkoisten järjestelmien kanssa.

Käyttötapaus: Tikettien automaattinen osoittaminen käyttäjien käytettävyyden perusteella.

Yhdistämällä ScriptRunnerin resurssien seuranta- ja hallintatyökaluun, kuten Activity Timeline  (opens in a new tab) tai Planner by Tempo  (opens in a new tab), voit viedä tikettien hallinnan uudelle tasolle.

Tarkastellaan esimerkiksi kriittisten ohjelmistovirheiden hallintaprosessia. Aluksi on hyödyllistä automatisoida kriittisen prioriteetin tikettien osoittaminen nimetylle kokeneelle ohjelmistokehittäjälle.

Vaikka tämä automaatio saattaa teoriassa vaikuttaa riittävältä, käytännössä on tärkeää huomioida tilanteet, joissa kyseinen kehittäjä ei ole tilapäisesti käytettävissä.

Integraation avulla voidaan seurata resurssien käytettävyyttä ja osoittaa tiketit automaattisesti toiselle käytettävissä olevalle kehittäjälle, jos ensisijainen vastuuhenkilö ei ole tavoitettavissa.

Integroimalla ScriptRunnerin resurssienhallintatyökaluihin voidaan optimoida resurssien kohdentamista ja nopeuttaa tikettien ratkaisemista, mikä parantaa toiminnan kokonaistehokkuutta.

Käyttötapaus: Työntekijätietojen siirtäminen Active Directorysta Jira Assetsiin.

Esimerkiksi ScriptRunnerin integrointi Office 365 -palveluun mahdollistaa työntekijätietojen sujuvan hakemisen Microsoft Entra ID:stä (aiemmin Azure Active Directory) ja niiden automaattisen tallentamisen Assets  (opens in a new tab) -sovelluksen (aiemmin Insight) objekteihin ja niihin liittyviin attribuutteihin.

Assetsiin objekteina tallennettuihin käyttäjiin voidaan liittää useita attribuutteja, kuten yhteystiedot, osastotiedot ja käyttäjän rooliin liittyvät tiedot.

Assetsiin tallennettuja tietoja voidaan hyödyntää tehokkaasti erilaisten toimintaprosessien tukena. Niiden avulla voidaan esimerkiksi sujuvoittaa laitehankintoja asiakastukiprojekteissa sekä helpottaa työntekijöiden perehdytys- (onboarding) ja työsuhteen päättymisprosesseja (offboarding) henkilöstöhallinnon projekteissa.

ScriptRunner laajentaa Jiran kyselykielen (JQL) mahdollisuuksia tarjoamalla yli 40 lisätoimintoa  (opens in a new tab), joiden avulla voit luoda entistä tehokkaampia ja pitkälle räätälöityjä hakuja.

Käyttötapaus: Haluat löytää kaikki Epic-tiketit, joihin liittyy ratkaisemattomia käyttäjätarinoita (Stories).

Vaikka Jiran tavallinen JQL ei suoraan tue tällaista hakua, se voidaan toteuttaa monimutkaisen kiertotavan avulla:

• tunnista kaikki tikettityypit, jotka voivat kuulua Epic-tikettiin
• hae näitä tikettityyppejä tikettihaussa, lisää hakuehdoksi Resolution-kenttä ja määritä ehdoksi, ettei Epic Link -kenttä ole tyhjä
• lisää hakutuloksiin Epic Link -kenttä omaksi sarakkeekseen
• vie hakutulokset XML-muodossa
• avaa hakutulokset Excelissä ja analysoi tietoja tarkemmin kaikkien Epic-tikettien tunnistamiseksi.

Tämä lähestymistapa soveltuu todennäköisesti parhaiten kertaluonteisiin tai satunnaisesti suoritettaviin hakuihin.

Jos hakua kuitenkin tarvitaan säännöllisesti, tehokkaampi ratkaisu on käyttää ScriptRunnerin JQL-toimintoa issueFunction in epicsOf("resolution = unresolved"), joka palauttaa hakutulokset muutamassa sekunnissa.

Lisäksi järjestelmänvalvojat voivat luoda omia mukautettuja JQL-toimintoja Groovy-ohjelmointikielellä ilman, että heidän tarvitsee opetella Atlassian SDK:n käyttöä.

Asetutaan seuraavaksi projektipäällikön asemaan. Tehtävänäsi on ehkäistä ennakoivasti projektin laajuuden hallitsematonta kasvua (scope creep) ja tunnistaa mahdolliset pullonkaulat.

Saatat esimerkiksi haluta selvittää, mihin tehtäviin on kirjattu enemmän työtunteja kuin alun perin arvioitiin. Näin voit tunnistaa mahdolliset ongelmat tehtävien työmäärän arvioinnissa.

Tätä varten voit hyödyntää Time Spent- ja Original Estimate -kenttiä ja luoda seuraavan JQL-haun:

issueFunction in expression("", "timespent > originalestimate")

Saatat myös haluta nähdä luettelon kaikista tiketeistä, joiden kokonais työmääräennuste ylittää alkuperäisen arvion, jotta voit kohdentaa resurssit tarkoituksenmukaisesti.

Tätä varten voit lisätä hakuun Remaining Estimate -kentän:

issueFunction in expression("", "timespent + remainingestimate > originalestimate")