Importare, esportare e gestire tipi di elemento di lavoro [witadmin]

Articolo
11/18/2015

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

destroywitd: elimina in modo permanente un tipo di elemento di lavoro e tutti gli elementi di lavoro di tale tipo.
exportwitd: esporta la definizione di un tipo di elemento di lavoro in un file XML o nella finestra del prompt dei comandi.
importwitd: importa i 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, la nuova definizione del tipo di elemento di lavoro sovrascriverà quella esistente. Se il tipo di elemento di lavoro non esiste ancora, con questo comando viene creato un nuovo tipo di elemento di lavoro. Per convalidare l'XML che definisce un tipo di elemento di lavoro senza importare il file, usare 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, il nuovo nome viene visualizzato negli elementi di lavoro di questo tipo.

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 32 bit di Windows sostituire %programfiles(x86)% con %programfiles%.

Per altre informazioni sui tipi di elemento di lavoro, vedere Aggiungere definizioni di tipi per elementi di lavoro a un modello di processo.

Nota

È possibile creare e modificare i tipi di elemento di lavoro utilizzando l'Editor di processo (Process Editor), un power tool per Visual Studio.Questo strumento non è supportato.Per altre informazioni, vedere la pagina del sito Web Microsoft relativa ai Power Tool di Team Foundation Server.

Requisiti

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

Per esportare o elencare i tipi di elemento di lavoro, è necessario essere membri del gruppo Project Administrators o che l'autorizzazione Visualizza informazioni a livello di progetto sia impostata su Consenti.
Per eliminare, importare o rinominare tipi di elemento di lavoro, è necessario essere membri del gruppo di sicurezza Team Foundation Administrators o Project Administrators.

Per altre informazioni, 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 e scegliere Esegui come amministratore.Per altre informazioni, vedere il sito Web Microsoft: Controllo dell'account utente.

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	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
/p: Project	Progetto team per il quale è necessario gestire i tipi di elemento di lavoro. Questo progetto team deve essere definito nella raccolta di progetti specificata dal parametro /collection. Il parametro /p è necessario, a meno che non si esegua il comando importwitd con l'opzione /v.
/n: TypeName	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 elemento di lavoro da esportare o importare. Se si omette questo parametro quando si utilizza il comando exportwitd, viene visualizzato l'XML nella finestra del prompt dei comandi. Nota Se si usa Windows Vista, è possibile che non si disponga delle autorizzazioni per determinate cartelle.Se si tenta di esportare un tipo di elemento di lavoro 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 evitare questo reindirizzamento, è possibile esportare il file in un percorso per cui si dispone delle autorizzazioni necessarie. Per altre informazioni sulla virtualizzazione del Registro di sistema, vedere il sito Web Microsoft: Virtualizzazione del Registro di sistema e Problemi comuni di virtualizzazione dei file e del Registro di sistema in Windows Vista.
/e: Encoding	Nome di un formato di codifica .NET Framework 2.0. Il comando usa 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 ha esito negativo, witadmin usa la codifica UTF-8.
/exportgloballists	Esporta le definizioni degli elenchi globali a cui fa riferimento il tipo di elemento di lavoro. Le definizioni per gli elenchi globali verranno incorporate nell'XML di definizione del tipo di elemento di lavoro. Se non viene specificato questo parametro, le definizioni per gli elenchi globali vengono omesse.
/v	Convalida l'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 al gruppo con ambito di progetto vengono ignorati.
/new: NewName	Nuovo nome del tipo di elemento di lavoro.
/noprompt	Disabilita il prompt di conferma.
/? o help	Visualizza il testo della Guida relativo al comando nella finestra del prompt dei comandi.

Note

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

Il tipo di elemento di lavoro
Tutti gli elementi di lavoro di tale tipo
Le voci corrispondenti nelle tabelle di elementi di lavoro, nelle tabelle di testo lungo e nelle tabelle di collegamenti
Gli oggetti nella cache dei metadati del tipo di elemento di lavoro

Esempi

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

URI per la raccolta di progetti team: http://AdventureWorksServer:8080/tfs/DefaultCollection
Nome progetto: AdventureWorks
Nome del file di input o output: myworkitems.xml
Nome del tipo di elemento di lavoro: myworkitem
Codifica predefinita: UTF-8

Esportare la definizione di un tipo di elemento di lavoro

Il comando seguente esporta la definizione di myworkitem nel file myworkitems.xml.

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

Nell'esempio seguente l'elemento di lavoro viene esportato usando la codifica Unicode (UTF-7).

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

Esportare la definizione di un tipo di elemento di lavoro e i relativi elenchi globali di riferimento.

Nell'esempio seguente vengono esportati il tipo di elemento di lavoro e i relativi elenchi globali di riferimento.

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

Elencare la definizione di un tipo di elemento di lavoro

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

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /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/tfs/DefaultCollection /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 viene importata la definizione.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks /v

Domande e risposte

D: Quali personalizzazioni si possono applicare se si continua a usare Configurazione guidata delle funzionalità per aggiornare il progetto team dopo un aggiornamento a TFS?

R: È possibile aggiungere tipi di elemento di lavoro e modificare il layout del form. Con la procedura guidata Configurazione funzionalità è possibile aggiornare i progetti team e accedere alle ultime funzionalità.

Se si modifica il flusso di lavoro o si rinomina un tipo di elemento di lavoro, può essere necessario eseguire alcune operazioni manuali durante l'aggiornamento del progetto team. Per informazioni sulle personalizzazioni che è possibile applicare e quelle da evitare, vedere la sezione Prima di personalizzare, comprendere le implicazioni di aggiornamento e di manutenzione in Personalizzare oggetti di rilevamento degli elementi di lavoro per supportare i processi del team.

D: È possibile modificare il colore associato a un tipo di elemento di lavoro?

R: In Team Web Access gli elementi di lavoro vengono visualizzati nei risultati della query e nella pagine dell'area e di backlog degli strumenti di pianificazione Agile. Per modificare il colore associato a un tipo di elemento di lavoro esistente o per aggiungere il colore da usare per un nuovo tipo di elemento di lavoro, modificare la configurazione del processo.

Assegnazione di colori ai diversi tipi di elementi di lavoro

D: Come è possibile disattivare o disabilitare un tipo di elemento di lavoro?Come è possibile impedire agli utenti di creare elementi di lavoro di un tipo specifico?

R: Se si vuole eseguire il ritiro di un tipo di elemento di lavoro, ma si vogliono mantenere gli elementi di lavoro creati in base a tale tipo, è possibile aggiungere una regola in base alla quale il salvataggio del tipo di elemento di lavoro viene disabilitato per tutti gli utenti validi.

<TRANSITION from=" " to="New">
   <FIELDS>
     <FIELD refname="System.CreatedBy">
         <VALIDUSER not="[Team Project Name]Project Valid Users" />
     </FIELD>
   </FIELDS>
</TRANSITION>

Se si vuole limitare la creazione di un tipo di elemento di lavoro specifico a un gruppo di utenti, è possibile limitare l'accesso in due modi diversi:

Aggiungere il tipo di elemento di lavoro al gruppo di categorie nascoste per impedirne la creazione alla maggior parte dei collaboratori. Per consentire a un gruppo di utenti di effettuare l'accesso, è possibile creare un collegamento ipertestuale a un modello che consente di aprire il form dell'elemento di lavoro e di condividere tale collegamento con i membri del team cui consentire la creazione.
Aggiungere una regola di campo nel flusso di lavoro per il campo System.CreatedBy per limitare la creazione di un elemento di lavoro di un tipo specifico a un gruppo di utenti. Come illustrato nell'esempio seguente, per salvare l'elemento di lavoro l'utente che lo crea deve appartenere a Allowed Group.
```
<TRANSITION from=" " to="New">
   <FIELDS>
     <FIELD refname="System.CreatedBy">
         <VALIDUSER for="Allowed Group" not="Disallowed Group" />
     </FIELD>
   </FIELDS>
</TRANSITION> 
```

D: Come si elimina un tipo di elemento di lavoro?

R: Per impedire ai membri del team di usare un tipo di elemento di lavoro specifico per creare un elemento di lavoro, è possibile rimuoverlo dal progetto team. Quando si usa witadmin destroywitd, si eliminano in modo permanente tutti gli elementi di lavoro creati con il tipo di elemento di lavoro e il tipo di elemento di lavoro stesso. Se il team non usa "Impedimento", ad esempio, è possibile eliminare il tipo di elemento di lavoro contrassegnato "Impedimento" dal progetto di sito Web di Fabrikam.

witadmin destroywitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"Impediment"

Quando si elimina un tipo di elemento di lavoro che appartiene a una categoria, è necessario aggiornare la definizione della categoria per il progetto team in modo da riflettere il nuovo nome. In particolare, gli strumenti di pianificazione Agile non vengono eseguiti finché non si aggiorna la definizione della categoria.

Per altre informazioni, vedere Importare ed esportare categorie [witadmin].

Vedere anche

Condividi tramite