Importa e aggiorna elementi di lavoro in blocco con file CSV
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Importare ed esportare elementi di lavoro in blocco usando un file in formato CSV in Azure DevOps. 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.
Nota
La funzionalità di esportazione è disponibile con Azure DevOps Server 2019 Update 1 e versioni successive. La funzionalità di importazione è disponibile con Azure DevOps Server 2020 e Azure DevOps Services.
Importare nuovi elementi di lavoro
Tutti gli elementi di lavoro importati vengono creati in uno stato Nuovo . Questa regola significa che non è possibile specificare valori di campo che non soddisfano le regole di campo per il nuovo stato. Ad esempio, quando si crea una nuova storia utente con il processo Agile, state = New e Reason = New. Non è possibile specificare altri valori.
Creare un file import.csv locale e aprirlo in Visual Studio Code o Excel.
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.
Nell'esempio seguente viene incluso il campo Priorità .
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,2Dal portale Web per il progetto aprire Boards - Query e quindi selezionare l'opzione Importa elementi di lavoro.
Selezionare il file CSV e quindi scegliere Importa.
Il processo di importazione carica gli elementi di lavoro importati nella visualizzazione query in uno stato non salvato . Nessun ID assegnato.
Verificare i risultati e quindi selezionare Salva elementi per salvare gli elementi di lavoro.
Suggerimento
Non assegnare ID ai nuovi elementi di lavoro che si stanno aggiungendo. In caso contrario, verrà visualizzato un messaggio di errore.
TFS401232: l'elemento di lavoro 1794 non esiste o non si dispone delle autorizzazioni per leggerlo.
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 è stato immesso un valore non valido nel campo Priorità. 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.
Suggerimento
È possibile aggiungere collegamenti padre-figlio tra gli elementi di lavoro importati rientrando le colonne del titolo, come illustrato nell'esempio riportato più avanti in questo articolo, È possibile importare un file CSV con collegamenti padre-figlio?. Tuttavia, non è possibile specificare altri tipi di collegamento durante l'importazione o l'aggiornamento degli elementi di lavoro.
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.
Aggiornare gli elementi di lavoro esistenti
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.
Il file esportato dovrebbe essere simile alla sintassi seguente:
ID,Work Item Type,State,Assigned To,Title,Tags "1043","Issue","To Do",,"Fix issues with code", "1044","Issue","To Do",,"Merge testing modules", "1045","Issue","To Do",,"Open private preview for select customers", "1046","Issue","To Do",,"Enable feature for customer champs", "1047","Issue","To Do",,"Remove old test code",Apportare le modifiche agli elementi di lavoro. Il file CSV deve contenere i campi ID, Tipo elemento di lavoro, Titolo e Stato . 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 diversi valori per gli elementi di lavoro esistenti.
"1043","Issue","To Do","Jamal Hartnett <fabrikamfiber4@hotmail.com>","Fix issues with code",architecture "1044","Issue","To Do","Jamal Hartnett <fabrikamfiber4@hotmail.com>","Merge testing modules",testing "1045","Issue","To Do","Raisa Pokrovskaya <fabrikamfiber5@hotmail.com>","Open private preview for select customers","customer focus" "1046","Issue","To Do","Raisa Pokrovskaya <fabrikamfiber5@hotmail.com>","Enable feature for customer champs","customer focus" "1047","Issue","To Do","Christie Church <fabrikamfiber1@hotmail.com>","Remove old test code",architecture```Salvare il file e l'importazione (vedere i passaggi da 4 a 6 della sezione di importazione precedente).
L'elenco dei risultati con elementi di lavoro contenenti modifiche al valore viene visualizzato in grassetto. Selezionare Salva elementi per applicare le modifiche.
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.
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.
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 o aggiornare campi RTF
È possibile aggiornare o importare campi RTF, ad esempio i campi Descrizione o Criteri di accettazione. I campi RTF sono campi in formato HTML. Sostituire le righe che terminano in CRLF racchiudendo le frasi 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> You can include bold text</strong></p><p><em> And italic text</em></p><p><u> Underline text</u></p>"
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",
D: Ricerca per categorie aggiungere più tag?
R: È possibile aggiungere più tag separati da un punto e virgola. Per altre informazioni, vedere Attività che è possibile e non è possibile eseguire con Excel.
D: È possibile importare un file CSV con collegamenti padre-figlio?
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",
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.
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 esegue l'importazione tramite CSV, per motivi di prestazioni, la selezione identità non esegue questi passaggi aggiuntivi. Verifica solo se nell'organizzazione è già presente un 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.
Articoli correlati
Commenti e suggerimenti
Presto disponibile: nel corso del 2024 verranno dismessi i problemi di GitHub come meccanismo di feedback per il contenuto e verranno sostituiti con un nuovo sistema di feedback. Per altre informazioni, vedere: https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per