witAdmin: Personalizzare e gestire gli oggetti per tenere traccia del lavoro
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
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.
È possibile modificare il modo in cui si tiene traccia dello stato di avanzamento del team creando e personalizzando gli oggetti che tengono traccia degli elementi di lavoro. Usando lo strumento da riga di comando witadmin , è possibile creare, eliminare, importare ed esportare oggetti come categorie, elenchi globali, flusso di lavoro globale, tipi di collegamenti e tipi di elementi di lavoro. È anche possibile eliminare, elencare o modificare gli attributi dei campi dell'elemento di lavoro.
Inoltre, per i server Azure DevOps locali, è possibile gestire i tipi di risoluzione, i bug e i tipi di errore usati con la gestione dei test case con il comando fieldmapping tcm.
Come illustrato nella figura seguente, si gestiscono categorie e tipi di elementi di lavoro e per ogni progetto. È possibile gestire elenchi globali, tipi di collegamenti e campi nell'elemento di lavoro per ogni raccolta di progetti. È possibile personalizzare il flusso di lavoro globale per un progetto o una raccolta.
Per la maggior parte dei comandi, è necessario essere membri dei gruppi Project Administrators o Project Collection Administrators. Per altre informazioni, vedere Modifica autorizzazioni a livello di raccolta di progetti.
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.
Nota
Per connettersi ad Azure DevOps Services, è consigliabile usare la versione più recente di Visual Studio o Visual Studio Community.
Nota
Per connettersi a un server locale, è consigliabile usare la stessa versione di Visual Studio o successiva di Azure DevOps Server. Ad esempio, se ci si connette ad Azure DevOps Server 2019, connettersi al progetto da una versione di Visual Studio 2019.
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.
Parametri globali
È possibile usare i parametri seguenti per visualizzare il testo della Guida per witadmin.
| Parametro | Descrizione |
|---|---|
/? oppure help |
Visualizza la sintassi e i parametri per lo strumento da witadmin riga di comando. |
command /helpor command /? |
Visualizza la sintassi e i parametri per il witadmin comando specificato. |
File di definizione XML
È possibile personalizzare tutti gli oggetti di rilevamento del lavoro, ad esempio i tipi di elemento di lavoro, la configurazione del processo, gli elenchi globali, aggiornando le definizioni XML. Se non si ha familiarità con la personalizzazione del rilevamento del lavoro, vedere Personalizzare l'esperienza di rilevamento del lavoro.
Si eseguono comandi witadmin in Azure DevOps Services o in un server Azure DevOps locale. Come illustrato negli elenchi di comandi seguenti, per Azure DevOps Services sono supportati solo i comandi witadmin che elencano o esportano i file.
Tipi di elemento di lavoro
Gli elementi di lavoro vengono usati per tenere traccia di tutto ciò che è necessario tenere traccia. Ogni elemento di lavoro è basato su un tipo di elemento di lavoro. Ogni tipo di elemento di lavoro definisce i campi disponibili in cui archiviare le informazioni. I tipi di elemento di lavoro disponibili dipendono dal processo usato al momento della creazione del progetto (Agile, Scrum, Basic o CMMI). Per altre informazioni, vedere Tenere traccia degli elementi di lavoro nelle storie utente di Azure Boards, problemi, bug, funzionalità ed epiche.
Per il modello di processo ereditato, è possibile aggiungere ed eliminare tipi di elemento di lavoro dal portale Web. Per altre informazioni, vedere Aggiungere e gestire i tipi di elemento di lavoro (processo di ereditarietà).
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 vengono usati per tenere traccia dello stato e delle informazioni associate agli elementi di lavoro. I campi vengono definiti per un'organizzazione o una raccolta. Per altre informazioni, vedere Campi e attributi dell'elemento di lavoro. Per cercare la descrizione di un campo specifico, vedere Descrizioni dei campi per i campi predefiniti e degli elementi di lavoro usati nei modelli di processo.
Per il modello di processo ereditato, è possibile visualizzare ed eliminare campi dal portale Web. Per altre informazioni, vedere Aggiungere e gestire campi (processo di ereditarietà).
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 associano uno o più tipi di elemento di lavoro appartenenti alla stessa categoria. Azure Boards si basa sulle definizioni di categoria predefinite, molte delle quali specificano un singolo tipo di elemento di lavoro per categoria. 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
Usare tipi di collegamento diversi per gestire le varie relazioni tra gli elementi di lavoro. Per i modelli di processo XML locale e XML ospitato, è possibile definire tipi di collegamento personalizzati. Per altre informazioni, vedere Collegare elementi di lavoro ad altri oggetti e Guida di riferimento per i tipi di collegamento.
Comando
Servizi di Azure DevOps
Azure DevOps Server
deletelinktype: eliminare un tipo di collegamento
✔️
exportlinktype: esportare 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 che è possibile includere all'interno di uno o più campi e definizioni dei tipi di elemento di lavoro. È possibile condividere elementi di elenco tra diversi tipi di elementi di lavoro per una raccolta di progetti includendo gli elementi di elenco in uno o più elementi 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
Con il flusso di lavoro globale, è possibile definire e aggiornare campi e elenchi globali applicabili 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 le funzionalità di configurazione e funzionalità predefinite a cui i team possono accedere tramite Azure Boards. La configurazione determina i tipi di elemento di lavoro visualizzati nel backlog del prodotto, nei backlog sprint, nelle bacheche e nelle schede attività. Per altre informazioni sulla configurazione del processo e su cosa è possibile personalizzare, vedere Configurazione del processo.
Per il modello di processo ereditato, è possibile personalizzare i backlog dal portale Web. Per altre informazioni, vedere Personalizzare i backlog o le bacheche (processo di ereditarietà).
Comando
Servizi di Azure DevOps
Azure DevOps Server
exportprocessconfig: esportare il file ProcessConfiguration
✔️
✔️
importprocessconfig: importare il file ProcessConfiguration
✔️
Cache client
Dopo alcune operazioni di manutenzione, i computer client richiedono un aggiornamento della cache. Dopo lo spostamento, il ripristino, la ridenominazione o il failover di un server livello dati o di livello applicazione, è necessario aggiornare la cache per tenere traccia degli elementi di lavoro e gli utenti devono aggiornare la cache di controllo della versione nei computer client.
Il comando seguente witadmin è disponibile solo per Azure DevOps Server locale.
rebuildcache: ricompilare la cache client
Mapping dei campi di gestione dei test case
Per personalizzare i tipi di risoluzione, il tipo di elemento di lavoro dei bug e i tipi di errore usati quando si usano i piani di test di Azure, è possibile usare il comando tcm seguente. Questo comando è disponibile solo per le versioni locali di Azure DevOps Server.
tcm fieldmapping: importare o esportare un file che definisce i tipi di risoluzione, i bug o i tipi di errore da usare con la gestione dei test case.