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

  • Artigo

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

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

Para organizações que gerenciam seus usuários e grupos usando o Microsoft Entra ID, os seletores de pessoas suportam a 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 a pesquisa e a seleção de identidade.

Nota

Você pode postar um @mention via 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 que você adicione rapidamente um usuário a um item de trabalho ou discussão de solicitação pull. Usando o seletor de pessoas do controle de @mention , você pode selecionar um membro do projeto na lista de pesquisa e ele receberá um e-mail notificando-o do seu comentário.

Para organizações que gerenciam seus usuários usando o Ative Directory, os seletores de pessoas fornecem suporte para pesquisar todos os usuários adicionados ao Ative 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 rich-text
  • Uma discussão de pull request
  • Confirmar comentários
  • Comentários do conjunto de alterações ou do conjunto de prateleiras
  • Uma discussão de item de trabalho
  • Uma discussão de pull request
  • Confirmar comentários
  • Comentários do conjunto de alterações ou do conjunto de prateleiras

Nota

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

Seleção de pesquisa de identidade

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

Aviso

Se tiver permissão para convidar utilizadores para a organização, independentemente de a política Restringir convites estar desativada, pode @mention um utilizador que não faça parte da sua organização. Esta ação convida esse usuário para sua organização. Para obter mais informações, consulte Restringir convites de novos usuários de administradores de projeto e equipe.

Para filtrar a lista, introduza o nome de utilizador ou alias até encontrar uma correspondência.

Captura de tela do seletor de pessoas

Você também pode usar menções de grupo. Introduza o nome de uma equipa ou de um grupo de segurança, escolha Procurar e, em seguida, selecione uma das opções listadas.

Para @mention um usuário que você nunca selecionou anteriormente, continue digitando 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 eles foram adicionados à conversa.

Captura de tela da seção de discussão com a menção feita.

Nota

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 inserida corretamente, ela não se registra como uma menção verdadeira nem envia uma notificação por e-mail.

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

Captura de ecrã do e-mail enviado no Outlook.

Use o controle @mention em discussões de solicitação pull, comentários de confirmação, 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 ao 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 apenas aos usuários e grupos adicionados a um projeto específico, elas podem fazer isso habilitando o recurso de visualização Limitar a visibilidade e a colaboração do usuário a projetos específicos para sua organização.

Importante

  • As funcionalidades de visibilidade limitada descritas nesta secção aplicam-se apenas às interações através do portal Web. Com as APIs REST ou azure devops os 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 pesquisar usuários com o seletor de pessoas. Quando o recurso de visualização está 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 de visualização Limitar a visibilidade e a colaboração do usuário a projetos específicos está habilitado para uma organização, a lista de identidades que você pode selecionar de 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 contenha 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 aos usuários e grupos adicionados explicitamente ao projeto ao qual estão conectados.

Aviso

Quando o recurso de visualização 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 podem pesquisar usuários que foram adicionados à organização por meio da associação ao grupo Microsoft Entra, em vez de por meio de um convite explícito de usuário. Este é um comportamento inesperado e uma resolução está sendo trabalhada. Para resolver automaticamente esse problema, desative o recurso de visualização Limitar a visibilidade e a colaboração do usuário a projetos específicos para a organização.