Integrazioni: Jira, Xray, Azure DevOps, Slack e Telegram

Nexus Studio si collega a cinque servizi: Jira Cloud, Xray Cloud, Azure DevOps, Slack e Telegram. Ciascuno è disattivato finché non lo attivi e viene raggiunto direttamente dal tuo computer, mai tramite i nostri server. Questa pagina spiega cosa fa ciascun servizio, quali chiavi legge e cosa non fa mai.

A cura del team di Nexus Studio, Verdict System LLC. 9 ottobre 2026.

Come funziona ogni integrazione

• Disattivata finché non la attivi. Ogni servizio ha il proprio interruttore: JIRA_ENABLED, XRAY_ENABLED, AZURE_BOARDS_ENABLED, SLACK_ENABLED e TELEGRAM_ENABLED. Tutti sono impostati su false per impostazione predefinita.
• Direttamente dal tuo computer. Il motore chiama l'API di ciascun servizio dal computer che esegue i test. Nulla passa attraverso i nostri server e non vediamo mai le tue segnalazioni, i tuoi avvisi o i tuoi risultati.
• Le chiavi restano nell'area di lavoro. I token e le chiavi sono righe nel file .env dell'area di lavoro, sul tuo disco. Nelle Impostazioni, la sezione Integrazioni consente di modificarli e mostra tutti i token, le chiavi e i webhook oscurati.
• Le esecuzioni nella sandbox sono escluse. Un'esecuzione nella sandbox è un test in costruzione, non un problema rilevato: non apre, commenta o chiude mai una segnalazione.

Una segnalazione per test, finché continua a fallire

Jira e Azure Boards seguono lo stesso ciclo di vita. La segnalazione è associata al test, non all'esecuzione: quindi un test che fallisce ogni notte ha un'unica segnalazione con una cronologia, non una nuova segnalazione ogni notte.

1. Il primo fallimento apre una segnalazione. Un'esecuzione che termina con BREACHED, BREACHED_FLAKY, CHAOS_BREACHED o TIMEOUT apre una segnalazione per quel test, con l'errore e la schermata del fallimento allegata.
2. Un fallimento successivo aggiunge un commento. Finché la segnalazione è aperta, il fallimento successivo vi aggiunge un commento, con la nuova schermata allegata. Due browser che falliscono contemporaneamente aggiornano la stessa segnalazione.
3. Un superamento senza errori la chiude. Quando il test viene superato senza errori su tutti i browser di un'esecuzione, la segnalazione riceve un commento che lo conferma e passa allo stato completato. Se il flusso di lavoro non prevede tale transizione o stato, riceve solo il commento.
4. Un fallimento successivo apre una nuova segnalazione. Lo stesso vale per un fallimento la cui segnalazione è stata eliminata o spostata.

Allegati: solo la schermata, per impostazione predefinita. La traccia di Playwright e il registro dell'esecuzione vengono allegati solo se lo autorizzi impostando NEXUS_ISSUE_ATTACH_TRACE=true nelle Impostazioni, perché possono contenere dati di sessione: cookie, intestazioni di autorizzazione e password digitate. Ogni file viene allegato fino a un massimo di 10 MB.

FLAKY non apre mai segnalazioni: un'esecuzione che fallisce e poi viene superata a un nuovo tentativo non è un bug. Lo stesso vale per BLOCKED, UNREACHABLE, CRASHED o un errore di configurazione, che riguardano l'ambiente, non la tua applicazione (come vengono determinati gli esiti). L'associazione tra segnalazioni e test è conservata in evidence/integrations/issue-map.json, nell'area di lavoro.

Jira Cloud

• Connessione: l'indirizzo email del tuo account Atlassian e un token API, creato su id.atlassian.com. Nelle Impostazioni, sotto Integrazioni, incolla un qualsiasi collegamento del tuo sito Jira: Studio conserva il sito e la chiave del progetto. L'indirizzo del sito, JIRA_BASE_URL, deve essere https. Verifica connessione controlla i dati e non crea nulla.
• Segnalazioni: un Bug in JIRA_PROJECT_KEY, secondo il ciclo di vita descritto sopra. Quando il test viene superato senza errori, la segnalazione segue la transizione indicata in JIRA_DONE_TRANSITION, Done per impostazione predefinita, individuata per nome senza distinzione tra maiuscole e minuscole.
• Nessun duplicato: se nelle ultime 24 ore è stato creato un Bug con lo stesso riepilogo, non ne viene aperto un secondo.
• Manualmente: Evidence Locker può inviare un fallimento a Jira quando lo scegli tu.

Xray Cloud

Con XRAY_ENABLED=true, ogni esecuzione di nexus ci importa il proprio XML JUnit in Xray Cloud come Test Execution, in XRAY_PROJECT_KEY, oppure in JIRA_PROJECT_KEY se il primo è vuoto, e sotto il Test Plan indicato in XRAY_TEST_PLAN_KEY se ne imposti uno.

• Connessione: una coppia di chiavi API, XRAY_CLIENT_ID e XRAY_CLIENT_SECRET, creata in Jira sotto App, Xray, Impostazioni globali, Chiavi API.
• Cosa viene inviato: il file JUnit di quella esecuzione, e nient'altro. Un file JUnit lasciato da un'esecuzione precedente non viene mai importato.
• Non causa mai il fallimento dell'esecuzione: se l'importazione non riesce, il registro dell'esecuzione ne indica il motivo in una sola riga, con il segreto oscurato.

Azure DevOps: Boards, Test Plans e Pipelines

Un token di accesso personale (PAT) e un progetto, in AZURE_DEVOPS_ORG_URL (https://dev.azure.com/<org> o https://<org>.visualstudio.com) e AZURE_DEVOPS_PROJECT. Il PAT viene inviato solo agli host di Azure DevOps e non compare mai nei registri. In Impostazioni, sotto Integrazioni, Connetti Azure DevOps verifica il progetto e il tipo di elemento di lavoro, senza creare nulla.

• Azure Boards: con AZURE_BOARDS_ENABLED=true, un errore apre un elemento di lavoro di tipo AZURE_BOARDS_WORK_ITEM_TYPE, Bug per impostazione predefinita, seguendo il ciclo di vita descritto sopra. Quando il test viene superato senza errori, l'elemento passa allo stato indicato in AZURE_BOARDS_DONE_STATE, Resolved per impostazione predefinita; se il processo rifiuta quello stato, viene aggiunto solo il commento. Il PAT richiede Work Items (Read & write). Anche Evidence Locker può inviare manualmente un errore ad Azure Boards.
• Azure Test Plans: il file azure-pipelines.yml generato dalla schermata CI/CD pubblica l'XML JUnit dell'esecuzione tramite l'attività PublishTestResults@2, così ogni esecuzione della pipeline compare in Test Plans, Esecuzioni.
• Azure Pipelines: nexus ci-remote --provider=azure mette in coda un'esecuzione della pipeline indicata in AZURE_PIPELINE_ID, ne attende il completamento e riporta il relativo XML JUnit su questa macchina. Per questa operazione il PAT richiede Build (Read & execute).

Slack

• Connessione: un URL webhook in ingresso, in SLACK_WEBHOOK_URL. In Impostazioni è disponibile il pulsante Invia messaggio di prova.
• Cosa riceve: messaggi Block Kit: il riepilogo dell'esecuzione e, con NEXUS_SLACK_NOTIFY=true, un messaggio per ogni test fallito, instabile, di caos o di regressione visiva. Un messaggio relativo a un errore contiene il collegamento alla relativa segnalazione Jira, se presente.
• Manualmente: Evidence Locker può pubblicare su Slack il riepilogo testuale di un errore. Slack non riceve file.

Telegram

• Connessione: un bot personale, creato una sola volta con @BotFather, in TELEGRAM_TOKEN. In Impostazioni, Connetti tramite QR associa la tua chat e compila TELEGRAM_CHAT_ID. Non esiste un bot condiviso.
• Cosa riceve: avvisi in caso di errore, uno per test con NEXUS_TELEGRAM_NOTIFY=true, e i rapporti e i file che scegli di condividere da Studio.
• Prima di attivarlo: Telegram può ricevere file, come rapporti e PDF, che vengono inviati ai server di Telegram. In un ambiente soggetto a normative, consulta prima il team responsabile della conformità.

Le chiavi

Ogni chiave occupa una riga nel file .env dell'area di lavoro. Puoi modificarle tutte in Impostazioni.

In una pipeline, le stesse chiavi, tutte tranne AZURE_PIPELINE_ID, sono le variabili segrete della pipeline, e una chiave non impostata mantiene disattivato il relativo servizio (segreti in CI/CD).

Domande

Nexus Studio vede i miei dati di Jira o Azure DevOps?

No. Il motore comunica con Jira, Xray, Azure DevOps, Slack e Telegram dal tuo computer, usando le tue chiavi. Nessun dato passa attraverso i nostri server.

Un test instabile aprirà una segnalazione?

No. FLAKY non apre alcuna segnalazione. BREACHED_FLAKY invece sì: l'errore stesso era intermittente, e un nuovo tentativo non lo nasconde.

Un test è fallito 30 volte questa settimana. Quante segnalazioni vengono create?

Una, con un commento e un nuovo screenshot per ogni errore dopo il primo, finché il test non viene superato senza problemi su tutti i browser.

Posso usare Jira e Azure Boards contemporaneamente?

Sì. Ciascuno mantiene una propria segnalazione per ogni test.