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 pull requests (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 examinar as alterações e fazer 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.

O Teams pode 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

Categoria Requisitos
Acesso ao Projeto Membro de um projeto.
Permissões - Exibir código em projetos privados: no mínimo acesso Básico.
- Clonar ou contribuir para o código em projetos privados: Membro do grupo de segurança Colaboradores ou com permissões correspondentes no projeto.
- Definir permissões de ramo ou repositório: permissões para Gerenciar permissões para o branch ou repositório.
- Alterar o branch padrão: permissões para Editar políticas para o repositório.
- Importar um repositório: membro do grupo de segurança Administradores do projeto ou com a permissão Criar repositório no nível do projeto Git definida como Permitir. Para obter mais informações, consulte Definir permissões do Repositório do Git.
Serviços Repositório habilitado.
Ferramentas Opcional. Use comandos az repos: CLI do Azure DevOps.

Observação

Em projetos públicos, os usuários com acesso Stakeholder têm acesso total aos Repositórios do Azure, incluindo exibição, clonagem e contribuição para o código.

Categoria Requisitos
Acesso ao Projeto Membro de um projeto.
Permissões - Exibir código: no mínimo acesso Básico.
- Clonar ou contribuir para o código: Membro do grupo de segurança Colaboradores ou com permissões correspondentes no projeto.
Serviços Repositório habilitado.

Listar 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, acesse esse projeto no portal da Web e selecione Repos>Pull requests.

    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 repositório.

  3. O modo de exibição padrão mostra suas PRs na guia Mina . Selecione Ativo para mostrar todos os PRs ativos para o repositório atual. Selecione Concluído ou Abandonado para apresentar listas de PRs fechadas.

    Selecione qualquer PR na lista para acessar a página visão geral da PR.

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

  4. Você pode listar todas as suas solicitações pull (PRs) em diferentes projetos em sua organização escolhendo Solicitações Pull na visão Meu Trabalho.

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

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

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

Para filtrar a lista de solicitações pull, na página Pull requests, selecione o ícone Filtrar no canto superior direito. Em seguida, selecione branch de destino ou outro cabeçalho de coluna e selecione o branch ou outro valor pelo qual deseja filtrar.

Para personalizar ainda mais o modo de exibição da lista de RP, selecione Personalizar o modo de exibição no canto superior direito na página Desativar solicitações .

Captura de tela mostrando o botão Personalizar exibição na página de Pull requests.

Na página Personalizar exibição, você pode reorganizar as seções de exibição atuais, 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 as 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 da seção Personalizar.

Essas exibições personalizadas criam seções separadas e colapsáveis na página de pull request. Essas consultas personalizadas também funcionam entre repositórios na guia Minhas solicitações de pull da home page da organização. Captura de tela da página de Pull Requests mostrando seções colapsáveis.

Para alterar os parâmetros das exibições personalizadas, selecione o botão Personalizar ao lado do modo de exibição. Ou selecione Personalizar modo de exibição e, na tela Personalizar exibição, selecione a 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 selecione entre as opções.

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

  • Palavra-chave: insira uma 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 do comentário: Ativo (padrão), Pendente, Resolvido, Como projetado, Não será corrigido, 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 do navegador, do Visual Studio ou da CLI do Azure, a página Visão geral de PR é aberta no navegador.

Para abrir um PR no navegador, selecione o PR na lista na página de Pull Requests. A PR é aberta na sua guia Visão Geral. A guia Visão Geral mostra o título da PR, a descrição, os revisores, os itens de trabalho vinculados, o histórico e o status. Você pode ver um resumo das políticas de ramo que estão passando ou falhando, e ver os comentários que os revisores fizeram.

Captura de tela que mostra a guia Visão Geral do P R.

Na aba Arquivos do PR, você pode revisar as alterações efetivas nos arquivos do PR. Nas guias Atualizações e Commits, você pode ver as alterações feitas pelo autor para atualizar o ramo PR.

Para revisar as alterações, fazer comentários ou sugestões ou aprovar ou votar na PR, consulte Examinar 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 P R do Azure Repos em um dispositivo móvel.

Próximas etapas

Analisar as solicitações de pull