Jira

Jira ja Siesta AI:n yhdistäminen

1. Yhdistäminen-osiossa valitse Add Connection ja valitse Jira.
2. Täytä URL, Käyttäjänimi ja Salasana (API-tunnus) ja määritä Shared tai Private.
3. Valinnaisesti muokkaa, mitkä toiminnot ovat sallittuja.

Yhteenveto

Tämä yhdistäminen tarjoaa ohjelmointirajapinnan Jira (Atlassian) -työkalun käyttöön. Se mahdollistaa Jira-ongelmien (liput) luomisen, lukemisen, hakemisen, päivittämisen ja määrittämisen eri projekteissa.

Suunniteltu:

• Häiriöiden ja operaatioiden automatisointi
• Insinöörityönkulkujen orkestrointi
• Ulkoisten järjestelmien (CRM, valvonta, AI-agentit) synkronointi
• Auditointikelpoiset lippupohjaiset prosessit

Varmennus ja turvallisuus

• Yhdistäminen käyttää virallista Jira REST API:a.
• Varmennus tapahtuu Atlassian-tilin avulla (OAuth / API-tunnus).
• Käyttäjä tunnistetaan Atlassian Account ID:n avulla, ei sähköpostin.
• Oikeudet hallitaan suoraan Jira-instanssin tasolla.

Jos käyttäjällä ei ole oikeutta nähdä ongelmaa, yhdistäminen ei myöskään näe sitä.

Peruskäsitteet

• IssueKey: lipun ID (esim. PROJ-123).
• ProjectKey: Jira-projektin avain (esim. PROJ).
• AccountId: käyttäjän ainutlaatuinen tunniste Atlassian-ekosysteemissä.
• JQL: Jira Query Language.

1. Lipun luominen

1.1 CreateTicketAsync

Kuvaus
Luo uusi Jira-ongelma annettuun projektiin.

Syöttöparametrit

Parametri	Tyyppi	Pakollinen	Kuvaus
projectKey	String	Kyllä	Jira-projektin avain.
issueType	String	Kyllä	Ongelmatyyppi (Tehtävä, Virhe, Tarina, ...).
summary	String	Kyllä	Lyhyt otsikko ongelmalle.
description	String	Ei	Yksityiskohtainen kuvaus.
assigneeId	String	Ei	Atlassian Account ID käyttäjälle.

Käyttäytyminen

• IssueType:n on oltava olemassa projektissa.
• Ei tee fallbackia tai tyyppien kartoitusta.
• Väärä yhdistelmä = epäonnistuminen.

2. Lipun määrittäminen

2.1 AssignTicketAsync

Kuvaus
Määrittää olemassa olevan ongelman tietylle käyttäjälle.

Syöttöparametrit

Parametri	Tyyppi	Pakollinen
issueKey	String	Kyllä
assigneeAccountId	String	Kyllä

Huomautus Jira ei huomioi sähköposteja. Account ID on ainoa luotettava tunniste.

3. Lipun hakeminen

3.1 GetTicketAsync

Kuvaus
Palauttaa ongelman tiedot issueKey-tunnuksen mukaan.

Syöttöparametrit

Parametri	Tyyppi	Pakollinen
issueKey	String	Kyllä

3.2 GetTicketsByProjectAsync

Kuvaus
Palauttaa ongelmat, jotka kuuluvat tiettyyn projektiin.

Syöttöparametrit

Parametri	Tyyppi	Pakollinen
projectKey	String	Kyllä
maxResults	Int	Ei

3.3 GetTicketsByUserAsync

Kuvaus
Palauttaa ongelmat, jotka on määritetty tietylle käyttäjälle.

Syöttöparametrit

Parametri	Tyyppi	Pakollinen
assigneeEmail	String	Kyllä
maxResults	Int	Ei

4. Lipun päivitys

4.1 UpdateTicketAsync

Kuvaus
Päivittää olemassa olevan ongelman otsikon ja/tai kuvauksen.

Syöttöparametrit

Parametri	Tyyppi	Pakollinen
issueKey	String	Kyllä
summary	String	Ei
description	String	Ei

Käyttäytyminen

• Vain annettuja kenttiä päivitetään.
• Ei tee validointia työnkulkujen tilasta.

5. Haku ja kysely

5.1 SearchTicketsAsync

Kuvaus
Hakee ongelmia JQL-kyselyn avulla.

Syöttöparametrit

Parametri	Tyyppi	Pakollinen
jql	String	Kyllä
maxResults	Int	Ei

Esimerkki JQL

project = PROJ AND status = "To Do"

Virheellinen JQL palauttaa välittömän virheen.

6. Projekti- ja käyttäjätoiminnot

6.1 GetAllProjectsAsync

Kuvaus
Palauttaa luettelon projekteista, jotka ovat nykyisen käyttäjän saatavilla.

Syöttöparametrit

Parametri	Tyyppi	Pakollinen
maxResults	Int	Ei

6.2 GetUserAsync

Kuvaus
Palauttaa käyttäjätiedot Account ID:n mukaan.

Syöttöparametrit

Parametri	Tyyppi	Pakollinen
accountId	String	Kyllä

Suunnitteluperiaatteet

• Account ID > sähköposti (GDPR ja Atlassianin todellisuus).
• Ilmeiset syötteet ilman oletuksia.
• Fail-fast-käyttäytyminen virheellisissä pyyntöissä.
• Jira-työnkulkujen sääntöjen kunnioittaminen.

Yhteenveto

Jira-yhdistäminen tarjoaa suoran, turvallisen ja auditointikelpoisen pääsyn Jira-ongelmiin ja projekteihin. Se soveltuu automatisoituun liputukseen, häiriöagentteihin, insinöörityökalujen tuottavuuteen ja yritystyönkulkujen integrointiin.