Personalizzazione e gestione dei tipi di elemento di lavoro

È possibile gestire i tipi di elementi di lavoro per un progetto team tramite i seguenti comandi witadmin:

• destroywitd: Distrugge un tipo di elemento di lavoro e distrugge in modo permanente ogni elemento di lavoro di quel tipo senza recupero.

• exportwitd: Esporta la definizione di un tipo di elemento di lavoro in un file XML o alla finestra del prompt dei comandi.

• importwitd: Importa tipi di elemento di lavoro da un file di definizione XML in un progetto team su un server che esegue Team Foundation Server. Se esiste già un tipo di elemento di lavoro con lo stesso nome, il comando di importazione sovrascriverà il tipo di elemento di lavoro esistente. Se il tipo di elemento di lavoro non esiste già, questo comando crea un nuovo tipo di elemento di lavoro. Per convalidare il codice XML che definisce un tipo di elemento di lavoro, ma non importa il file, utilizzare l'opzione /v.

• listwitd: Visualizza i nomi dei tipi di elemento di lavoro nel progetto specificato nella finestra del Prompt dei comandi.

• renamewitd: Modifica il nome visualizzato di un tipo di elemento di lavoro all'interno di un progetto specifico. Dopo avere eseguito questo comando, elementi di lavoro di questo tipo mostrano il nuovo nome.

L'utilità della riga di comando witadmin si trova in Unità>:\Programmi\Microsoft Visual Studio 10.0\Common7\IDE nel computer client che esegue Team Explorer. 

Per ulteriori informazioni sui tipi di elementi di lavoro, vedere Tipi di elemento di lavoro.

Autorizzazioni necessarie

Per il progetto team in cui sono definiti i tipi di elemento di lavoro, è necessario disporre del set di autorizzazioni seguente:

• Per esportare o elencare tipi di elementi di lavoro, è necessario essere un membro del gruppo Readers o disporre dell'autorizzazione Visualizza elementi di lavoro in questo nodo impostata su Consenti.

• Per distruggere, importare o riattivare i tipi di elementi di lavoro, è necessario essere un membro del gruppo di sicurezza Administrators di Team Foundation o Project Administrators.

Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server e Gruppi predefiniti, autorizzazioni e ruoli di Team Foundation Server.

witadmin destroywitd /collection:CollectionURL /p:Project /n:TypeName [/noprompt]

witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName [/f:FileName] [/e:Encoding] [/exportglobalists]

witadmin importwitd /collection:CollectionURL [/p:Project] /f:FileName [/e:Encoding] [/v]

witadmin listwitd /collection:CollectionURL /p:Project

witadmin renamewitd /collection:CollectionURL /p:Project /n:TypeName /new:NewName [/noprompt]

Parametri

Parametro	Oggetto di descrizione
/collection:CollectionURL	Specifica l'URI dell'insieme 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
/p:Progetto	Il progetto team per il quale i tipi di elementi di lavoro devono essere gestiti. Questo progetto team deve essere definito nell'insieme di progetti specificato dal parametro /collection. Viene richiesto il parametro /p a meno che non si esegua il comando importwitd con l'opzione /v.
/n:TypeName	Il nome del tipo di elemento di lavoro da eliminare, esportare, importare o rinominare.
/f:FileName	Percorso e nome del file di definizione XML contenente i tipi di elementi di lavoro da esportare o importare. Se si omette questo parametro quando si utilizza il comando exportwitd, il file XML viene visualizzato nella finestra del Prompt dei comandi. Nota Se si utilizza Windows Vista, è possibile che non si disponga delle autorizzazioni per alcune cartelle.Se si tenta di esportare il tipo di elemento di lavoro 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 evitare il reindirizzamento, è possibile esportare il file in un percorso per il quale si dispone di autorizzazioni. Per ulteriori informazioni sulla virtualizzazione del registro di sistema, vedere il sito Web Microsoft: Virtualizzazione del Registro di sistema e Problemi comuni di virtualizzazione di file e del Registro di sistema in Windows Vista.
/e:Codifica	Il nome di un formato di codifica .NET Framework 2.0. Il comando utilizza la codifica specificata 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. Se il rilevamento non riesce, witadmin utilizza la codifica UTF-8.
/exportgloballists	Esporta le definizioni degli elenchi globali a cui fa riferimento il tipo di elemento di lavoro. Le definizioni degli elenchi globali saranno incorporate nel codice XML della definizione del tipo di elemento di lavoro. Quando non specificate, le definizioni per gli elenchi globali vengono omesse.
/v	Convalida il codice XML che definisce il tipo di elemento di lavoro, ma non importa il file di definizione XML. Nota È possibile convalidare la definizione del tipo senza specificare un progetto team.I riferimenti ai gruppi in ambito progetto vengono ignorati.
/new:NewName	Nuovo nome del tipo di elemento di lavoro.
/noprompt	Disabilita la richiesta di conferma.
/? o help	Visualizza il testo della Guida relativo al comando nella finestra del prompt dei comandi.

Note

Quando si utilizza il comando destroywitd, vengono eliminati tutti gli oggetti seguenti:

• Tipo di elemento di lavoro

• Tutti gli elementi di lavoro di quel tipo

• Voci corrispondenti nelle tabelle dell'elemento di lavoro, le tabelle di testo lunghe e le tabelle di collegamento

• Oggetti nella cache dei metadati del tipo di elemento di lavoro

Esempi

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

• URI per l'insieme di progetti team: http://AdventureWorksServer:8080/AWTeam/Collection1

• Nome del progetto: AdventureWorks

• Nome del file di input o di output: myworkitems.xml

• Nome del tipo di elemento di lavoro: myworkitem

• Codifica predefinita: UTF-8

Esportare le definizioni di un tipo di elemento di lavoro

Il comando seguente consente di esportare la definizione per myworkitem nel file myworkitems.xml.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myworkitems.xml /n:myworkitem

Nell'esempio riportato di seguito viene eseguita l'esportazione dell'elemento di lavoro utilizzando la codifica Unicode (UTF-7).

witadmin exportwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /e:utf-7

Esportare la definizione del tipo di elemento di lavoro e dei relativi elenchi globali di riferimento

Nell'esempio riportato di seguito viene eseguita l'esportazione del tipo di elemento di lavoro e dei relativi elenchi globali di riferimento.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /exportgloballists

Elencare le definizioni di un tipo di elemento di lavoro

Nell'esempio seguente viene visualizzata la definizione del tipo di elemento di lavoro nella finestra Prompt dei comandi.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /n:myworkitem

Importare la definizione dei tipi di elementi di lavoro

Nell'esempio seguente viene importata la definizione dell'elemento di lavoro dal file XML.

witadmin importwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:myworkitem.xml /p:AdventureWorks

Convalidare la definizione XML di tipi di elemento di lavoro

Nell'esempio seguente viene convalidato il codice XML che definisce il tipo di elemento di lavoro, ma non importa la definizione.

witadmin importwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:myworkitem.xml /p:AdventureWorks /v

Vedere anche

Attività

Creare un tipo di elemento di lavoro