Jira

Oversigt

Jira-forbindelsen muliggør en sikker forbindelse mellem Siesta AI-platformen og Atlassian Jira via det officielle API. Integration giver kontrolleret adgang til Jira-projekter og issues og muliggør:

• oprettelse af issues,
• søgning og indlæsning af issues,
• opdatering af eksisterende issues,
• tildeling af issues til brugere.

Designet til:

• hændelses- og ops-automatisering,
• orkestrering af engineering workflows,
• synkronisering af eksterne systemer (CRM, overvågning, AI-agenter),
• reviderbare ticket-baserede processer.

Krav

• Aktiv Jira Cloud site.
• Atlassian-konto, der har adgang til de Jira-projekter, som forbindelsen skal arbejde med.
• Genereret API-token i Atlassian-kontoen (id.atlassian.com → Sikkerhed → API-tokens).
• Administratorrettigheder til at administrere forbindelsen i Siesta AI.

Konfigurationsparametre

Obligatoriske parametre

Parameter	Beskrivelse
Navn	Intern betegnelse for forbindelsen
ApiKey	API-token genereret i Atlassian-kontoen
Email eller brugernavn på Atlassian-konto	E-mail (eller brugernavn) på kontoen, hvor tokenet blev oprettet
URL	URL til Jira/Atlassian-instans (f.eks. https://firma.atlassian.net)

Fremgangsmåde for tilføjelse af Jira-forbindelse

1) Forbered dine adgangsoplysninger

Før du begynder at oprette forbindelsen i Siesta AI, skal du forberede alle de værdier, du vil indsætte i formularen.

Åbn Sikkerhed og sektionen API-tokens i din Atlassian-konto.

Klik på Opret API-token (uden scopes), indtast navnet på tokenet og udløbsdatoen, og bekræft oprettelsen.

Efter oprettelsen skal du én gang kopiere tokenet og gemme det sikkert.

Forbered derefter også:

• E-mail eller brugernavn på Atlassian-kontoen, hvor tokenet blev oprettet
• URL til Jira/Atlassian-instans (f.eks. https://firma.atlassian.net)

2) Åbn administrationspanelet for integrationer i Siesta AI

Gå til Administration → Tilsluttede apps i Siesta AI-administrationen.

3) Vælg Jira

I dialogboksen Tilføj forbindelse vælg Jira og fortsæt.

4) Udfyld Jira-formularen

Udfyld:

• Navn
• ApiKey (token fra Atlassian)
• Email / brugernavn på Atlassian-kontoen, hvor tokenet blev oprettet
• URL (f.eks. https://firma.atlassian.net)

Bekræft oprettelsen af integrationen.

5) Indstil tilladelser for operationer

Efter oprettelsen af integrationen skal du åbne Indstillinger for tilladelser og indstille tilladte operationer.

Anbefaling: indstil skriveoperationer til Tilladt med bekræftelse.

Vigtig bemærkning om API-token og tilladelser

API-tokenet er knyttet til en specifik Atlassian-konto. Forbindelsen arver derefter tilladelserne fra denne konto i Jira (hvad kontoen ikke kan se eller redigere, kan forbindelsen heller ikke).

Derfor anbefales det:

• at hver bruger har sit eget token, hvis forbindelsen kører under deres identitet,
• eller at bruge en dedikeret servicekonto til delte/produktionsautomatiseringer,
• at overvåge tokenets udløb og udføre regelmæssig rotation.

Autentifikation og sikkerhed

• Forbindelsen bruger det officielle Jira REST API.
• Autentifikationen af forbindelsen sker via Atlassian-kontoen og API-tokenet (angivet i feltet ApiKey).
• Tilladelser styres direkte på niveauet for Jira-instansen.
• For at arbejde med assignee bruges AccountId i Jira API (ikke e-mail).

Hvis en bruger ikke har ret til at se issues, vil forbindelsen heller ikke kunne se dem.

Grundlæggende begreber

• IssueKey: ID for ticket (f.eks. PROJ-123).
• ProjectKey: nøgle for Jira-projektet (f.eks. PROJ).
• AccountId: unik identifikator for brugeren i Atlassian-økosystemet.
• JQL: Jira Query Language.

1. Oprettelse af ticket

1.1 CreateTicketAsync

Beskrivelse
Opretter en ny Jira-issue i det angivne projekt.

Indgangsparametre

Parameter	Type	Obligatorisk	Beskrivelse
projectKey	String	Ja	Nøgle for Jira-projektet.
issueType	String	Ja	Type af issue (Task, Bug, Story, ...).
summary	String	Ja	Kort titel på issue.
description	String	Nej	Detaljeret beskrivelse.
assigneeId	String	Nej	Atlassian Account ID for brugeren.

Adfærd

• IssueType skal eksistere i projektet.
• Udfører ikke fallback eller mapping af typer.
• Forkert kombination = fejl.

2. Tildeling af ticket

2.1 AssignTicketAsync

Beskrivelse
Tildeler en eksisterende issue til en bestemt bruger.

Indgangsparametre

Parameter	Type	Obligatorisk
issueKey	String	Ja
assigneeAccountId	String	Ja

Bemærkning Jira ignorerer e-mails. Account ID er den eneste pålidelige identifikator.

3. Hentning af ticket

3.1 GetTicketAsync

Beskrivelse
Returnerer detaljerne for en issue baseret på issueKey.

Indgangsparametre

Parameter	Type	Obligatorisk
issueKey	String	Ja

3.2 GetTicketsByProjectAsync

Beskrivelse
Returnerer issues, der tilhører et bestemt projekt.

Indgangsparametre

Parameter	Type	Obligatorisk
projectKey	String	Ja
maxResults	Int	Nej

3.3 GetTicketsByUserAsync

Beskrivelse
Returnerer issues, der er tildelt en bestemt bruger.

Indgangsparametre

Parameter	Type	Obligatorisk
assigneeEmail	String	Ja
maxResults	Int	Nej

4. Opdatering af ticket

4.1 UpdateTicketAsync

Beskrivelse
Opdaterer summary og/eller description for en eksisterende issue.

Indgangsparametre

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

Adfærd

• Kun de angivne felter opdateres.
• Udfører ikke validering af workflows-status.

5. Søgning og forespørgsel

5.1 SearchTicketsAsync

Beskrivelse
Søger efter issues ved hjælp af en JQL-forespørgsel.

Indgangsparametre

Parameter	Type	Obligatorisk
jql	String	Ja
maxResults	Int	Nej

Eksempel på JQL

project = PROJ AND status = "To Do"

Forkert JQL returnerer en øjeblikkelig fejl.

6. Projekt- og brugeroperationer

6.1 GetAllProjectsAsync

Beskrivelse
Returnerer en liste over projekter, der er tilgængelige for den aktuelle bruger.

Indgangsparametre

Parameter	Type	Obligatorisk
maxResults	Int	Nej

6.2 GetUserAsync

Beskrivelse
Returnerer oplysninger om en bruger baseret på Account ID.

Indgangsparametre

Parameter	Type	Obligatorisk
accountId	String	Ja

Designprincipper

• Account ID > e-mail (GDPR og Atlassians realitet).
• Eksplosive indgange uden antagelser.
• Fail-fast adfærd ved fejl i anmodninger.
• Respekt for Jira workflows-regler.

Resumé

Jira-forbindelsen giver direkte, sikker og reviderbar adgang til Jira-issues og projekter. Den er velegnet til automatiseret ticketing, hændelsesagenter, engineering produktivitetsværktøjer og enterprise workflows-integrationer.