Aggiungere e gestire campi (processo di ereditarietà)

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

È possibile personalizzare il sistema di rilevamento del lavoro aggiungendo campi personalizzati o modificando gli attributi specifici di un . Ad esempio, è possibile aggiungere un campo personalizzato per acquisire altri dati o modificare l'etichetta visualizzata nel modulo dell'elemento di lavoro per un campo ereditato.

Per visualizzare tutti i campi definiti per l'organizzazione, inclusi i campi di sistema e ereditati, vedere Visualizzare i campi e gli attributi degli elementi di lavoro.

Dopo aver aggiunto un campo personalizzato, è possibile usarlo per creare query, grafici o visualizzazioni di Analisi e report di Power BI per tenere traccia e analizzare i dati correlati.

Prerequisiti

Per indicazioni su come personalizzare Azure Boards per allinearsi ai requisiti aziendali specifici, vedere Informazioni sulla configurazione e la personalizzazione di Azure Boards.

Categoria	Requisiti
Autorizzazioni	- Per creare, eliminare o modificare un processo: Membro del gruppo Amministratori raccolta progetti o autorizzazioni specifiche a livello di raccolta Crea processo, Elimina processo, Modifica processo, o Elimina un campo dall'organizzazione impostato su Consenti. Per ulteriori informazioni, consultare Impostazione delle autorizzazioni e dell'accesso per il monitoraggio del lavoro, Personalizzazione di un processo ereditato. - Per aggiornare le bacheche: Amministratore del Team o membro del gruppo Amministratori del Progetto.
Accesso	- Anche se si ha basic o un accesso inferiore, è comunque possibile modificare un processo se qualcuno concede le autorizzazioni necessarie. - Per aggiornare e modificare il tipo di elementi di lavoro esistenti: membro del progetto.
modello di processo del progetto	- Assicurarsi di avere il modello di processo di ereditarietà per la raccolta di progetti che contiene il progetto. - Se si esegue la migrazione dei dati ad Azure DevOps Services, utilizzare il Servizio di importazione database di Team Foundation Server.
Conoscenza	Familiarità con la personalizzazione e i modelli di processo.

Aprire le impostazioni del processo dell'organizzazione

1. Accedi all'organizzazione (https://dev.azure.com/{yourorganization}).

2. Seleziona Impostazioni organizzazione.

   

3. Seleziona Processo.

   

Nota

Quando si personalizza un processo ereditato, tutti i progetti che usano tale processo riflettono automaticamente le personalizzazioni. Per garantire una transizione uniforme, è consigliabile creare un processo di test e un progetto, che consente di testare le personalizzazioni prima di implementarle a livello di organizzazione. Per altre informazioni, vedere Creare e gestire processi ereditati.

Nomi di campo personalizzati

Quando si aggiunge un campo personalizzato a un processo ereditato, Azure DevOps assegna un nome di riferimento preceduto da Custom e rimuove gli spazi dal nome del campo. Ad esempio, a un campo denominato "DevOps Triage" viene assegnato il nome di riferimento Custom.DevOpsTriage. Gli spazi non sono consentiti nei nomi di riferimento.

Aggiungere un campo personalizzato

È possibile aggiungere campi e specificare il gruppo e la pagina in cui devono essere visualizzati. Dopo aver aggiunto un campo, è possibile trascinarlo e rilasciarlo all'interno di una pagina per regolarne la posizione nel modulo. Se si prevede di aggiungere più campi a una pagina o a un gruppo personalizzato, creare le pagine o i gruppi prima di aggiungere i campi.

Ogni processo può definire fino a 1.024 campi, inclusi i campi di sistema e ereditati. I campi possono essere aggiunti solo all'interno di una pagina di un modulo. Non è possibile aggiungere campi all'area grigia del modulo in cui si trovano i campi Assegnato a, Stato e Motivo.

1. Nella pagina Processo del processo ereditato selezionato selezionare il tipo di elemento di lavoro (WIT) in cui si desidera aggiungere il campo personalizzato.

   Nell'esempio seguente viene selezionato Bug WIT. Si notino i collegamenti di navigazione che consentono di tornare a Tutti i processi e alla pagina del processo MyAgile .

   

   Se il campo Nuovo e altre opzioni sono disabilitate, non si dispone delle autorizzazioni necessarie per modificare il processo.

2. Con il WIT selezionato, scegliere il campo Nuovo.

   

3. Assegnare un nome al campo e selezionare il tipo di campo da uno dei tipi di dati supportati. Se lo si desidera, aggiungere una descrizione.

   I nomi dei campi devono essere univoci all'interno dell'organizzazione. Un campo personalizzato in un processo non può condividere lo stesso nome di un campo in un altro processo. Per altre informazioni, vedere Che cos'è un campo? Come vengono usati i nomi dei campi?

   Nell'esempio seguente viene aggiunto un tipo di campo Integer con etichetta Customer Ticket.

   

4. (Facoltativo) Nella scheda Opzioni indicare se il campo è obbligatorio e specificare un valore predefinito. Se lasciato vuoto, il campo rimane facoltativo. Quando si imposta un campo Obbligatorio, gli utenti devono specificare un valore per salvare l'elemento di lavoro. Il valore predefinito viene impostato quando viene creato o aperto un elemento di lavoro e il campo è vuoto.

   

5. (Facoltativo) Nella scheda Layout è possibile specificare un'etichetta di modulo diversa rispetto al nome del campo. È anche possibile scegliere la pagina e il gruppo in cui viene visualizzato il campo nel modulo.

   Nell'esempio seguente si aggiunge il campo Customer Ticket a un nuovo gruppo con etichetta Customer focus.

   

   Nota

   Anche se è possibile modificare l'etichetta del modulo, è necessario usare il nome del campo quando si aggiungono campi alle schede (bacheca, lavagna) o si creano query in base al campo.

6. Scegliere Aggiungi campo per completare il processo. Se non si specifica un percorso di layout, il sistema aggiunge il campo al primo gruppo di campi nel modulo.

7. Al termine delle modifiche, aprire un elemento di lavoro del tipo personalizzato per esaminare gli aggiornamenti.

   L'esempio seguente mostra che il campo Customer Ticket è stato aggiunto correttamente al gruppo Stato. Se le modifiche non sono immediatamente visibili, aggiornare il browser per assicurarsi che gli aggiornamenti vengano visualizzati correttamente. Questo passaggio garantisce che il nuovo campo sia integrato correttamente nel modulo dell'elemento di lavoro e pronto per l'uso.

   

Aggiungere un menu a tendina

Limiti di tracciamento del lavoro, processi e progetti

È possibile aggiungere un nuovo campo e definire un elenco di selezione o personalizzare l'elenco di selezione di un campo ereditato.

Ogni organizzazione o raccolta può definire fino a 2.048 elenchi a discesa. Ogni elenco a discesa può contenere fino a 2.048 elementi. Gli elementi dell'elenco di selezione non devono superare i 256 caratteri. Per aggiungere elenchi a discesa dipendenti, vedere Elenchi a catena.

1. Selezionare Nuovo campo, quindi specificare il tipo di elenco a discesa—integer o stringa—e aggiungere gli elementi da visualizzare nell'elenco a discesa. È possibile aggiungere un elemento e quindi selezionare INVIO per aggiungere un altro elemento.

   

   Per eliminare un elemento nell'elenco, evidenziare l'elemento e quindi selezionare l'.

   Per modificare l'elenco di selezione di un campo ereditato, scegliere Modifica per modificare il campo. Nella scheda Definizione è possibile scegliere Aggiungi valore.

   

2. (Facoltativo) Specificare i valori obbligatori o predefiniti e scegliere dove viene visualizzato il campo nel modulo.

   

Aggiungere un campo Identità

Usare un campo basato sull'identità per aggiungere un campo simile al campo Assegnato a. I campi basati sull'identità funzionano come il campo Assegnato a, fornendo una funzione di ricerca e un selettore di identità. Quando l'organizzazione gestisce gli utenti con Microsoft Entra ID o Active Directory, il sistema sincronizza i campi basati sull'identità con i nomi definiti in queste directory.

Selezionare Nuovo campo, quindi il nome del campo, il tipo di identità e facoltativamente una descrizione.

(Facoltativo) Specificare i valori obbligatori o predefiniti e scegliere dove viene visualizzato il campo nel modulo.

Aggiungere un campo in formato rich-text, HTML

1. Selezionare il WIT a cui si vuole aggiungere il campo e quindi scegliere Nuovo campo.

2. Scegliere Testo (più righe) come tipo. In questo caso il campo viene etichettato come Richiesta cliente per acquisire i commenti dei clienti per le richieste di funzionalità del prodotto.

   

3. Il campo viene aggiunto alla prima colonna sotto tutti i campi di testo ricco definiti dal sistema, ma prima del controllo Discussione.

   

4. (Facoltativo) Specificare i valori obbligatori o predefiniti e scegliere dove viene visualizzato il campo nel modulo.

Aggiungere un campo di casella di controllo

1. Selezionare il WIT a cui si vuole aggiungere il campo e quindi scegliere Nuovo campo.

2. Scegliere Boolean come tipo e assegnargli un'etichetta. In questo caso il campo viene etichettato come Triaged per tenere traccia dello stato di valutazione del bug.

   

3. (Facoltativo) Selezionare Opzioni e quindi specificare se il campo è obbligatorio.

   

4. Per impostazione predefinita, il campo viene aggiunto all'ultimo gruppo definito nella seconda colonna. Selezionare Layout e quindi trascinare il campo in un altro gruppo nel modulo.

   Nota

   Il campo viene visualizzato come casella di controllo nel modulo dell'elemento di lavoro. La selezione della casella di controllo indica un valore True . Se il campo viene visualizzato nella scheda o nella lavagna, i valori True e False vengono visualizzati come testo anziché come casella di controllo.

Aggiungere un campo esistente a un altro WIT

I campi esistenti corrispondono a qualsiasi campo ereditato e campo personalizzato definito all'interno dell'insieme. Dopo aver aggiunto un campo personalizzato a un WIT, è possibile aggiungerlo ad altri dal menu del modulo. In alternativa, è possibile aggiungere un campo definito per un processo a un tipo di elemento di lavoro in un altro processo. Aprire il tipo di elemento di lavoro e scegliere il campo esistente.

Per cercare le descrizioni di qualsiasi campo dell'elemento di lavoro definito dal sistema, vedere l'indice del campo Elemento di lavoro.

Nell'esempio seguente il campo Customer Ticket viene aggiunto al WIT della storia utente.

(Facoltativo) Specificare i valori obbligatori o predefiniti e scegliere dove viene visualizzato il campo nel modulo.

Etichettare nuovamente un campo

La ridenominazione di un campo o la modifica del relativo tipo non è supportata. Tuttavia, è possibile modificare l'etichetta visualizzata nel modulo dell'elemento di lavoro dalla scheda Layout . Quando si creano query, usare il nome del campo, non l'etichetta.

Nell'esempio seguente rinominiamo il campo Customer Ticket a Numero Ticket.

Modificare il testo di aiuto della descrizione

Il testo di aiuto della descrizione viene visualizzato quando gli utenti posizionano il cursore su un campo nel modulo dell'elemento di attività. È possibile personalizzare il testo della Guida per i campi personalizzati e ereditati, ma il comportamento è diverso in base al tipo di campo:

• Campi ereditati: il testo della Guida può essere personalizzato per ogni tipo di elemento di lavoro e processo.
• Campi personalizzati: il testo della Guida è coerente in tutti i tipi di processi e di elementi di lavoro.

Per modificare il testo della Guida Descrizione , scegliere il tipo di elemento di lavoro da modificare, scegliere Modifica per il campo e scegliere la scheda Definizione . Il valore modificato influisce solo sul campo nel processo e sul tipo di elemento di lavoro.

Qui modifichiamo il campo Punti Storia per la User Story.

Mostrare, nascondere o rimuovere un campo

È possibile scegliere di visualizzare o nascondere qualsiasi campo o controllo personalizzato da visualizzare in un modulo. Se si desidera ripristinare un campo nel modulo in un secondo momento, è possibile visualizzare Queste azioni differiscono dall'opzione Elimina , che elimina il campo dall'organizzazione.

Nota

I dati definiti per un campo ereditato, anche se nascosti, vengono mantenuti nell'archivio dati e nella cronologia degli elementi di lavoro. È possibile visualizzare un record visualizzando la scheda cronologia per un elemento di lavoro.

Quando si rimuove un campo personalizzato dal layout, viene mantenuto nell'archivio dati ma rimosso dalla cronologia. È possibile visualizzarlo dai risultati della query. Se si aggiunge di nuovo il campo al modulo, la cronologia viene ripristinata. Per eliminare un campo personalizzato da una raccolta di progetti, vedere Eliminare un campo.

Nascondere un campo o un controllo personalizzato

1. Aprire il menu di scelta rapida per il campo o il controllo e scegliere Nascondi dal layout.

   

2. Per aggiungere un campo o un controllo nascosto al modulo, scegliere Mostra nel layout.

Rimuovere un campo personalizzato da un modulo

1. Scegliere Rimuovi dal menu di scelta rapida del campo da rimuovere.

   

2. Conferma di voler rimuovere il campo.

   

3. Per aggiungere un campo personalizzato che è stato rimosso, scegliere Nuovo campo e selezionare Usa un campo esistente.

Ripristinare le impostazioni predefinite del campo

È possibile rimuovere le modifiche apportate a un campo ereditato. Nella pagina Layout del tipo di elemento di lavoro modificato scegliere l'opzione Ripristina per il campo.

Eliminare un campo personalizzato

Con il modello processo di ereditarietà è possibile eliminare solo campi personalizzati; non è possibile eliminare i campi predefiniti del sistema.

L'eliminazione di un campo rimuove tutti i dati associati, inclusi i valori cronologici. Potrebbe verificarsi un breve ritardo prima dell'avvio dei processi di eliminazione dei dati. Durante questo periodo, è possibile tentare di ripristinare il campo e recuperare i dati usando l'API REST Fields - Update. Il ripristino potrebbe essere completo, parziale o non riuscito, a seconda dei dati rimanenti. Prestare attenzione quando si eliminano i campi, perché il ripristino non è sempre possibile o completo.

Nota

Impossibile annullare l'azione. Eliminare solo i campi che non sono in uso. Usare il comando witadmin listfields per identificare i campi inutilizzati. Per altre informazioni, vedere Gestire i campi dell'elemento di lavoro (witadmin).For more information, see Manage work item fields (witadmin).
Se Analytics è abilitato per l'organizzazione o la raccolta, è possibile eseguire query su Analytics per trovare dove è in uso un campo personalizzato con la sintassi seguente:

https://analytics.dev.azure.com/{OrganizationName}/_odata/v4.0-preview/WorkItemTypeFields?$filter=FieldReferenceName eq {CustomFieldReferenceName}&$select=WorkItemType

Per eliminare un campo personalizzato, seguire questa procedura:

1. Selezionare Impostazioni organizzazione>Elabora>campi>Altre azioni>Elimina.

   

   Essere un membro del gruppo Project Collection Administrators o concedere autorizzazioni esplicite per eliminare i campi.

2. Immettere il nome del campo come illustrato nell'esempio seguente e quindi confermare selezionando Elimina elemento di lavoro campo.

   

Articoli correlati

Nota

Esaminare le modifiche apportate a un processo ereditato tramite il log di controllo. Per altre informazioni, vedere Accedere, esportare e filtrare i log di controllo.

• Visualizzare i campi e gli attributi degli elementi di lavoro
• Aggiungere o modificare un tipo di elemento di lavoro personalizzato
• Personalizzare il layout Web
• Limiti di tracciamento del lavoro, processi e progetti