Usar @mentions em itens de trabalho e solicitações de pull

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019 | TFS 2018

O controle @mention permite que você adicione rapidamente um usuário ou grupo a um item de trabalho ou discussão de solicitação de pull. Usando o seletor de pessoas do controle @mention , você pode selecionar um membro ou grupo do projeto na lista de pesquisa e eles recebem um email notificando-os sobre seu comentário.

Para organizações que gerenciam seus usuários e grupos usando o Microsoft Entra ID, os seletores de pessoas oferecem suporte à pesquisa de todos os usuários e grupos adicionados ao Microsoft Entra ID, não apenas os usuários e grupos adicionados ao seu projeto. Para limitar o conjunto a membros e grupos do projeto, consulte Gerenciar sua organização, Limitar pesquisa e seleção de identidade.

Observação

Você pode postar um @mention por meio da API. Obter a ID de Usuário do Azure DevOps

Se sua organização estiver usando o edtitor HTML existente, adicione o seguinte código html:: <div><a href="#" data-vss-mention="version:2.0,{user id}">@John Doe</a> Testing mentioning</div>

Se sua organização estiver usando o novo edtitor Markdown para comentários, você poderá usar o seguinte código: @<UserID>

O controle @mention permite adicionar rapidamente um usuário a um item de trabalho ou discussão de solicitação de pull. Usando o seletor de pessoas do controle @mention , você pode selecionar um membro do projeto na lista de pesquisa e eles recebem um email notificando-os sobre seu comentário.

Para organizações que gerenciam seus usuários usando o Active Directory, os seletores de pessoas dão suporte para pesquisar todos os usuários adicionados ao Active Directory, não apenas os usuários adicionados ao seu projeto.

Use o controle @mention para iniciar ou continuar uma discussão nas seguintes áreas:

  • Uma discussão de item de trabalho ou qualquer campo de rich text
  • Uma discussão de solicitação de pull
  • Comentários de commit
  • Comentários de conjunto de alterações ou de conjunto de prateleiras
  • Uma discussão de item de trabalho
  • Uma discussão de solicitação de pull
  • Comentários de commit
  • Comentários de conjunto de alterações ou de conjunto de prateleiras

Observação

Para Azure DevOps Server locais, configure um servidor SMTP para que os membros da equipe vejam a opção Notificações no menu de perfil da organização ou do usuário e recebam notificações.

Seleção de pesquisa de identidade

Quando você deixar um comentário de código em uma solicitação de pull, insira @ para disparar o seletor de @mention pessoas. No seletor de pessoas, você verá uma lista de usuários mencionados recentemente. Para fazer uma pesquisa de diretório, escolha um nome ou insira o nome do usuário que você está procurando.

Aviso

Se você tiver permissão para convidar usuários para a organização, independentemente de a política Restringir convites ser desabilitada , poderá @mention um usuário que não faz parte da sua organização. Essa ação convida esse usuário para sua organização. Para obter mais informações, consulte Restringir novos convites de usuários de administradores de projeto e de equipe.

Para filtrar a lista, insira o nome de usuário ou o alias até encontrar uma correspondência.

Screenshot of people picker

Você também pode usar menções de grupo. Insira o nome de uma equipe ou um grupo de segurança, escolha Pesquisar e selecione entre as opções listadas.

Para @mention um usuário que você nunca selecionou anteriormente, continue inserindo o nome inteiro para fazer sua pesquisa no diretório completo.

Os nomes dos usuários mencionados aparecem em texto azul. Escolha o nome do link @mention para abrir as informações de contato do usuário. As informações de contato fornecem mais contexto para o motivo pelo qual foram adicionadas à conversa.

Screenshot of discussion section with at mention made.

Web portal, At mention user contact information accessible

Observação

Não copie/cole @mention usuários de um comentário anterior. Embora a formatação resultante pareça idêntica a uma menção corretamente inserida, ela não se registra como uma menção verdadeira nem envia uma notificação por email.

Após a conclusão da seleção e da entrada de texto, o usuário @mention recebe um email alertando-o sobre a menção.

Screenshot of Email sent in Outlook.

Email sent to at-mention user organization

Use o controle @mention em discussões de solicitação de pull, comentários de commit, comentários de conjunto de alterações e comentários de conjunto de prateleiras.

Identidades limitadas na seleção de pesquisa

Em geral, os seletores de pessoas pesquisam e selecionam qualquer usuário ou grupo adicionado à ID do Microsoft Entra de uma organização.

Para organizações que gerenciam seus usuários e grupos usando a ID do Microsoft Entra, os seletores de pessoas fornecem suporte para pesquisar usuários e grupos adicionados à ID do Microsoft Entra. Para organizações que desejam limitar a pesquisa e a seleção somente aos usuários e grupos adicionados a um projeto específico, eles podem fazer isso habilitando o recurso Limitar visibilidade e colaboração do usuário à versão prévia de projetos específicos para sua organização.

Importante

  • Os recursos de visibilidade limitados descritos nesta seção se aplicam apenas a interações por meio do portal da Web. Com as APIs REST ou azure devops comandos da CLI, os membros do projeto podem acessar os dados restritos.
  • Os usuários convidados que são membros do grupo limitado com acesso padrão no Microsoft Entra ID, não podem procurar usuários com o seletor de pessoas. Quando o recurso de visualização é desativado para a organização ou quando os usuários convidados não são membros do grupo limitado, os usuários convidados podem pesquisar todos os usuários do Microsoft Entra, conforme o esperado.

Quando o recurso limitar a visibilidade e a colaboração do usuário a projetos específicos de visualização estiver habilitado para uma organização, a lista de identidades que você pode selecionar em um seletor de pessoas é limitada de uma das seguintes maneiras:

  • Os usuários adicionados ao grupo Usuários com Escopo do Projeto só podem selecionar em uma lista de identidade que contém usuários e grupos adicionados explicitamente ao projeto ao qual estão conectados.
  • Se todos os membros do projeto forem adicionados ao grupo Usuários com Escopo do Projeto , os seletores de pessoas serão limitados apenas aos usuários e grupos adicionados ao projeto. Todos os membros do projeto só podem selecionar identidades que correspondam a usuários e grupos adicionados explicitamente ao projeto ao qual estão conectados.

Aviso

Quando o recurso Limitar a visibilidade e a colaboração do usuário a projetos específicos está habilitado para a organização, os usuários com escopo de projeto não conseguem pesquisar usuários que foram adicionados à organização por meio da associação ao grupo do Microsoft Entra, em vez de por meio de um convite explícito do usuário. Esse é um comportamento inesperado e uma resolução está sendo trabalhada. Para resolver esse problema automaticamente, desabilite o recurso Limitar visibilidade e colaboração do usuário à versão prévia de projetos específicos para a organização.