Definire elenchi globali
Gli elenchi globali in Team Foundation Server (TFS) consentono di ridurre il lavoro richiesto per aggiornare un elenco presente nelle definizioni di diversi tipi di elemento di lavoro. Gli elenchi globali sono elenchi di selezione che è possibile includere in uno o più campi e nelle definizioni dei tipi di elemento di lavoro. È possibile definire un elenco globale all'interno di un tipo di elemento di lavoro aggiunto a un progetto team, come elenco globale per una raccolta di progetti team o all'interno di un flusso di lavoro globale. È possibile condividere gli elementi dell'elenco tra più tipi di elemento di lavoro di una raccolta includendo gli elementi dell'elenco in uno o più elementi GLOBALLIST.
Quando si definiscono i tipi di elemento di lavoro, è possibile che alcuni campi condividano gli stessi valori. Spesso, è possibile eseguire una condivisione tra più tipi di elemento di lavoro e persino tra più progetti team. Alcuni di questi valori, ad esempio il numero di build delle build notturne, vengono modificati di frequente, quindi l'amministratore deve aggiornare spesso questi elenchi in diverse posizioni. Gli elenchi globali possono essere particolarmente utili quando è necessario derivare un elenco da un sistema esterno. Ad esempio, si ipotizzi una società che gestisce un database dei clienti separato. Quando si elabora un bug rilevato da un cliente, il nome del cliente viene immesso in un campo Found By Customer personalizzato.
È possibile gestire gli elenchi globali per una raccolta sotto forma di un 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
Non esistono elenchi globali definiti dal sistema, né elenchi globali predefiniti nei modelli di processo predefiniti forniti da TFS.
Requisiti
Per esportare o visualizzare gli elenchi globali, è necessario essere un membro del gruppo Project Collection Valid Users o che l'autorizzazione Visualizza informazioni a livello di raccolta sia impostata su Consenti.
Per definire o modificare gli elenchi globali, è necessario essere un membro del gruppo Project Administrators o che l'autorizzazione Modifica informazioni a livello di progetto sia impostata su Consenti.
Per aggiungere o modificare un elenco globale, usare lo strumento da riga di comando witadmin per importare ed esportare la definizione per gli elenchi globali. Vedere Gestire gli elenchi globali per i tipi di elemento di lavoro [witadmin]. Per usare un elenco globale, aggiungerlo alla definizione FIELD all'interno di un tipo di elemento di lavoro. Vedere Riferimento a tutti gli elementi XML FIELD.
Aggiungere e gestire gli elenchi globali
Un elenco globale è un set di elementi LISTITEM archiviato e usato globalmente da tutti i progetti team in una raccolta. Gli elenchi globali sono utili per i campi definiti in più tipi di elementi di lavoro, ad esempio Sistema operativo, Rilevato in compilazione e Corretto in compilazione.
È possibile definire gli elenchi globali e i relativi elementi usando uno dei seguenti metodi:
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 aver creato un progetto team, è possibile aggiungere gli elenchi globali che si vogliono rendere disponibili per un tipo di elemento di lavoro alla relativa definizione.
Definizione del flusso di lavoro globale: dopo aver creato un progetto team, è possibile aggiungere gli elenchi globali che si vogliono rendere disponibili per tutti i tipi di elementi di lavoro alla definizione del flusso di lavoro globale per un progetto team o una raccolta. Per altre informazioni, vedere Personalizzare il flusso di lavoro globale.
Struttura della sintassi
La tabella seguente descrive gli elementi GLOBALLIST e LISTITEM. Questi elementi possono essere usati per enumerare un elenco di valori presentato all'utente sotto forma di elenco di selezione o di menu a discesa di elementi.
Elemento |
Sintassi |
Descrizione |
|---|---|---|
GLOBALLIST |
|
Definisce un set di elementi LISTITEM archiviato per una raccolta e utilizzabile da tutti i progetti team in una raccolta. globalListName: stringa di testo contenente da 1 a 255 caratteri. GLOBALLIST è un elemento figlio obbligatorio dell'elemento GLOBALLISTS e un elemento figlio facoltativo degli elementi ALLOWEDVALUES, SUGGESTEDVALUES e PROHIBITEDVALUES. Per altre informazioni, vedere Definire elenchi di opzioni. |
LISTITEM |
|
Definisce un valore valido dell'elenco. Nota Gli elenchi globali non devono includere gruppi con ambito di progetto perché non hanno l'ambito in un progetto. LISTITEM è un elemento figlio obbligatorio di GLOBALLIST e un elemento figlio facoltativo degli elementi ALLOWEDVALUES, SUGGESTEDVALUES e PROHIBITEDVALUES. |
Elenco globale di esempio
Aggiungendo la seguente sintassi, è 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:
<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>
Con la seguente sintassi, è possibile fare riferimento a un elenco globale all'interno di un file di definizione XML per un tipo di elemento di lavoro:
<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 la posizione dei file di definizione per i tipi di elemento di lavoro o per il flusso di lavoro globale, vedere rispettivamente Riferimento a tutti gli elementi XML WITD o Riferimento agli elementi XML del flusso di lavoro globale.
Elenco globale di esempio gestito per una raccolta di progetti
Per aggiungere un elenco globale a una raccolta di progetti, è possibile importare la seguente sintassi usando 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.
Domande e risposte
D: Gli elenchi globali vengono popolati automaticamente con i dati?
R: Sì. L'elenco globale denominato Builds – NomeProgettoTeam viene aggiunto ogni volta che viene eseguita una build. Nel tempo l'elenco può diventare molto lungo, quindi si consiglia di rimuovere periodicamente gli elementi inusati dall'elenco.
Per altre informazioni sull'uso dell'elenco, vedere Campi che supportano l'integrazione con il test, la compilazione e il controllo della versione.
Vedere anche
Riferimenti
Gestire gli elenchi globali per i tipi di elemento di lavoro [witadmin]
Concetti
Personalizzare oggetti di rilevamento degli elementi di lavoro per supportare i processi del team