Partilhar via


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

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

Muitos fatores determinam os destinatários de uma notificação por e-mail 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.

Nota

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 preferido do usuário que possui a assinatura ou no endereço de e-mail configurado na assinatura.

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.

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

Captura de ecrã do endereço de e-mail preferido.

Endereço de e-mail personalizado numa subscrição pessoal

Captura de ecrã do endereço de e-mail personalizado.

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.>

    Captura de ecrã a mostrar as definições de Entrega de Equipa.

  1. 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 da equipa. Essa configuração geralmente é a opção padrão. Para obter mais informações sobre a opção padrão, consulte Expansão da equipe.

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

    Captura de tela mostrando a caixa de diálogo Configurações de entrega de equipe.

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 a membros individuais ou Não entregar.

Gorjeta

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 de subscrição de equipa e grupo personalizados

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.

email-team-delivery-options

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 do grupo que têm uma das funções selecionadas (por exemplo, cessionário do 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 e-mail preferido ou membros da equipe)
  • Endereço de e-mail personalizado: destinatário é o endereço de e-mail especificado
  • Membros da equipa: os destinatários são todos os membros da equipa ou do grupo, exceto os membros que optaram por não participar na subscrição.
  • SOAP: semelhante ao Gerenciamento de API, os destinatários são especificados adicionando seus endereços de e-mail (assinatura) ao serviço SOAP.

Nota

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

Membro da equipa por função

A lista de destinatários do e-mail é 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 atribuída ao item de trabalho tem a função Atribuída a (anterior). A lista completa de funções para cada tipo de evento é mostrada nos tipos de evento suportados.

Captura de tela mostrando a função de opção de entrega da equipe de e-mail.

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 equipa

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 a membros individuais: Veja a seguinte opção, Membros de team_.
  • Não entregar: Nenhum e-mail é entregue.

Captura de tela mostrando a preferência da opção de entrega da equipe de e-mail.

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 e-mail personalizados, separados por ponto-e-vírgula.

Captura de ecrã a mostrar opções de entrega personalizadas da equipa de e-mail.

Membros da equipa

A associação de equipe ou grupo é expandida para determinar os destinatários do e-mail. 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.

Captura de tela mostrando o nome de uma equipe para entrega de e-mail.

Destinatários de subscrição predefinidos

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 suportados.

Captura de ecrã a mostrar os destinatários das subscrições predefinidas.

Nota

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 e-mail

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 e-mail. Este é um processo potencialmente recursivo que começa por olhar para os membros diretos da equipa.

Apenas os membros que não optaram por não participar na subscrição 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 cumprir": não é feita mais nenhuma avaliação 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: utilizador 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 seja notificado através dos 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 a 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 a 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 seja notificado através dos seus endereços de e-mail preferidos. Os membros do não são notificados, pois o Azure DevOps não expande grupos do A1 AD ao entregar notificações.