Share via


Definire elenchi globali

Utilizzando gli elenchi globali in Team Foundation Server (TFS), è possibile ridurre il lavoro richiesto di aggiornare un elenco di tipi di elementi di lavoro.Gli elenchi globali sono elenchi di selezione che è possibile includere in uno o più campi e tipi di elemento di lavoro.È possibile definire un elenco globale in un tipo di elemento di lavoro che si aggiunge a un progetto team, ad esempio elenchi globali per una raccolta di progetti team, o di un flusso di lavoro globale.È possibile condividere elementi dell'elenco tra più tipi di elementi di lavoro di una raccolta includendo tali elementi di elenco in uno o più elementi GLOBALLIST.

Quando si definiscono i tipi di elementi di lavoro, alcuni campi possono condividere gli stessi valori.Di solito è possibile dividerli tra diversi tipi di elementi di lavoro e anche tra diversi progetti team.Alcuni di questi valori, ad esempio il numero delle compilazioni notturne, cambiano frequentemente, ciò richiede a un amministratore l'aggiornamento frequente di tali elenchi in molti percorsi.Gli elenchi globali sono particolarmente utili quando è necessario derivare un elenco da un sistema esterno.Ad esempio, se un'azienda gestisce un database dei clienti separato,Quando viene generato un bug individuato da un cliente, il relativo nome viene inserito in un campo personalizzato Found By Customer.

È possibile gestire gli elenchi globali per una raccolta in forma di file XML che è possibile elencare, importare, esportare ed eliminare.Il nome di ogni elenco globale può essere composto da un massimo di 254 caratteri Unicode e deve essere univoco in una raccolta.

[!NOTA]

Esistono elenchi globali definiti dal sistema, né elenchi globali predefiniti nei modelli di processo predefiniti che il TFS.

In questo argomento

  • Aggiunta e gestione di elenchi globali

  • Struttura della sintassi per la definizione di elenchi globali

  • Struttura della sintassi degli elenchi globali aggiunta a una definizione di tipo di elemento di lavoro o a un flusso di lavoro globale

  • Struttura della sintassi degli elenchi globali gestiti per una raccolta

[!NOTA]

Per aggiungere o modificare un elenco globale, utilizzare lo strumento da riga di comando witadmin per importare ed esportare la definizione per elenchi globali.Vedere Gestire gli elenchi globali per i tipi di elemento di lavoro [witadmin].Per utilizzare un elenco globale, aggiungerlo alla definizione di FIELD in un tipo di elemento di lavoro.Vedere Riferimento a tutti gli elementi XML FIELD.

Aggiunta e gestione di elenchi globali

Un elenco globale è un set di elementi LISTITEM archiviato e utilizzato a livello globale da tutti i progetti team in una raccolta.Gli elenchi globali sono utili per i campi definiti all'interno di diversi tipi di elementi di lavoro, ad esempio Sistema operativo, Rilevato in compilazione, Corretto in compilazione.

È possibile definire elenchi globali e i relativi elementi utilizzando uno dei seguenti metodi:

  • Modello di processo: È possibile definire elenchi globali nella definizione per un tipo di elemento di lavoro nel modello di processo.Ogni progetto team creato da tale modello dispone di accesso agli elenchi globali.

  • Raccolta di progetti team: è possibile esportare, modificare, eliminare e importare gli elenchi globali definiti per una raccolta di progetti team.Questi elenchi globali sono disponibili per tutti i progetti team nella raccolta.

  • Definizione del tipo di elemento di lavoro: Dopo che un progetto team, è possibile aggiungere elenchi globali si desidera avere a disposizione per un tipo di elemento di lavoro alla definizione.

  • Definizione di flusso di lavoro globale: Dopo che un progetto team, è possibile aggiungere elenchi globali si desidera avere a disposizione per tutti i tipi di elementi di lavoro alla definizione di flusso di lavoro globale per un progetto team o una raccolta.Per ulteriori informazioni, vedere Personalizzare il flusso di lavoro globale.

Torna all'inizio

Struttura della sintassi per la definizione di elenchi globali

Nella tabella seguente vengono descritti gli elementi GLOBALLIST e LISTITEM.È possibile utilizzare tali elementi per enumerare un elenco di valori presentati all'utente come un elenco di selezione o un menu a discesa di elementi.

Elemento

Sintassi

Descrizione

GLOBALIST

<GLOBALLIST name="globalListName">
    <LISTITEM> . . . </LISTITEM>
</GLOBALLIST>
 

Definisce un set di elementi LISTITEM archiviato per una raccolta e che tutti i progetti team in una raccolta possono utilizzare.

globalListName: stringa di testo tra 1 e 255 caratteri.

GLOBALLIST è un elemento figlio obbligatorio dell'elemento GLOBALLISTS e un elemento figlio facoltativo degli elementi ALLOWEDVALUES, SUGGESTEDVALUES e PROHIBITEDVALUES.Per ulteriori informazioni, vedere Definire elenchi di opzioni.

LISTITEM

<LISTITEM value="Name" />

Definisce un valore di elenco valido.

NotaNota
Gli elenchi globali non devono includere gruppi in ambito progetto poichè non sono definiti per l'ambito di un progetto.

LISTITEM è un elemento figlio obbligatorio di GLOBALLIST e un elemento figlio facoltativo degli elementi ALLOWEDVALUES, SUGGESTEDVALUES e PROHIBITEDVALUES.

Torna all'inizio

Struttura della sintassi degli elenchi globali aggiunta a una definizione di tipo di elemento di lavoro o a un flusso di lavoro globale

È possibile definire un elenco globale all'interno di un file di definizione XML per un tipo di elemento di lavoro o un flusso di lavoro globale aggiungendo la sintassi seguente:

<GLOBALLISTS>
    <GLOBALLIST name="name of global list">
        <LISTITEM value="List item 1" />
        <LISTITEM value="List item 2" />
        <LISTITEM value="List item 3" />
        <LISTITEM value="List item 4" />
        . . .
        <LISTITEM value="List item n" />
    </GLOBALLIST>
</GLOBALLISTS>

È possibile fare riferimento a un elenco globale all'interno di un file di definizione XML per un tipo di elemento di lavoro utilizzando la sintassi seguente:

<GLOBALLISTS>
   <GLOBALLIST name=" name of global list 1" />
   <GLOBALLIST name=" name of global list 2" />
   . . .
   <GLOBALLIST name=" name of global list n" />
</GLOBALLISTS>

Per informazioni sulla struttura e sul percorso dei file di definizione dei tipi di elementi di lavoro o del flusso di lavoro globale, vedere Riferimento a tutti gli elementi XML WITD o Riferimento agli elementi XML flusso di lavoro globale, rispettivamente.

Torna all'inizio

Struttura della sintassi degli elenchi globali gestiti per una raccolta di progetti

Per aggiungere un elenco globale a una raccolta di progetti, è possibile importare la sintassi seguente utilizzando il comando witadmin importgloballist:

<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/globallists">
    <GLOBALLIST name="NameOfGlobalList">
        <LISTITEM value="ListItem1" />
        <LISTITEM value="ListItem2" />
        <LISTITEM value="ListItem3" />
        <LISTITEM value="ListItem4" />
        . . .
        <LISTITEM value="ListItemN" />
    </GLOBALLIST>
</gl:GLOBALLISTS>

Un elenco globale non può essere vuoto.Ogni elemento GLOBALLIST deve contenere almeno un elemento LISTITEM definito.

Torna all'inizio

Vedere anche

Riferimenti

Gestire gli elenchi globali per i tipi di elemento di lavoro [witadmin]

Concetti

Personalizzare dati di rilevamento, form, flusso di lavoro e altri oggetti del progetto

Definire elenchi utenti, elenchi di opzioni ed elenchi globali

Altre risorse

Personalizzare il flusso di lavoro globale