Collega Jira Cloud: guida passo passo
Crea un Bug per ogni test non superato, aggiunge un commento quando il test fallisce di nuovo e lo sposta nello stato Completato quando il test viene superato senza problemi. Questa guida ti accompagna da zero fino alla verifica della connessione ed elenca gli errori che potresti incontrare con le relative cause e soluzioni.
Ultimo aggiornamento:
Mantieni riservate le tue credenziali. Non incollare mai token, chiavi, password o URL di webhook in una chat. Inseriscili solo in Studio → Impostazioni → Integrazioni, dove vengono salvati nel file .env del tuo spazio di lavoro e visualizzati come puntini. Lo stesso vale per un assistente IA: può accompagnarti lungo questa guida, ma non ha mai bisogno del tuo token.
Cosa serve
- Un sito Jira Cloud, ad esempio https://your-team.atlassian.net (solo Jira Cloud; l'indirizzo deve usare https).
- L'indirizzo email del tuo account Atlassian e un token API creato con lo stesso account.
- Una chiave di progetto, ad esempio QA, il cui progetto abbia un tipo di segnalazione denominato Bug.
- In quel progetto, le autorizzazioni per quell'account a consultare il progetto, creare segnalazioni, aggiungere commenti, creare allegati e modificare lo stato delle segnalazioni.
Ottieni le credenziali
- Apri https://id.atlassian.com/manage-profile/security/api-tokens e scegli Crea token API.
- Assegnagli un nome (ad esempio "Nexus StudioQA"), scegli una scadenza, crealo e copia subito il token. Atlassian lo mostra una sola volta.
- Tienilo negli appunti. Non incollarlo da nessuna parte tranne che nello Studio (passaggio successivo).
Collegalo nello Studio
- In Studio, apri Impostazioni → Integrazioni → Collega Jira.
- Incolla un qualsiasi collegamento dal tuo Jira (la pagina iniziale, una bacheca o una segnalazione) e premi Verifica connessione. Studio conserva l'indirizzo del sito e la chiave del progetto.
- Quando richiesto, inserisci la tua email Atlassian e il token, poi premi Salva & verifica.
- Scegli il progetto in "Destinazione dei bug", quindi attiva
JIRA_ENABLED.
Verifica che funzioni
- Verifica connessione mostra "Accesso effettuato come <il tuo nome>" e "<KEY> accetta ticket Bug". La verifica esegue solo operazioni di lettura; non apre mai un ticket.
- Apri Impostazioni → Integrazioni → Ticket e premi Crea ticket di prova. Crea un ticket con l'etichetta nexus-test ed è l'unico pulsante in quella sezione che effettua una chiamata a Jira.
- Apri quel ticket in Jira e verifica che abbia le etichette auto-generated, nexus-studioqa-automation e nexus-test. Eliminalo quando hai finito.
Errori comuni
| Cosa vedi | Causa | Soluzione |
|---|---|---|
| "Questo non è un collegamento" o "Un collegamento Jira inizia con https://" | Il testo incollato non è un indirizzo web completo oppure inizia con http://. | Copia l'indirizzo dalla barra degli indirizzi mentre sei sul tuo sito Jira. Deve iniziare con https://. |
| HTTP 401 | L'email o il token non sono corretti, il token è scaduto o è stato revocato, oppure l'email non corrisponde all'account che ha creato il token. | Crea un nuovo token su id.atlassian.com con l'account di cui hai salvato l'email, poi salva di nuovo entrambi in Impostazioni. |
| HTTP 403 | L'accesso funziona, ma Jira indica che l'account non è autorizzato a eseguire l'operazione: di solito manca l'autorizzazione Crea segnalazioni, Aggiungi commenti o Crea allegati nel progetto. | Chiedi queste autorizzazioni all'amministratore del progetto oppure scegli un altro progetto. Nexus StudioQA non può concederle. |
| HTTP 404 | L'indirizzo del sito o la chiave del progetto non esiste, oppure l'account non può visualizzare il progetto (Jira risponde con 404 per i progetti che nasconde). | Incolla un qualsiasi collegamento dal sito corretto e scegli il progetto dall'elenco. |
| "L'indirizzo ha risposto, ma non con un account Jira" | L'indirizzo non corrisponde a un sito Jira Cloud (ad esempio è un indirizzo Server o Data Center, oppure un'altra pagina web). | Usa l'indirizzo https://<team>.atlassian.net del tuo sito Jira Cloud. |
| "<KEY> non ha un tipo di segnalazione chiamato Bug" | Il progetto non ha un tipo di segnalazione chiamato Bug, quindi non è possibile creare ticket. | In Jira, apri Impostazioni progetto → Tipi di segnalazione e aggiungi Bug, oppure scegli un altro progetto. |
| "impossibile raggiungere Jira (ENOTFOUND)" oppure "nessuna risposta entro 20 s" | Questo PC non riesce a raggiungere il sito: c'è un errore nell'indirizzo, una VPN o un proxy, oppure manca la connessione di rete. | Correggi l'indirizzo, poi apri il sito in un browser sullo stesso PC. Ripeti la verifica. |
| Tutte le verifiche vanno a buon fine, ma non compare alcun ticket | JIRA_ENABLED è false; oppure l'esito era FLAKY o relativo all'ambiente; oppure era un'esecuzione in un ambiente isolato; oppure esiste già un Bug aperto per quel test (un errore ripetuto aggiunge invece un commento); oppure è stato creato un Bug con lo stesso titolo nelle ultime 24 ore. | Attiva JIRA_ENABLED, leggi "Una segnalazione per test" nella pagina delle integrazioni e usa Crea ticket di prova per verificare la connessione. |
| Un test superato non chiude il relativo ticket | Il flusso di lavoro non ha una transizione con il nome indicato in JIRA_DONE_TRANSITION, quindi al ticket viene aggiunto solo il commento. | Imposta JIRA_DONE_TRANSITION sul nome esatto del pulsante di transizione nel tuo flusso di lavoro. |
Chiavi di configurazione
| Chiave | Cosa fa | Valore valido | Come verificarlo |
|---|---|---|---|
JIRA_ENABLED | Crea ticket Jira per i test non superati | true o false | Attiva l'integrazione, poi esegui Crea ticket di prova. |
JIRA_BASE_URL | Indirizzo del sito Jira | https://<site>.atlassian.net | Verifica connessione mostra il sito; incollando un collegamento, il campo viene compilato. |
JIRA_EMAIL | Email di accesso a Jira | L'email dell'account Atlassian a cui appartiene il token | Verifica connessione mostra "Accesso effettuato come …" con questa email. |
JIRA_API_TOKEN | Token di accesso Jira (segreto, salvato solo su questo computer) | Una sola riga, senza virgolette né spazi | Verifica connessione: HTTP 401 indica che la coppia email/token è errata. |
JIRA_PROJECT_KEY | Progetto Jira per i ticket Bug | La chiave del progetto, di solito in lettere maiuscole, ad esempio QA | Il progetto compare nell'elenco a discesa; "accetta ticket Bug" conferma il tipo. |
JIRA_DONE_TRANSITION | Stato Jira quando il test viene superato | Il nome esatto di una transizione del flusso di lavoro, senza distinzione tra maiuscole e minuscole | Un test superato senza problemi fa avanzare il ticket; se il flusso di lavoro non prevede quella transizione, viene aggiunto solo un commento. |
Approfondimenti: tutte le integrazioni, la guida alle impostazioni, risoluzione dei problemi. Altre guide: Azure Boards, Slack, Microsoft Teams, Telegram, GitHub Issues.
Non riesci ancora a risolvere? Scrivi a [email protected] riportando l'esatta riga di errore mostrata da Studio. Non includere token.