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.
Oggetto di rilevamento degli elementi di lavoro |
Nome di riferimento |
Nome descrittivo |
|---|---|---|
Tipo di elemento di lavoro |
Non applicabile |
Il nome di ogni tipo di elemento di lavoro può essere composto da un massimo di 255 caratteri Unicode e deve essere univoco all'interno di un progetto team. |
Campo dell'elemento di lavoro |
Obbligatorio. Vedere Requisiti dei nomi di riferimento. |
I nomi del campo possono essere composti da un massimo di 128 caratteri Unicode e devono essere univoci all'interno di un insieme di progetti team. |
Tipo collegamento |
Obbligatorio. Vedere Requisiti dei nomi di riferimento. |
Per ogni tipo di collegamento si definiscono due nomi descrittivi: un nome diretto e un nome inverso. Tali nomi possono essere composti da un massimo di 128 caratteri Unicode e devono essere univoci per tutti i tipi di collegamenti definiti per un insieme di progetti team. |
Categoria |
Obbligatorio. Vedere Requisiti dei nomi di riferimento. |
I nomi descrittivi della categoria possono essere composti da un massimo di 128 caratteri Unicode e devono essere univoci in un progetto team. |
Elenco globale |
Non applicabile |
Il nome di ogni elenco globale può essere composto da un massimo di 254 caratteri Unicode e deve essere univoco in un insieme di progetti team. |
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