Condividi tramite


Campi personalizzati

Azure DevOps Services

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.

Prerequisiti

Categoria Requisiti
Accesso al progetto Membro del progetto.
livelli di accesso - Per visualizzare gli elementi di lavoro correlati ai test: è necessario almeno l'accesso di base. Gli utenti con il livello di accesso Stakeholder non hanno accesso ai piani di test.
- Per aggiungere piani di test e gruppi di test, eliminare gli artefatti di test e definire configurazioni di test: accesso Basic + Piani di test o una delle seguenti sottoscrizioni di Visual Studio:
- Impresa
- Test Professionale
- piattaforme MSDN
autorizzazioni Autorizzazioni percorso area:
- Per aggiungere o modificare piani di test, gruppi di test, test case o altri tipi di elementi di lavoro basati su test: Modificare gli elementi di lavoro in questo nodo impostato su Consenti.
- Per modificare le proprietà del piano di test, ad esempio le impostazioni di compilazione e test: gestire i piani di test impostati su Consenti.
- Per creare ed eliminare gruppi di test, aggiungere e rimuovere test case dai gruppi di test, modificare le configurazioni dei test associate ai gruppi di test e modificare una gerarchia del gruppo di test (spostare un gruppo di test): gestire i gruppi di test impostati su Consenti.

permessi a livello di progetto
- Per gestire configurazioni di test o ambienti di test: gestire le configurazioni di test e Gestire gli ambienti di test impostati su Consenti.
- Per eliminare definitivamente gli elementi di lavoro basati su test: eliminare definitivamente gli elementi di lavoro impostati su Consenti.

Per altre informazioni, vedere L'accesso manuale ai test e le autorizzazioni.

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 Project settings, scegliendo Gestione test sotto Pipelines. 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
  • DateTime
  • Int
  • Float
  • Stringa
  • 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 campi nell'interfaccia utente 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 un'esecuzione di test, chiamare REST API Runs - Create e per aggiungere un risultato di test, chiamare REST API Results - Add.

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 hardcodificare il tipo se si conosce il tipo del campo personalizzato con il nome specificato.