Determinar destinatários de e-mails de notificação

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Muitos fatores determinam os destinatários de uma notificação por email quando um evento corresponde a uma assinatura. Se você não estiver ciente, esses fatores podem fazer com que sua caixa de entrada receba muitos ou poucos e-mails. Saiba como o tipo de assinatura, suas configurações de entrega, preferências de entrega e outros fatores determinam o conjunto de destinatários.

Observação

Muitos dos conceitos abordados neste artigo são aplicáveis a versões anteriores do Azure DevOps, embora a interface do usuário possa ter sido alterada.

Subscrições pessoais personalizadas

Com a assinatura pessoal personalizada, os e-mails são entregues no endereço de e-mail preferencial do usuário proprietário da assinatura ou no endereço de e-mail configurado na assinatura.

Endereço de e-mail preferencial em uma assinatura pessoal (padrão)

Endereço de e-mail personalizado em uma assinatura pessoal

Configurações de entrega para equipes e grupos

As configurações de entrega controlam o comportamento de entrega padrão quando a equipe ou grupo é o destinatário de uma notificação. A assinatura é configurada com uma opção de entrega que examina as configurações de entrega dos destinatários.

Você pode gerenciar assinaturas e configurações de entrega no nível da equipe ou da organização.

Configurações no nível da organização

1. Em Configurações da organização, selecione Notificações>globais Assinantes> suas configurações de Entrega de equipe.>

   

2. Selecione uma das seguintes configurações:

• Entregar no endereço de e-mail: as notificações são entregues em um endereço de e-mail específico.

• Entregar a membros individuais: as notificações são entregues a cada membro do grupo ou equipe. Essa configuração geralmente é a opção padrão. Para obter mais informações sobre a opção padrão, consulte Expansão de equipe.

• Não entregar: as notificações não são entregues por padrão.

  

Se você não escolher explicitamente as configurações de entrega para uma equipe ou grupo, isso será determinado a partir da configuração de entrega no nível da organização. O padrão é Entregar para membros individuais ou Não entregar.

Dica

A caixa de diálogo de configurações de entrega não indica se a seleção atual foi definida explicitamente ou se foi herdada.

Destinatários personalizados de assinatura de equipe e grupo

Os destinatários de uma assinatura personalizada de equipe ou grupo são determinados pela assinatura. Mas, com certas opções de entrega, a configuração de entrega padrão da equipe é usada para determinar o conjunto de destinatários.

As seguintes opções de entrega estão disponíveis para uma assinatura de grupo ou equipe:

• Membros da equipe por função: os destinatários são membros da equipe ou grupo que têm uma das funções selecionadas (por exemplo, cessionário de item de trabalho)
• Preferência da equipe: os destinatários são determinados pela configuração de entrega da equipe ou grupo (Não entregar, endereço de email preferencial ou membros da equipe)
• Endereço de e-mail personalizado: destinatário é o endereço de e-mail especificado
• Membros da equipe: os destinatários são todos os membros da equipe ou do grupo, exceto os membros que optaram por não participar da assinatura.
• SOAP: semelhante ao Gerenciamento de API, os destinatários são especificados adicionando seus endereços de e-mail (assinatura) ao serviço SOAP.

Observação

A configuração de entrega padrão de cada membro é respeitada, incluindo grupos que são membros da equipe ou grupo.

Membro da equipe por função

A lista de destinatários do email é determinada pelos membros que tiveram uma função no evento. Por exemplo, o usuário atribuído ao item de trabalho tem a função Atribuído a (novo), enquanto a identidade que foi atribuída ao item de trabalho tem a função Atribuído a (anterior). A lista completa de funções para cada tipo de evento é mostrada nos tipos de evento com suporte.

A opção Ignorar iniciador, que aparece para a maioria dos tipos de evento, controla se o usuário ou grupo que iniciou o evento deve ser explicitamente excluído do conjunto de destinatários. Em geral, essa opção deve estar "ativada", já que a maioria dos usuários não quer receber uma notificação sobre algo que fez.

Preferência da equipe

A opção de entrega é retirada da configuração de entrega da equipe e pode ser uma das seguintes opções:

• Entregar no endereço de e-mail: o e-mail é entregue no endereço de e-mail preferido da equipe.
• Entregar para membros individuais: Veja a seguinte opção, Membros de team_.
• Não entregar: Nenhum e-mail é entregue.

O valor da configuração de entrega da equipe é exibido após o rótulo Endereço e não pode ser alterado.

Endereço de e-mail personalizado

A notificação é enviada para vários endereços de email personalizados, que são separados por ponto-e-vírgula.

Membros da equipe

A associação de equipe ou grupo é expandida para determinar os destinatários do email. No caso simples, uma equipe ou grupo se expande para uma lista de indivíduos e cada um é incluído na linha Para: do e-mail resultante. No entanto, os resultados dessa expansão podem ser complicados e são explicados com mais detalhes na seção de expansão de equipe e grupo.

Destinatários de assinatura padrão

A opção de entrega para uma assinatura padrão geralmente é uma ou mais funções. Não é possível alterar esses valores As funções e a opção Ignorar iniciador variam dependendo do tipo de evento. Para obter mais informações e uma lista de funções disponíveis para cada tipo de evento, consulte Tipos de eventos com suporte.

Observação

A opção Ignorar iniciador não está disponível para todos os tipos de evento.

Expansão de equipe e grupo para destinatários de email

Quando uma equipe ou grupo recebe uma notificação e a preferência de assinatura ou entrega é para todos os membros, a equipe deve ser "expandida" para determinar o conjunto real de destinatários de email. Trata-se de um processo potencialmente recursivo que começa com a observação dos membros diretos da equipe.

Apenas os membros que não optaram por não participar da assinatura são considerados para a lista final de destinatários. Qualquer membro que seja um usuário individual é adicionado à lista de destinatários.

Apenas os grupos dos Serviços de DevOps do Azure permanecem. Para cada grupo, as preferências de entrega do grupo são examinadas:

• "Não entregue": nenhuma avaliação adicional é feita sobre este grupo e o próximo grupo de membros é avaliado
• "Entregar no endereço de e-mail": o endereço de e-mail é adicionado à lista final de destinatários
• "Entregar a membros individuais": o grupo é expandido (como seu grupo pai) e as mesmas regras para avaliar seus membros são seguidas

Cenários

Vejamos alguns cenários. Usamos os seguintes símbolos para indicar os tipos de membros:

• I: usuário individual
• T: equipe ou grupo aninhado
• A: grupo Microsoft Entra habilitado para email.

Cenário	Exemplo
Um membro com preferência Não entregar	A equipe tem membros I1, I2e T1. T1A preferência de entrega é Não entregar. O que acontece: apenas I1 e I2 ser notificado através de seus endereços de e-mail preferidos. Os membros do T1 não são notificados.
Um membro com preferência Entregar a membros individuais	A equipe tem membros I1, I2e T1. T1A preferência de entrega é Entregar para membros individuais. T1 tem membros I2 e I3. O que acontece: T1 é expandido (por causa de sua preferência de entrega) e assim I1, I2e I3 ser notificado através de seus endereços de e-mail preferidos.
Um grupo aninhado	A equipe tem membros I1, I2e T1. T1 tem membros I2, I3e T2. T1A preferência de entrega é Não entregar. T2 tem membros I4 e I5. T2A preferência de entrega é Entregar para membros individuais. O que acontece: porque T1 não é expandido (porque sua preferência de entrega é "não entregar"), apenas I1 e I2 ser notificado através de seus endereços de e-mail preferidos.
Um membro que é um grupo do Microsoft Entra	A equipe tem membros I1, I2e A1. O que acontece: apenas I1 e I2 ser notificado através de seus endereços de e-mail preferidos. Os membros do não são notificados, pois o Azure DevOps não expande os grupos do A1 AD ao entregar notificações.

Artigos relacionados

• Gerenciar notificações para uma equipe, grupo, organização global
• Notificações padrão e com suporte
• Permissões, grupos de segurança e referência de contas de serviço