Compartilhar via


Exibir, filtrar e abrir solicitações de pull

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

Visual Studio 2019 | Visual Studio 2022

Você cria solicitações de pull (PRs) para revisar e mesclar alterações de código em um repositório Git no Azure Repos. Os membros da equipe e os stakeholders podem revisar as alterações e fornecer comentários antes de mesclar o código no branch de destino. Os revisores também podem comentar as alterações e votar para aprovar ou rejeitar o código.

As Equipes podem exigir PRs para quaisquer alterações em branches protegidos e definir políticas de branch para exigir que determinadas PRs atendam a critérios específicos.

Há várias maneiras de listar, filtrar, exibir e abrir PRs para um projeto.

Pré-requisitos

  • Os repositórios devem estar habilitados em seu projeto. Se o hub repos e as páginas associadas não forem exibidos, consulte Ativar ou desativar um serviço do Azure DevOps para reabilitar repositórios.

  • Para examinar PRs, você deve ser membro do projeto do Azure DevOps em que a PR está, com acesso Básico ou superior. Se você não for um membro do projeto, será adicionado.

    Observação

    Para projetos públicos, os usuários que receberam acesso de Stakeholder têm acesso total a Azure Repos.

  • Os repositórios devem estar habilitados em seu projeto. Se o hub repos e as páginas associadas não forem exibidos, consulte Ativar ou desativar um serviço do Azure DevOps para reabilitar repositórios.
  • Para exibir as PRs, você deve ser membro do projeto do Azure DevOps com acesso Básico ou superior. Se você não for um membro do projeto, será adicionado.

Listar as solicitações de pull

Você pode listar PRs usando o site do projeto do Azure DevOps, o Visual Studio ou a linha de comando do Azure DevOps.

  1. Para listar PRs em um repositório específico em um projeto, vá para esse projeto no portal da Web e selecioneSolicitações de >Pull do Repositório.

    Captura de tela da exibição de suas solicitações de pull.

  2. Verifique se você selecionou o repositório correto.

    Captura de tela da escolha do seu repositório.

  3. O modo de exibição padrão mostra suas PRs na guia Mine. Selecione Ativo para mostrar todas as PRs ativas para o repositório atual. Selecione Concluído ou Abandonado para exibir listas de PRs fechadas.

    Selecione qualquer PR na lista para ir para a página Visão geral dessa PR.

    Captura de tela das guias de exibição para PRs no Azure Repos.

  4. Você pode listar todas as suas PRs em diferentes projetos em sua organização escolhendo Solicitações de pull no modo de exibição Meu Trabalho.

    Captura de tela da exibição de suas solicitações de pull.

Definir uma exibição de solicitação de pull personalizada

Filtrar a lista de PR ajuda você a encontrar e organizar PRs para priorizar os arquivos mais importantes em seu fluxo de trabalho.

Para filtrar a lista de PR, na página Solicitações de pull, selecione o ícone Filtro no canto superior direito. Em seguida, selecione Branch de destino ou outro cabeçalho de coluna e selecione o branch ou outro valor que você deseja filtrar.

Para personalizar ainda mais sua exibição da lista de PR, selecione Personalizar exibição no canto superior direito na página Solicitações de pull.

Captura de tela mostrando o botão Personalizar exibição na página Solicitações de pull.

Na página Personalizar exibição, você pode reorganizar as seções do modo de exibição atual, editá-las ou removê-las. Para criar uma nova seção, selecione Adicionar seção.

Captura de tela mostrando a página Personalizar exibição com o botão Adicionar seção.

Na página Personalizar seção, insira e selecione valores para filtrar a seção por parâmetros como estado de rascunho ou data atualizada. Você pode escolher se deseja Mostrar solicitações de pull que aprovei ou rejeitei em uma guia separada ou Excluir solicitações de pull (duplicatas) incluídas nas seções anteriores. Quando terminar de personalizar o modo de exibição, selecione Salvar.

Captura de tela mostrando a página Personalizar seção.

Essas exibições personalizadas criam seções separadas e flexíveis na página de solicitação de pull. Essas consultas personalizadas também funcionam em repositórios na guia Minhas solicitações de pull da página inicial da organização. Captura de tela da página Solicitações de Pull mostrando seções flexíveis.

Para alterar os parâmetros dos modos de exibição personalizados, selecione o botão Personalizar ao lado do modo de exibição. Ou selecione Personalizar exibição e, na tela Personalizar exibição, selecione o modo de exibição que você deseja alterar. Alguns modos de exibição, como Atribuído a mim, não podem ser personalizados, mas podem ser reorganizados ou removidos.

Em uma guia Arquivos de PR, você pode usar vários filtros para selecionar arquivos e comentários para revisões mais rápidas. Selecione Filtrar e, em seguida, selecione entre as opções.

Captura de tela da guia Arquivos com opções de filtro.

  • Palavra-chave: insira um palavra-chave.
  • Revisado/Não Revisado: Todos (padrão), Pendentes, Revisados.
  • Arquivos com comentários: todos os arquivos (padrão), Arquivos com comentários.
  • Comentários: Mostrar (padrão), Novidades, Ocultar.
  • Status de comentário: Ativo (padrão), Pendente, Resolvido, Como projetado, Não corrigirá, Fechado.
  • Comentado por: Todos os comentários (padrão) ou uma pessoa específica.

Você também pode digitar uma cadeia de caracteres no campo Pesquisa para mostrar os resultados correspondentes das opções anteriores.

Abrir uma solicitação de pull

Quando você abre uma PR no navegador, no Visual Studio ou na CLI do Azure, a página Visão geral da PR é aberta no navegador.

Para abrir uma PR no navegador, selecione a PR na lista na página Solicitações de pull. A PR é aberta na guia Visão geral. A guia Visão geral mostra o título, a descrição, os revisores, os itens trabalhados vinculados, o histórico e os status da PR. Você pode ver um resumo das políticas de branch que estão sendo aprovadas ou reprovadas e ver comentários que os revisores fizeram.

Captura de tela que mostra a guia visão geral da PR.

Na guia Arquivos da PR, você pode revisar as alterações reais nos arquivos da PR. Nas guias Atualizações e Confirmações, você pode ver as alterações que o autor fez para atualizar o branch da PR.

Para revisar as alterações, fazer comentários ou sugestões ou aprovar ou votar na PR, consulte Revisar solicitações de pull.

Exibir e atualizar solicitações de pull de um dispositivo móvel

Você pode usar dispositivos móveis para exibir todas as telas de PR do Azure Repos e executar ações.

Captura de tela das telas de PR do Azure Repos em um dispositivo móvel.

Próximas etapas