Jira
Tilkobling av Jira med Siesta AI
- I Tilkoblinger velg Legg til tilkobling og velg Jira.
- Fyll ut URL, Brukernavn og Passord (API-token) og sett Delt eller Privat.
- Valgfritt, juster hvilke operasjoner som er tillatt.
Oversikt
Denne tilkoblingen gir et programgrensesnitt for å jobbe med Jira (Atlassian). Den muliggjør oppretting, lesing, søk, oppdatering og tildeling av Jira issues (billetter) på tvers av prosjekter.
Designet for:
- Hendelse- og driftsautomatisering
- Orkestrering av ingeniørarbeidsflyter
- Synkronisering av eksterne systemer (CRM, overvåking, AI-agenter)
- Reviderbare billettbaserte prosesser
Autentisering og sikkerhet
- Tilkoblingen bruker det offisielle Jira REST API.
- Autentisering skjer via Atlassian-konto (OAuth / API-token).
- Brukeren identifiseres med Atlassian Account ID, ikke e-post.
- Tillatelser styres direkte på nivået til Jira-instansen.
Hvis brukeren ikke har rett til å se en issue, vil tilkoblingen heller ikke se den.
Grunnleggende begreper
- IssueKey: ID for billetten (f.eks.
PROJ-123). - ProjectKey: nøkkel for Jira-prosjektet (f.eks.
PROJ). - AccountId: unik identifikator for brukeren i Atlassian-økosystemet.
- JQL: Jira Query Language.
1. Oppretting av billett
1.1 CreateTicketAsync
Beskrivelse
Oppretter en ny Jira-issue i det angitte prosjektet.
Inngangsparametere
| Parameter | Type | Obligatorisk | Beskrivelse |
|---|---|---|---|
| projectKey | String | Ja | Nøkkel for Jira-prosjektet. |
| issueType | String | Ja | Type issue (Oppgave, Feil, Historie, ...). |
| summary | String | Ja | Kort tittel på issue. |
| description | String | Nei | Detaljert beskrivelse. |
| assigneeId | String | Nei | Atlassian Account ID for brukeren. |
Atferd
- IssueType må eksistere i prosjektet.
- Utfører ikke fallback eller mapping av typer.
- Feil kombinasjon = feil.
2. Tildeling av billett
2.1 AssignTicketAsync
Beskrivelse
Tildeler en eksisterende issue til en spesifikk bruker.
Inngangsparametere
| Parameter | Type | Obligatorisk |
|---|---|---|
| issueKey | String | Ja |
| assigneeAccountId | String | Ja |
Merk Jira ignorerer e-poster. Account ID er den eneste pålitelige identifikatoren.
3. Henting av billett
3.1 GetTicketAsync
Beskrivelse
Returnerer detaljer om en issue basert på issueKey.
Inngangsparametere
| Parameter | Type | Obligatorisk |
|---|---|---|
| issueKey | String | Ja |
3.2 GetTicketsByProjectAsync
Beskrivelse
Returnerer issues som tilhører et spesifikt prosjekt.
Inngangsparametere
| Parameter | Type | Obligatorisk |
|---|---|---|
| projectKey | String | Ja |
| maxResults | Int | Nei |
3.3 GetTicketsByUserAsync
Beskrivelse
Returnerer issues tildelt en spesifikk bruker.
Inngangsparametere
| Parameter | Type | Obligatorisk |
|---|---|---|
| assigneeEmail | String | Ja |
| maxResults | Int | Nei |
4. Oppdatering av billett
4.1 UpdateTicketAsync
Beskrivelse
Oppdaterer sammendrag og/eller beskrivelse av en eksisterende issue.
Inngangsparametere
| Parameter | Type | Obligatorisk |
|---|---|---|
| issueKey | String | Ja |
| summary | String | Nei |
| description | String | Nei |
Atferd
- Bare de angitte feltene oppdateres.
- Utfører ikke validering av arbeidsflytstatus.
5. Søk og spørring
5.1 SearchTicketsAsync
Beskrivelse
Søker etter issues ved hjelp av en JQL-spørring.
Inngangsparametere
| Parameter | Type | Obligatorisk |
|---|---|---|
| jql | String | Ja |
| maxResults | Int | Nei |
Eksempel på JQL
project = PROJ AND status = "To Do"
Feil JQL returnerer umiddelbar feil.
6. Prosjekt- og brukeroperasjoner
6.1 GetAllProjectsAsync
Beskrivelse
Returnerer en liste over prosjekter tilgjengelige for den nåværende brukeren.
Inngangsparametere
| Parameter | Type | Obligatorisk |
|---|---|---|
| maxResults | Int | Nei |
6.2 GetUserAsync
Beskrivelse
Returnerer informasjon om en bruker basert på Account ID.
Inngangsparametere
| Parameter | Type | Obligatorisk |
|---|---|---|
| accountId | String | Ja |
Designprinsipper
- Account ID > e-post (GDPR og virkeligheten til Atlassian).
- Eksplisitte innganger uten antagelser.
- Fail-fast atferd ved feil forespørsel.
- Respektere Jira arbeidsflytregler.
Oppsummering
Jira-tilkoblingen gir direkte, sikker og revidert tilgang til Jira issues og prosjekter. Den er egnet for automatisert billettbehandling, hendelsesagenter, verktøy for ingeniørproduktivitet og integrasjon av bedriftsarbeidsflyter.