Elencare i campi e gli attributi degli elementi di lavoro

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

I campi degli elementi di lavoro vengono usati per tenere traccia delle informazioni all'interno di Azure DevOps. Questi campi vengono definiti a livello di organizzazione e vengono condivisi tra tutti i progetti dell'organizzazione. Per esaminare i campi definiti per l'organizzazione, è possibile usare uno dei due strumenti seguenti, 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

Autorizzazioni: per visualizzare i campi definiti per un'organizzazione o una raccolta, essere membri del gruppo di applicazioni Utenti validi della raccolta di progetti o 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, usare uno degli strumenti seguenti in base al modello di processo, ereditato, XML ospitato o XML locale. Per un indice di campi definiti nei processi predefiniti, vedere Indice dei campi elemento di lavoro.

Strumento	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 inclusi negli elementi di lavoro di tale tipo. Ogni campo ha più attributi, molti dei quali sono definiti dal sistema e non modificabili.

I campi vengono definiti dai tre attributi seguenti:

• Tipo di dati: indica il tipo di dati che è possibile immettere nel campo, ad esempio Boolean, Double, Integer, HTML o String. Per descrizioni dettagliate di ogni tipo di dati, vedere Campi, operatori e macro di query.
• Nome descrittivo: nome descrittivo assegnato al campo, usato quando si seleziona un campo in una clausola di query. Questo nome potrebbe essere diverso dal nome visualizzato nel modulo dell'elemento di lavoro.
• Nome di riferimento: identificatore usato durante la creazione di query WIQL, modelli di elementi di lavoro improvvisati, esecuzione di comandi API REST o definizione di definizioni di tipi di elemento di lavoro XML. Il nome del riferimento è permanente e non può essere modificato una volta impostato.

Per una descrizione dettagliata di ogni attributo di campo e istruzioni su come elencarli, vedere Attributi dei campi e Attributi dei campi elenco più avanti in questo articolo. Per una panoramica dei tipi di elementi di lavoro (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 include 31 campi di sistema e diversi campi specifici del tipo. Gli elementi di lavoro vengono usati per pianificare e tenere traccia del progetto.

Ogni campo acquisisce informazioni specifiche sul lavoro da eseguire. I valori assegnati a questi campi vengono archiviati nell'archivio dati di rilevamento del lavoro, consentendo di creare query che determinano 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, fare riferimento all'indice del campo 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 conformi alle linee guida seguenti:

• Univocità: i nomi dei campi devono essere univoci all'interno dell'account o della raccolta di progetti.
• Lunghezza: i nomi dei campi devono contenere almeno 128 caratteri Unicode.
• Spaziatura: i nomi dei campi non possono avere spazi iniziali o finali o contenere due o più spazi consecutivi.
• Composizione: i nomi dei campi devono includere almeno un carattere alfabetico.
• Caratteri non consentiti: i nomi dei campi non possono includere i caratteri seguenti: .,;':~/*|?" &%$!+=()[]{}<>'.

Poiché i campi personalizzati sono definiti a livello di organizzazione o raccolta, non è possibile aggiungere un campo personalizzato con lo stesso nome a più processi.

Per altre informazioni, vedere Limitazioni e convenzioni di denominazione.

Campi di sistema e predefiniti

Un nome di campo dell'elemento di lavoro identifica in modo univoco ogni campo all'interno di Azure DevOps. Assicurarsi che i nomi dei campi siano conformi alle linee guida seguenti:

• Univocità: i nomi dei campi devono essere univoci all'interno di un account o di una raccolta di progetti.
• Lunghezza: i nomi dei campi devono avere un massimo di 128 caratteri Unicode.
• Spaziatura: i nomi dei campi non possono avere spazi iniziali o finali o contenere più spazi consecutivi.
• Composizione: i nomi dei campi devono includere almeno un carattere alfabetico.
• Caratteri non consentiti: i nomi dei campi non possono includere i caratteri seguenti: .,;':~/*|?" &%$!+=()[]{}<>'.

Poiché i campi personalizzati sono definiti a livello di organizzazione o raccolta, non è possibile aggiungere un campo personalizzato con lo stesso nome a più processi.

Per altre informazioni, vedere Limitazioni e convenzioni di denominazione.

Campi personalizzati

Poiché i campi personalizzati sono definiti a livello di organizzazione o raccolta di progetti, non è possibile aggiungere un campo personalizzato con lo stesso nome a più processi.

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

• Numero massimo di campi per tipo di elemento di lavoro (WIT): 64
• Numero massimo di campi per processo: 512

Il tipo di dati del campo determina il tipo e le dimensioni dei dati che possono essere archiviati nel campo. Ogni campo può avere un solo tipo definito all'interno di una raccolta di progetti, incoraggiando l'uso di campi comuni in progetti e tipi di elementi di lavoro diversi.

Quando si aggiunge un campo personalizzato a un processo ereditato, Azure DevOps assegna un nome di riferimento preceduto da Custom seguito dal nome del campo senza spazi. Ad esempio, l'aggiunta di un campo denominato DevOps Triage comporta il nome di riferimento Custom.DevOpsTriage. Gli spazi non sono consentiti nei nomi di riferimento.

Per altre informazioni, vedere Limitazioni e convenzioni di denominazione.

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>.

Elenco dei campi di revisione

Per esaminare l'elenco dei campi definiti per un'organizzazione o una raccolta, seguire questa procedura:

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

   

2. Selezione Elabora.

   

3. Selezionare Campi.

   I campi elencati corrispondono a tutti i campi definiti per l'organizzazione o la raccolta, che include tutti i campi personalizzati e i campi 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 descrizioni, utilizzo e nomi di riferimento di ogni campo, fare riferimento all'indice del campo Elemento di lavoro. Inoltre, è possibile recuperare i nomi dei riferimenti ai campi usando l'API REST Field - List Dei tipi di elemento di lavoro.

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, installare lo strumento Editor processi. In base alla versione installata di Visual Studio, ottenere lo strumento Editor di processi da una delle estensioni seguenti.

• Visual Studio 2019 & 2022: al momento non è disponibile alcuna estensione specifica editor modelli di processo. Tuttavia, è comunque possibile personalizzare i modelli di processo usando altri strumenti, ad esempio qualsiasi editor di testo o editor XML. È anche possibile usare il portale Web di Azure DevOps per determinate personalizzazioni, in particolare per i processi ereditati.
• 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 a seconda che vengano recuperati tramite l'API REST Fields - Get o visualizzarli tramite lo strumento Esplora campi elemento di lavoro (WIFE).

Gli attributi assegnati a un campo dipendono dalla piattaforma e dalla versione in uso. Ad esempio, alcuni attributi non sono supportati con il processo di ereditarietà. Per cercare il nome di riferimento per un campo, vedere l'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:

Booleano

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:

Booleano

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:

Booleano

Indica se il campo è impostato su sola lettura. Per Azure DevOps Services, solo i campi personalizzati possono essere modificati in sola lettura. Non è possibile 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. Sostituire OrganizationName con il nome effettivo dell'organizzazione.

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

Ad esempio, per elencare gli attributi per il percorso di iterazione, usare il nome System.IterationPath di riferimento per l'organizzazione fabrikam :

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

**Returned data:**

> [!div class="tabbedCodeSnippets"]
> ```JSON
> {
> "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

• Fare riferimento al riferimento rapido query per comprendere rapidamente la sintassi e l'utilizzo delle query.
• Esplorare l'indice del campo Elemento di lavoro per visualizzare tutti i campi degli elementi di lavoro disponibili.
• Aggiungere e gestire i campi per un processo ereditato per personalizzare i campi in base ai requisiti del processo ereditato.
• Accedere alle informazioni di riferimento sui metadati per Analisi di Azure Boards per comprendere i metadati di analisi e le funzionalità di creazione di report.