Partilhar via

Importar, atualizar e exportar itens de trabalho em massa com arquivos CSV nos Painéis do Azure

  • Artigo

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

Importe e exporte itens de trabalho em massa usando arquivos formatados em CSV nos Painéis do Azure. Embora você possa continuar a usar o Excel para importações e atualizações em massa, o recurso nativo de importação/exportação permite gerenciar itens de trabalho sem exigir o Excel. Para obter mais informações, consulte Adicionar ou modificar itens de trabalho em massa com o Excel.

Exporte itens de trabalho em massa usando arquivos formatados em CSV. Embora o Excel ainda possa ser usado para importações e atualizações em massa, o recurso de exportação nativo de Consultas permite gerenciar itens de trabalho sem depender do Excel. Para obter mais informações, consulte Adicionar ou modificar itens de trabalho em massa com o Excel.

Pré-requisitos

Permissões:

  • Exportar itens de trabalho: Membro do grupo de Administradores de Projeto ou Exibir informações no nível do projeto permissão definida como Permitir.
  • Importar itens de trabalho: Membro do grupo de segurança Administradores de Projeto ou do grupo de segurança Administradores do Team Foundation.

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 foi 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 Índice de Campos de Itens 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 Alterada, Criado porou 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 para os 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.

Nota

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.

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

  2. O arquivo deve conter os campos Tipo de Item de Trabalho e Título . Você pode incluir outros campos conforme necessário. Para obter uma lista de campos padrão, consulte Índice de campo de item de trabalho.

    O exemplo a seguir inclui o 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. No portal da web do seu projeto, selecione Painéis>Consultas>Importar itens de trabalho.

    Captura de ecrã a mostrar a página Painéis com Consultas e, em seguida, Importar itens de trabalho selecionados.

  4. Selecione Escolher arquivo, escolha seu arquivo e, em seguida, selecione Importar.

    Captura de ecrã a mostrar a caixa de diálogo Importar itens de trabalho com o botão Importar realçado.

    O processo de importação carrega os itens de trabalho importados na exibição de consultas em um estado não salvo . Nenhum ID é atribuído.

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

    Captura de ecrã a mostrar Guardar itens para itens de trabalho importados.

    Gorjeta

    Não atribua IDs a novos itens de trabalho adicionados. A atribuição de IDs resulta em uma mensagem de erro.

  6. O sistema destaca os itens de trabalho com problemas de dados. Resolva os problemas de dados antes de salvar os itens de trabalho. Neste exemplo, um valor inválido está no campo Prioridade. 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.

    Captura de tela mostrando itens de trabalho com problemas de dados para corrigir.

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 com links pai-filho?. No entanto, não é possível especificar outros tipos 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 Padrão e Iteração: Os campos Área e Iteração usam como padrão o nó de nível superior. Esse comportamento ocorre porque o processo de importação não tem o contexto para esses campos, a menos que explicitamente especificado no arquivo CSV. Para definir caminhos específicos de Área e Iteração durante a importação, verifique se esses campos estão 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 sua máquina local.

    Captura de tela mostrando itens de trabalho em uma consulta com a opção Exportar para CSV selecionada.

    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 nos seus itens de trabalho. O arquivo CSV deve conter os campos ID, Tipo de Item de Trabalho e Título . Quaisquer outros campos que pretenda incluir são opcionais.

    Nota

    Ao importar campos de identidade, insira o nome e o e-mail 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 um usuário válido para o sistema, poderá encontrar problemas com a importação.

    No exemplo a seguir, alteramos 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.

    Captura de ecrã a mostrar Importar Itens de Trabalho com a opção Guardar itens.

  5. Os itens de trabalho com problemas de dados são destacados 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 usar a edição em massa se tiver muitos itens de trabalho com o mesmo problema.

    Captura de ecrã a mostrar um valor inválido que aparece no campo Atribuído a.

Exportar lista como um arquivo CSV

A partir de qualquer consulta, você pode exportar uma lista de itens de trabalho como uma lista delimitada por vírgula. Abra a consulta, selecione o ícone de ações e, em seguida, selecione Exportar para CSV.

Nota

Requer o Azure DevOps Server 2019 Atualização 1 ou versão posterior.

Captura de ecrã a mostrar Exportar uma consulta como CSV.

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. Mas, antes de importá-los para outro projeto, você deve remover a ID do item de trabalho. Você recebe um erro se tentar importar novos itens de trabalho para um projeto com uma ID especificada.

Importar campos 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:

  1. Verifique se o arquivo CSV inclui tags HTML nos campos relevantes.
  2. Importe o arquivo CSV para o Excel.

O Excel pode lidar com campos de texto de várias linhas de forma diferente, por isso é importante verificar a formatação após a importação. Substitua as linhas que terminam em CRLF frases circundantes por <p>... </p>.

Por exemplo, você pode importar o seguinte item de trabalho, 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>&nbsp;You can include bold text</strong></p><p><em>&nbsp;And italic text</em></p><p><u>&nbsp;Underline text</u></p>"

Converter campos de várias linhas em texto simples

Para desativar o HTML em campos de várias linhas para garantir que sejam texto sem formatação, use o comando witadmin changefield. Para obter mais informações, 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

Quando você trabalha com campos HTML em diferentes produtos da Microsoft, você pode encontrar inconsistências de formatação. Aqui estão algumas dicas para lidar com esses problemas:

  • Revise a formatação após a importação para garantir que ela atenda aos seus requisitos.
  • Use tags e estruturas HTML apropriadas para minimizar discrepâncias. Você pode adicionar várias tags 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 Fornecer texto de ajuda, hiperlinks ou conteúdo da Web em um formulário de item de trabalho.

Tipos de item de trabalho sem suporte

A importação CSV não suporta os seguintes tipos de item de trabalho:

  • Pedido de Revisão do Código
  • Resposta à Revisão do Código
  • Pedido de Comentários
  • Resposta aos Comentários
  • Caso de Teste
  • Plano de Teste
  • Conjunto de Testes
  • Parâmetro Partilhado

Para obter mais informações, consulte 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: Com certeza! Deixe o campo ID vazio para quaisquer novos itens de trabalho. No exemplo a seguir, a última entrada para um Epic não especifica um 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: Sim, você pode adicionar itens de trabalho filho recuando colunas de título. O exemplo a seguir adiciona três problemas filho no épico 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",

Captura de ecrã a mostrar a vista do Excel.

P: Como posso saber se o meu ficheiro importado tem erros?

R: Você pode testar adicionando tags com espaços e hífenes, por exemplo, e incluí-lo na exportação. A importação deve corresponder ao mesmo formato. Qualquer problema com a formatação do arquivo CSV aparece na página Resultados da visualização de importação. Não é possível importar os itens de trabalho até que a formatação e a sintaxe estejam corretas.

Captura de ecrã a mostrar um erro CSV na página Importar Itens de Trabalho.

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. Caso contrário, ele pesquisa a identidade no Microsoft Entra ID. Se o usuário estiver no ID do Microsoft Entra, mas não na organização, esse usuário 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 apenas verifica se já há um Nome Principal de Usuário (UPN) correspondente na organização. Se não encontrar um UPN correspondente, informa que a identidade é desconhecida.