Vincular histórias, problemas, bugs e outros itens de trabalho do usuário Azure Boards

Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 – TFS 2013

Vincule itens de trabalho a outros itens de trabalho para gerenciar dependências e ver relações dentro do trabalho. Você pode vincular itens de trabalho em seu projeto ou para itens de trabalho em outro projeto em sua organização. Use tipos de link diferentes para dar suporte a diferentes metas de negócios. Você também pode vincular itens de trabalho a outros objetos, como builds, confirmações, itens com versão ou recursos de rede.

Vincule itens de trabalho a outros itens de trabalho para gerenciar dependências e ver relações dentro do trabalho. Você pode vincular itens de trabalho em seu projeto ou para itens de trabalho em outro projeto em sua coleção. Use tipos de link diferentes para dar suporte a diferentes metas de negócios. Você também pode vincular itens de trabalho a outros objetos, como builds, confirmações, itens com versão ou recursos de rede.

Em geral, você usa os seguintes tipos de link ao vincular itens de trabalho entre si:

  • Usar links pai/filho para vincular itens de trabalho que você deseja agrupar em uma hierarquia
  • Usar o Antecessor/Sucessor ou Afeta/Afetado por links para vincular itens de trabalho que têm dependências
  • Usar Duplicar/Duplicar de links para vincular itens de trabalho que acompanham o mesmo defeito ou trabalho de código
  • Usar Relacionado para vincular itens de trabalho com algum nível de relação, mas não tão forte

Você pode adicionar um link a um item de trabalho de dentro do formulário de item de trabalho ou de uma lista de pendências ou resultados da consulta. Em uma lista de resultados de consulta ou lista de pendências, você pode selecionar vários itens de trabalho e vinculá-los a um item de trabalho novo ou existente. Em geral, use a edição em massa para atualizar vários itens de trabalho para vincular ao mesmo item de trabalho, novo ou existente.

Use este artigo para saber como:

  • Vincular um ou mais itens de trabalho a um item de trabalho existente
  • Vincular um ou mais itens de trabalho a um novo item de trabalho que você adiciona ao vincular
  • Adicionar um link a um item de trabalho remoto
  • Vincular vários itens de trabalho a um novo git branch
  • Vincular itens de trabalho a um artefato de build
  • Encontrar itens de trabalho aos que você deseja vincular
  • Modificar relações de vínculo em massa
  • Vincular um ou mais itens de trabalho a um item de trabalho existente
  • Vincular um ou mais itens de trabalho a um novo item de trabalho que você adiciona ao vincular
  • Vincular vários itens de trabalho a um novo git branch
  • Vincular itens de trabalho a um artefato de build
  • Encontrar itens de trabalho aos que você deseja vincular
  • Modificar relações de vínculo em massa

Para ver uma lista de todos os tipos de link e relações de vínculo com suporte, consulte Vinculação, rastreabilidade e gerenciamento de dependências.

Para uma visão geral de quais tipos de link usar e recursos relacionados a vínculo, consulte Vinculando, rastreabilidade e gerenciamento de dependências. Em geral, recomendamos que você siga estas diretrizes:

  • Para itens de trabalho que aparecem em suas pendências, produto e portfólio, use os tipos de link Pai e Filho para criar uma hierarquia e um trabalho em grupo. Para vincular rapidamente muitos itens de trabalho da lista de pendências em uma hierarquia, consulte Organizar sua lista de pendências,mapear itens de trabalho filho para os pais.
  • Ao vincular itens de trabalho com tipos de link Pai e Filho, evite aninhar itens de trabalho do mesmo tipo. Embora o sistema permita aninhar itens de trabalho do mesmo tipo, como vincular bugs a bugs ou bugs a histórias de usuários ao acompanhar os dois tipos na lista de pendências do produto, ele pode causar problemas com o arrastar e soltar de itens de trabalho em uma lista de pendências ou a exibição de itens em um quadro Kanban. Para saber mais, confira Corrigir problemas de exibição, reordenação e aninhamento.
  • Para acompanhar as dependências de itens de trabalho, use os tipos de link Antecessor e Sucessor.
  • Para todas as outras finalidades gerais de acompanhamento, use o tipo de link Relacionado.

As seguintes relações de vínculo são restritas:

  • Não é possível atribuir um item de trabalho a mais de um pai usando um tipo de link Pai/Filho ou outro tipo de link de topologia de árvore. Para saber mais sobre tipos de link, consulte Referência de tipo de link.
  • Você não pode adicionar links de forma a criar uma relação circular.
  • Não é possível vincular mais de 1.000 itens de trabalho a um único item de trabalho.

Pré-requisitos

Os registros posteriores são criados automaticamente quando você cria um projeto ou adiciona uma equipe. Cada equipe tem acesso ao seu próprio produto, portfólio e registros posteriores do Sprint, conforme descrito em sobre equipes e ferramentas Agile.

  • Você deve se conectar a um projeto do. Se você ainda não tiver um projeto, crie um.
  • você deve ser adicionado a um projeto como membro do grupo de segurança colaboradores ou administradores de Project . Para ser adicionado, adicione usuários a um projeto ou equipe.
  • Para adicionar ou modificar itens de trabalho, você deve receber acesso de Stakeholder ou superior. Para obter detalhes, consulte referência rápida de acesso do stakeholder.
  • Para exibir ou modificar itens de trabalho, você deve ter os itens de trabalho de exibição neste nó e Editar itens de trabalho neste nó permissões definidas como permitir. Por padrão, o grupo colaboradores tem esse conjunto de permissões. Para saber mais, consulte definir permissões e acesso para acompanhamento de trabalho.

Observação

Os usuários com acesso de Stakeholder para um projeto público têm acesso completo aos recursos de registro posterior e de quadro, assim como os usuários com acesso básico . Para obter detalhes, consulte referência rápida de acesso do stakeholder.

  • Você deve se conectar a um projeto do. Se você ainda não tiver um projeto, crie um.
  • você deve ser adicionado a um projeto como membro do grupo de segurança colaboradores ou administradores de Project . Para ser adicionado, adicione usuários a um projeto ou equipe.
  • Para adicionar ou modificar itens de trabalho, você deve receber acesso de Stakeholder ou superior. Para obter detalhes, consulte referência rápida de acesso do stakeholder.
  • Para exibir ou modificar itens de trabalho, você deve ter os itens de trabalho de exibição neste nó e Editar itens de trabalho neste nó permissões definidas como permitir. Por padrão, o grupo colaboradores tem esse conjunto de permissões. Para saber mais, consulte definir permissões e acesso para acompanhamento de trabalho.

  1. No portal da Web, abra uma página de resultados da lista de pendências ou de consulta e selecione vários itens de trabalho aos que você deseja adicionar um link.

  2. Abra o menu de contexto de um dos itens de trabalho selecionados, escolha Adicionar link e, em seguida, escolha Item existente... ou Novo item....

    Aqui, selecionamos várias na lista de pendências do produto e escolhemos Item existente....

    Captura de tela do menu de contexto da lista de pendências, Itens de seleção múltiplo na lista de pendências, menu de contexto aberto, escolha Adicionar link a um item de trabalho existente.

  1. No portal da Web, abra uma página de resultados da consulta e selecione vários itens de trabalho aos que você deseja adicionar um link.

  2. Abra o menu de contexto ... de um dos itens de trabalho selecionados e, em seguida, escolha Vincular a um novo item... ou Vincular a um item existente....

    Aqui, selecionamos várias na página Consultas e escolhemos Vincular a um novo item … .

    Captura de tela da página Resultados da consulta, itens com várias seleções, menu de contexto aberto, escolha Vincular a um novo item de trabalho, versão do TFS-2017.

  1. No portal da Web, abra uma página de resultados da consulta e selecione vários itens de trabalho aos que você deseja adicionar um link.

  2. Abra o menu de contexto de um dos itens de trabalho selecionados e, em seguida, escolha Vincular itens selecionados a um novo item de trabalho... ou Vincular a um item existente....

    Aqui, selecionamos várias na página Consultas e escolhemos Vincular itens selecionados a um novo item de trabalho....

    Captura de tela da página Resultados da consulta, itens com várias seleções, menu de contexto aberto, escolha Vincular a um novo item de trabalho, versões TFS-2015 e eaqrlier

Ao vincular itens de trabalho, você seleciona um tipo de link. Em geral, use os seguintes tipos de link, conforme indicado. Para saber mais sobre cada tipo de link, consulte Referência de tipo de link.

  • Use o tipo de link Duplicar quando dois itens de trabalho foram criados que capturam essencialmente as mesmas informações; feche um dos itens de trabalho e mantenha o outro ativo
  • Use os tipos de link Pai/Filho quando quiser separar itens de trabalho em itens menores, por exemplo, separar recursos em histórias ou — histórias em tarefas
  • Use tipos de link Antecessor-Sucessor quando quiser acompanhar tarefas que devem ser concluídas antes que outras possam ser iniciadas; esse tipo de link é usado com mais frequência quando você planeja trabalhar usando Project
  • Use o tipo de link Relacionado quando os itens de trabalho que estão sendo vinculados estão no mesmo nível, como duas histórias de usuário que definem recursos que se sobrepõem entre si ou para vincular itens de trabalho definidos em projetos diferentes ou gerenciados por equipes — — diferentes.

Na caixa de diálogo Adicionar link, selecione o tipo de link, insira uma ID de item de trabalho e escolha OK.

Por exemplo, aqui usamos o tipo de link Relacionado para vincular três itens ao bug com a ID de 400.

Adicionar caixa de diálogo de link, portal da Web, a um item de trabalho existente.

Para vincular a vários itens de trabalho, você pode usar adicionar em linha, que localiza itens de trabalho com base em suas pesquisas recentes de atividade ou palavra-chave. Selecione um ou mais dos itens de trabalho exibidos automaticamente com base em sua atividade recente ou insira uma palavra-chave. As pesquisas de palavra-chave exibirão itens de trabalho com base em itens de trabalho que incluem essa palavra-chave em seu título.

Observação

Você precisa adicionar cada link um de cada vez. (Você não pode mais inserir suas IDs separadas por vírgulas ou espaços.) Para encontrar rapidamente itens de trabalho de interesse, você também pode usar a pesquisa de item de trabalho.

Para exibir os itens de trabalho selecionados para vinculação, você pode escolher o .

Caixa de diálogo Adicionar link a um item de trabalho existente

Captura de tela do menu de contexto da lista de pendências, escolha Adicionar link a um item de trabalho existente, TFS-2018 e versões anteriores.

Para vincular a vários itens de trabalho, insira suas IDs separadas por vírgulas ou espaços. Se você não conhece as IDs ou deseja vincular a um item em um projeto diferente, escolha o menu de contexto para abrir um diálogo que dará suporte a você na escolha de itens de trabalho baseados em … IDs,em uma consulta ou na palavra-chave de título .

Se você estiver trabalhando na página Resultados da Consulta, precisará salvar em massa os itens de trabalho modificados. Quando você trabalha de uma lista de pendências, os itens de trabalho são salvos automaticamente.

Captura de tela da página Resultados da consulta, salve itens modificados em massa.

Captura de tela da página Resultados da consulta, itens com várias seleções, itens de trabalho modificados de salvar em massa, TFS-2018 e versões anteriores.

Aqui, selecionamos adicionar um link aos itens de trabalho selecionados.

  1. Especifique o tipo de link, o tipo de item de trabalho e o título do novo item de trabalho. Selecione OK.

    Caixa de diálogo Adicionar link, Vincular a um novo item de trabalho, TFS-2018 e versões posteriores.

    Caixa de diálogo Adicionar link, link para um novo item de trabalho, TFS-2017 e versões anteriores.

  2. Um item de trabalho do tipo selecionado é aberto. Insira informações adicionais e salve o item de trabalho.

    Captura de tela do novo problema de item de trabalho adicionado.

  3. Se estiver trabalhando na página resultados da consulta, você precisará salvar em massa os itens de trabalho modificados conforme mostrado no procedimento anterior.

você pode vincular itens de trabalho a objetos definidos em outras organizações Azure DevOps, contanto que ambas as organizações usem o mesmo Azure Active Directory para gerenciar usuários.

Escolha um dos dois tipos de link remoto a seguir com suporte.

  • Use os tipos de link consumir de/produzir para quando você quiser controlar as dependências de itens de trabalho que são definidas em diferentes organizações e gerenciadas por equipes diferentes.
  • Use o tipo de link relacionado remoto quando os itens de trabalho que estão sendo vinculados são definidos em organizações diferentes e gerenciados por equipes diferentes, mas não têm forte dependências.

Na caixa de diálogo Adicionar link, selecione o tipo de link, insira a URL do item de trabalho remoto e escolha OK.

Por exemplo, aqui usamos o tipo de link relacionado remoto para vincular a ID de item de trabalho 350 que existe na organização remotelinkingtest2 , projeto RemoteLinking .

Caixa de diálogo Adicionar link, adicione um link a um item de trabalho remoto existente.

A guia link mantém uma contagem de todos os links para o item de trabalho. O campo contagem de link remoto mantém uma contagem do número de Links adicionados a um item de trabalho vinculado a um item de trabalho definido em outro projeto ou organização.

A imagem a seguir mostra um exemplo de dois links remotos, indicado pelo ícone de nuvem, adicionado a uma história de usuário.

Captura de tela do formulário de história de usuário, guia link, mostrando dois links externos.

Você pode adicionar um novo Branch git e vinculá-los a itens de trabalho existentes ao mesmo tempo.

Em uma página de resultados da consulta ou da pendência, Selecione vários itens de trabalho que você deseja vincular a um novo Branch git, escolha o ícone ações e, em seguida, nova ramificação.... Para saber mais, confira vincular itens de trabalho a objetos de desenvolvimento do git.

Captura de tela da pendência, menu de contexto, escolha vincular vários itens da pendência a um Branch git.

Captura de tela da pendência, menu de contexto, escolha vincular vários itens da pendência a uma ramificação do git, versão 2017 do TFS.

Você pode vincular itens de trabalho a compilações existentes na caixa de diálogo Adicionar link . Essas compilações podem estar dentro de seu projeto ou de outros projetos em sua organização ou coleção.

Observação

este recurso requer a instalação da atualização do Azure DevOps Server 2020,1. para saber mais, consulte as notas de versão do Azure DevOps Server 2020 atualização 1 RC1 Boards.

  1. Na guia links de um item de trabalho, escolha Adicionar link>item existente.

  2. Na caixa de diálogo Adicionar link , escolha um dos tipos de link de compilação — Build, encontrado em Build, integrado em Build — e especifique o número da compilação.

    Se você não souber o número de Build de — uma combinação do pipeline e o nome da compilação, — poderá pesquisá-lo escolhendo o ícone.

    Caixa de diálogo Adicionar link com o tipo de link de compilação selecionado.

  3. Na caixa de diálogo compilações de link , escolha os parâmetros para filtrar sua pesquisa de compilações.

    se estiver vinculando a uma compilação em um projeto diferente, primeiro escolha o Project cujo build você deseja vincular.

    Por exemplo, você pode especificar um número de Build, selecionar um pipeline de compilação, um resultado de compilação, como — All, Succeeded, Succeeded, Failed ou Canceled. Ou, com todos os selecionados para resultado, escolha Localizar para listar as compilações disponíveis para vincular.

    Caixa de diálogo Localizar compilações com o projeto selecionado e as compilações listadas.

  4. Escolha a compilação na lista à qual você deseja vincular e, em seguida, escolha OK.

  5. Na caixa de diálogo Adicionar link , escolha OK para concluir a operação.

    Caixa de diálogo Adicionar link com o número de Build preenchido.

Você pode vincular itens de trabalho a compilações existentes na caixa de diálogo Adicionar link .

  1. Na guia links de um item de trabalho, escolha Adicionar link>item existente.

  2. Na caixa de diálogo Adicionar link , escolha um dos tipos de link de compilação — Build, encontrado em Build, integrado em Build — e especifique o número da compilação.

    Se você não souber o número de Build de — uma combinação do pipeline e o nome da compilação, — poderá pesquisá-lo escolhendo o ícone.

    Caixa de diálogo Adicionar link com o tipo de link de compilação selecionado.

  3. Na caixa de diálogo compilações de link , escolha os parâmetros para filtrar sua pesquisa de compilações.

    Por exemplo, você pode especificar um número de Build, selecionar um pipeline de compilação, um resultado de compilação, como — All, Succeeded, Succeeded, Failed ou Canceled. Ou, com todos os selecionados para resultado, escolha Localizar para listar as compilações disponíveis para vincular.

    Caixa de diálogo Localizar compilações, link para uma compilação em seu projeto.

  4. Escolha a compilação na lista à qual você deseja vincular e, em seguida, escolha OK.

  5. Na caixa de diálogo Adicionar link , escolha OK para concluir a operação.

    Caixa de diálogo Adicionar link com o número de Build preenchido.

Na caixa de diálogo Adicionar link, você pode abrir uma caixa de diálogo secundária para ajudá-lo a escolher um ou mais itens de trabalho para vincular. Se você for localizar e listar itens de trabalho para vincular usando uma consulta salva, primeiro defina a consulta que deseja usar.

  1. na caixa de diálogo adicionar link, escolha o … menu de contexto ou o botão procurar (Visual Studio) para abrir a caixa de diálogo a seguir.

    Escolher itens de trabalho vinculados

    Se os itens de trabalho forem definidos em outro projeto, primeiro selecione o Project. Em seguida, faça suas seleções:

    • Consulta. Use esse método quando tiver definido uma consulta que você sabe que contém o conjunto ou o superconjunto dos itens de trabalho desejados.

    • IDs. Use esse método quando você souber as IDs dos itens de trabalho aos quais deseja vincular. Na caixa IDs , digite as IDs dos itens de trabalho que você deseja localizar, separados por vírgulas ou espaços.

    • O título contém. Use este método para localizar itens de trabalho que têm uma palavra ou frase comum no campo título. Na lista e tipo , selecione o tipo de item de trabalho que você deseja recuperar.

      Observação

      Para minimizar o tempo necessário para executar a consulta, restrinja os critérios de filtro da pesquisa.

  2. Selecione o botão Localizar .

    Somente os itens de trabalho definidos para o projeto selecionado e o tipo de item de trabalho especificado são listados. Para classificar em um campo de coluna, escolha o título da coluna.

  3. Na lista de itens de trabalho retornados, selecione um ou mais itens de trabalho.

    • No portal da Web: para selecionar vários itens em uma sequência, mantenha pressionada a tecla Shift. Para selecionar vários itens não sequenciais, use a tecla CTRL.

    • para Visual Studio, selecione cada item de trabalho que deve vincular ao item de trabalho atual. Você também pode pressionar a tecla SHIFT enquanto clica para selecionar um intervalo de itens de trabalho ou pressionar a tecla CTRL enquanto clica para selecionar vários itens de trabalho.

Definir estado do item de trabalho na solicitação pull

Ao criar uma solicitação de pull, você pode definir o valor de estado dos itens de trabalho vinculados na descrição. Siga a sintaxe: {state value}: #ID . Quando você mescla a solicitação de pull, o sistema lê a descrição e atualiza o estado do item de trabalho. No exemplo a seguir, definimos itens de trabalho #300 e #301 como Resolvidos e #323 e #324 como Fechado.

Captura de tela da configuração do estado do item de trabalho em uma PR.

Observação

Esse recurso requer a instalação Azure DevOps Server atualização 2020.1. Para saber mais, confira Azure DevOps Server Notas de versão da Atualização 1 RC1 de 2020, Boards.

Para saber mais sobre esse recurso, confira vincular a itens de trabalho de outros objetos.

Outros recursos que você pode usar para vincular ou alterar rapidamente links que usam o tipo de link pai-filho (alguns recursos são dependentes de versão, consulte o artigo vinculado para obter detalhes):

Exibir lista de objetos vinculados

Para exibir a lista de todos os objetos vinculados a um item de trabalho, abra o item de trabalho e escolha a guia Links. A guia links indica a contagem de todos os objetos vinculados.

Captura de tela da guia Links com a contagem de objetos vinculados.

Os objetos vinculados são agrupados sob seu tipo de link, com uma contagem dentro de cada grupo. Você pode expandir ou fechar cada grupo e classificar dentro de cada grupo por Estado, Atualização Mais Recente ou Comentário escolhendo o título da coluna correspondente.

Por exemplo, a guia Links a seguir mostra uma parte dos 64 objetos vinculados para um item de trabalho.

Captura de tela da guia Links com muitos objetos vinculados.

Os links prefaced com o ponto de exclamação vermelho indicam que o build, a versão ou outro objeto foi excluído. Isso geralmente ocorre devido a políticas de retenção que excluem automaticamente esses objetos após um determinado período de tempo ter passado.