Gestire gli elenchi globali per i tipi di elemento di lavoro

Articolo
02/19/2013

Gli elenchi globali sono elenchi di opzioni che è possibile includere in uno o più campi e tipi di elementi di lavoro.Utilizzarli per ridurre il lavoro richiesto per aggiornare un elenco condiviso da diversi tipi di elementi di lavoro.Poiché gli elenchi globali sono definiti per una raccolta di progetti team, possono essere inclusi nei tipi di elemento di lavoro per tutti i progetti team nella raccolta.

[!NOTA]

Gli elenchi globali non devono includere gruppi di sicurezza in ambito progetto poiché non hanno lo stesso ambito di un progetto team.

È possibile definire un elenco globale all'interno del relativo file di definizione, in uno relativo a un tipo di elemento di lavoro o in un flusso di lavoro globale.La definizione dell'elenco globale gestisce gli elenchi globali definiti per una raccolta.La definizione di elenco globale utilizza i seguenti comandi nello strumento della riga di comandi witadmin:

destroygloballist: distruggere un elenco globale.
exportgloballist: esporta gli elenchi globali in un file XML o nella finestra del prompt dei comandi.Esporta un singolo file che contiene tutti gli elenchi globali definiti per la raccolta di progetti team.
importgloballist: importa gli elenchi globali da un file XML.Se si tenta di importare un elenco globale già esistente sul server, viene visualizzato un avviso in cui viene richiesto se si desidera sovrascriverne uno sul server.Se si tenta di importare un elenco globale che non esiste già, il comando crea un nuovo elenco globale.
listgloballist: visualizza il nome di ogni elenco globale definito nel server.

Vedere Definire elenchi globali e Personalizzare il flusso di lavoro globale.

Per eseguire lo strumento della riga di comando witadmin, aprire una finestra Prompt dei comandi in cui è installato Visual Studio o Team Explorer e immettere:

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

In una versione a 64 bit di Windows sostituire %programfiles% con %programfiles(x86)%.

[!NOTA]

È possibile creare e modificare elenchi globali tramite Editor processi, uno strumento avanzato per Visual Studio.Questo strumento non è supportato.Per ulteriori informazioni, vedere la pagina seguente sul sito Web Microsoft: Power Tool di Team Foundation Server.

Requisiti

Per la raccolta di progetti team in cui vengono definiti gli elenchi globali, è necessario disporre del set di autorizzazioni seguente:

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 distruggere o importare elenchi globali, è necessario essere un membro del gruppo di sicurezza Administrators di Team Foundation o Project Administrators.

Vedere Autorizzazioni per Team Foundation Server e Gruppi predefiniti, autorizzazioni e ruoli di Team Foundation Server.

[!NOTA]

Anche se si accede con autorizzazioni amministrative, è necessario aprire una finestra del prompt dei comandi con privilegi elevati per eseguire questa funzione su un server che esegue Windows Server 2008.Per aprire una finestra del prompt dei comandi con privilegi elevati, scegliere Start, aprire la finestra di scelta rapida Prompt dei comandi, quindi scegliere Esegui come amministratore.Per ulteriori informazioni, vedere questa pagina nel sito Web Microsoft: Controllo dell'account utente.

witadmin destroygloballist /collection:CollectionURL /n:GlobalListName [/noprompt] [/force]

witadmin exportgloballist /collection:CollectionURL [/f:FileName] [/e:Encoding] 

witadmin importgloballist /collection:CollectionURL /f:FileName [/e:Encoding]

witadmin listgloballist /collection:CollectionURL

Parametri

Parametro	Descrizione
/collection:CollectionURL	Specifica l'URI della raccolta di progetti team.Il formato per l'URI è il seguente: http://NomeServer:Porta/NomeDirectoryVirtuale/NomeInsieme Se non viene utilizzata alcuna directory virtuale, il formato dell'URI sarà il seguente: http://NomeServer:Porta/NomeInsieme.
/n:GlobalListName	Nome dell'elenco globale da eliminare.
/f:FileName	Percorso e nome del file di definizione XML dell'elenco globale da esportare o importare. Nota Se il computer client esegue Windows Vista, è possibile che non si disponga delle autorizzazioni per accedere ad alcune cartelle.Se si tenta di esportare l'elenco globale in una posizione per la quale non si dispone di autorizzazioni, la tecnologia di virtualizzazione del Registro di sistema reindirizzerà automaticamente il file esportato e lo salverà nell'archivio virtuale.Per ulteriori informazioni, vedere le pagine seguenti del sito Web Microsoft: Virtualizzazione del registro (la pagina potrebbe essere in inglese) e Problemi comuni di virtualizzazione di file e del Registro di sistema in Windows Vista.Per evitare il reindirizzamento, è possibile esportare il file in un percorso per il quale si dispone di autorizzazioni.
/e:Encoding	Il nome di un formato di codifica .NET Framework 2.0.La codifica specificata verrà utilizzata per esportare o importare i dati XML.Ad esempio, /e utf-7 specifica la codifica Unicode (UTF-7).Se si omette questo parametro, witadmin tenta di rilevare la codifica e se il rilevamento non riesce, witadmin utilizza UTF-8.
/noprompt	Disabilita la richiesta di conferma.
/? or help	Visualizza il testo della Guida relativo al comando nella finestra del prompt dei comandi.

Note

L'importazione di un elenco globale comporta la creazione di un elenco se questo non è già esistente.Se l'elenco esiste già, il comando witadmin importgloballist avverte l'utente che l'elenco corrente sarà sovrascritto.È possibile scrivere un programma personalizzato per aggiornare un elenco globale esistente o aggiornare l'elenco globale manualmente con i dati nuovi.

Per creare un nuovo elenco globale, iniziare con il codice seguente e modificarlo in base alle necessità.In questo esempio verrà definito un elenco globale di discipline che è possibile assegnare alle attività.

<?xml version="1.0" encoding="utf-8"?>
<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/globallists">
    <GLOBALLIST name="Disciplines">
        <LISTITEM value="Architecture" />
        <LISTITEM value="Requirements" />
        <LISTITEM value="Development" />
        <LISTITEM value="Release Management" />
        <LISTITEM value="Project Management" />
        <LISTITEM value="Test" />
    </GLOBALLIST>
</gl:GLOBALLISTS>

Per aggiungere un elenco globale a un campo, esportare la definizione per il tipo di elemento di lavoro contenente il campo e aggiungerla alla definizione di campo, come illustrato nel seguente esempio:

<FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES>
     <GLOBALLIST name="Disciplines" />
  </ALLOWEDVALUES>
</FIELD>

Per visualizzare le modifiche, importare la definizione del tipo e aggiornare il browser o la cache client.Potrebbe essere necessario chiudere e riaprire tutti gli elementi di lavoro che fanno riferimento al campo.

Per ulteriori informazioni sull'esportazione e l'importazione di definizioni di tipi, vedere Personalizzare e gestore i tipi di elemento di lavoro [witadmin].

Esempi

Se non diversamente specificato, i valori seguenti vengono applicati in ogni esempio:

URI per la raccolta di progetti team: http://AdventureWorksServer:8080/tfs/DefaultCollection
Numero della porta del sito Web server: 8080

Visualizzare i nomi di elenchi globali

Nell'esempio seguente vengono mostrati gli elenchi globali definiti nel server.Nell'esempio vengono esportati gli elenchi globali utilizzando la codifica predefinita UTF-8:

witadmin listgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Esportare la definizione di elenchi globali

Nell'esempio seguente vengono esportati gli elenchi globali:

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml

Nell'esempio seguente vengono esportati gli stessi elenchi globali nello stesso server, ma si utilizza la codifica Unicode (UTF-7):

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml /e:utf-7

Importare la definizione di elenchi globali

Nell'esempio seguente vengono importati gli elenchi globali:

witadmin importgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml

Nell'esempio seguente vengono importati gli stessi elenchi globali nello stesso server, ma si utilizza la codifica Unicode (UTF-7):

witadmin importgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml /e utf-7

Vedere anche

Concetti

Definire elenchi globali

Altre risorse

Personalizzare il flusso di lavoro globale

witAdmin: personalizzare e gestire oggetti per il rilevamento degli elementi di lavoro

Condividi tramite