Uso @mentions em itens de trabalho e solicitações de pull
Azure DevOps Services | 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 de pull. Usando o seletor de pessoas no controle @mention , você pode selecionar um membro ou grupo do projeto na lista de pesquisa. O usuário ou grupo mencionado recebe uma notificação por e-mail sobre seu comentário.
Para organizações que gerenciam seus usuários e grupos usando a ID do Microsoft Entra, os seletores de pessoas dão suporte à pesquisa de todos os usuários e grupos na ID do Microsoft Entra. Você pode pesquisar usuários e grupos além dos usuários adicionados ao seu projeto. Para obter mais informações, consulte Limitar a visibilidade do usuário em projetos e muito mais.
Observação
Você pode postar um @mention por meio da API. Para obter a ID de usuário do Azure DevOps, consulte Obter a ID de Usuário do Azure DevOps.
- Se sua organização estiver usando o editor de 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 editor Markdown para comentários, use 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 no controle @mention , você pode selecionar um membro do projeto na lista de pesquisa. O usuário mencionado recebe uma notificação por e-mail sobre seu comentário.
Para organizações que gerenciam seus usuários usando o Active Directory, os seletores de pessoas dão suporte à pesquisa de todos os usuários no Active Directory, não apenas dos usuários adicionados ao seu projeto.
Use o controle @mention para iniciar ou continuar uma discussão nas seguintes áreas:
- Discussões de item de trabalho ou quaisquer campos rich text
- Discussões de solicitação de pull
- Comentários de commit
- Comentários de conjunto de alterações ou de conjunto de prateleiras
- Discussões de item de trabalho
- Discussões 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.
Pré-requisitos
| Categoria | Requisitos |
|---|---|
| Acesso ao projeto | Membro do projeto. |
Seleção de pesquisa de identidade
- Insira @ um comentário de código em uma solicitação de pull para disparar o seletor de pessoas @mention .
- Veja a lista de usuários que você mencionou recentemente.
- Pesquise o diretório selecionando um nome na lista ou inserindo 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 alias até encontrar uma correspondência.
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, fornecendo mais contexto para o motivo pelo qual ele foi adicionado à conversa.
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.
Observação
Não copie e cole @mention usuários de um comentário anterior. Embora a formatação possa parecer idêntica a uma menção inserida corretamente, ela não é registrada como uma menção verdadeira e não envia uma notificação por e-mail.
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.
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.
Dica
Como não há macro direta @CreatedBy , você pode usar a @Me macro em combinação com o campo "Criado por" para filtrar itens de trabalho criados por você. Por exemplo, para marcar o criador de itens com descrições em branco, você pode executar uma consulta para identificar esses itens e, em seguida, marcar manualmente os criadores na seção de comentários de cada item de trabalho, solicitando que eles atualizem a descrição.
Identidades limitadas na seleção de pesquisa
Os seletores de pessoas geralmente pesquisam e selecionam qualquer usuário ou grupo adicionado à ID do Microsoft Entra de uma organização.
Para organizações que usam a ID do Microsoft Entra para gerenciar usuários e grupos, os seletores de pessoas dão suporte à pesquisa de todos os usuários e grupos dentro do diretório. Para limitar a pesquisa e a seleção apenas aos usuários e grupos adicionados a um projeto específico, ative o recurso de visualização Limitar a visibilidade e a colaboração do usuário a projetos específicos para sua organização.
Quando o recurso 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 em um seletor de pessoas é limitada das seguintes maneiras:
- Os usuários adicionados ao grupo Usuários com Escopo do Projeto só podem selecionar em uma lista de identidades que contenha usuários e grupos explicitamente adicionados 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 explicitamente adicionados ao projeto ao qual estão conectados.
Aviso
Considere as seguintes limitações ao usar este recurso de visualização:
- 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 devopscomandos da CLI, os membros do projeto podem acessar os dados restritos. - Os usuários do grupo limitado só podem selecionar usuários que são adicionados explicitamente ao Azure DevOps e não aos usuários que têm acesso por meio da associação de grupo do Microsoft Entra.
- Os usuários convidados que são membros do grupo limitado com acesso padrão na ID do Microsoft Entra não podem pesquisar usuários com o seletor de pessoas.