Convenzioni di denominazione per oggetti di rilevamento di elementi di lavoro

In Visual Studio Team Foundation Server (TFS) tutti gli oggetti rilevamento degli elementi di lavoro sono associati a uno o più nomi. La maggior parte dispone di nomi visualizzati descrittivi e tutti, ad eccezione dei tipi di elemento di lavoro e degli elenchi globali, sono associati a nomi di riferimento. Un nome descrittivo è un identificatore univoco, visibile all'utente di un campo. L'utilizzo di nomi descrittivi garantisce la coerenza tra tutti i progetti team e i tipi di elemento di lavoro in una raccolta di progetti. In TFS il nome di riferimento viene usato internamente e non può essere modificato dopo che è stato definito.

Nella tabella seguente vengono riepilogati i requisiti di denominazione che è necessario soddisfare per ogni oggetto di rilevamento degli elementi di lavoro.

Requisiti dei nomi descrittivi

Oltre ai requisiti riepilogati nella tabella elencata precedentemente in questo argomento, i nomi descrittivi che si definiscono devono soddisfare i requisiti seguenti:

• I nomi non devono essere vuoti.

• I nomi non possono avere spazi vuoti iniziali o finali.

• I nomi non possono contenere caratteri barra rovesciata (\).

• I nomi di campo non possono contenere i caratteri seguenti: barra rovesciata (\), punto (.) e parentesi quadre di apertura e chiusura ([]).

• I nomi non possono contenere due o più spazi vuoti consecutivi.

Requisiti dei nomi di riferimento

Quando viene aggiunto o creato un campo, un tipo di collegamento o una categoria per l'elemento di lavoro, è necessario creare un nome di riferimento. Tutti i nomi di riferimento possono essere costituiti da un massimo di 70 caratteri Unicode.

È possibile definire un nome di riferimento utilizzando caratteri alfanumerici, sottolineature e trattini. Ciascun nome di riferimento deve contenere almeno un punto (.), ma all'inizio e alla fine del nome non possono essere presenti punti. Un nome di riferimento non può iniziare con un numero o un carattere di sottolineatura e non può includere più trattini consecutivi, ad esempio (--).

Nomi di riferimento campo e portabilità

Il linguaggio di definizione del tipo di elemento di lavoro include il concetto di nome di riferimento campo. I nomi di riferimento campo possono aiutare a trasportare le definizioni tra raccolte di progetti Team Foundation e anche consentire le integrazioni di terze parti per individuare e fare riferimento a campi specifici. Analogamente a quanto avviene per gli spazi dei nomi in .NET Framework, tali nomi sono univoci a livello globale.

Non è possibile rinominare i nomi di riferimento campo. Se ad esempio si modifica il nome del campo "Titolo" in "Intestazione", il nome di riferimento di tale campo rimane invariato. Nelle integrazioni e nelle rappresentazioni interne dei campi è necessario usare i nomi di riferimento dei campi anziché dipendere dallo stesso nome del campo.

Lo spazio dei nomi System è usato solo per definire tutti i campi di sistema di base che sono obbligatori per le funzioni di sistema di Team Foundation. Team Foundation Server impedisce di creare un campo System.X personalizzato perché potrebbe ostacolarne le relative funzionalità.

Lo spazio dei nomi Microsoft viene usato per definire i campi di gestione degli elementi di lavoro. Questi campi sono definiti in una definizione di tipo di elemento di lavoro dei modelli di processo TFS. Tramite TFS non viene impedita la creazione di campi Microsoft.X personalizzati. Tuttavia, questa pratica è fortemente sconsigliata in quanto potrebbe impedire la funzionalità di Team Foundation Server TFS o la possibilità di aggiornare correttamente un progetto team tramite la procedura guidata Configura funzionalità dopo un aggiornamento TFS.

Clienti e partner possono creare spazi dei nomi dei campi personalizzati per tipi di elemento di lavoro personalizzati.

Per le descrizioni dei campi di sistema e dei campi definiti nei modelli di processo TFS, vedere Riferimenti ai campi elemento di lavoro per Visual Studio ALM.

Esempi di nomi di riferimento campo

Negli esempi riportati di seguito sono mostrati nomi di riferimento dei campi validi in vari spazi dei nomi.

Esempi di spazi dei nomi System

System.Id

System.Title

System.CreatedBy

System.CreationDate

System.ChangedBy

System.ChangedDate

System.State

System.Reason

Esempi di spazi dei nomi Microsoft

Microsoft.Common.Status

Microsoft.Common.Priority

Microsoft.Scheduling.Duration

Microsoft.Scheduling.PercentComplete

Microsoft.Testing.TestCaseName

Esempi in altri spazi dei nomi

Clienti e partner possono definire propri spazi dei nomi per supportare tipi di elemento di lavoro personalizzati. Ad esempio, la società immaginaria Trey Research può definire i seguenti tipi di elemento di lavoro personalizzati:

TreyResearch.Common.Severity

TreyResearch.Common.Phase

TreyResearch.RiskManagement.RiskType

TreyResearch.RiskManagement.Resolution

La società di software immaginaria A. Datum Corporation può definire i seguenti tipi di elemento di lavoro:

A_Datum.Common.BusinessPriority

A_Datum.Bug.FoundInPhase

A_Datum.Bug.FixInPhase

Vedere anche

Riferimenti

Riferimento all'elemento FIELD (Definizione)

Concetti

Personalizzare oggetti di rilevamento degli elementi di lavoro per supportare i processi del team