Importazione dei risultati dei test automatizzati¶
Il client web supporta l'importazione di JUnit XML, TRX e NUnit 3 XML. Esso mappa i risultati di test automatizzati alle varianti ordinarie di caso di prova pianificato. Risultati manuali e importati appaiono insieme nei rapporti di prova e rilascio esistenti, mentre l'origine dell'importazione rimane identificabile.
Preparati.¶
Creare i casi di prova richiesti, varianti e test prima esecuzione. Una corsa dedicata per una costruzione automatizzata rende la mappatura più facile e protegge il lavoro manuale. Hai bisogno delle normali autorizzazioni di lettura e di modifica dei risultati per l'esecuzione selezionata e le sue varianti.
I processi di importazione dei file sono solo il file di risultato XML selezionato. L'entrata separata di Jenkins può avviare i lavori configurati e ottenere risultati; vedere di seguito. Il formato viene rilevato dal suo contenuto; i file TRX possono utilizzare l'estensione .trx. Gli script di Windows esistenti e le azioni di risultato MCP rimangono disponibili.
Anteprima e importazione¶
- Aprire l'esecuzione di destinazione e la sua entrata automatica-risultati nel client web.
- Scegliere il file di risultato e inserire una fonte significativa e un identificatore di compilazione. Non caricare le credenziali o i registri riservati.
- Approssimativamente mappare ogni test esterno che si desidera importare a una variante pianificata e una definizione di risultato appropriata nel progetto. I titoli simili non vengono trattati automaticamente come identici.
- Rivedere l'anteprima. Le righe non mappate, saltate e bloccate non sono test di successo.
- Conferma l'importazione e ispeziona il risultato di ogni riga. Un fallimento parziale può significare che alcune altre file sono già state importate.
I file sono limitati a 2 casi di test MiB e 1000. Vengono respinte duplicazioni di identità esterne, stati contraddittori, durata non valida e XML con entità esterne. Un test esterno saltato non crea un risultato eseguito o di successo. Le righe di prova rapida non sono supportate da questa importazione.
Formati e limiti supportati¶
- JUnit XML: comprese le esportazioni da piytest, PHPUnit e Playwright. Esempi generati da questi tre reporter sono coperti da test di regressione permanenti. JUnit è un formato di scambio qui, non una restrizione a Java o test unità.
- TRX: Visual Studio riferisce utilizzando il namespace XML TeamTest 2010.
Passedmappa al successo; mappa diFailed,ErroreTimeoutal fallimento; mappeNotExecutedper saltare. Le righe di dati nidi (InnerResults) non sono ancora supportate. - Nuovo 3 XML: NUnit riporta rooted a
test-run. I casi parametrizzati rimangono separati dai loro nomi completi. Sono supportatiPassed,FailedeSkipped.
Gli stati inconclusi, abortiti o non sostenuti sono respinti. Riconosciuto retry/cancellatori, identità duplicate e prove di successo contraddittorie non diventano mai silenziosamente il successo. Se un reporter esporta solo il risultato finale senza prove di riprovazione, i fallimenti precedenti non possono essere ricostruiti. Gli allegati, l'output della console e gli ambienti di esecuzione non vengono importati automaticamente; la diagnostica di guasto limitata diventa la descrizione del risultato. Il rapporto sorgente non sostituisce un controllo di completezza del campo di prova.
Proteggere i lavori esistenti¶
Le autorizzazioni, lo stato di esecuzione, i prerequisiti e i risultati di destinazione sono controllati di nuovo prima dell'importazione. I risultati completi e i risultati già modificati manualmente non vengono sovrascritti. Le note, la durata e gli allegati contano anche come lavoro esistente. I campi e le dipendenze dei casi di test richiesti mantengono la loro normale validazione.
Ripetire lo stesso identificatore di importazione con contenuto identico e mappatura non crea risultati duplicati. Riutilizzare un identificatore con contenuti modificati, o incontrare i risultati cambiati nel frattempo, produce un conflitto. Ispezione delle righe colpite invece di trattare un'importazione fallita come completata.
Dopo un parziale fallimento, creare una nuova anteprima con lo stesso identificatore di importazione e mappatura per riprovare. Confermare la stessa anteprima restituisce nuovamente la ricevuta esistente.
Origine e limitazioni¶
Fonte, identificativo di costruzione, importatore e tempo di importazione descrivono la registrazione del risultato. Non provano chi ha effettivamente eseguito il test automatizzato o quando ha funzionato. Il tempo di esecuzione sconosciuto rimane sconosciuto. Un risultato importato inoltre non dimostra automaticamente quale versione della specifica di prova ha esercitato il test esterno.
Pertanto, confronto e valutazione del rischio può ancora mostrare lacune di prova. Un risultato importato di successo da solo non sostituisce né il campo di prova completo né l'accettazione umana. Dopo una modifica manuale, l'origine originale dell'importazione non è una prova per il contenuto dei risultati attuali.
Windows e MCP¶
Windows legge i risultati ordinari e fornisce un collegamento web al relativo test run. Il lancio web condiviso passa la sessione di Windows autenticata; il sign-in è richiesto solo se quel handoff non riesce. L'interfaccia di importazione stessa è nel client web.
MCP utilizza gli stessi controlli tramite ztm_automation_import_read, ztm_automation_import_preview e ztm_automation_import_commit. Si applicano autorizzazioni di progetto ordinarie; impegnando inoltre richiede la capacità di scrittura project.automation-import.commit. MCP mantiene anche il suo limite di 1 MiB esistente per l'intero corpo di richiesta JSON, tra cui la scansione XML e JSON; utilizzare l'interfaccia web per i file più grandi fino a 2 MiB. Consultare le descrizioni degli strumenti del server collegato e conservare gli identificatori di importazione per i retries sicuri.
Operare Jenkins dal client web¶
Caricamento dei file e la pipeline di spinta descritta di seguito sono disponibili accanto all'integrazione diretta Jenkins.
Gli amministratori del server configurano Collegamenti Jenkins: URL di base, percorso di lavoro, percorso di artefatto fisso, utente Jenkins, token API e GUID di progetto approvati. L'amministrazione del progetto da sola non consente di cambiare le destinazioni o le credenziali. I gettoni sono protetti sul server e non vengono mai più visualizzati; un campo di token vuoto conserva il token memorizzato. Recuperare i dati del server insieme ai suoi tasti di protezione dei dati.
Utilizzare un utente dedicato di Jenkins con i diritti di lavoro/build/artifact richiesti e un token API, non una password. Gli URL di base possono includere un percorso di contesto Jenkins. I percorsi di lavoro utilizzano job/name o job/folder/job/name. I segmenti del percorso supportano le lettere ASCII, le cifre, i puntini, i segni e i trattini. Spazi, caratteri codificati e traversale di direzione-genitore sono respinti. I reindirizzamenti non sono seguiti. HTTP è supportato per endpoint intranet esplicitamente amministrati; utilizzare HTTPS altrimenti.
- Aprire l'importazione automatica dei risultati per l'esecuzione del bersaglio, quindi Jenkins costruisce.
- Scegliere una connessione approvata e confermare esplicitamente Iniziare a costruire. L'avvio non importa i risultati.
- Aggiorna lo stato e mantieni il link di stato con il suo ID di funzionamento. Se il risultato è Avviare non confermato — nessuna riprova, ispezionare Jenkins prima: una costruzione può già essere in esecuzione. La stessa operazione non invia mai un'altra richiesta di inizio. Un altro inizio è una nuova azione deliberata.
- Sotto Risultati di acquisizione e anteprima, inserisci il numero esatto di una build completata. Gli alias mobili come
lastSuccessfulBuildnon sono accettati. - Esaminare le mappe di test esplicite e confermare l'importazione, come con l'upload di file. Anteprima e commit utilizzare l'artefatto invariato recuperato anche se Jenkins poi lo sostituisce.
Gli artefatti sono limitati a 2 MiB e protetti per almeno 15 minuti; i byte scaduti vengono periodicamente rimossi. Scard rimuove anche i byte in scena. Un ID di importazione non può acquisire silenziosamente contenuti diversi. Dopo un riavvio del server, lo stesso ID importazione può produrre una nuova anteprima dai suoi byte memorizzati all'interno di quella finestra. Dopo la scadenza, recupera esplicitamente con un nuovo ID. Dopo aver commesso, è possibile ricaricare la pagina di ricezione anche per un'importazione parziale. Mostra l'ultimo risultato commesso. I test saltati e non mappati non creano un risultato. Un'entrata manuale è riportata come un conflitto e viene conservata. La chiave API utilizzata per l'importazione può leggere di nuovo la ricevuta tramite MCP o REST utilizzando ztm_ci_receipt con {"importId":"<UUID>"}. La ricevuta rimane leggibile dopo la scadenza del manufatto. Cambiamenti di connessione e blocco di approvazione del progetto revocato vecchie anteprime. Si applicano anche permessi di esecuzione/risultato normale e restrizioni demo.
Accesso MCP e REST¶
Tutte le otto operazioni condividono il servizio web. REST utilizza POST /api/v1/operations/ztm_ci_<operation>, con chiave portante e X-ZTM-Project-UniqueId; MCP utilizza lo stesso nome dell'utensile. Il contratto filtrato /api/v1/openapi.json descrive gli input e le uscite.
| Operazione | Oggetto | Capacità di scrittura |
|---|---|---|
connections |
Leggi le connessioni approvate per una corsa | Nessuno |
status |
Leggi un'operazione memorizzata | Nessuno |
start |
Iniziare con una stabile operationId |
project.ci.start |
refresh |
Ritiro e persistono lo stato di Jenkins | project.ci.refresh |
preview |
Presa esplicita buildNumber sotto stabile importId |
project.ci.preview |
repreview |
Ricontrollare le mappe esplicite | project.ci.repreview |
commit |
Impegnare l'anteprima | project.ci.commit |
discard |
Discard in scena byte | project.ci.discard |
Le scritture richiedono un'abilitazione globale di scrittura del progetto e la capacità di corrispondenza. Avviare e commettere richiedono anche confirmed: true dopo una decisione deliberata. Le operazioni e le anteprime si legano al progetto, all'utente e alla chiave API o alla sessione web. La configurazione di connessione server-admin è intenzionalmente esclusa dal progetto MCP/REST: l'accesso a scrittura di progetto non deve autorizzare destinazioni di rete o modifiche segrete. Windows mantiene i suoi percorsi di importazione esistenti; i nuovi controlli Jenkins sono nel client web.
REST e Jenkins¶
REST API espone le stesse tre operazioni a POST /api/v1/operations/ztm_automation_import_read, ztm_automation_import_preview e ztm_automation_import_commit. Inviare la chiave API come token Bearer e l'identificatore di progetto in X-ZTM-Project-UniqueId. REST limita anche l'intero corpo di richiesta JSON a 1 MiB. Le normali autorizzazioni per l'editing dei risultati e la capacità di scrittura project.automation-import.commit esplicitamente concessa rimangono necessarie.
Un esempio adattabile di Jenkins con uno script Python e test HTTP locali è incluso nel pacchetto sorgente di ZetaTestMain/Source/docs/examples/jenkins-automation-import. Richiede un agente Linux affidabile con Python 3.11 o versioni successive e segue la fase di test di produzione dei report. Memorizza la chiave come credenziali Jenkins Testo segreto. Le chiavi, i contenuti XML e i token di anteprima devono rimanere fuori dai registri delle console; proteggere lo spazio di lavoro e l'accesso all'artefatto di anteprima/outcome.
- Preparare il progetto, eseguire modifiche e mappe esplicite.
readcon{"testRunId":123}restituisce obiettivi e definizioni dei risultati idonei. Un'anteprima conmappingsvuoto può scoprire identificatori di prova esterni; i titoli simili non sostituiscono le mapping. previewaccetta un UUIDimportId,testRunId,xml,source,buildIdemappings. Ogni mappatura contieneexternalCaseId,plannedVariantIderesultDefinitionId. L'esempio si ferma prima di scrivere se una riga non-skipped è non mappata o bloccata.- Verificare ogni test esterno, stato, variante di destinazione e definizione dei risultati nel manufatto di anteprima Jenkins, così come costruire e eseguire l'identità. Solo allora approvi la fase di ingresso di Jenkins. I gettoni di anteprima scadono dopo 15 minuti; l'esempio limita l'approvazione e si impegna a dieci minuti.
commitaccetta solo{"previewToken":"<token of the approved preview>"}. La sua risposta includeCompleteeRowsindividuale. L'esempio accetta solo righe completamente confermate con lo statoImported,AlreadyImportedoSkippedconservato. I test saltati rimangono ineseguiti; un'importazione di successo non significa che i test sono stati superati.
Le risposte sono oggetti diretti JSON. Le risposte all'importazione esistenti utilizzano nomi come Token, ExpiresUtc, Rows e Code, mentre gli input utilizzano il caso camel inferiore indicato sopra. HTTP 200 da solo non stabilisce un'importazione completa: fallimenti parziali possono lasciare altre righe salvate. L'esempio fallisce su questi risultati, conflitti, anteprime scadute e errori di trasporto, senza riprovare automaticamente le scritture.
Per riprovare la stessa configurazione esterna, conservare il suo identificatore originale, file, mappature, indirizzo del server, progetto ed esecuzione. L'esempio deriva lo stesso identificatore di importazione da tale identità. Dopo parziale fallimento, ottenere una nuova anteprima, rivedere e approvare di nuovo. Dopo un timeout di commit, ispezionare la storia dell'importazione e salvare i risultati prima, perché l'importazione potrebbe già aver completato. Le nuove esecuzioni di test hanno bisogno di un nuovo identificatore di build. I test HTTP locali non sostituiscono né la validazione della pipeline adattata nel proprio Jenkins né un'importazione sintetica in un progetto di prova dedicato.
In un test, Aprire i risultati CI sul web apre anche la pagina CI/Jenkins con quella eseguita selezionata. Aprire la pagina non inizia un lavoro né importa i risultati. Questa voce utilizza lo stesso manuale automatico di accesso.