Campi e attributi degli elementi di lavoro in Azure Boards

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

I campi dell'elemento di lavoro vengono usati per tenere traccia delle informazioni. I campi vengono definiti per un'organizzazione e condivisi tra tutti i progetti definiti per tale organizzazione. È possibile usare uno dei due strumenti per esaminare i campi definiti per l'organizzazione. Questi strumenti sono disponibili sia per i modelli di processo Ereditati che per i modelli di processo XML ospitati.

• Pagina Web Elabora>campi
• Esplora campi elemento di lavoro

Per una descrizione di ogni campo definito con un processo di sistema, vedere Indice dei campi dell'elemento di lavoro.

Prerequisiti

• Per visualizzare i campi definiti per un'organizzazione o una raccolta, è necessario essere membri del gruppo di applicazioni Utenti validi della raccolta di progetti oppure impostare l'autorizzazione Visualizza informazioni a livello di istanza su Consenti per l'organizzazione o la raccolta.

Elencare o rivedere i campi

Per elencare o esaminare i campi, è possibile usare uno degli strumenti seguenti, a seconda del modello di processo, ereditarietà, XML ospitato o XML locale, usato. Per un indice di campi definiti nei processi predefiniti, vedere Indice dei campi elemento di lavoro.

Tool	Ereditarietà	XML ospitato	XML locale
Portale Web: elencare i campi ereditati e personalizzati	✔️	✔️1
Esplora campi elemento di lavoro	✔️	✔️	✔️
Strumento da riga di comando witadmin listfields	✔️	✔️	✔️

Nota

1. Supportato solo per i processi predefiniti (Agile, CMMI, Scrum).

Tipi e nomi di dati dei campi

Ogni tipo di elemento di lavoro specifica i campi definiti per gli elementi di lavoro che fanno riferimento a tale tipo. Ogni campo è associato a un numero di attributi, molti dei quali sono impostati dal sistema e non possono essere modificati.

Ogni campo è definito dai tre attributi seguenti.

• Tipo di dati: specifica il tipo di dati che è possibile immettere nel campo, ad esempio Boolean, Double, Integer, HTML e String. Per le descrizioni di ogni tipo di dati, vedere Campi, operatori e macro di query.
• Nome descrittivo: specifica il nome assegnato al campo e che si seleziona per un campo in una clausola di query. Questo nome può differire dal nome visualizzato nel modulo dell'elemento di lavoro.
• Nome riferimento: specifica il nome usato per la creazione di una query WIQL o di un modello di elemento di lavoro improvvisato, usando i comandi dell'API REST o definendo definizioni di tipi di elemento di lavoro XML. Una volta definito, il nome del riferimento non può essere modificato.

Per una descrizione di ogni attributo di campo e come elencarli, vedere Attributi campo e Attributi campo elenco più avanti in questo articolo. Per una panoramica delle connessioni WIT e degli elementi di lavoro, vedere Tenere traccia delle storie utente, dei problemi, dei bug, delle funzionalità e delle epiche.

Che cos'è un campo? Come vengono usati i nomi dei campi?

Ogni tipo di elemento di lavoro è associato a 31 campi di sistema e a diversi campi più specifici del tipo. Gli elementi di lavoro vengono usati per pianificare e tenere traccia del progetto.

Ogni campo supporta il rilevamento di una parte di informazioni sul lavoro da eseguire. I valori assegnati a un campo vengono archiviati nell'archivio dati di rilevamento del lavoro che è possibile creare query per determinare lo stato e le tendenze.

Per le descrizioni e l'utilizzo di ogni campo definito per i processi di sistema principali, Agile, Basic, Scrum e CMMI, vedere Indice dei campi dell'elemento di lavoro.

Nomi dei campi

Un nome di campo dell'elemento di lavoro identifica in modo univoco ogni campo dell'elemento di lavoro. Assicurarsi che i nomi dei campi siano compresi nelle linee guida seguenti:

• I nomi dei campi devono essere univoci all'interno della raccolta di account/progetto
• I nomi dei campi devono avere un massimo di 128 caratteri Unicode
• I nomi dei campi non possono contenere spazi iniziali o finali, né due o più spazi consecutivi
• I nomi dei campi devono contenere almeno un carattere alfabetico
• I nomi dei campi non possono contenere i caratteri seguenti: .,;'`:~\/\*|?"&%$!+=()[]{}<>.

Poiché i campi personalizzati sono definiti per un'organizzazione o una raccolta, non è possibile aggiungere un campo personalizzato a un processo con lo stesso nome di campo aggiunto a un altro processo.

Per altre informazioni, vedere Limitazioni e convenzioni di denominazione.

Campi di sistema e predefiniti

Tutti i campi definiti dal sistema hanno nomi di riferimento che iniziano con System, ad esempio System.AreaPath, System.AssignedTo e continuano in tale modello.

I campi predefiniti definiti dal processo predefinito iniziano con Microsoft.VSTS e quindi differiscono ulteriormente in base all'utilizzo. Di seguito sono riportati alcuni esempi di campi predefiniti usati in comune, per scopi di pianificazione e integrazione con Office Project, per l'integrazione con Team Foundation Build e l'integrazione con la gestione del test case (TCM):

• Microsoft.VSTS.Common.Priority
• Microsoft.VSTS.Scheduling.DueDate
• Microsoft.VSTS.Build.FoundIn
• Microsoft.VSTS.TCM.Steps

Per una panoramica di tutti i campi di sistema e predefiniti definiti per i modelli di processo/processi predefiniti, vedere Indice dei campi dell'elemento di lavoro. Per altre informazioni sulla specifica dei nomi dei campi, vedere Restrizioni di denominazione.

Campi personalizzati

Poiché i campi personalizzati sono definiti per un'organizzazione o una raccolta di progetti, non è possibile aggiungere un campo personalizzato a un processo con lo stesso nome di campo aggiunto a un altro processo.

Quando si aggiungono campi personalizzati, tenere presenti i limiti seguenti:

• È possibile definire un massimo di 64 campi per ogni WIT
• È possibile definire un massimo di 512 campi per processo

Il tipo di dati del campo determina il tipo e le dimensioni dei dati che è possibile archiviare nel campo. Un campo può avere un solo tipo definito all'interno di una raccolta di progetti. Questa restrizione incoraggia le organizzazioni a usare campi comuni tra progetti e tipi di elementi di lavoro.

Quando si aggiunge un campo personalizzato a un processo ereditato, Azure DevOps assegna un nome di riferimento preceduto da Custom e quindi il nome del campo con spazi rimossi. Ad esempio, si aggiunge un campo denominato DevOps Triage, il nome di riferimento è Custom.DevOpsTriage. Non sono consentiti spazi all'interno del nome del riferimento.

Come è possibile determinare il tipo di dati del campo?

È possibile visualizzare il tipo di dati dei campi definiti per l'organizzazione aprendo la pagina Campi processo>.

Pagina Web Elabora>campi

Per esaminare l'elenco dei campi definiti per un'organizzazione o una raccolta, aprire Campi processo> impostazioni>organizzazione.

1. Scegliere il logo di Azure DevOps per aprire Progetti. Quindi scegliere Impostazioni organizzazione.

   

2. Scegliere quindi Processo.

   

   Nota

   Se non viene visualizzato Processo, si sta lavorando da TFS-2018 o versione precedente. La pagina Processo non è supportata. È necessario usare le funzionalità supportate per il modello di processo XML locale.

3. Scegliere quindi Campi.

   I campi elencati corrispondono a tutti i campi definiti per l'organizzazione o la raccolta. Sono inclusi tutti i campi personalizzati e quelli definiti per i processi di sistema.

   

   Nota

   Se non viene visualizzato Fields, la raccolta usa il processo XML locale. La pagina Campi non è supportata per tale processo.

   Per le descrizioni e l'utilizzo di ogni campo, nonché il nome di riferimento per ogni campo, è possibile cercarlo dall'indice del campo Elemento di lavoro. È anche possibile ottenere il nome di riferimento dei campi dall'API REST Campi tipi di elemento di lavoro - Elenco.

Esplora campi elemento di lavoro

È possibile cercare le assegnazioni degli attributi dei campi usando lo strumento Esplora campi elemento di lavoro.

Per accedere a Esplora campi elemento di lavoro, è necessario installare lo strumento Editor processi. In base alla versione di Visual Studio installata, ottenere lo strumento Editor di processi da una delle estensioni seguenti.

• Visual Studio 2019: Editor modelli di processo.
• Visual Studio 2017: Editor modelli di processo TFS. È anche possibile usare questa versione dell'editor di processi per modificare i moduli degli elementi di lavoro in stile precedente. Non è possibile usarlo per modificare i moduli associati ai nuovi web form.
• Visual Studio 2015: TFS Power Tools.

Attributi campo

Esistono molti attributi non modificabili e nascosti per ogni campo dell'elemento di lavoro. Nella tabella seguente sono descritti i singoli attributi. Gli attributi hanno nomi diversi in base a se li si ottiene tramite l'API REST Fields - Geto la visualizzazione tramite lo strumento Esplora campi elemento di lavoro (WIFE).

Gli attributi assegnati a un campo dipendono dalla piattaforma e dalla versione usata. Ad esempio, alcuni attributi non sono supportati con il processo di ereditarietà. Per cercare il nome di riferimento per un campo, vedere Indice del campo elemento di lavoro.

Attributo

Tipo di attributo

Descrizione

---

REST:
WIFE: AllowedValues

collection

Ottiene l'insieme di valori validi per un campo che contiene valori di elenco a discesa. È possibile modificare questa impostazione specificando un elenco di selezione o un elenco globale (locale).
Può cambiare?=Sì

REST: canSortBy
MOGLIE: CanSortBy

boolean

Indica se è possibile ordinare i risultati della query con questo campo.
Può cambiare?=No

REST: descrizione
MOGLIE: HelpText

string

Specifica una descrizione per il campo, che definisce anche il testo della Guida visualizzato quando si passa il puntatore del mouse sul campo all'interno del modulo dell'elemento di lavoro.
Può cambiare?=Sì

REST:
MOGLIE: ID

Intero

Specifica l'ID interno del campo.
Può cambiare?=No

REST:
MOGLIE: IsCloneable

boolean

Indica se il valore definito per il campo viene copiato quando un utente sceglie di copiare un elemento di lavoro. Ad esempio, i campi Titolo, Tag e Descrizione vengono copiati, ma i campi ID e Cronologia non vengono copiati.
Può cambiare?=No

REST:
MOGLIE: IsComputed

boolean

Indica se il valore impostato da questo campo viene calcolato dal sistema (True) o meno (False). Esempi di campi calcolati sono quelli impostati dal sistema, ad esempio ID, Data revisione, Data modificata e Conteggio collegamenti esterni.
Può cambiare?=No

REST:
MOGLIE: IsCoreField

boolean

Indica se questo campo viene specificato per tutti i tipi di elemento di lavoro.
Può cambiare?=No

REST:
MOGLIE: IsEditable

boolean

Indica se gli utenti possono modificare questo campo (True) o meno (False). Esempi di campi non modificabili sono quelli impostati dal sistema, ad esempio i campi ID, Revision, Created By e Changed By
Può cambiare?=No

REST: isIdentity
MOGLIE: IsIdentity

boolean

Indica se questo campo è un campo Identity . I campi Identity sono campi stringa usati per archiviare le identità utente.
Può cambiare?=No

REST:
MOGLIE: IsIndexed¹

boolean

Indica se questo campo è indicizzato per supportare la ricerca.
Può cambiare?=No

REST:
MOGLIE: IsLongText

boolean

Indica che il campo può contenere più di 255 caratteri, ad esempio i campi assegnati a un tipo di dati PlainText, HTML o History.
Può cambiare?=No

REST: isPicklist² WIFE:

boolean

Indica se il campo è associato a un elenco a discesa. Il valore è impostato su True quando viene definito un campo personalizzato per il tipo di elenco di controllo Azure DevOps e Picklist (String) o Picklist (Integer). Il valore è impostato su False per i campi ereditati che definiscono elenchi a discesa.
Può cambiare?=No

REST: isPicklistSuggested² WIFE:

boolean

Indica se il campo consente agli utenti di immettere i propri valori per un elenco a discesa. Il valore è impostato su True quando viene definito un campo personalizzato per il tipo Azure DevOps, Picklist (String) o Picklist (Integer) e viene selezionata la casella di controllo Consenti agli utenti di impostare i propri valori .
Può cambiare?=Sì

REST: isQueryable
MOGLIE: IsQueryable

boolean

Indica se il campo viene visualizzato all'interno del set di campi che è possibile aggiungere per filtrare una query dell'elemento di lavoro (True) o meno (False). La maggior parte dei campi è queryabile.
Può cambiare?=No

REST:
MOGLIE: IsReportable ³

boolean

Indica se l'attributo segnalabile è definito o impostato su un valore diverso da Nessuno. Questo attributo può essere modificato per gli ambienti locali.
Può cambiare?=Sì

REST:
MOGLIE: IsUsedInGlobalWorkflow

boolean

Indica se il campo è definito all'interno di un flusso di lavoro globale.
Può cambiare?=No

REST:
WIFE: IsUserNameField

boolean

Indica se il campo viene utilizzato per visualizzare un campo Identity.
Può cambiare?=No

REST: nome
WIFE: Nome

string

Nome descrittivo assegnato al campo. Il nome descrittivo non può essere modificato per Azure DevOps, ma può essere modificato per l'ambiente locale usando il comando witadmin changefield .
Può cambiare?=Solo locale

REST: picklistId
MOGLIE: HelpText

GUID

Se il campo è un elenco a discesa, l'identificatore dell'elenco a discesa associato, altrimenti Null. Viene assegnato un valore GUID univoco quando viene definito un campo personalizzato per il tipo di elenco di controllo Azure DevOps e Picklist (String) o Picklist (Integer).
Può cambiare?=No

REST:
MOGLIE: ProhibitedValues

collection

Ottiene la raccolta di valori non consentiti per un campo che specifica tali valori. È possibile definire solo valori non consentiti per le distribuzioni locali.
Può cambiare?=Solo locale

REST: readOnly
MOGLIE:

boolean

Indica se il campo è impostato su sola lettura. Per Azure DevOps Services, solo i campi personalizzati possono essere modificati in sola lettura. Impossibile modificare i campi di sistema.
Può cambiare?=Sì

REST: referenceName
WIFE: ReferenceName

string

Specifica il nome di riferimento di un campo.
Può cambiare?=No

REST:
MOGLIE: ReportingAttributes³

Specifica dettagli, dimensione o misura, a seconda che e come si desidera includere il campo nei report. I dati dei campi con un valore diverso da Nessuno per questo attributo vengono esportati nel data warehouse e possono essere inclusi nei report SQL.
Può cambiare?=Solo locale

REST:
MOGLIE: ReportingName³

string

Specifica l'etichetta per un campo quando i dati vengono visualizzati nei report SQL. Se non si specifica un valore, viene usato il nome descrittivo del campo.
Può cambiare?=Solo locale

REST:
MOGLIE: ReportingReferenceName³

string

Specifica un nome di riferimento diverso a un campo utilizzato quando i dati vengono esportati nel data warehouse relazionale. Se non si specifica un valore, viene usato il nome di riferimento dei campi.
Può cambiare?=Solo locale

REST: supportedOperations
MOGLIE:

set

Set di operatori di query validi per l'uso quando si fa riferimento a questo campo. Per un rapido riferimento alle operazioni supportate in base al tipo di dati, vedere Riferimento rapido alle query, Operatori e macro supportate per ogni tipo di dati.
Può cambiare?=No

REST:
WIFE: SupportsTextQuery

boolean

Indica se il campo supporta query di testo, ad esempio Contains Words, Does Not Contains Words.
Può cambiare?=No

REST:
MOGLIE: SystemType

string

Specifica il tipo di dati del campo, facendo riferimento al nome di sistema, ad esempio System.DateTime o System.String.
Può cambiare?=No

REST: tipo
MOGLIE: FieldType

string

Specifica il tipo di dati del campo, ad esempio Boolean, DateTime, Integer, String e così via. Per un elenco completo e le descrizioni, vedere Campi, operatori e macro di query.
Può cambiare?=No

REST: utilizzo
MOGLIE: Utilizzo

string

Specifica se il campo è destinato all'uso con gli elementi di lavoro (WorkItem) o gli oggetti WorkItemLink (WorkItemLink). L'utilizzo per la maggior parte dei campi è WorkItem. Per un elenco completo dei valori di utilizzo, vedere Get Fields, FieldUsage.
Può cambiare?=No

Nota

1. Per le distribuzioni locali, è possibile abilitare l'indicizzazione per un campo per migliorare i tempi di risposta delle query durante il filtro sul campo. Per altre informazioni, vedere Campi indicizzati più avanti in questo articolo.
2. Gli attributi isPicklist e isPicklistSuggested vengono assegnati solo ai campi personalizzati definiti per un processo ereditato. Il modello di processo ereditato è supportato per Azure DevOps Server 2019 e versioni successive. Per altre informazioni, vedere Modello di processo ereditato.
3. Tutti gli attributi di creazione di report sono validi solo per le distribuzioni locali i cui progetti sono stati configurati per supportare SQL Server Reporting e SQL Server Analysis Services.

Attributi dei campi elenco

È possibile elencare gli attributi assegnati a un campo usando l'API REST Fields - Get. Immettere il nome dell'organizzazione per Nome organizzazione.

https://dev.azure.com/OrganizationName/_apis/wit/fields/FieldReferenceName

Ad esempio, qui vengono elencati gli attributi per il percorso di iterazione, specificando il nome di riferimento, System.IterationPath, per l'organizzazione fabrikam.

https://dev.azure.com/fabrikam/_apis/wit/fields/System.IterationPath

Dati restituiti:

{
"name": "Iteration Path",
"referenceName": "System.IterationPath",
"description": "The iteration within which this bug will be fixed",
"type": "treePath",
"usage": "workItem",
"readOnly": false,
"canSortBy": true,
"isQueryable": true,
"supportedOperations": [
{
"referenceName": "SupportedOperations.Under",
"name": "Under"
},
{
"referenceName": "SupportedOperations.NotUnder",
"name": "Not Under"
},
{
"referenceName": "SupportedOperations.Equals",
"name": "="
},
{
"referenceName": "SupportedOperations.NotEquals",
"name": "<>"
},
{
"referenceName": "SupportedOperations.In",
"name": "In"
},
{
"name": "Not In"
}
],
"isIdentity": false,
"isPicklist": false,
"isPicklistSuggested": false,
"url": "https://dev.azure.com/mseng/_apis/wit/fields/System.IterationPath"
}

Aggiungere e modificare i campi

Per aggiungere campi a un processo, aggiungerli a uno o più tipi di elemento di lavoro. Per altre informazioni, vedere Personalizzare un processo di ereditarietà.

Articoli correlati

• Riferimento rapido alle query
• Indice del campo dell'elemento di lavoro
• Aggiungere e gestire campi per un processo ereditato
• Informazioni di riferimento sui metadati per Analisi di Azure Boards