Jira
Integrazione di Jira con Siesta AI
- In Connessione seleziona Aggiungi Connessione e scegli Jira.
- Compila URL, Username e Password (token API) e imposta Condiviso o Privato.
- Facoltativamente modifica quali operazioni sono consentite.
Panoramica
Questa Connessione fornisce un'interfaccia programmativa per lavorare con Jira (Atlassian). Consente la creazione, lettura, ricerca, aggiornamento e assegnazione di issue Jira (ticket) attraverso progetti.
Progettato per:
- Automazione di incidenti e operazioni
- Orchestrazione di flussi di lavoro ingegneristici
- Sincronizzazione di sistemi esterni (CRM, monitoraggio, agenti AI)
- Processi basati su ticket auditabili
Autenticazione e sicurezza
- La connessione utilizza l'API REST ufficiale di Jira.
- L'autenticazione avviene tramite un account Atlassian (OAuth / token API).
- L'utente è identificato tramite l'Account ID di Atlassian, non tramite email.
- I permessi sono gestiti direttamente a livello di istanza Jira.
Se l'utente non ha il diritto di vedere un'issue, la Connessione non la vedrà nemmeno.
Concetti di base
- IssueKey: ID del ticket (es.
PROJ-123). - ProjectKey: chiave del progetto Jira (es.
PROJ). - AccountId: identificatore unico dell'utente nell'ecosistema Atlassian.
- JQL: Jira Query Language.
1. Creazione Ticket
1.1 CreateTicketAsync
Descrizione
Crea una nuova issue Jira nel progetto specificato.
Parametri di input
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| projectKey | String | Sì | Chiave del progetto Jira. |
| issueType | String | Sì | Tipo di issue (Task, Bug, Story, ...). |
| summary | String | Sì | Breve titolo dell'issue. |
| description | String | No | Descrizione dettagliata. |
| assigneeId | String | No | Atlassian Account ID dell'utente. |
Comportamento
- IssueType deve esistere nel progetto.
- Non esegue fallback né mapping dei tipi.
- Combinazione errata = errore.
2. Assegnazione Ticket
2.1 AssignTicketAsync
Descrizione
Assegna un'issue esistente a un utente specifico.
Parametri di input
| Parametro | Tipo | Obbligatorio |
|---|---|---|
| issueKey | String | Sì |
| assigneeAccountId | String | Sì |
Nota Jira ignora le email. L'Account ID è l'unico identificatore affidabile.
3. Recupero Ticket
3.1 GetTicketAsync
Descrizione
Restituisce i dettagli dell'issue in base a issueKey.
Parametri di input
| Parametro | Tipo | Obbligatorio |
|---|---|---|
| issueKey | String | Sì |
3.2 GetTicketsByProjectAsync
Descrizione
Restituisce le issue appartenenti a un progetto specifico.
Parametri di input
| Parametro | Tipo | Obbligatorio |
|---|---|---|
| projectKey | String | Sì |
| maxResults | Int | No |
3.3 GetTicketsByUserAsync
Descrizione
Restituisce le issue assegnate a un utente specifico.
Parametri di input
| Parametro | Tipo | Obbligatorio |
|---|---|---|
| assigneeEmail | String | Sì |
| maxResults | Int | No |
4. Aggiornamento Ticket
4.1 UpdateTicketAsync
Descrizione
Aggiorna il summary e/o la description di un'issue esistente.
Parametri di input
| Parametro | Tipo | Obbligatorio |
|---|---|---|
| issueKey | String | Sì |
| summary | String | No |
| description | String | No |
Comportamento
- Vengono aggiornati solo i campi forniti.
- Non esegue la validazione dello stato dei flussi di lavoro.
5. Ricerca e Query
5.1 SearchTicketsAsync
Descrizione
Cerca le issue utilizzando una query JQL.
Parametri di input
| Parametro | Tipo | Obbligatorio |
|---|---|---|
| jql | String | Sì |
| maxResults | Int | No |
Esempio di JQL
project = PROJ AND status = "To Do"
JQL errato restituisce un errore immediato.
6. Operazioni su Progetti e Utenti
6.1 GetAllProjectsAsync
Descrizione
Restituisce un elenco dei progetti disponibili per l'utente attuale.
Parametri di input
| Parametro | Tipo | Obbligatorio |
|---|---|---|
| maxResults | Int | No |
6.2 GetUserAsync
Descrizione
Restituisce informazioni sull'utente in base all'Account ID.
Parametri di input
| Parametro | Tipo | Obbligatorio |
|---|---|---|
| accountId | String | Sì |
Principi di design
- Account ID > email (GDPR e realtà di Atlassian).
- Input espliciti senza assunzioni.
- Comportamento fail-fast su richieste errate.
- Rispetto delle regole dei flussi di lavoro di Jira.
Riepilogo
La Connessione Jira fornisce un accesso diretto, sicuro e auditabile alle issue e ai progetti di Jira. È adatta per il ticketing automatizzato, agenti di incidenti, strumenti di produttività ingegneristica e integrazione di flussi di lavoro aziendali.