Condividi tramite


Jira

Jira è uno strumento di sviluppo software che consente ai team agile di pianificare, tenere traccia e rilasciare software di livello mondiale. Connettere i problemi di Jira al resto degli strumenti consente di abbattere le barriere e di liberare il potenziale del team.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio Class Regions
Copilot Studio Di alta qualità Tutte le aree di Power Automate , ad eccezione delle seguenti:
     - China Cloud gestito da 21Vianet
App per la logica Normale Tutte le aree di App per la logica , ad eccezione delle seguenti:
     - Aree di Azure Cina
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps Di alta qualità Tutte le aree di Power Apps , ad eccezione dei seguenti:
     - China Cloud gestito da 21Vianet
Power Automate Di alta qualità Tutte le aree di Power Automate , ad eccezione delle seguenti:
     - China Cloud gestito da 21Vianet
Contatto
Nome Microsoft
URL https://support.microsoft.com/
Email abapi@microsoft.com
Metadati del connettore
Editore Microsoft
Sito Web https://www.atlassian.com/software/jira
Informativa sulla privacy https://www.atlassian.com/legal/privacy-policy
Categorie Operazioni IT; Collaborazione

Per usare questa integrazione, è necessario un account Jira.

Importante

A causa di modifiche recenti nelle API back-end Jira, gli aggiornamenti seguenti influisce sul connettore Jira:

  • Coerenza della ricerca: l'endpoint back-end non fornisce coerenza immediata di ricerca dopo scrittura. Gli aggiornamenti recenti eseguiti dagli utenti potrebbero non essere riportati immediatamente nei risultati della ricerca.
  • Limiti per gli elementi restituiti: l'endpoint restituisce un massimo di 20 commenti e 40 elementi del log delle modifiche.
  • Query JQL nei trigger: le query JQL non associate non sono supportate. Le richieste con query non associate genereranno una risposta di richiesta non valida 400.

Per altri dettagli: Che cos'è la ricerca avanzata in Jira Cloud? Riferimento: Log modifiche per sviluppatori Atlassian

Problemi noti e limitazioni

  • Per l'autenticazione, è necessario usare un token API. Per ottenere un token, passare a questo collegamento.
  • L'autenticazione di base con password è deprecata. Per altre informazioni, vedere la documentazione dell'API jira.
  • Jira Server dietro un firewall o con l'API REST disabilitata non è supportata.
  • Quando si crea una connessione a Jira Cloud, è necessario usare un indirizzo di posta elettronica valido per il nome utente. In caso contrario, la connessione non verrà stabilita, anche se sembra che abbia esito positivo.
  • I nomi utente in Jira Cloud sono deprecati e non possono più essere usati per campi come Reporter. Per altre informazioni, vedere la documentazione di Atlassian Cloud.
  • Come indicato nella documentazione dell'API Jira, l'API jira restituisce un massimo di 50 progetti, quindi i primi 50 progetti verranno elencati nell'elenco a discesa in azioni/trigger.
  • L'impaginazione è stata implementata nei progetti Get. Restituirà tutti i progetti.
  • L'azione Crea un nuovo problema (V2) supporta solo tipi di campo semplici, ad esempio 'string', 'number', 'date' e 'datetime' nello schema dinamico. Se la configurazione del progetto include campi obbligatori di tipi di dati complessi, l'operazione avrà esito negativo con l'errore" "Campo '{key}' di tipo '{type}' non supportato". Per risolvere questo problema, modificare la configurazione dei campi del progetto e rendere questi campi non necessari.
  • L'azione Crea un nuovo problema (V3) supporta solo tipi di campo semplici, ad esempio 'string', 'number', 'date' e 'datetime' nello schema dinamico. Se la configurazione del progetto include campi obbligatori di tipi di dati complessi, l'operazione avrà esito negativo con l'errore" "Campo '{key}' di tipo '{type}' non supportato". Per risolvere questo problema, modificare la configurazione dei campi del progetto e rendere questi campi non necessari.
  • La Project proprietà prevista dalle azioni e dai trigger del connettore deve essere compilata usando una delle opzioni seguenti:
    • Selezionare un progetto dalla selezione del progetto. Si noti che le connessioni Jira Cloud mostrano solo i primi 50 progetti nella selezione.
    • Usare un output dell'azione Recupera progetti (proprietà del Project Key progetto).
  • Per altre informazioni sull'operazione di modifica del problema , vedere la documentazione dell'API Jira
  • Quando un flusso di lavoro inizia a non riuscire con una risposta 400 o una richiesta non valida per qualsiasi azione o trigger, verificare se la chiave API usata per creare la connessione è scaduta e, in tal caso, ricreare la connessione con una nuova chiave API.

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:

API Token Usare il token API per accedere a Jira Tutte le aree geografiche Non condivisibile
Oauth Usare Oauth per accedere a Jira. Tutte le aree geografiche Non condivisibile
Impostazione predefinita [DEPRECATO] Questa opzione è solo per le connessioni meno recenti senza un tipo di autenticazione esplicito e viene fornita solo per la compatibilità con le versioni precedenti. Tutte le aree geografiche Non condivisibile

API Token

ID autenticazione: APIToken

Applicabile: tutte le aree

Usare il token API per accedere a Jira

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Nome TIPO Description Obbligatorio
Nome utente o posta elettronica corda Nome utente Jira. Per Jira Cloud è necessario usare un indirizzo di posta elettronica valido. Vero
Token API securestring Token API (https://id.atlassian.com/manage/api-tokens). Vero

Oauth

ID autenticazione: oauth

Applicabile: tutte le aree

Usare Oauth per accedere a Jira.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Impostazione predefinita [DEPRECATO]

Applicabile: tutte le aree

Questa opzione è solo per le connessioni meno recenti senza un tipo di autenticazione esplicito e viene fornita solo per la compatibilità con le versioni precedenti.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Nome TIPO Description Obbligatorio
Istanza di Jira corda URL in cui è ospitata l'istanza di Jira (deve supportare https). Vero
Nome utente o posta elettronica corda Nome utente Jira. Per Jira Cloud è necessario usare un indirizzo di posta elettronica valido. Vero
Token API securestring Token API (https://id.atlassian.com/manage/api-tokens). Vero

Limiti per la limitazione delle richieste

Nome Chiamate Periodo di rinnovo
Chiamate API per connessione 100 60 secondi
Frequenza dei polling dei trigger 1 60 secondi

Azioni

Aggiorna progetto

Aggiorna i dettagli del progetto di un progetto.

Aggiorna progetto (V2)

Aggiorna i dettagli del progetto di un progetto.

Aggiungi commento

Questa operazione viene usata per aggiungere un commento a un problema Jira esistente.

Aggiungi commento (V2)

Questa operazione viene usata per aggiungere un commento a un problema Jira esistente.

Annulla attività

Annulla un'attività. Autorizzazioni necessarie: amministrare Jira o Creator dell'attività.

Annulla attività (V2)

Annulla un'attività. Autorizzazioni necessarie: amministrare Jira o Creator dell'attività.

Attività Get (V2)

Restituisce lo stato di un'attività asincrona a esecuzione prolungata. Al termine di un'attività, questa operazione restituisce il BLOB JSON applicabile all'attività.

Crea categoria progetto

Crea una categoria di progetto. Autorizzazioni necessarie: Amministrare Jira (autorizzazioni globali)

Crea categoria progetto (V2)

Crea una categoria di progetto. Autorizzazioni necessarie: Amministrare Jira (autorizzazioni globali)

Creare un nuovo problema (V2) [DEPRECATO]

Questa azione è stata deprecata. Usare invece Crea un nuovo problema (V3).

Questa operazione viene usata per creare un nuovo problema.

Creare un nuovo problema (V3)

Questa operazione viene usata per creare un nuovo problema.

Creare un nuovo problema [DEPRECATO]

Questa azione è stata deprecata. Usare invece Crea un nuovo problema (V3).

Questa operazione viene usata per creare un nuovo problema.

Creare un nuovo progetto

Questa operazione viene usata per creare un nuovo progetto Jira.

Creare un nuovo progetto (V2)

Questa operazione viene usata per creare un nuovo progetto Jira.

Elencare gli utenti per progetto

Questa operazione viene utilizzata per recuperare un elenco di tutti gli utenti associati a un progetto.

Elencare gli utenti per progetto (V2)

Questa operazione viene utilizzata per recuperare un elenco di tutti gli utenti associati a un progetto.

Elimina il progetto

Elimina un progetto. Autorizzazioni necessarie: Amministrare Jira (autorizzazioni globali)

Elimina progetto (V2)

Elimina un progetto. Autorizzazioni necessarie: Amministrare Jira (autorizzazioni globali)

Esegue una transizione di problema

Esegue la transizione di un problema a un nuovo stato.

Jira MCP Server

Jira MCP Server

Modifica problema

Modifica un problema. È possibile applicare una transizione e aggiornare le proprietà dei problemi come parte della modifica. Le modifiche apportate ai campi del problema vengono definite usando gli aggiornamenti e i campi.

Ottenere l'elenco dei filtri

Questa operazione restituisce un elenco di filtri accessibili all'utente.

Ottenere l'elenco dei filtri (V2)

Questa operazione restituisce un elenco di filtri accessibili all'utente.

Ottenere l'elenco dei problemi

Questa operazione restituisce un elenco di problemi relativi all'uso di JQL.

Ottenere l'elenco dei problemi (Datacenter)

Questa operazione restituisce un elenco di problemi relativi all'uso di JQL.

Ottenere l'elenco delle risorse

Questa operazione restituisce un elenco di risorse accessibili all'utente.

Ottenere l'elenco delle transizioni

Restituisce un elenco delle transizioni possibili per questo problema dall'utente corrente

Ottenere l'utente (V2)

Restituisce un utente. Autorizzazioni necessarie: esplorare utenti e gruppi.

Ottenere l'utente corrente

Questa operazione restituisce i dettagli per l'utente corrente

Ottenere progetti

Questa operazione viene usata per recuperare un elenco di progetti per l'istanza di Jira.

Ottenere progetti (V2)

Questa operazione viene usata per recuperare un elenco di progetti per l'istanza di Jira.

Ottenere progetti [DEPRECATO]

Questa azione è stata deprecata. Usare invece Get projects (Ottieni progetti ).

Questa operazione viene usata per recuperare un elenco di progetti per l'istanza di Jira.

Ottenere tutte le categorie di progetti (V2)

Restituisce tutte le categorie di progetto.

Ottenere tutte le categorie di progetto

Restituisce tutte le categorie di progetto.

Ottenere un problema per chiave

Questa operazione viene utilizzata per recuperare l'oggetto problema per una determinata chiave di problema.

Ottenere un problema per chiave (V2)

Questa operazione viene utilizzata per recuperare l'oggetto problema per una determinata chiave di problema.

Ottenere un utente

Restituisce un utente. Autorizzazioni necessarie: esplorare utenti e gruppi.

Ottieni attività

Restituisce lo stato di un'attività asincrona a esecuzione prolungata. Al termine di un'attività, questa operazione restituisce il BLOB JSON applicabile all'attività.

Problema di modifica (V2)

Modifica un problema. È possibile applicare una transizione e aggiornare le proprietà dei problemi come parte della modifica. Le modifiche apportate ai campi del problema vengono definite usando gli aggiornamenti e i campi.

Rimuovi categoria progetto

Elimina una categoria di progetto. Autorizzazioni necessarie: Amministrare Jira (autorizzazioni globali)

Rimuovi categoria progetto (V2)

Elimina una categoria di progetto. Autorizzazioni necessarie: Amministrare Jira (autorizzazioni globali)

Aggiorna progetto

Aggiorna i dettagli del progetto di un progetto.

Parametri

Nome Chiave Necessario Tipo Descrizione
ID progetto o chiave
projectIdOrKey True string

Specificare l'ID progetto o la chiave da aggiornare1

key
key string

Key

nome
name string

Nome

projectTypeKey
projectTypeKey string

Chiave del tipo di progetto

projectTemplateKey
projectTemplateKey string

Chiave del modello di progetto

descrizione
description string

Description

piombo
lead string

Piombo

leadAccountId
leadAccountId string

Lead Account ID

URL
url string

URL

assigneeType
assigneeType string

Tipo assegnatario

avatarId
avatarId string

Avatar ID

issueSecurityScheme
issueSecurityScheme string

Problema schema di sicurezza

permissionScheme
permissionScheme string

Schema di autorizzazione

notificationScheme
notificationScheme string

Schema di notifica

categoryId
categoryId string

ID della categoria

Aggiorna progetto (V2)

Aggiorna i dettagli del progetto di un progetto.

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance True string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

ID progetto o chiave
projectIdOrKey True string

Specificare l'ID progetto o la chiave da aggiornare1

key
key string

Key

nome
name string

Nome

projectTypeKey
projectTypeKey string

Chiave del tipo di progetto

projectTemplateKey
projectTemplateKey string

Chiave del modello di progetto

descrizione
description string

Description

piombo
lead string

Piombo

leadAccountId
leadAccountId string

Lead Account ID

URL
url string

URL

assigneeType
assigneeType string

Tipo assegnatario

avatarId
avatarId string

Avatar ID

issueSecurityScheme
issueSecurityScheme string

Problema schema di sicurezza

permissionScheme
permissionScheme string

Schema di autorizzazione

notificationScheme
notificationScheme string

Schema di notifica

categoryId
categoryId string

ID della categoria

Aggiungi commento

Questa operazione viene usata per aggiungere un commento a un problema Jira esistente.

Parametri

Nome Chiave Necessario Tipo Descrizione
Chiave del problema
issueKey True string

Chiave univoca del problema a cui aggiungere un commento.

Comment
body True string

Corpo del commento.

Restituisce

Aggiungi commento (V2)

Questa operazione viene usata per aggiungere un commento a un problema Jira esistente.

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance True string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

Chiave del problema
issueKey True string

Chiave univoca del problema a cui aggiungere un commento.

Comment
body True string

Corpo del commento.

Restituisce

Annulla attività

Annulla un'attività. Autorizzazioni necessarie: amministrare Jira o Creator dell'attività.

Parametri

Nome Chiave Necessario Tipo Descrizione
ID attività
taskId True string

ID dell'attività.

Annulla attività (V2)

Annulla un'attività. Autorizzazioni necessarie: amministrare Jira o Creator dell'attività.

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance True string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

ID attività
taskId True string

ID dell'attività.

Attività Get (V2)

Restituisce lo stato di un'attività asincrona a esecuzione prolungata. Al termine di un'attività, questa operazione restituisce il BLOB JSON applicabile all'attività.

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance True string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

ID attività
taskId True string

ID dell'attività.

Crea categoria progetto

Crea una categoria di progetto. Autorizzazioni necessarie: Amministrare Jira (autorizzazioni globali)

Parametri

Nome Chiave Necessario Tipo Descrizione
nome
name string

Nome

descrizione
description string

Description

Crea categoria progetto (V2)

Crea una categoria di progetto. Autorizzazioni necessarie: Amministrare Jira (autorizzazioni globali)

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance True string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

nome
name string

Nome

descrizione
description string

Description

Creare un nuovo problema (V2) [DEPRECATO]

Questa azione è stata deprecata. Usare invece Crea un nuovo problema (V3).

Questa operazione viene usata per creare un nuovo problema.

Parametri

Nome Chiave Necessario Tipo Descrizione
Progetto
projectKey True string

Selezionare un progetto in cui creare il problema.

ID tipo di problema
issueTypeIds True string

Selezionare un tipo di problema.

oggetto
item dynamic

Elemento

Restituisce

Creare un nuovo problema (V3)

Questa operazione viene usata per creare un nuovo problema.

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance True string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

Progetto
projectKey True string

Selezionare un progetto in cui creare il problema.

ID tipo di problema
issueTypeIds True string

Selezionare un tipo di problema.

oggetto
item dynamic

Elemento

Restituisce

Creare un nuovo problema [DEPRECATO]

Questa azione è stata deprecata. Usare invece Crea un nuovo problema (V3).

Questa operazione viene usata per creare un nuovo problema.

Parametri

Nome Chiave Necessario Tipo Descrizione
Progetto
projectKey True string

Selezionare un progetto in cui creare il problema.

ID tipo di problema
id True string

Selezionare un tipo di problema.

Riassunto
summary True string

Breve descrizione del problema.

Components
components string

Campo di sistema che è costituito da più valori indirizzati da 'name' (ad esempio Microsoft Entra ID, Commutatore di rete).

Reporter Id
id string

Persona che segnala il problema.

Description
description string

Descrizione dettagliata del problema.

ID priorità
id string

Selezionare una priorità per il problema.

Etichette
labels string

Immettere un elenco delimitato da virgole di etichette

Id assegnatario
id string

Agent a cui è assegnato il problema.

ID problema padre
id string

Impostare l'elemento padre per una sottoattività.

Nome epico (customfield_10011)
customfield_10119 string

Il nome epico è obbligatorio per il tipo di problema epico. Questo campo corrisponde al campo 'customfield_10011' nel server Jira.

Restituisce

Creare un nuovo progetto

Questa operazione viene usata per creare un nuovo progetto Jira.

Parametri

Nome Chiave Necessario Tipo Descrizione
Chiave del progetto
key True string

La chiave univoca inizia con una lettera maiuscola.

Nome
name True string

Titolo del progetto.

TIPO
projectTypeKey True string

Chiave del tipo di progetto.

Lead Id
leadAccountId True string

ID del lead del progetto.

Description
description string

Descrizione dettagliata del progetto.

Restituisce

Creare un nuovo progetto (V2)

Questa operazione viene usata per creare un nuovo progetto Jira.

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance True string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

Chiave del progetto
key True string

La chiave univoca inizia con una lettera maiuscola.

Nome
name True string

Titolo del progetto.

TIPO
projectTypeKey True string

Chiave del tipo di progetto.

Lead Id
leadAccountId True string

ID del lead del progetto.

Description
description string

Descrizione dettagliata del progetto.

Restituisce

Elencare gli utenti per progetto

Questa operazione viene utilizzata per recuperare un elenco di tutti gli utenti associati a un progetto.

Parametri

Nome Chiave Necessario Tipo Descrizione
Chiave del progetto
projectKey True string

Chiave univoca del progetto.

Restituisce

Elementi
UserList

Elencare gli utenti per progetto (V2)

Questa operazione viene utilizzata per recuperare un elenco di tutti gli utenti associati a un progetto.

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance True string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

Chiave del progetto
projectKey True string

Chiave univoca del progetto.

Restituisce

Elementi
UserList

Elimina il progetto

Elimina un progetto. Autorizzazioni necessarie: Amministrare Jira (autorizzazioni globali)

Parametri

Nome Chiave Necessario Tipo Descrizione
ID progetto o chiave
projectIdOrKey True string

ID progetto o chiave del progetto (con distinzione tra maiuscole e minuscole).

Abilita annulla
enableUndo boolean

Indica se il progetto viene inserito nel Cestino di Jira in cui sarà disponibile per il ripristino.

Elimina progetto (V2)

Elimina un progetto. Autorizzazioni necessarie: Amministrare Jira (autorizzazioni globali)

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance True string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

ID progetto o chiave
projectIdOrKey True string

ID progetto o chiave del progetto (con distinzione tra maiuscole e minuscole).

Abilita annulla
enableUndo boolean

Indica se il progetto viene inserito nel Cestino di Jira in cui sarà disponibile per il ripristino.

Esegue una transizione di problema

Esegue la transizione di un problema a un nuovo stato.

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance True string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

ID problema o chiave
issueIdOrKey True string

ID o chiave del problema da eseguire per la transizione

nome
name string
nome
name string
activityDescription
activityDescription string
avatarUrl
avatarUrl string
nome visualizzato
displayName string
id
id string
type
type string
URL
url string
id
id string
type
type string
descrizione
description string
Iterazione
Iteration string
Step
Step string
id
id string
type
type string
type
type string
id
id string
body
body string

Jira MCP Server

Jira MCP Server

Parametri

Nome Chiave Necessario Tipo Descrizione
jsonrpc
jsonrpc string
id
id string
method
method string
params
params object
risultato
result object
Errore
error object
sessionId
sessionId string

Restituisce

Modifica problema

Modifica un problema. È possibile applicare una transizione e aggiornare le proprietà dei problemi come parte della modifica. Le modifiche apportate ai campi del problema vengono definite usando gli aggiornamenti e i campi.

Parametri

Nome Chiave Necessario Tipo Descrizione
ID problema o chiave
issueIdOrKey True string

Specificare l'ID problema o la chiave per il problema da modificare

Inviare una notifica agli utenti
notifyUsers boolean

Inviare una notifica agli utenti?

Eseguire l'override della sicurezza dello schermo
overrideScreenSecurity boolean

Eseguire l'override della sicurezza dello schermo?

Eseguire l'override del flag modificabile
overrideEditableFlag boolean

Eseguire l'override del flag modificabile?

ID transizione
id string

ID transizione

Ciclo di transizione
looped string

Ciclo di transizione

Fields
fields object

Elenco dei campi della schermata dei problemi da aggiornare, specificando il sottocampo da aggiornare e il relativo valore per ogni campo. Questo campo offre un'opzione semplice quando si imposta un sottocampo. Quando sono necessari più campi secondari o altre operazioni, usare l'aggiornamento. I campi inclusi qui non possono essere inclusi nell'aggiornamento.

Update
update object

Mappa contenente il nome del campo e un elenco di operazioni da eseguire nel campo della schermata del problema. Si noti che i campi inclusi qui non possono essere inclusi nei campi.

Tipo di metadati
type string

Tipo di metadati della cronologia

Descrizione dei metadati
description string

Descrizione dei metadati della cronologia

Chiave di descrizione dei metadati
descriptionKey string

Chiave di descrizione dei metadati della cronologia

Descrizione dell'attività dei metadati
activityDescription string

Descrizione dell'attività dei metadati della cronologia

Chiave di descrizione dell'attività di metadati
activityDescriptionKey string

Chiave di descrizione dell'attività dei metadati della cronologia

Descrizione del messaggio di posta elettronica dei metadati
emailDescription string

Descrizione della posta elettronica dei metadati della cronologia

Chiave di descrizione del messaggio di posta elettronica dei metadati
emailDescriptionKey string

Chiave di descrizione della posta elettronica dei metadati della cronologia

ID attore
id string

ID attore

Nome visualizzato attore
displayName string

Nome visualizzato attore

Chiave del nome visualizzato dell'attore
displayNameKey string

Chiave del nome visualizzato dell'attore

Tipo di attore
type string

Tipo di attore

URL avatar attore
avatarUrl string

URL avatar attore

URL attore
url string

URL attore

ID generatore
id string

ID generatore

Nome visualizzato del generatore
displayName string

Nome visualizzato del generatore

Chiave del nome visualizzato del generatore
displayNameKey string

Chiave del nome visualizzato del generatore

Tipo di generatore
type string

Tipo di generatore

URL avatar generatore
avatarUrl string

URL avatar generatore

URL generatore
url string

URL generatore

ID causa
id string

ID causa

Causa nome visualizzato
displayName string

Causa nome visualizzato

Causa chiave del nome visualizzato
displayNameKey string

Causa chiave del nome visualizzato

Tipo di causa
type string

Tipo di causa

Causa url avatar
avatarUrl string

Causa url avatar

Causa URL
url string

Causa URL

Dati aggiuntivi
extraData string

Dati aggiuntivi

key
key string

Key

Ottenere l'elenco dei filtri

Questa operazione restituisce un elenco di filtri accessibili all'utente.

Restituisce

Ottenere l'elenco dei filtri (V2)

Questa operazione restituisce un elenco di filtri accessibili all'utente.

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance True string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

Restituisce

Ottenere l'elenco dei problemi

Questa operazione restituisce un elenco di problemi relativi all'uso di JQL.

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance True string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

Restituisce

Ottenere l'elenco dei problemi (Datacenter)

Questa operazione restituisce un elenco di problemi relativi all'uso di JQL.

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance True string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

Restituisce

Ottenere l'elenco delle risorse

Questa operazione restituisce un elenco di risorse accessibili all'utente.

Restituisce

Elementi
Sites

Ottenere l'elenco delle transizioni

Restituisce un elenco delle transizioni possibili per questo problema dall'utente corrente

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance True string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

ID problema o chiave
issueIdOrKey True string

ID o chiave del problema per recuperare le transizioni per

Restituisce

Nome Percorso Tipo Descrizione
Transizioni
transitions array of Transition

Ottenere l'utente (V2)

Restituisce un utente. Autorizzazioni necessarie: esplorare utenti e gruppi.

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance True string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

ID dell'account
accountId True string

ID account dell'utente, che identifica in modo univoco l'utente in tutti i prodotti Atlassian. Ad esempio, 5b10ac8d82e05b22cc7d4ef5. Obbligatorio.

Espandi
expand string

Usare expand per includere informazioni aggiuntive sugli utenti nella risposta. Questo parametro accetta un elenco delimitato da virgole. Le opzioni di espansione includono: * groups include tutti i gruppi e i gruppi annidati a cui appartiene l'utente. * applicationRoles include i dettagli di tutte le applicazioni a cui l'utente ha accesso.

Ottenere l'utente corrente

Questa operazione restituisce i dettagli per l'utente corrente

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance True string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

Espandi
expand string

Usare expand per includere informazioni aggiuntive sugli utenti nella risposta. Questo parametro accetta un elenco delimitato da virgole. Le opzioni di espansione includono: * groups include tutti i gruppi e i gruppi annidati a cui appartiene l'utente. * applicationRoles include i dettagli di tutte le applicazioni a cui l'utente ha accesso.

Ottenere progetti

Questa operazione viene usata per recuperare un elenco di progetti per l'istanza di Jira.

Restituisce

Ottenere progetti (V2)

Questa operazione viene usata per recuperare un elenco di progetti per l'istanza di Jira.

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance True string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

Restituisce

Ottenere progetti [DEPRECATO]

Questa azione è stata deprecata. Usare invece Get projects (Ottieni progetti ).

Questa operazione viene usata per recuperare un elenco di progetti per l'istanza di Jira.

Restituisce

Elementi
ProjectArray

Ottenere tutte le categorie di progetti (V2)

Restituisce tutte le categorie di progetto.

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance True string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

Restituisce

Nome Percorso Tipo Descrizione
array of object
stesso
self string

Self

id
id string

Documento d'identità

descrizione
description string

Description

nome
name string

Nome

Ottenere tutte le categorie di progetto

Restituisce tutte le categorie di progetto.

Restituisce

Nome Percorso Tipo Descrizione
array of object
stesso
self string

Self

id
id string

Documento d'identità

descrizione
description string

Description

nome
name string

Nome

Ottenere un problema per chiave

Questa operazione viene utilizzata per recuperare l'oggetto problema per una determinata chiave di problema.

Parametri

Nome Chiave Necessario Tipo Descrizione
Chiave del problema
issueKey True string

Chiave univoca del problema.

Restituisce

Problema
FullIssue

Ottenere un problema per chiave (V2)

Questa operazione viene utilizzata per recuperare l'oggetto problema per una determinata chiave di problema.

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance True string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

Chiave del problema
issueKey True string

Chiave univoca del problema.

Restituisce

Problema
FullIssue

Ottenere un utente

Restituisce un utente. Autorizzazioni necessarie: esplorare utenti e gruppi.

Parametri

Nome Chiave Necessario Tipo Descrizione
ID dell'account
accountId True string

ID account dell'utente, che identifica in modo univoco l'utente in tutti i prodotti Atlassian. Ad esempio, 5b10ac8d82e05b22cc7d4ef5. Obbligatorio.

Espandi
expand string

Usare expand per includere informazioni aggiuntive sugli utenti nella risposta. Questo parametro accetta un elenco delimitato da virgole. Le opzioni di espansione includono: * groups include tutti i gruppi e i gruppi annidati a cui appartiene l'utente. * applicationRoles include i dettagli di tutte le applicazioni a cui l'utente ha accesso.

Ottieni attività

Restituisce lo stato di un'attività asincrona a esecuzione prolungata. Al termine di un'attività, questa operazione restituisce il BLOB JSON applicabile all'attività.

Parametri

Nome Chiave Necessario Tipo Descrizione
ID attività
taskId True string

ID dell'attività.

Problema di modifica (V2)

Modifica un problema. È possibile applicare una transizione e aggiornare le proprietà dei problemi come parte della modifica. Le modifiche apportate ai campi del problema vengono definite usando gli aggiornamenti e i campi.

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance True string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

ID problema o chiave
issueIdOrKey True string

Specificare l'ID problema o la chiave per il problema da modificare

Inviare una notifica agli utenti
notifyUsers boolean

Inviare una notifica agli utenti?

Eseguire l'override della sicurezza dello schermo
overrideScreenSecurity boolean

Eseguire l'override della sicurezza dello schermo?

Eseguire l'override del flag modificabile
overrideEditableFlag boolean

Eseguire l'override del flag modificabile?

ID transizione
id string

ID transizione

Ciclo di transizione
looped string

Ciclo di transizione

Fields
fields object

Elenco dei campi della schermata dei problemi da aggiornare, specificando il sottocampo da aggiornare e il relativo valore per ogni campo. Questo campo offre un'opzione semplice quando si imposta un sottocampo. Quando sono necessari più campi secondari o altre operazioni, usare l'aggiornamento. I campi inclusi qui non possono essere inclusi nell'aggiornamento.

Update
update object

Mappa contenente il nome del campo e un elenco di operazioni da eseguire nel campo della schermata del problema. Si noti che i campi inclusi qui non possono essere inclusi nei campi.

Tipo di metadati
type string

Tipo di metadati della cronologia

Descrizione dei metadati
description string

Descrizione dei metadati della cronologia

Chiave di descrizione dei metadati
descriptionKey string

Chiave di descrizione dei metadati della cronologia

Descrizione dell'attività dei metadati
activityDescription string

Descrizione dell'attività dei metadati della cronologia

Chiave di descrizione dell'attività di metadati
activityDescriptionKey string

Chiave di descrizione dell'attività dei metadati della cronologia

Descrizione del messaggio di posta elettronica dei metadati
emailDescription string

Descrizione della posta elettronica dei metadati della cronologia

Chiave di descrizione del messaggio di posta elettronica dei metadati
emailDescriptionKey string

Chiave di descrizione della posta elettronica dei metadati della cronologia

ID attore
id string

ID attore

Nome visualizzato attore
displayName string

Nome visualizzato attore

Chiave del nome visualizzato dell'attore
displayNameKey string

Chiave del nome visualizzato dell'attore

Tipo di attore
type string

Tipo di attore

URL avatar attore
avatarUrl string

URL avatar attore

URL attore
url string

URL attore

ID generatore
id string

ID generatore

Nome visualizzato del generatore
displayName string

Nome visualizzato del generatore

Chiave del nome visualizzato del generatore
displayNameKey string

Chiave del nome visualizzato del generatore

Tipo di generatore
type string

Tipo di generatore

URL avatar generatore
avatarUrl string

URL avatar generatore

URL generatore
url string

URL generatore

ID causa
id string

ID causa

Causa nome visualizzato
displayName string

Causa nome visualizzato

Causa chiave del nome visualizzato
displayNameKey string

Causa chiave del nome visualizzato

Tipo di causa
type string

Tipo di causa

Causa url avatar
avatarUrl string

Causa url avatar

Causa URL
url string

Causa URL

Dati aggiuntivi
extraData string

Dati aggiuntivi

key
key string

Key

Rimuovi categoria progetto

Elimina una categoria di progetto. Autorizzazioni necessarie: Amministrare Jira (autorizzazioni globali)

Parametri

Nome Chiave Necessario Tipo Descrizione
ID del progetto
id True integer

ID della categoria di progetto da eliminare.

Rimuovi categoria progetto (V2)

Elimina una categoria di progetto. Autorizzazioni necessarie: Amministrare Jira (autorizzazioni globali)

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance True string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

ID del progetto
id True integer

ID della categoria di progetto da eliminare.

Trigger

Quando un nuovo problema viene restituito da una query JQL

Questa operazione viene attivata quando viene visualizzato un nuovo problema nei 100 risultati più recenti di una query JQL.

Quando un nuovo problema viene restituito da una query JQL (Datacenter)

Questa operazione viene attivata quando viene visualizzato un nuovo problema nei 100 risultati più recenti di una query JQL.

Quando un nuovo problema viene restituito da una query JQL (V2)

Questa operazione viene attivata quando viene visualizzato un nuovo problema nei 100 risultati più recenti di una query JQL.

Quando un problema viene chiuso

Questa operazione viene attivata quando un problema esistente viene chiuso nel progetto specificato.

Quando un problema viene chiuso (Datacenter)

Questa operazione viene attivata quando un problema esistente viene chiuso nel progetto specificato.

Quando un problema viene chiuso (V2)

Questa operazione viene attivata quando un problema esistente viene chiuso nel progetto specificato.

Quando viene creato un nuovo problema

Questa operazione viene attivata quando viene aggiunto un nuovo problema al progetto specificato.

Quando viene creato un nuovo problema (Datacenter)

Questa operazione viene attivata quando viene aggiunto un nuovo problema al progetto specificato.

Quando viene creato un nuovo problema (V2)

Questa operazione viene attivata quando viene aggiunto un nuovo problema al progetto specificato.

Quando un nuovo problema viene restituito da una query JQL

Questa operazione viene attivata quando viene visualizzato un nuovo problema nei 100 risultati più recenti di una query JQL.

Parametri

Nome Chiave Necessario Tipo Descrizione
JQL Query
jql True string

Query da usare.

Restituisce

Problema
FullIssue

Quando un nuovo problema viene restituito da una query JQL (Datacenter)

Questa operazione viene attivata quando viene visualizzato un nuovo problema nei 100 risultati più recenti di una query JQL.

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

JQL Query
jql True string

Query da usare.

Restituisce

Problema
FullIssue

Quando un nuovo problema viene restituito da una query JQL (V2)

Questa operazione viene attivata quando viene visualizzato un nuovo problema nei 100 risultati più recenti di una query JQL.

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

JQL Query
jql True string

Query da usare.

Restituisce

Problema
FullIssue

Quando un problema viene chiuso

Questa operazione viene attivata quando un problema esistente viene chiuso nel progetto specificato.

Parametri

Nome Chiave Necessario Tipo Descrizione
Progetto
projectKey True string

Chiave univoca del progetto per cercare nuovi problemi.

Restituisce

Problema
FullIssue

Quando un problema viene chiuso (Datacenter)

Questa operazione viene attivata quando un problema esistente viene chiuso nel progetto specificato.

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

Progetto
projectKey True string

Chiave univoca del progetto per cercare nuovi problemi.

Restituisce

Problema
FullIssue

Quando un problema viene chiuso (V2)

Questa operazione viene attivata quando un problema esistente viene chiuso nel progetto specificato.

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

Progetto
projectKey True string

Chiave univoca del progetto per cercare nuovi problemi.

Restituisce

Problema
FullIssue

Quando viene creato un nuovo problema

Questa operazione viene attivata quando viene aggiunto un nuovo problema al progetto specificato.

Parametri

Nome Chiave Necessario Tipo Descrizione
Progetto
projectKey True string

Chiave univoca del progetto per cercare nuovi problemi.

Restituisce

Problema
FullIssue

Quando viene creato un nuovo problema (Datacenter)

Questa operazione viene attivata quando viene aggiunto un nuovo problema al progetto specificato.

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

Progetto
projectKey True string

Chiave univoca del progetto per cercare nuovi problemi.

Restituisce

Problema
FullIssue

Quando viene creato un nuovo problema (V2)

Questa operazione viene attivata quando viene aggiunto un nuovo problema al progetto specificato.

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza di Jira
X-Request-Jirainstance string

URL in cui è ospitata l'istanza di Jira (deve supportare https).

Progetto
projectKey True string

Chiave univoca del progetto per cercare nuovi problemi.

Restituisce

Problema
FullIssue

Definizioni

CreateProjectResponse

Nome Percorso Tipo Descrizione
ID progetto
id integer

ID univoco del progetto.

Chiave del progetto
key string

Chiave univoca del progetto.

CreateIssueResponse

Nome Percorso Tipo Descrizione
ID problema
id string

Identificatore univoco del problema.

Chiave del problema
key string

Chiave univoca del problema.

ListProjects_ResponseV2

Nome Percorso Tipo Descrizione
values
values ProjectArray

ProjectArray

Nome Percorso Tipo Descrizione
ID progetto
id string

ID univoco del progetto.

Chiave del progetto
key string

Chiave univoca del progetto.

Nome progetto
name string

Nome del progetto.

Chiave del tipo di progetto
projectTypeKey string

Chiave univoca del tipo di progetto.

FullIssue

Nome Percorso Tipo Descrizione
ID problema
id string

ID univoco del problema.

Chiave del problema
key string

Chiave univoca del problema.

URL problema
self string

Passare al problema usando questo URL.

ID tipo di problema
fields.issuetype.id string

ID univoco del tipo di problema.

Descrizione del tipo di problema
fields.issuetype.description string

Titolo dettagliato del tipo di problema.

URL icona del tipo di problema
fields.issuetype.iconUrl string

Icona associata al tipo di problema.

Nome del tipo di problema
fields.issuetype.name string

Titolo del tipo di problema.

Tempo trascorso
fields.timespent integer

Tempo impiegato per un problema

ID progetto
fields.project.id string

ID univoco del progetto.

Chiave del progetto
fields.project.key string

Chiave univoca del progetto.

Nome progetto
fields.project.name string

Titolo del progetto.

Chiave del tipo di progetto
fields.project.projectTypeKey string

Chiave univoca del tipo di progetto.

Tempo aggregato impiegato
fields.aggregatetimespent integer

Tempo aggregato dedicato alle sottoattività.

URL della risoluzione del problema
fields.resolution.self string
ID della risoluzione del problema
fields.resolution.id string
Descrizione della risoluzione del problema
fields.resolution.description string
Assegnare un nome alla risoluzione del problema
fields.resolution.name string
Data risoluzione
fields.resolutiondate date-time

aaaa-MM-ggTHH:mm:ss.fffZ

Rapporto lavoro
fields.workratio integer

Percentuale di lavoro registrata rispetto alla stima del problema.

Data di creazione
fields.created date-time

aaaa-MM-ggTHH:mm:ss.fffZ

URL icona priorità
fields.priority.iconUrl string

Icona associata alla priorità del problema.

Nome priorità
fields.priority.name string

Titolo della priorità.

ID priorità
fields.priority.id string

ID della priorità del problema.

Stima del tempo
fields.timeestimate integer

Tempo stimato rimanente in secondi.

Stima tempo aggregato
fields.aggregatetimeoriginalestimate integer

Somma originale di tutte le stime del tempo dell'attività secondaria in secondi.

Id assegnatario
fields.assignee.accountId string

Persona a cui viene assegnato un problema.

Chiave assegnatario
fields.assignee.key string

La chiave utente del problema della persona viene assegnata a.

Indirizzo di posta elettronica assegnatario
fields.assignee.emailAddress string

L'indirizzo di posta elettronica del problema della persona viene assegnato.

Assegna nome visualizzato
fields.assignee.displayName string

Nome visualizzato del problema della persona a cui è assegnato.

Date-Time aggiornato
fields.updated date-time

aaaa-MM-ggTHH:mm:ss.fffZ

Descrizione stato
fields.status.description string

Stato del problema.

URL icona di stato
fields.status.iconUrl string

Stato del problema.

Nome stato
fields.status.name string

Stato del problema.

ID stato
fields.status.id string

Stato del problema.

ID categoria stato
fields.status.statusCategory.id integer

Categoria di stato del problema.

Chiave categoria stato
fields.status.statusCategory.key string

Categoria di stato del problema.

Nome colore categoria stato
fields.status.statusCategory.colorName string

Categoria di stato del problema.

Nome categoria stato
fields.status.statusCategory.name string

Categoria di stato del problema.

Stima ora originale
fields.timeoriginalestimate integer

Stima dell'ora originale in secondi.

Description
fields.description string

Descrizione del problema.

Stima tempo aggregato
fields.aggregatetimeestimate integer

Somma temporale di tutte le attività secondarie rimanenti in secondi.

Riassunto
fields.summary string

Titolo del problema.

Components
fields.components array of object

Campo di sistema che è costituito da più valori indirizzati da 'name' (ad esempio Microsoft Entra ID, Commutatore di rete).

ID componente
fields.components.id string
Il nome del componente
fields.components.name string
ID creatore
fields.creator.accountId string

Utente che ha creato il problema.

Chiave creatore
fields.creator.key string

Chiave univoca dell'utente che ha creato il problema.

Messaggio di posta elettronica creatore
fields.creator.emailAddress string

Indirizzo di posta elettronica dell'utente che ha creato il problema.

Nome visualizzato creatore
fields.creator.displayName string

Nome dell'utente che ha creato il problema.

Reporter Id
fields.reporter.accountId string

Utente che ha segnalato il problema.

Chiave reporter
fields.reporter.key string

Chiave univoca dell'utente che ha segnalato il problema.

Messaggio di posta elettronica del giornalista
fields.reporter.emailAddress string

Indirizzo di posta elettronica dell'utente che ha segnalato il problema.

Nome visualizzato reporter
fields.reporter.displayName string

Nome visualizzato dell'utente che ha segnalato il problema.

Stato aggregato completato
fields.aggregateprogress.progress integer

Stato totale completato di tutte le attività secondarie in secondi.

Lavoro stimato aggregato
fields.aggregateprogress.total integer

Somma totale di tutte le attività secondarie stimate.

Percentuale di avanzamento aggregato
fields.aggregateprogress.percent integer

Percentuale dello stato di avanzamento aggregato completato in relazione allo sforzo stimato.

Scadenza Date-Time
fields.duedate date-time

aaaa-MM-ggTHH:mm:ss.fffZ

Stato completato
fields.progress.progress integer

Stato completato in secondi.

Sforzo stimato
fields.progress.total integer

Lo sforzo stimato.

Percentuale di avanzamento
fields.progress.percent integer

Percentuale dello stato di avanzamento completato in relazione allo sforzo stimato.

Nome epico (customfield_10011)
fields.customfield_10119

Il nome epico è obbligatorio per il tipo di problema epico. Questo campo corrisponde al campo 'customfield_10011' nel server Jira.

UserList

Nome Percorso Tipo Descrizione
id
accountId string

ID del membro del progetto.

Key
key string

Chiave univoca associata all'utente.

Email
emailAddress string

Email indirizzo dell'utente.

Nome visualizzato
displayName string

Nome completo dell'utente.

ListFiltersResponse

Nome Percorso Tipo Descrizione
values
values FilterArray

FilterArray

Nome Percorso Tipo Descrizione
id
id string

ID del filtro.

Nome
name string

Nome del filtro.

JQL
jql string

jql usato in Filter.

ListIssuesResponse

Nome Percorso Tipo Descrizione
issues
issues array of FullIssue

ListIssuesResponseDatacenter

Nome Percorso Tipo Descrizione
issues
issues array of FullIssue

CommentResponse

Nome Percorso Tipo Descrizione
ID commento
id string

ID univoco del commento.

Corpo commento
body string

Corpo del commento.

Creazione di Date-Time
created date-time

aaaa-MM-ggTHH:mm:ss.fffZ

Sites

Nome Percorso Tipo Descrizione
ID cloud
id string

ID istanza di Jira

Nome del sito
name string
URL sito
url string

Transition

Nome Percorso Tipo Descrizione
id
id string

ID della transizione

nome
name string

Nome della transizione

a
to TransitionStatus
fields
fields object

Campi necessari per questa transizione

TransitionStatus

Nome Percorso Tipo Descrizione
id
id string

ID dello stato

nome
name string

Nome dello stato

MCPQueryResponse

Nome Percorso Tipo Descrizione
jsonrpc
jsonrpc string
id
id string
method
method string
params
params object
risultato
result object
Errore
error object