Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Integrazione con Atlassian Jira Cloud
Usa il connettore di azione Atlassian Jira Cloud per creare, aggiornare, cercare e gestire problemi, progetti, sprint e utenti di Jira direttamente in Amazon Quick tramite linguaggio naturale.
La configurazione di questa integrazione prevede due passaggi. Innanzitutto, crei un'app OAuth 2.0 (3LO) nell'Atlassian Developer Console e ne configuri le autorizzazioni. Quindi, crei l'integrazione in Amazon Quick e la connetti alla tua app Atlassian. Per informazioni sui metodi di autenticazione supportati da Amazon Quick, consulta[Metodi di autenticazione](quick-action-auth.md).
## Prima di iniziare
Assicurati di disporre di quanto segue prima di configurare l'integrazione.
+ Atlassian Jira Cloud.
+ Accesso alla [Atlassian Developer Console](https://developer.atlassian.com/console/myapps/) per creare o gestire un'app. OAuth
+ Per i requisiti di abbonamento, consulta. [Configura le integrazioni nella console](integration-console-setup-process.md)
## Configura l'Atlassian Developer Console
Se prevedi di utilizzare l'autenticazione utente (3LO), crea un'app OAuth 2.0 nell'Atlassian Developer Console prima di configurare Amazon Quick. Completa tutti i passaggi seguenti prima di passare alla console Amazon Quick.
Se prevedi di utilizzare solo l'autenticazione del servizio (chiave API), puoi saltare questa sezione e procedere [Configura l'integrazione in Amazon Quick](#jira-integration-setup) con.
Per ulteriori informazioni sulle app OAuth 2.0 (3LO), consulta le app [OAuth 2.0 (3LO)](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/) nella documentazione per sviluppatori di Atlassian.
### Crea un'app OAuth 2.0 (3LO)
Amazon Quick utilizza un'app Atlassian OAuth 2.0 (3LO) per autenticarsi con il tuo prodotto Atlassian Cloud per conto dei tuoi utenti. Crea questa app nell'Atlassian Developer Console prima di configurare Amazon Quick.
1. Apri l'[Atlassian Developer Console](https://developer.atlassian.com/console/myapps/) e accedi con il tuo account Atlassian.
1. **Scegli **Crea**, quindi scegli l'integrazione 2.0. OAuth **
1. Per **Nome**, inserisci un nome descrittivo per l'integrazione, ad esempio`your-app-name connector`.
1. Leggi e accetta i termini per gli sviluppatori di Atlassian.
1. Scegli **Create** (Crea).
### Configurazione delle autorizzazioni
Dopo aver creato l'app OAuth 2.0, aggiungi le autorizzazioni API di cui Amazon Quick ha bisogno per interagire con il tuo prodotto Atlassian.
1. Dalla tua app nella Atlassian Developer Console, scegli **Autorizzazioni** nella barra di navigazione a sinistra.
1. **Trova l'API per il tuo prodotto Atlassian (ad esempio, **Jira API o **Confluence** API**) e scegli Aggiungi.** Il pulsante cambia in **Configura** dopo l'aggiunta dell'API.
1. Scegli **Configura**. La pagina degli ambiti si apre con le schede **Ambiti classici** e Ambiti **granulari**.
1. **Nella scheda Ambiti **classici, scegli Modifica ambiti.**** **Seleziona gli ambiti classici richiesti e scegli Salva.**
1. **Scegli la scheda Ambiti **granulari, quindi scegli Modifica ambiti**.** **Seleziona gli ambiti granulari richiesti e scegli Salva.**
Per gli ambiti specifici richiesti per l'integrazione, consulta la sezione sugli ambiti che segue.
### Configura le autorizzazioni API
Aggiungi i seguenti ambiti alla tua app OAuth 2.0 per l'integrazione delle azioni di Jira Cloud.
**Ambiti classici**
Nella scheda **Ambiti classici**, scegli **Modifica ambiti e seleziona i seguenti ambiti**.
**Integrazione con Jira Action: ambiti classici**
| Scope | Description |
| --- | --- |
| read:jira-work | Leggi i dati dei progetti e dei problemi di Jira, cerca i problemi e gli oggetti associati a problemi come allegati e registri di lavoro. |
| manage:jira-project | Crea e modifica le impostazioni del progetto e crea nuovi oggetti a livello di progetto (ad esempio versioni e componenti). |
| manage:jira-configuration | Intraprendi azioni amministrative con Jira (ad esempio, crea progetti e campi personalizzati, visualizza i flussi di lavoro, gestisci i tipi di link ai problemi). |
| read:jira-user | Visualizza le informazioni sull'utente in Jira a cui l'utente ha accesso, inclusi nomi utente, indirizzi email e avatar. |
| write:jira-work | Crea e modifica problemi in Jira, pubblica commenti come utente, crea registri di lavoro ed elimina problemi. |
| manage:jira-webhook | Recupera, registra, aggiorna ed elimina i webhook Jira dichiarati dinamicamente. |
**Ambiti granulari**
**Scegli la scheda Ambiti **granulari, quindi scegli Modifica ambiti**.** Utilizza la barra di ricerca per trovare gli ambiti di seguito. Ad esempio, cerca per trovare gli `sprint:jira-software` oscilloscopi relativi allo sprint.
**Integrazione con Jira Action: ambiti granulari**
| Scope | Description |
| --- | --- |
| read:board-scope:jira-software | Leggi le configurazioni della scheda. |
| read:sprint:jira-software | Leggi le informazioni sullo sprint. |
| write:sprint:jira-software | Crea e modifica gli sprint. |
| delete:sprint:jira-software | Eliminare gli sprint. |
| write:board-scope:jira-software | Gestisci le configurazioni della scheda. |
| read:project:jira | Leggi i dettagli del progetto. |
### Configurazione dell’autorizzazione
Imposta l'URL di callback in modo che Atlassian possa reindirizzare gli utenti ad Amazon Quick dopo aver autorizzato l'app.
1. **Dalla tua app nella Atlassian Developer Console, scegli Autorizzazione nella barra di navigazione a sinistra.**
1. **Accanto a **OAuth 2.0 (3LO), scegli Aggiungi**.**
1. Per **Callback URLs, inserisci**. `https://region.quicksight.aws.amazon.com/sn/oauthcallback` Sostituisci *region* con la AWS regione in cui è distribuita l'istanza Amazon Quick, ad esempio`us-east-1`.
1. Scegli **Save changes** (Salva modifiche).
### Registra le tue credenziali
Prima di uscire dall'Atlassian Developer Console, verifica di avere i seguenti valori. Ne hai bisogno per la configurazione di Amazon Quick.
1. Dalla tua app nell'Atlassian Developer Console, scegli **Impostazioni** nella barra di navigazione a sinistra.
1. In **Dettagli di autenticazione**, copia i valori **Client ID** e **Secret**.
**Credenziali richieste dalla Atlassian Developer Console**
| Valore | Dove trovarlo |
| --- | --- |
| ID client | Pagina delle impostazioni, in Dettagli di autenticazione |
| Segreto | Pagina delle impostazioni, in Dettagli di autenticazione |
## Configura l'integrazione in Amazon Quick
Dopo aver preparato le credenziali di autenticazione, crea l'integrazione in Amazon Quick.
1. Nella console Amazon Quick, scegli **Integrazioni.**
1. Scegli la scheda **Azioni**.
1. In **Configura una nuova integrazione di app per Actions**, trova **Atlassian Jira Cloud** e scegli il pulsante Aggiungi (più «\$1»).
1. Nella procedura guidata di **creazione dell'integrazione**, compila i seguenti campi:
+ **Nome: nome** descrittivo per l'integrazione con Jira.
+ **Descrizione** (opzionale): note su come verrà utilizzata questa connessione.
+ **Tipo di connessione**: scegli **Rete pubblica**.
1. In **Impostazioni di autenticazione**, scegli il metodo di autenticazione e compila i campi richiesti:
1. Per **l'autenticazione utente**, configura i seguenti campi:
+ **URL di base: l'URL** dell'istanza Jira per le chiamate API. Questo non è lo stesso URL a cui accedono gli utenti. Assomiglia al seguente:`https://api.atlassian.com/ex/jira/yourInstanceId`. Per trovare l'ID della tua istanza, vai a`https://your-domain.atlassian.net/_edge/tenant_info`.
+ **ID cliente**: ID cliente dalla pagina Impostazioni dell'app Atlassian OAuth .
+ **Client secret**: nascosto dalla pagina Impostazioni dell'app OAuth Atlassian.
+ **URL del token**: `https://auth.atlassian.com/oauth/token`
+ **URL di autorizzazione** — `https://auth.atlassian.com/authorize`
+ **URL di reindirizzamento**: questo campo è precompilato con il tuo URL di callback Amazon Quick.
1. Per l'**autenticazione del servizio**, configura i seguenti campi:
+ **Chiave API**: token API Jira.
+ **URL di base: l'URL dell'**istanza Jira per le chiamate API.
+ **Email: indirizzo e-mail** associato all'account utente.
1. Scegli **Crea e continua**.
1. (Facoltativo) Nella pagina di **integrazione Condividi**, scegli gli utenti con cui condividere l'integrazione.
**Importante**
Jira Cloud può restituire risposte di successo HTTP 200 anche quando i token API vengono revocati o configurati in modo errato. [Per ulteriori informazioni, consulta JRACLOUD-82932.](https://jira.atlassian.com/browse/JRACLOUD-82932) Se l'integrazione sembra connettersi correttamente ma le azioni falliscono in modo imprevisto, verifica che il token API sia valido e non sia stato revocato.
## Operazioni disponibili
Dopo aver configurato l'integrazione, sono disponibili le seguenti azioni.
**Azioni disponibili in Jira Cloud**
| Azione | Description |
| --- | --- |
| Aggiungi allegato | Aggiungi un allegato a un problema. |
| Aggiungi commento | Aggiungi un nuovo commento. |
| Modifica lo stato del problema | Modifica lo stato dell'attività di un problema. |
| Crea problema | Crea un nuovo problema o sottoattività. |
| Creazione di un progetto | Crea un nuovo progetto. |
| Crea Sprint | Crea uno sprint in un progetto. |
| Elimina commento | Rimuovi commento. |
| Elimina problema | Eliminare un problema in un progetto. |
| Eliminazione del progetto | Rimuovi progetto. |
| Elimina Sprint | Elimina uno sprint in un progetto. |
| Modifica problema | Modifica problema. |
| Trova utenti | Cerca un utente Jira. |
| Ottieni tutte le etichette | Visualizza tutte le etichette. |
| Ottieni tutti gli utenti | Elenca tutti gli utenti Jira. |
| Ottieni il contenuto degli allegati | Visualizza il contenuto di un allegato. |
| Ottieni commenti | Visualizza i commenti sui problemi. |
| Ottieni un problema | Visualizza i dettagli di un problema in un progetto. |
| Visualizza i tipi di problemi relativi al progetto | Visualizza i tipi di problemi del progetto. |
| Ottieni priorità | Visualizza le priorità dei problemi. |
| Ottieni il progetto | Visualizza i dettagli del progetto. |
| Ottieni Sprint | Visualizza i dettagli di uno sprint in un progetto. |
| Sposta i problemi in Backlog | Sposta i problemi nel backlog. |
| Sposta i problemi in Sprint e Rank | Assegna un problema a uno sprint. |
| Problemi di ricerca | Cerca problemi. |
| Cerca progetti | Trova progetti visibili. |
| Stati della ricerca | Cerca gli stati dei problemi. |
| Aggiorna commento | Modifica commento. |
| Aggiorna progetto | Modifica progetto. |
| Aggiorna Sprint | Aggiorna i dettagli dello sprint. |
**Nota**
Le azioni che puoi utilizzare dipendono dalle autorizzazioni configurate nell'istanza di Jira Cloud e dal metodo di autenticazione.
## Gestisci e risolvi i problemi
Per modificare, condividere o eliminare la tua integrazione, consulta. [Gestione delle integrazioni esistenti](integration-workflows.md#managing-existing-integrations)
### Problemi di autenticazione
+ **Configurazione errata dell'app**: verifica che l' OAuth app nell'Atlassian Developer Console includa gli ambiti richiesti e che l'URI di reindirizzamento corrisponda alla tua configurazione Amazon Quick.
+ **Token API scaduto o revocato: se utilizzi l'autenticazione del servizio, verifica che il token** API non sia scaduto o non sia stato revocato. A causa di un comportamento noto di Jira Cloud ([JRACLOUD-82932](https://jira.atlassian.com/browse/JRACLOUD-82932)), è possibile che l'integrazione si connetta correttamente anche con token non validi.
+ URL di **base errato: l'URL** di base per le chiamate API non è lo stesso dell'URL di accesso a Jira Cloud. Verifica di utilizzare il formato URL dell'API:`https://api.atlassian.com/ex/jira/yourInstanceId`. Per trovare l'ID della tua istanza, vai a`https://your-domain.atlassian.net/_edge/tenant_info`.
### Messaggi di errore comuni
+ **`Access denied. You do not have permission to perform this action`**— L'utente autenticato non dispone delle autorizzazioni richieste in Jira Cloud. Contatta il tuo amministratore di Jira Cloud per verificare e concedere le autorizzazioni appropriate.
+ **`OAuth 2.0 authorization failed`**— Verifica che l'ID client, il segreto del client e OAuth gli ambiti siano configurati correttamente sia nell'Atlassian Developer Console che in Amazon Quick.