Importar, atualizar e exportar itens de trabalho em massa com arquivos CSV no Azure DevOps
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Importe e exporte itens de trabalho em massa usando arquivos formatados em CSV no Azure DevOps. Embora você possa continuar usando o Excel para importação e atualizações em massa, você pode usar o recurso nativo de importação/exportação que não requer o Excel. Para obter mais informações, confira Adicionar ou modificar itens de trabalho em massa com o Excel.
Você pode exportar itens de trabalho em massa usando um arquivo formatado em CSV. Embora você continue usando o Excel para importação e atualizações em massa, você pode usar o recurso nativo de exportação de Consultas que não requer o Excel. Para obter mais informações, confira Adicionar ou modificar itens de trabalho em massa com o Excel.
Importar novos itens de trabalho
Execute as etapas a seguir para importar novos itens de trabalho.
Observação
Você pode importar até 1.000 itens de trabalho por vez. Se você tiver mais de 1.000 itens de trabalho para importar, divida-os em vários arquivos e importe-os separadamente.
Crie um arquivo import.csv local e abra-o no Visual Studio Code ou no Excel.
O arquivo deve conter o Tipo de Item de Trabalho e os campos de Título. Você pode incluir outros campos conforme necessário. Para obter uma lista de campos padrão, consulte Índice de campos de item de trabalho.
No exemplo a seguir, incluímos o campo Prioridade.
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,2No portal da Web do seu projeto, abra Quadros> Consultas e selecione Importar itens de trabalho.
Selecione Escolher arquivo, escolha seu arquivo e selecione Importar.
O processo de importação carrega os itens de trabalho importados na exibição de consultas em um estado não salvo. Nenhuma ID é atribuída.
Verifique os resultados e selecione Salvar itens para salvar os itens de trabalho.
Dica
Evite atribuir IDs a novos itens de trabalho que você está adicionando; isso causa uma mensagem de erro.
O sistema realça os itens de trabalho com problemas de dados. Resolva os problemas de dados antes de salvar os itens de trabalho. Neste exemplo, o campo Prioridade contém um valor inválido. Corrija os dados abrindo o item de trabalho diretamente. Em vez disso, use a edição em massa para corrigir vários itens de trabalho com o mesmo problema.
Dicas
- Links pai-filho: Você pode adicionar links pai-filho entre itens de trabalho importados recuando as colunas de título, conforme mostrado em Posso importar um arquivo CSV que tem links pai-filho?. No entanto, você não pode especificar nenhum outro tipo de link ao importar ou atualizar itens de trabalho.
- Campo Estado padrão: quando você importa novos itens de trabalho, o campo "Estado" é sempre definido como "Novo" por padrão. Não é possível especificar um estado diferente durante o processo de importação. Se for necessário alterar o estado dos itens de trabalho importados, você poderá usar a seguinte solução alternativa:
- Importe os itens de trabalho com o estado "Novo" padrão.
- Exporte os itens de trabalho importados para um arquivo CSV.
- Atualize os valores do campo "Estado" no arquivo CSV exportado.
- Reimporte o arquivo CSV atualizado para definir os estados desejados.
- Campos Área e Iteração padrão: os campos "Área" e "Iteração" são definidos em nível superior por padrão. Esse comportamento ocorre porque o processo de importação não tem o contexto para esses campos, a menos que isso seja especificado explicitamente no arquivo CSV. Para definir caminhos específicos de "Área" e "Iteração" durante a importação, certifique-se de que esses campos estejam incluídos em seu arquivo CSV com os valores corretos. Por exemplo:
Title,Description,Area Path,Iteration Path "Sample Work Item","This is a sample description.","Project\Team","Project\Sprint 1"
Atualizar itens de trabalho existentes
Para atualizar itens de trabalho, crie uma consulta que contenha todas as colunas que você deseja exportar e, possivelmente, editar. Salve sua consulta e selecione Exportar para CSV para salvar o arquivo data.csv no computador local.
O arquivo exportado deve ser semelhante à seguinte sintaxe:
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",Faça as edições em seus itens de trabalho. O arquivo CSV deve conter os campos ID, Tipo de Item de Trabalho e Título. Todos os outros campos que você deseja incluir são opcionais.
Observação
Quando você importar campos de identidade, insira o nome e o email no seguinte formato
"Display Name <email>". Por exemplo, para atribuir trabalho a Jamal Hartnett, especifique"Jamal Hartnett <fabrikamfiber4@hotmail.com>". Se você especificar um valor que não é reconhecido como usuário válido para o sistema, poderá encontrar problemas com a importação.No exemplo a seguir, alteramos vários valores em itens de trabalho existentes.
"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```Salve o arquivo e importe-o (consulte as etapas 4 a 6 da seção importar anterior).
A lista de resultados com itens de trabalho que contêm alterações de valor aparece realçada em negrito. Selecione Salvar Itens para aplicar as alterações.
Os itens de trabalho com problemas de dados são realçados em vermelho e devem ser resolvidos antes que você possa salvá-los. Neste exemplo, um valor inválido aparece no campo Atribuído a. Corrija os dados abrindo o item de trabalho diretamente. Você pode utilizar a edição em massa se tiver muitos itens de trabalho com o mesmo problema.
Exportar lista como arquivo CSV
Em qualquer consulta, você pode exportar uma lista de itens de trabalho como uma lista delimitada por vírgulas. Abra a consulta, selecione o ícone de ações 
e, em seguida, selecione Exportar para CSV.
Observação
Tem como requisito o Azure DevOps Server 2019 Atualização 1 ou versão posterior.
Exportar e importar itens de trabalho para um projeto diferente
Você pode usar esse recurso para exportar itens de trabalho de um projeto e importá-los para outro projeto. Entretanto, antes de importá-los para outro projeto, é necessário remover a ID do item de trabalho. Você obtém um erro se tentar importar novos itens de trabalho para um projeto com uma ID especificada.
Campos Importar HTML
Os campos HTML, como descrições e critérios de aceitação, incluem formatação rich text. Para garantir que essa formatação seja preservada, execute as seguintes tarefas:
- Certifique-se de que seu arquivo CSV inclua marcas HTML nos campos relevantes.
- Importe o arquivo CSV no Excel.
O Excel pode lidar com campos de texto de várias linhas de maneira diferente, por isso é importante verificar a formatação após a importação. Substitua as linhas que terminam em CRLF cercando as frases com <p>... </p>.
Por exemplo, você pode importar o item de trabalho a seguir, que inclui três linhas de texto no campo Descrição.
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>"
Converter campos de várias linhas em texto simples
Para desativar o HTML em campos de várias linhas e garantir que eles sejam texto simples, você pode usar o comando witadmin changefield. Para obter etapas detalhadas, consulte Gerenciar campos de item de trabalho.
Exemplo de comando :
witadmin changefield /collection:CollectionURL /n:FieldName /type:PlainText
Lidar com inconsistências de formatação
Ao trabalhar com campos HTML em diferentes produtos da Microsoft, talvez você encontre inconsistências de formatação. Veja aqui algumas dicas para lidar com esses problemas:
- Revise a formatação pós-importação para garantir que ela atenda aos seus requisitos.
- Use marcas e estruturas HTML apropriadas para minimizar discrepâncias. É possível adicionar várias marcas separadas por ponto e vírgula. Para obter mais informações, consulte Tarefas que você pode e não pode fazer com o Excel.
Para obter mais informações sobre como gerenciar conteúdo HTML e garantir a compatibilidade, consulte a documentação oficial sobre conteúdo HTML no Azure DevOps.
Perguntas frequentes
P: Posso importar novos itens e atualizar itens existentes no mesmo arquivo CSV?
R: Com certeza! Deixe o campo ID vazio para novos itens de trabalho. No exemplo a seguir, a última entrada de um Épico não especifica uma 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",
P: Posso importar um arquivo CSV que tenha links pai-filho?
R: Sim, você pode adicionar itens de trabalho filho recuando colunas de título. O exemplo a seguir adiciona três problemas filho no Epic já definido.
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",
P: Como saber se meu arquivo importado tem erros?
R: Você pode testar adicionando marcas com espaços e hifens, por exemplo, e incluí-lo na exportação. A importação deve corresponder ao mesmo formato. Problemas de formatação do arquivo CSV aparecem na página Resultados do modo de exibição de importação. Não é possível importar itens de trabalho até que a formatação e a sintaxe estejam corretas.
Os resultados do item de trabalho sempre listam os erros de dados encontrados para itens de trabalho individuais. Corrija cada erro no portal da Web ou no arquivo CSV e importe novamente.
P: Por que estou recebendo erros para alguns valores de identidade?
R: quando você usa a interface do usuário da Web, o seletor de identidade passa por etapas extras para validar o usuário. Primeiro, ele verifica se a pessoa é um usuário válido na organização. Se não for o caso, ele pesquisa a identidade no Microsoft Entra ID. Se o usuário estiver no Microsoft Entra ID, mas não na organização, ele será adicionado às identidades válidas. Quando você importa via CSV, por motivos de desempenho, o selecionador de identidade não passa por essas etapas extras. Ele verifica apenas se já existe um Nome Principal do Usuário (UPN) correspondente na organização. Se não encontrar um UPN correspondente, ele informa que a identidade é desconhecida.
P: A importação de CSV dá suporte a todos os tipos de item de trabalho?
R: não, a importação de CSV não dá suporte para os seguintes tipos de itens de trabalho:
- Solicitação de revisão de código
- Resposta da revisão de código
- Solicitação de comentários
- Resposta de comentários
- Caso de teste
- Plano de Teste
- Conjunto de testes
- Parâmetro Compartilhado
Para obter mais informações, confira Casos de teste de importação ou exportação em massa.