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

Articolo
11/18/2015

Gli elenchi globali sono elenchi di selezione che è possibile includere in uno o più campi e tipi di elementi di lavoro. È possibile usarli per ridurre il lavoro richiesto per aggiornare un elenco condiviso da più tipi di elementi di lavoro. Poiché gli elenchi globali sono definiti per un insieme di progetti team, possono essere inclusi nei tipi di elemento di lavoro per tutti i progetti team dell'insieme.

È possibile definire un elenco globale nel rispettivo file di definizione, nel file di definizione per un tipo di elemento di lavoro oppure nel flusso di lavoro globale. La definizione degli elenchi globali gestisce gli elenchi globali definiti per un insieme. La definizione degli elenchi globali usa i comandi seguenti nello strumento da riga di comando witadmin:

destroygloballist: elimina 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 l'insieme di progetti team.
importgloballist: importa gli elenchi globali da un file XML. Se si tenta di importare un elenco globale già esistente sul server, un avviso richiederà se si vuole sovrascrivere l'elenco globale presente sul server. Se si tenta di importare un elenco globale che non esiste già, il comando creerà un nuovo elenco globale.
listgloballist: visualizza il nome di ogni elenco globale definito sul server.

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

Lo strumento da riga di comando witadmin funziona solo se viene eseguito in un'istanza locale di TFS. Per eseguire lo strumento, aprire una finestra del prompt dei comandi in cui è installato Visual Studio o Team Explorer e digitare:

cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE

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

Nota

È possibile creare e modificare elenchi globali tramite l'Editor di processo, uno strumento avanzato per Visual Studio.Per altre informazioni, vedere Team Foundation Server Power Tools.

Requisiti

Per gli insiemi di progetti team in cui sono definiti gli elenchi globali, devono essere disponibili i set di autorizzazioni seguenti:

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 importare 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 eliminare un elenco globale usando witadmin destroygloballist, è necessario essere un membro del gruppo Project Collection Administrators o che l'autorizzazione Modifica informazioni a livello di raccolta sia impostata su Consenti.

Vedere Riferimento alle autorizzazioni per 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 in un server che esegue Windows Server 2008.Per aprire una finestra del prompt dei comandi con privilegi elevati, scegliere Start, aprire il menu di scelta rapida per Prompt dei comandi, quindi scegliere Esegui come amministratore.Per altre informazioni, vedere la pagina seguente del 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 dell'URI è il seguente: http://NomeServer:Porta/NomeDirectoryVirtuale/NomeRaccolta Se non viene usata alcuna directory virtuale, il formato dell'URI sarà il seguente: http://NomeServer:Porta/NomeRaccolta.
/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 determinate cartelle.Se si tenta di esportare un elenco globale in un percorso per cui non si dispone delle autorizzazioni, la tecnologia di virtualizzazione del Registro di sistema reindirizza automaticamente il file esportato e lo salva nell'archivio virtuale.Per altre informazioni, vedere la pagina del sito Web Microsoft relativa alla virtualizzazione del Registro di sistema e Problemi comuni di virtualizzazione di file e del Registro di sistema in Windows Vista.Per evitare questo reindirizzamento, è possibile esportare il file in un percorso per cui si dispone delle autorizzazioni necessarie.
/e:Encoding	Nome di un formato di codifica .NET Framework 2.0. La codifica specificata verrà usata per esportare o importare i dati XML. Ad esempio, /e utf-7 specifica la codifica Unicode (UTF-7). Se si omette questo parametro, verrà tentato da parte di witadmin di rilevare la codifica. Se il rilevamento non riesce, verrà usata da witadmin la codifica UTF-8.
/noprompt	Disabilita il prompt di conferma.
/? o help	Visualizza il testo della Guida relativo al comando nella finestra del prompt dei comandi.

Note

L'importazione di un elenco globale permette di creare un elenco, se non ne esiste già uno. Se l'elenco è già presente, verrà visualizzato tramite il comando witadmin importgloballist un avviso di sovrascrittura dell'elenco corrente. È possibile scrivere un programma personalizzato per aggiornare un elenco globale esistente oppure è possibile aggiornare personalmente l'elenco globale inserendo nuovi dati.

Per creare un nuovo elenco globale, iniziare a usare il codice seguente e modificarlo in base alla necessità. Questo esempio definisce un elenco globali 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>

Non includere in un elenco globale i gruppi di sicurezza con ambito di progetto, poiché l'ambito degli elenchi globali è relativo a una raccolta, non a un progetto.

Per aggiungere elenchi globali a un campo, esportare la definizione per il tipo di elemento di lavoro contenente il campo e aggiungerla alla definizione del campo, come illustrato nell'esempio seguente:

<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 dei tipi e aggiornare il browser o la cache del client. Potrebbe essere necessario chiudere eventuali elementi di lavoro che fanno riferimento al campo, quindi riaprirli.

Per informazioni sull'esportazione e l'importazione di definizioni dei tipi, vedere Importare, esportare e gestire tipi di elemento di lavoro [witadmin].

Esempi

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

URI per l'insieme di progetti team: http://AdventureWorksServer:8080/tfs/DefaultCollection
Numero di porta del sito Web del server Web: 8080

Visualizzare i nomi degli elenchi globali

L'esempio seguente mostra gli elenchi globali definiti sul server. L'esportazione degli elenchi globali viene eseguita nell'esempio usando la codifica UTF-8 predefinita:

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

Esportare la definizione degli elenchi globali

L'esempio seguente esporta gli elenchi globali:

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

L'esempio seguente esporta gli stessi elenchi globali nello stesso server, ma usa la codifica Unicode (UTF-7):

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

Importare la definizione degli elenchi globali

L'esempio seguente importa gli elenchi globali:

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

L'esempio seguente importa gli stessi elenchi globali nello stesso server, ma usa 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 gestire il lavoro

Condividi tramite