Importare, esportare e gestire i tipi di elementi di lavoro

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

È possibile gestire i tipi di elemento di lavoro per un progetto usando i comandi seguenti witadmin :

• destroywitd: elimina definitivamente un tipo di elemento di lavoro e elimina definitivamente ogni elemento di lavoro di quel tipo senza ripristino.
• 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. Se esiste già un tipo di elemento di lavoro con lo stesso nome, la nuova definizione del tipo di elemento di lavoro sovrascrive quella esistente. Se il tipo di elemento di lavoro non esiste, viene creato un nuovo tipo di elemento di lavoro. Per convalidare il codice XML che definisce un tipo di elemento di lavoro, ma non importare 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 aver eseguito questo comando, gli elementi di lavoro di questo tipo mostrano il nuovo nome.

Per altre informazioni sull'uso dei tipi di elementi di lavoro per tenere traccia del lavoro, vedere Tenere traccia degli elementi di lavoro nelle storie utente di Azure Boards, problemi, bug, funzionalità e epiche.

Eseguire lo strumento da witadmin riga di comando

Per eseguire lo strumento da witadmin riga di comando, aprire una finestra del prompt dei comandi in cui è installato Visual Studio. Lo witadmin strumento da riga di comando viene installato con qualsiasi versione di Visual Studio. È possibile accedere a questo strumento installando la versione gratuita di Visual Studio Community o Visual Studio Team Explorer.

Per Visual Studio 2022

%programfiles(x86)%\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

o Professional al Enterprise posto di Community, a seconda della versione installata.

Per Visual Studio 2019

%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

o Professional al Enterprise posto di Community, a seconda della versione installata.

Per Visual Studio 2017

%programfiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

o TeamExplorer al Professional posto di Enterprise, a seconda della versione installata.

In un'edizione a 32 bit di Windows sostituire %programfiles(x86)% con %programfiles%. È possibile installare Visual Studio Community (che fornisce l'accesso a Team Explorer) o Visual Studio Team Explorer 2017 gratuitamente.

Prerequisiti

Per il progetto in cui sono definiti i tipi di elemento di lavoro, è necessario disporre delle autorizzazioni seguenti:

• Per esportare o elencare i tipi di elementi di lavoro, è necessario essere membri del gruppo Project Administrators o disporre dell'autorizzazione Visualizza informazioni a livello di progetto impostata su Consenti.
• Per eliminare definitivamente, importare o rinominare i tipi di elementi di lavoro, è necessario essere membri del gruppo di sicurezza Amministratori di Team Foundation o del gruppo di sicurezza Project Administrators .

Per altre informazioni, vedere Modificare le autorizzazioni a livello di raccolta del progetto.

Sintassi

witadmin destroywitd /collection:CollectionURL /p:Project /n:TypeName [/noprompt]   
witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName [/f:FileName] [/e:Encoding] [/exportgloballists]  
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

Osservazioni:

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

• Tipo di elemento di lavoro
• Tutti gli elementi di lavoro di quel tipo
• Voci corrispondenti nelle tabelle degli elementi di lavoro, nelle tabelle di testo lunghe e nelle tabelle di collegamento
• Oggetti nella cache dei metadati dei tipi di elemento di lavoro

Esempi

Se non diversamente specificato, i valori seguenti si applicano in ogni esempio:

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

Esportare la definizione di un WIT

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

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

Nell'esempio seguente viene esportato l'elemento di lavoro 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 WIT e dei relativi elenchi globali a cui si fa riferimento

Nell'esempio seguente viene esportato 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 WIT

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 di wit

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 un WIT

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/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks /v  

Domande e risposte

D: Quali personalizzazioni è possibile apportare e usare la Configurazione guidata funzionalità per aggiornare il progetto dopo un aggiornamento?

R: È possibile aggiungere wit personalizzati e modificare il layout del modulo. La Configurazione guidata funzionalità aggiornerà i progetti e si otterrà l'accesso alle funzionalità più recenti.

La modifica del flusso di lavoro o la ridenominazione di un WIT potrebbe richiedere l'esecuzione di alcune operazioni manuali durante l'aggiornamento del progetto. Per informazioni sulle personalizzazioni che è possibile apportare in modo sicuro e su quali evitare, vedere Personalizzare l'esperienza di rilevamento del lavoro: prima di personalizzare, comprendere le implicazioni di manutenzione e aggiornamento.

D: Ricerca per categorie modificare il colore associato a un WIT?

R: Nel portale Web gli elementi di lavoro vengono visualizzati nei risultati delle query e nelle pagine backlog e bacheca degli strumenti di pianificazione Agile. Per modificare il colore associato a un WIT esistente o aggiungere il colore da utilizzare per un nuovo WIT, modificare la configurazione del processo.

D: Ricerca per categorie disattivare o disabilitare un WIT? Ricerca per categorie impedire agli utenti di creare elementi di lavoro di un determinato tipo?

R: Se si dispone di un tipo di elemento di lavoro che si desidera ritirare, ma mantenere gli elementi di lavoro creati in base a tale tipo, è possibile aggiungere una regola che disabilita tutti gli utenti validi dal salvataggio del tipo di elemento di lavoro.

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

Per limitare la creazione di un WIT specifico a un gruppo di utenti, esistono due modi per limitare l'accesso:

• Aggiungere il WIT al gruppo Categorie nascoste per impedire la creazione della maggior parte dei collaboratori. Se si desidera consentire l'accesso a un gruppo di utenti, è possibile creare un collegamento ipertestuale a un modello che apre il modulo dell'elemento di lavoro e condividere tale collegamento con i membri del team che si desidera creare.
• Aggiungere una regola di campo al flusso di lavoro per il campo System.CreatedBy per limitare in modo efficace un gruppo di utenti alla creazione di un elemento di lavoro di un tipo specifico. Come illustrato nell'esempio seguente, l'utente che crea l'elemento di lavoro deve appartenere a Allowed Group per salvare l'elemento di lavoro.

<TRANSITION from=" " to="New">  
   <FIELDS>  
     <FIELD refname="System.CreatedBy">  
         <VALIDUSER for="Allowed Group" not="Disallowed Group" />  
     </FIELD>  
   </FIELDS>  
</TRANSITION>  

D: Ricerca per categorie eliminare un WIT?

R: Per impedire ai membri del team di usare un WIT specifico per creare un elemento di lavoro, è possibile rimuoverlo dal progetto. Quando si usa witadmin destroywitd, si rimuovono definitivamente tutti gli elementi di lavoro creati usando tale WIT e il WIT stesso. Ad esempio, se il team non usa Ostacoli, è possibile eliminare il WIT con etichetta Ostacoli dal progetto sito Web Fabrikam.

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

Quando si elimina un WIT appartenente a una categoria, è necessario aggiornare la definizione delle categorie per il progetto in modo che rifletta il nuovo nome. In particolare, gli strumenti di pianificazione Agile non funzioneranno finché non si aggiorna la definizione delle categorie.

Per altre informazioni, vedere Importare ed esportare categorie.

Articoli correlati

• Personalizzare l'esperienza di rilevamento del lavoro
• Indice del campo dell'elemento di lavoro
• witAdmin: Personalizzare e gestire gli oggetti per tenere traccia del lavoro