Condividi tramite

Campi personalizzati

  • Articolo

Servizi di Azure DevOps

L'uso dei campi personalizzati consente di archiviare i dati personalizzati rispetto all'esecuzione del test e/o al risultato del test. Possono essere definiti fino a 100 campi personalizzati per un singolo progetto Azure DevOps. L'amministratore del progetto può gestire (aggiungere/eliminare) il set di campi personalizzati.

Gestire i campi personalizzati

Esistono due modi per gestire i campi personalizzati: tramite l'API REST o l'amministratore del progetto può farlo tramite le impostazioni del progetto scegliendo Gestione test in Pipeline. In tale pagina è possibile aggiungere un nuovo campo personalizzato facendo clic sul pulsante + Aggiungi nuovo .

Screenshot delle impostazioni del progetto con le impostazioni di gestione dei test selezionate e il pulsante per aggiungere un nuovo campo personalizzato contrassegnato da rettangolo rosso.

Scegliere + Aggiungi nuovo per aggiungere un nuovo campo personalizzato. Ogni campo personalizzato deve avere un nome, un tipo configurato e indicare il tipo di artefatto a cui si applica.

Screenshot di una finestra di dialogo usata per aggiungere un nuovo campo personalizzato.

Il nome del campo personalizzato non può contenere più di 50 caratteri (spazi, numeri e caratteri speciali non consentiti) e deve essere univoco nel progetto. I nomi non fanno distinzione tra maiuscole e minuscole, pertanto non è possibile avere un campo personalizzato denominato "Test" e l'altro denominato "test". Tipo può essere uno dei seguenti:

  • Bit
  • Data/Ora
  • Int
  • Float
  • String
  • GUID

I campi personalizzati esistenti possono essere modificati (è possibile modificare solo il nome) o rimuoverli.

Nota

Dopo aver rimosso il campo personalizzato, non è possibile usare il relativo nome per circa un giorno. Il processo in background che rimuove i campi personalizzati eliminati viene eseguito in modo permanente uno al giorno.

Archiviare dati personalizzati in campi personalizzati

È possibile archiviare i dati personalizzati nei campi personalizzati configurati come parte della creazione di test/risultati o dopo la creazione dell'esecuzione/risultato del test. Entrambe le operazioni possono essere eseguite usando l'API REST per il momento. In futuro i dati personalizzati verranno prelevati dal file dei risultati del test. Per ottenere i valori archiviati nei campi personalizzati per l'esecuzione/risultato del test esistente, è necessario usare l'API REST. Per il momento non vengono visualizzati i campi e i valori personalizzati archiviati in questi nell'interfaccia utente di Azure DevOps (in futuro verrà aggiunta tale capacità).

Quando si crea l'esecuzione di test e/o il risultato tramite l'API REST e si vuole archiviare dati personalizzati in un campo personalizzato esistente, l'opzione migliore consiste nell'inviare i dati personalizzati durante l'esecuzione del test e/o la creazione dei risultati. Per creare una chiamata di test alle esecuzioni dell'API REST - Creare e creare risultati della chiamata di test ai risultati dell'API REST - Aggiungi.

Quando l'esecuzione del test e/o il risultato non vengono creati tramite l'API REST, ma con altri mezzi, è prima necessario trovare l'identificazione dell'esecuzione o del risultato del test per cui si desidera impostare (o aggiornare) i dati personalizzati nei campi personalizzati e quindi chiamare esecuzioni API REST - Aggiornare per l'esecuzione del test e i risultati dell'API REST - Aggiornare per il risultato del test.

Per recuperare i dati personalizzati dai campi personalizzati archiviati in precedenza rispetto all'esecuzione del test e/o al risultato, è prima necessario trovare l'identificazione dell'esecuzione o del risultato del test. È quindi possibile chiamare le esecuzioni dell'API REST - Query per l'esecuzione del test e i risultati dell'API REST - Ottenere per il risultato del test.

I dati personalizzati per i campi personalizzati vengono inviati o ricevuti in una matrice. Ogni elemento della matrice contiene due proprietà "nomecampo" e "valore" ed è possibile visualizzare un esempio di tale valore qui. Il valore è l'oggetto del tipo che corrisponde al tipo configurato per il campo personalizzato. Per comprendere il tipo di campo personalizzato, è possibile usare l'API REST che fornisce una matrice di campi personalizzati. Per ogni campo è possibile trovarne l'ID, il nome, il tipo e l'ambito. È anche possibile impostare come hardcoded il tipo se si conosce il tipo del campo personalizzato del nome specificato.