Importar, atualizar e exportar itens de trabalho em massa com arquivos CSV no Azure Boards

Importar e exportar itens de trabalho em massa usando arquivos formatados em CSV no Azure Boards. Embora você possa continuar a usar o Excel para importações e atualizações em massa, o recurso de importação/exportação nativo permite que você gerencie itens de trabalho sem a necessidade do Excel. Para obter mais informações, confira Adicionar ou modificar itens de trabalho em massa com o Excel.

Importar novos itens de trabalho

Para importar itens de trabalho em massa, o arquivo CSV deve incluir os campos tipo de item de trabalho e título. Você pode incluir mais campos conforme necessário. Siga estas diretrizes para importar um arquivo CSV:

• Excluir o campo ID: não inclua o campo ID no arquivo CSV.
• Remover campos específicos do projeto: se o arquivo CSV tiver sido exportado de um projeto diferente, remova campos específicos do projeto de origem, como Caminho de Área e Tags. Para obter uma lista de campos padrão, consulte o Índice de Campo de Item de Trabalho .
• Incluir o campo Etapas de Teste: Ao importar casos de teste, inclua o campo Etapas de Teste. Para obter mais informações, consulte Casos de teste de importação ou exportação em massa.
• Não inclua os campos Atribuído a, Data da Alteração, Criado por ou Estado.
• Validar campos obrigatórios:
  • Verifique se os campos tipo de item de trabalho e título estão presentes no arquivo CSV.
  • Confirme se o tipo de item de trabalho corresponde a um tipo válido no projeto de destino.
  • Verifique se todos os campos no arquivo CSV correspondem aos campos dos tipos de item de trabalho no projeto de destino.
• Manipular valores inválidos: Se o arquivo CSV importado contiver itens de trabalho com valores inválidos, você deverá editar e corrigir esses itens de trabalho após a importação antes que eles possam ser salvos.

Execute as etapas a seguir para importar novos itens de trabalho.

1. Crie um arquivo import.csv local e abra-o no Visual Studio Code ou no Excel.

2. O arquivo deve conter o Tipo de Item de Trabalho e os campos de Título. Você pode incluir outros campos conforme necessário.

   Tip

   Para determinar os nomes de campo corretos para sua instância do Azure DevOps:

   • Exportar alguns itens de trabalho existentes do seu projeto para exibir os nomes de campo exatos
   • Criar um novo item de trabalho e examinar os campos disponíveis
   • Verifique o índice de campo do item de trabalho para referências de campos padrão

   O exemplo a seguir inclui o campo Prioridade . Seus campos disponíveis podem ser diferentes com base no modelo de processo:

   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. No portal da Web do seu projeto, selecione Quadros>Consultas>Importar itens de trabalho.

   

4. 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.

5. Verifique os resultados e selecione Salvar itens para salvar os itens de trabalho.

   

   Tip

   Não atribua IDs a novos itens de trabalho que você adicionar. A atribuição de IDs resulta em uma mensagem de erro.

6. 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.

   

Tips

• Compatibilidade de campo: Diferentes versões do Azure DevOps e modelos de processo (Agile, Scrum, CMMI ou personalizado) têm campos disponíveis diferentes. Sempre verifique os nomes de campo exportando itens de trabalho existentes do seu projeto antes de importar novos.

• Diferenças de modelo de processo:

  • Processo agile: usa história do usuário, tarefa, bug, épico, recurso, caso de teste
  • Processo scrum: usa item de lista de pendências do produto, tarefa, bug, épico, recurso, caso de teste
  • Processo CMMI: usa requisito, tarefa, bug, épico, recurso, caso de teste
  • Os nomes de campo e as opções disponíveis podem variar de acordo com o processo usado pelo projeto.

• 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 é definido como Novo por padrão. Não é possível especificar um estado diferente durante o processo de importação. Se você precisar alterar o estado dos itens de trabalho importados, use a seguinte solução alternativa:

  1. Importe os itens de trabalho com o estado novo padrão.
  2. Exporte os itens de trabalho importados para um arquivo CSV.
  3. Atualize os valores do campo Estado no arquivo CSV exportado.
  4. 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 no 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

1. 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 em seu computador local.

   

   O arquivo exportado deve ser semelhante ao exemplo a seguir:

   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. 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.

   Note

   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 seja reconhecido como um usuário válido para o sistema, poderá encontrar problemas com a importação.

   No exemplo a seguir, alteramos os valores em itens de trabalho existentes.

   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. Salve o arquivo e importe, conforme descrito na seção anterior.

4. 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.

   

5. 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 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. Porém, antes de importá-los para outro projeto, você deve 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.

Tipos de item de trabalho sem suporte

A importação de CSV não dá suporte aos seguintes tipos de item 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

• Etapa compartilhada

Para obter mais informações, confira Casos de teste de importação ou exportação em massa.

FAQs

P: Posso importar novos itens e atualizar itens existentes no mesmo arquivo CSV?

R: Absolutamente! 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 tags com espaços e hifens, por exemplo, e incluí-las na exportação. A importação deve corresponder ao mesmo formato. Quaisquer problemas de formatação do arquivo CSV aparecem na página Resultados da visã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 identificação?

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 do CSV, por motivos de desempenho, o seletor 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.