Jira

Anslutning av Jira med Siesta AI

1. I Anslutningar välj Lägg till anslutning och välj Jira.
2. Fyll i URL, Användarnamn och Lösenord (API-token) och ställ in Delad eller Privat.
3. Valfritt, justera vilka operationer som är tillåtna.

Översikt

Denna anslutning tillhandahåller ett programgränssnitt för att arbeta med Jira (Atlassian). Den möjliggör skapande, läsning, sökning, uppdatering och tilldelning av Jira-ärenden (biljetter) över projekt.

Designad för:

• Incident- och driftautomatisering
• Orkestrering av ingenjörsarbetsflöden
• Synkronisering av externa system (CRM, övervakning, AI-agenter)
• Revisionsbara biljettbaserade processer

Autentisering och säkerhet

• Anslutningen använder officiära Jira REST API.
• Autentisering sker via Atlassian-konto (OAuth / API-token).
• Användaren identifieras med Atlassian Account ID, inte e-post.
• Behörigheter styrs direkt på nivån av Jira-instansen.

Om användaren inte har rätt att se ett ärende, kommer anslutningen inte att se det heller.

Grundläggande begrepp

• IssueKey: ID för biljetten (t.ex. PROJ-123).
• ProjectKey: nyckel för Jira-projektet (t.ex. PROJ).
• AccountId: unik identifierare för användaren i Atlassian-ekosystemet.
• JQL: Jira Query Language.

1. Biljettskapande

1.1 CreateTicketAsync

Beskrivning
Skapar ett nytt Jira-ärende i det angivna projektet.

Ingångsparametrar

Parameter	Typ	Obligatorisk	Beskrivning
projectKey	String	Ja	Nyckel för Jira-projektet.
issueType	String	Ja	Typ av ärende (Task, Bug, Story, ...).
summary	String	Ja	Kort titel för ärendet.
description	String	Nej	Detaljerad beskrivning.
assigneeId	String	Nej	Atlassian Account ID för användaren.

Beteende

• IssueType måste finnas i projektet.
• Ingen fallback eller typmappning utförs.
• Felaktig kombination = misslyckande.

2. Biljettilldelning

2.1 AssignTicketAsync

Beskrivning
Tilldelar ett befintligt ärende till en specifik användare.

Ingångsparametrar

Parameter	Typ	Obligatorisk
issueKey	String	Ja
assigneeAccountId	String	Ja

Notering Jira ignorerar e-post. Account ID är den enda pålitliga identifieraren.

3. Hämtning av biljetter

3.1 GetTicketAsync

Beskrivning
Returnerar detaljer om ett ärende baserat på issueKey.

Ingångsparametrar

Parameter	Typ	Obligatorisk
issueKey	String	Ja

3.2 GetTicketsByProjectAsync

Beskrivning
Returnerar ärenden som tillhör ett specifikt projekt.

Ingångsparametrar

Parameter	Typ	Obligatorisk
projectKey	String	Ja
maxResults	Int	Nej

3.3 GetTicketsByUserAsync

Beskrivning
Returnerar ärenden som är tilldelade en specifik användare.

Ingångsparametrar

Parameter	Typ	Obligatorisk
assigneeEmail	String	Ja
maxResults	Int	Nej

4. Biljettuppdatering

4.1 UpdateTicketAsync

Beskrivning
Uppdaterar sammanfattning och/eller beskrivning av ett befintligt ärende.

Ingångsparametrar

Parameter	Typ	Obligatorisk
issueKey	String	Ja
summary	String	Nej
description	String	Nej

Beteende

• Endast angivna fält uppdateras.
• Ingen validering av arbetsflödesstatus utförs.

5. Sök och fråga

5.1 SearchTicketsAsync

Beskrivning
Söker efter ärenden med hjälp av JQL-fråga.

Ingångsparametrar

Parameter	Typ	Obligatorisk
jql	String	Ja
maxResults	Int	Nej

Exempel på JQL

project = PROJ AND status = "To Do"

Felaktig JQL returnerar ett omedelbart fel.

6. Projekt- och användaroperationer

6.1 GetAllProjectsAsync

Beskrivning
Returnerar en lista över projekt som är tillgängliga för den aktuella användaren.

Ingångsparametrar

Parameter	Typ	Obligatorisk
maxResults	Int	Nej

6.2 GetUserAsync

Beskrivning
Returnerar information om en användare baserat på Account ID.

Ingångsparametrar

Parameter	Typ	Obligatorisk
accountId	String	Ja

Designprinciper

• Account ID > e-post (GDPR och verkligheten i Atlassian).
• Explicita ingångar utan antaganden.
• Fail-fast-beteende vid felaktiga förfrågningar.
• Respektera Jira-arbetsflödesregler.

Sammanfattning

Jira-anslutningen ger direkt, säker och revisionsbar åtkomst till Jira-ärenden och projekt. Den är lämplig för automatiserad biljettning, incidentagenter, verktyg för ingenjörers produktivitet och integration av företagsarbetsflöden.