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

  • Artigo

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 pesquisa e a seleção de identidade.

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.

Seleção de pesquisa de identidade

  1. Insira @ um comentário de código em uma solicitação de pull para disparar o seletor de pessoas @mention .
  2. Veja a lista de usuários que você mencionou recentemente.
  3. 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.

Captura de tela do seletor de pessoas

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.

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

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.
  • Se você @mention um grupo que não tem membros, nenhum e-mail será enviado, mesmo que o grupo seja membro de outros grupos.

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.

Captura de tela de Email enviadas no Outlook.

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.

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 na ID do Microsoft Entra 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 esperado.

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

Habilitar o recurso Limitar a visibilidade e a colaboração do usuário a projetos específicos impede que os usuários com escopo de projeto pesquisem usuários adicionados à organização por meio da associação de grupo do Microsoft Entra, em vez de por meio de um convite de usuário explícito. Esse é um comportamento inesperado e uma resolução está em andamento. Para resolver 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.