Nota
L'accesso a questa pagina richiede l'autorizzazione. Puoi provare ad accedere o a cambiare directory.
L'accesso a questa pagina richiede l'autorizzazione. Puoi provare a cambiare directory.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Importante
Per il modello di processo XML locale, è possibile usare witadmin per elencare, importare, esportare e modificare un processo per un progetto. Per i modelli di processo XML ereditati e ospitati, è possibile usare witadmin solo per elencare ed esportare le informazioni sul processo. Per una panoramica dei modelli di processo e delle funzionalità supportate, vedere Personalizzare l'esperienza di rilevamento del lavoro.
Lo strumento da riga di comando witadmin consente di personalizzare il rilevamento del lavoro creando, eliminando, importando ed esportando oggetti come tipi di elemento di lavoro, categorie, elenchi globali, flusso di lavoro globale e tipi di collegamento. È anche possibile gestire gli attributi dei campi dell'elemento di lavoro.
Per Azure DevOps Server locale, è anche possibile gestire i tipi di risoluzione, il tipo di bug e i tipi di errore usati con la gestione dei test case usando il comando tcm fieldmapping .
Il diagramma seguente illustra l'ambito degli oggetti di rilevamento del lavoro. Le categorie e i tipi di elemento di lavoro vengono gestiti a livello di progetto. Gli elenchi globali, i tipi di collegamento e i campi degli elementi di lavoro vengono gestiti a livello di raccolta di progetti. Il flusso di lavoro globale può essere personalizzato per un progetto o una raccolta.
Per eseguire la maggior parte dei comandi witadmin, è necessario essere membri del gruppo Project Administrators o Project Collection Administrators . Per altre informazioni, vedere Modifica autorizzazioni a livello di raccolta di progetti.
Eseguire lo strumento da riga di comando witadmin
Lo strumento da riga di comando witadmin viene installato con Visual Studio. Aprire una finestra del prompt dei comandi e passare alla directory in cui è installato Visual Studio. È anche possibile installare l'edizione gratuita di Visual Studio Community .
Nota
Per Azure DevOps Services, usare la versione più recente di Visual Studio.
Nota
Per Azure DevOps Server locale, usare la stessa versione o successiva di Visual Studio. Ad esempio, usare Visual Studio 2019 o versione successiva per connettersi ad Azure DevOps Server 2019.
%programfiles(x86)%\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
Sostituire Community con Professional o Enterprise, a seconda della versione installata.
In un'edizione a 32 bit di Windows sostituire %programfiles(x86)% con %programfiles%.
Parametri globali
I parametri seguenti visualizzano il testo della Guida per i comandi witadmin.
| Parametro | Descrizione |
|---|---|
/? oppure help |
Visualizza la sintassi e i parametri per lo strumento da riga di comando witadmin. |
command /help oppure command /? |
Visualizza la sintassi e i parametri per il comando witadmin specificato. |
File di definizione XML
Gli oggetti di rilevamento del lavoro vengono personalizzati aggiornando le definizioni XML. Gli oggetti includono tipi di elementi di lavoro, configurazione dei processi, elenchi globali e tipi di collegamento. Per una panoramica delle opzioni di personalizzazione, vedere Personalizzare l'esperienza di rilevamento del lavoro.
È possibile eseguire comandi witadmin su Azure DevOps Services o Azure DevOps Server. Azure DevOps Services supporta tuttavia solo i comandi che elencano o esportano le definizioni. Le operazioni di importazione e modifica sono disponibili solo per Azure DevOps Server.
Tipi di elemento di lavoro
I tipi di elementi di lavoro definiscono i campi e il flusso di lavoro per il rilevamento del lavoro. I tipi disponibili dipendono dal processo del progetto (Agile, Scrum, Basic o CMMI). Per altre informazioni, vedere Informazioni sugli elementi di lavoro.
Per il modello di processo ereditato, gestire i tipi di elemento di lavoro dal portale Web. Per altre informazioni, vedere Aggiungere e gestire i tipi di elementi di lavoro.
Comando
Servizi di Azure DevOps
Azure DevOps Server
destroywitd: eliminare un tipo di elemento di lavoro
✔️
exportwitd: esportare un file di tipo elemento di lavoro
✔️
✔️
importwitd: importare un file di tipo elemento di lavoro
✔️
listwitd: elencare i tipi di elemento di lavoro
✔️
✔️
renamewitd: modificare il nome visualizzato per un tipo di elemento di lavoro
✔️
Campi
I campi archiviano lo stato e le informazioni negli elementi di lavoro. I campi vengono definiti a livello di organizzazione o raccolta. Per altre informazioni, vedere Campi e attributi dell'elemento di lavoro e indice dei campi elemento di lavoro.
Per il modello di processo ereditato, gestire i campi dal portale Web. Per altre informazioni, vedere Aggiungere e gestire i campi.
Comando
Servizi di Azure DevOps
Azure DevOps Server
deletefield: eliminare un campo
✔️
listfields: elencare gli attributi dei campi
✔️
✔️
changefield: Modificare un attributo di campo
✔️
renamewitd: Modificare un nome visualizzato WIT
✔️
Categorie
Le categorie raggruppano uno o più tipi di elementi di lavoro. Azure Boards usa definizioni di categoria per determinare quali tipi di elementi di lavoro vengono visualizzati nei backlog e nelle schede. Per altre informazioni, vedere Usare le categorie per raggruppare i tipi di elementi di lavoro.
Comando
Servizi di Azure DevOps
Azure DevOps Server
exportcategories: esportare il file categorie
✔️
✔️
importcategories: importare il file Categorie
✔️
Tipi di collegamento
I tipi di collegamento definiscono le relazioni tra elementi di lavoro, ad esempio padre-figlio o correlato. È possibile definire tipi di collegamento personalizzati per i modelli di processo XML e XML ospitati locali. Per altre informazioni, vedere Collegare elementi di lavoro e Informazioni di riferimento sul tipo di collegamento.
Comando
Servizi di Azure DevOps
Azure DevOps Server
deletelinktype: eliminare un tipo di collegamento
✔️
exportlinktype: esportare un file di tipo collegamento
✔️
✔️
importlinktype: importare un file di tipo collegamento
✔️
listlinktypes: elencare i tipi di collegamento definiti
✔️
✔️
reactivatelinktype: riattivare o rinominare un tipo di collegamento
✔️
Elenchi globali
Gli elenchi globali sono elenchi di selezione riutilizzabili a cui è possibile fare riferimento in più campi e definizioni dei tipi di elemento di lavoro in una raccolta di progetti. Definire elenchi globali utilizzando l'elemento XML GLOBALLIST . Per altre informazioni, vedere Informazioni di riferimento sugli elementi XML GLOBALLIST.
Comando
Servizi di Azure DevOps
Azure DevOps Server
destroygloballist: eliminare un elenco globale
✔️
exportgloballist: esportare l'elenco globale
✔️
✔️
importgloballist: importare l'elenco globale
✔️
listgloballist: elencare tutti i nomi di elenco globale
✔️
✔️
Flusso di lavoro globale
Il flusso di lavoro globale definisce i campi e gli elenchi globali che si applicano a tutti i tipi di elemento di lavoro in un progetto o una raccolta. Per altre informazioni, vedere Informazioni di riferimento sugli elementi XML del flusso di lavoro globali.
Comando
Servizi di Azure DevOps
Azure DevOps Server
exportglobalworkflow: esportare il file del flusso di lavoro globale
✔️
importglobalworkflow: importare il file del flusso di lavoro globale
✔️
Configurazione del processo
La configurazione del processo definisce i tipi di elemento di lavoro visualizzati nei backlog, nelle bacheche, nei backlog sprint e nelle schede attività. Controlla anche le colonne predefinite e altre funzionalità del team. Per ulteriori informazioni, vedere il riferimento all'elemento XML ProcessConfiguration.
Per il modello di processo ereditato, personalizzare i backlog dal portale Web. Per altre informazioni, vedere Personalizzare backlog e bacheche.
Comando
Servizi di Azure DevOps
Azure DevOps Server
exportprocessconfig: esportare il file ProcessConfiguration
✔️
✔️
importprocessconfig: importare il file ProcessConfiguration
✔️
Cache client
Dopo le operazioni di manutenzione del server, ad esempio lo spostamento, il ripristino, la ridenominazione o il failover dei server, è necessario aggiornare la cache client. Questo comando è disponibile solo per Azure DevOps Server.
-
rebuildcache: ricompila la cache client per il rilevamento degli elementi di lavoro
Mapping dei campi di gestione dei test case
Personalizzare i tipi di risoluzione, il tipo di elemento di lavoro di bug e i tipi di errore usati con i piani di test di Azure. Questo comando è disponibile solo per Azure DevOps Server.
-
tcm fieldmapping: importa o esporta il file che definisce tipi di risoluzione, tipo di bug o tipi di errore per la gestione dei test case