Condividi tramite

Importare, aggiornare ed esportare elementi di lavoro in blocco con file CSV in Azure Boards

  • Articolo

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

Importare ed esportare elementi di lavoro in blocco usando file in formato CSV in Azure Boards. Sebbene sia possibile continuare a usare Excel per l'importazione e gli aggiornamenti in blocco, è possibile usare la funzionalità di importazione/esportazione nativa che non richiede Excel. Per altre informazioni, vedere Aggiungere o modificare in blocco elementi di lavoro con Excel.

È possibile esportare gli elementi di lavoro in blocco usando un file in formato CSV. Mentre si continua a usare Excel per l'importazione e gli aggiornamenti in blocco, è possibile usare la funzionalità di esportazione nativa da query che non richiedono Excel. Per altre informazioni, vedere Aggiungere o modificare in blocco elementi di lavoro con Excel.

Importare nuovi elementi di lavoro

Per importare elementi di lavoro in blocco, il file CSV deve contenere i campi Tipo elemento di lavoro e Titolo . È possibile includere altri campi in base alle esigenze. Per importare un file CSV:

  • Non includere il campo ID .
  • Se il file CSV è stato esportato da un progetto diverso, rimuovere i campi che contengono un valore specifico per il progetto di origine. Ad esempio, per rimuovere percorso area, tag per un elenco di campi predefiniti, vedere Indice dei campi dell'elemento di lavoro.
  • Quando si importano test case, è necessario includere il campo Passaggi di test. Per altre informazioni, vedere Test case di importazione o esportazione in blocco. Non includere i campi Assegnato a, Data modificata, Creato da o Stato .
  • Assicurarsi che i campi Tipo elemento di lavoro e Titolo siano inclusi nel file CSV.
  • Verificare che il tipo di elemento di lavoro sia un tipo valido nel progetto di destinazione.
  • Assicurarsi che i campi nel file CSV corrispondano ai campi fi=o al tipo di elemento di lavoro nel progetto di destinazione.
  • Se si importa un file CSV contenente elementi di lavoro con valori non validi, dopo aver importato il file, è necessario modificare gli elementi di lavoro per correggere i valori non validi prima di poter salvare gli elementi di lavoro.

Per importare nuovi elementi di lavoro, seguire questa procedura.

Nota

È possibile importare fino a 1.000 elementi di lavoro alla volta. Se sono presenti più di 1.000 elementi di lavoro da importare, suddividerli in più file e importarli separatamente.

  1. Creare un file import.csv locale e aprirlo in Visual Studio Code o Excel.

  2. Il file deve contenere i campi Tipo elemento di lavoro e Titolo . È possibile includere altri campi in base alle esigenze. Per un elenco dei campi predefiniti, vedere Indice dei campi dell'elemento di lavoro.

    L'esempio seguente include il campo Priority .

    Work Item Type,Title,Priority
Issue,Fix issues with code,1
Issue,Merge testing modules,3
Issue,Open private preview for select customers,2
Issue,Enable feature for customer champs,2
Issue,Remove old test code,2

  3. Dal portale Web per il progetto aprire Boards Queries (Query boards>) e quindi selezionare Import work items (Importa elementi di lavoro).

    Screenshot che mostra la pagina Boards con Query e quindi Importa elementi di lavoro selezionati.

  4. Selezionare Scegli file, scegliere il file e quindi selezionare Importa.

    Screenshot che mostra la finestra di dialogo Importa elementi di lavoro con il pulsante Importa evidenziato.

    Il processo di importazione carica gli elementi di lavoro importati nella visualizzazione query in uno stato non salvato . Nessun ID assegnato.

  5. Verificare i risultati e quindi selezionare Salva elementi per salvare gli elementi di lavoro.

    Screenshot che mostra Salva elementi per gli elementi di lavoro importati.

    Suggerimento

    Non assegnare ID ai nuovi elementi di lavoro aggiunti. L'assegnazione di ID genera un messaggio di errore.

  6. Il sistema evidenzia gli elementi di lavoro con problemi di dati. Risolvere i problemi relativi ai dati prima di salvare gli elementi di lavoro. In questo esempio, un valore non valido si trova nel campo Priority. Correggere i dati aprendo direttamente l'elemento di lavoro. Usare invece la modifica in blocco per risolvere diversi elementi di lavoro con lo stesso problema.

    Screenshot che mostra gli elementi di lavoro con problemi di dati da risolvere.

I suggerimenti seguenti possono essere utili.

  • Collegamenti padre-figlio: è possibile aggiungere collegamenti padre-figlio tra elementi di lavoro importati rientrando le colonne del titolo, come illustrato in È possibile importare un file CSV con collegamenti padre-figlio?. Tuttavia, non è possibile specificare altri tipi di collegamento quando si importano o aggiornano gli elementi di lavoro.

  • Campo Stato predefinito: quando si importano nuovi elementi di lavoro, il campo Stato è impostato su Nuovo per impostazione predefinita. Non è possibile specificare uno stato diverso durante il processo di importazione. Se è necessario modificare lo stato degli elementi di lavoro importati, usare la soluzione alternativa seguente:

    1. Importare gli elementi di lavoro con lo stato Nuovo predefinito.
    2. Esportare gli elementi di lavoro importati in un file CSV.
    3. Aggiornare i valori del campo Stato nel file CSV esportato.
    4. Reimportare il file CSV aggiornato per impostare gli stati desiderati.

  • Campi area e iterazione predefiniti: per impostazione predefinita i campi Area e Iterazione sono i nodi di primo livello. Questo comportamento si verifica perché il processo di importazione non ha il contesto per questi campi, a meno che non venga specificato in modo esplicito nel file CSV. Per impostare percorsi specifici di area e iterazione durante l'importazione, assicurarsi che questi campi siano inclusi nel file CSV con i valori corretti. Ad esempio:

    Title,Description,Area Path,Iteration Path
"Sample Work Item","This is a sample description.","Project\Team","Project\Sprint 1"

Aggiornare gli elementi di lavoro esistenti

  1. Per aggiornare gli elementi di lavoro, creare una query contenente tutte le colonne da esportare ed eventualmente modificare. Salvare la query e selezionare Esporta in CSV per salvare il file data.csv nel computer locale.

    Screenshot che mostra gli elementi di lavoro in una query con l'opzione Esporta in CSV selezionata.

    Il file esportato dovrebbe essere simile all'esempio seguente:

    ID,Work Item Type,Title,Assigned To,State,Tags
"272","Issue","Fix issues with code","Active","",
"273","Issue","Merge testing modules","Active","",
"274","Issue","Open private preview for select customers","Active","",
"275","Issue","Enable feature for customer champs","Active","",
"276","Issue","Remove old test code","Active","",

  2. Apportare le modifiche agli elementi di lavoro. Il file CSV deve contenere i campi ID, Tipo elemento di lavoro e Titolo . Tutti gli altri campi da includere sono facoltativi.

    Nota

    Quando si importano i campi identity, immettere il nome e il messaggio di posta elettronica nel formato "Display Name <email>"seguente. Ad esempio, per assegnare il lavoro a Jamal Hartnett, specificare "Jamal Hartnett <fabrikamfiber4@hotmail.com>". Se si specifica un valore non riconosciuto come utente valido per il sistema, è possibile che si verifichino problemi con l'importazione.

    Nell'esempio seguente vengono modificati i valori per gli elementi di lavoro esistenti.

    ID,Work Item Type,Title,Assigned To,State,Tags
"272","Issue","Fix issues with code","Jamal Hartnett <fabrikamfiber4@hotmail.com>","Active",
"273","Issue","Merge testing modules","Jamal Hartnett <fabrikamfiber4@hotmail.com>","Active",
"274","Issue","Open private preview for select customers","Raisa Pokrovskaya <fabrikamfiber5@hotmail.com>","Active",
"275","Issue","Enable feature for customer champs","Raisa Pokrovskaya <fabrikamfiber5@hotmail.com>","Active",
"276","Issue","Remove old test code","Christie Church <fabrikamfiber1@hotmail.com>","Active",

  3. Salvare il file e importare, come descritto nella sezione precedente.

  4. L'elenco dei risultati con elementi di lavoro contenenti modifiche al valore viene visualizzato in grassetto. Selezionare Salva elementi per applicare le modifiche.

    Screenshot che mostra l'opzione Importa elementi di lavoro con l'opzione Salva elementi.

  5. Gli elementi di lavoro con problemi di dati vengono evidenziati in rosso e devono essere risolti prima di poterli salvare. In questo esempio viene visualizzato un valore non valido nel campo Assegnato a. Correggere i dati aprendo direttamente l'elemento di lavoro. È possibile usare la modifica in blocco se sono presenti molti elementi di lavoro con lo stesso problema.

    Screenshot che mostra un valore non valido visualizzato nel campo Assegnato a.

Esportare l'elenco come file CSV

Da qualsiasi query è possibile esportare un elenco di elementi di lavoro come elenco delimitato da virgole. Aprire la query, selezionare l'icona azioni e quindi selezionare Esporta in CSV.

Nota

Richiede Azure DevOps Server 2019 Update 1 o versione successiva.

Screenshot che mostra l'esportazione di una query come CSV.

Esportare e importare elementi di lavoro in un progetto diverso

È possibile usare questa funzionalità per esportare gli elementi di lavoro da un progetto e importarli in un altro progetto. Tuttavia, prima di importarli in un altro progetto, è necessario rimuovere l'ID dell'elemento di lavoro. Viene visualizzato un errore se si tenta di importare nuovi elementi di lavoro in un progetto con un ID specificato.

Importare campi HTML

I campi HTML, ad esempio descrizioni e criteri di accettazione, includono la formattazione rtf. Per assicurarsi che questa formattazione venga mantenuta, eseguire le attività seguenti:

  1. Assicurarsi che il file CSV includa tag HTML all'interno dei campi pertinenti.
  2. Importare il file CSV in Excel.

Excel potrebbe gestire campi di testo su più righe in modo diverso, quindi è importante controllare la formattazione dopo l'importazione. Sostituire le righe che terminano CRLF con le frasi circostanti con <p>... </p>.

Ad esempio, è possibile importare l'elemento di lavoro seguente, che include tre righe di testo nel campo Descrizione .

Work Item Type,Title,Description
"Product Backlog Item","Hello World Web Site - 8","<p><strong>&nbsp;You can include bold text</strong></p><p><em>&nbsp;And italic text</em></p><p><u>&nbsp;Underline text</u></p>"

Convertire campi su più righe in testo non crittografato

Per disabilitare il codice HTML nei campi a più righe per assicurarsi che siano testo non crittografato, è possibile usare il witadmin changefield comando . Per altre informazioni, vedere Gestire i campi degli elementi di lavoro.

Comando di esempio:

witadmin changefield /collection:CollectionURL /n:FieldName /type:PlainText

Gestire le incoerenze di formattazione

Quando si lavora con campi HTML in diversi prodotti Microsoft, è possibile che si verifichino incoerenze di formattazione. Ecco alcuni suggerimenti per gestire questi problemi:

  • Esaminare la formattazione dopo l'importazione per assicurarsi che soddisfi i requisiti.
  • Usare tag e strutture HTML appropriati per ridurre al minimo le discrepanze. È possibile aggiungere più tag separati da un punto e virgola. Per altre informazioni, vedere Attività che è possibile e non è possibile eseguire con Excel.

Per altre informazioni sulla gestione del contenuto HTML e sulla compatibilità, vedere Fornire testo della Guida, collegamenti ipertestuali o contenuto Web in un modulo di un elemento di lavoro.

Domande frequenti

D: È possibile importare nuovi elementi e aggiornare gli elementi esistenti nello stesso file CSV?

R: Assolutamente! Lasciare vuoto il campo ID per tutti i nuovi elementi di lavoro. Nell'esempio seguente l'ultima voce per un'epica non specifica un ID.

ID,Work Item Type,Title,Assigned To,State,Priority,Tags
"16504","Issue","Fix issues with code",,"To Do","1",
"16505","Issue","Merge testing modules",,"To Do","3",
"16506","Issue","Open private preview for select customers",,"To Do","2",
"16507","Issue","Enable feature for customer champs",,"To Do","2",
"16508","Issue","Remove old test code",,"To Do","2",
,"Epic","Track Telemetry for data imports",,"To Do","2",

R: Sì, è possibile aggiungere elementi di lavoro figlio rientrando le colonne del titolo. Nell'esempio seguente vengono aggiunti tre problemi figlio nell'epica già definita.

ID,Work Item Type,Title 1,Title 2,Assigned To,State,Priority,Tags
"165","Epic","Track Telemetry for data imports",,,"To Do","2",
,"Issue",,"Fix issues with code",,"To Do","1",
,"Issue",,"Open private preview for select customers",,"To Do","2",
,"Issue",,"Enable feature for customer champs",,"To Do","2",

Screenshot che mostra la visualizzazione excel.

D: Ricerca per categorie sapere se il file importato presenta errori?

R: È possibile testare aggiungendo tag con spazi e trattini, ad esempio e includerlo nell'esportazione. L'importazione deve corrispondere allo stesso formato. Eventuali problemi con la formattazione del file CSV vengono visualizzati nella pagina Risultati della visualizzazione di importazione. Non è possibile importare gli elementi di lavoro finché la formattazione e la sintassi non sono corrette.

Screenshot che mostra un errore CSV nella pagina Importa elementi di lavoro.

I risultati dell'elemento di lavoro elencano sempre gli errori di dati trovati per singoli elementi di lavoro. Correggere ogni errore dal portale Web o nel file CSV e importare di nuovo.

D: Perché si ricevono errori per alcuni valori Identity?

R: Quando si usa l'interfaccia utente Web, la selezione identità esegue passaggi aggiuntivi per convalidare l'utente. Prima di tutto verifica se la persona è un utente valido nell'organizzazione. In caso contrario, cerca l'identità in Microsoft Entra ID. Se l'utente si trova in Microsoft Entra ID ma non nell'organizzazione, tale utente viene aggiunto alle identità valide.

Quando si importa da CSV, per motivi di prestazioni, la selezione identità non esegue questi passaggi aggiuntivi. Verifica solo se nell'organizzazione è già presente un nome dell'entità utente (UPN) corrispondente. Se non trova un UPN corrispondente, segnala che l'identità è sconosciuta.

D: L'importazione CSV supporta tutti i tipi di elementi di lavoro?

R: No, l'importazione CSV non supporta i tipi di elemento di lavoro seguenti:

  • Richiesta di revisione codice
  • Risposta alla revisione del codice
  • Richiesta feedback
  • Risposta feedback
  • Test case
  • Piano di test
  • Gruppo di test
  • Parametro condiviso

Per altre informazioni, vedere Test case di importazione o esportazione in blocco.