Exemplo: Ativando a Notificação por E-mail

Os modelos de adaptadores podem ser configurados para enviar uma notificação por e-mail aos usuários que causarem uma mudança no aplicativo externo. O exemplo a seguir mostra como configurar dois tipos de notificação:

Os procedimentos a seguir se referem a elementos no modelo ClearCaseByDate. Qualquer modelo de adaptador pode utilizar seus elementos para ativar a notificação.

Notifique todos os usuários que verificaram os arquivos do build atual

É possível usar o comando <adduser> para construir dinamicamente o grupo de usuários que efetuaram o registro de entrada do código para a construção e, em seguida, usar o comando <notify> para enviar notificações a esse grupo.

O modelo ClearCaseByDate consulta o ClearCase para obter uma visualização de todas as alterações entre os dois registros de data e hora. Os registros de data e hora padrão servem para o adaptador atual ser executado e também para o último adaptador ser executado. Em termos práticos, isso se transforma em uma lista de todas as alterações desde o último build, que foram verificadas no build atual.

Suposição: todos os nomes de usuários na visualização são conhecidos para o servidor SMTP que você utiliza para notificação com esse nome. Isso significa que os nomes de usuários do ClearCase precisam se alinhar com os nomes de usuários de e-mail.

Para ativar essa notificação:

  1. Abra o modelo do adaptador ClearCaseByDate em um editor XML.
  2. Localize e edite o <adduser> para criar um grupo de usuários, como a seguir:
    <adduser group="MyChangers" user="$4">
    O parâmetro posicional $4 se refere ao campo de nome de usuário que é mostrado na visualização do ClearCase criada pelo modelo ClearCaseByDate.
  3. Configure a notificação para enviar um e-mail a esse grupo. A configuração a seguir envia e-mail quando o projeto falha e quando o projeto tem êxito. Em alguns ambientes, você pode preferir a notificação somente se o build falhar.
    <!-- Set some notifications for when the build completes -->
    		<onproject result="fail">
    			<notify group="MyChangers" subject="Build $BF_TAG ($CurDate) Failed." message="${Changing}${Changes}"/>
    		</onproject>
    		<onproject result="pass">
    			<notify group="MyChangers" subject="Build $BF_TAG ($CurDate) Passed." message="${Changing}${Changes}"/>
    		</onproject>

  4. Salve o modelo do adaptador.

Quando o adaptador for executado, o grupo MyChangers é criado a partir dos nomes de usuário na visualização. A notificação por e-mail é enviada a esse grupo quando o projeto de construção é concluído.

Notifique todos os usuários que pertencem a um grupo de acesso do Build Forge

Nesse exemplo, você deseja notificar todos os membros de um grupo de acesso do Build Forge. O modelo do adaptador ClearCaseByDate é utilizado como exemplo. Suposição: todos os nomes de usuários no Build Forge correspondem a nomes de usuários de e-mail no servidor SMTP.

  1. Abra o modelo do adaptador ClearCaseByDate em um editor XML.
  2. Localize e edite o <adduser> para criar um grupo de usuários a partir de um grupo de acesso do Build Forge, como a seguir:
    <adduser group="Developer_Access_Group" user="Developer">
  3. Configure a notificação para enviar um e-mail a esse grupo. A configuração a seguir envia e-mail quando o projeto falha e quando o projeto tem êxito. Em alguns ambientes, você pode preferir a notificação somente se o build falhar.
    <!-- Set some notifications for when the build completes -->
    		<onproject result="fail">
    			<notify group="Developer_Access_Group" 
             subject="Build $BF_TAG ($CurDate) Failed." message="${Changing}${Changes}"/>
    		</onproject>
    		<onproject result="pass">
    			<notify group="Developer_Access_Group" 
             subject="Build $BF_TAG ($CurDate) Passed." message="${Changing}${Changes}"/>
    		</onproject>

  4. Salve o modelo do adaptador.

Quando o adaptador for executado, o grupo Developer_Access_Group é criado a partir dos nomes de usuário que pertencem ao grupo de acesso Desenvolvedores. A notificação por e-mail é enviada a esse grupo quando o projeto de construção é concluído.

Importante: Se a diretiva <notify> falhar (por exemplo, se o usuário a quem o e-mail está endereçado não existir), o .xml falhará e todas as notificações subsequentes falharão.

Feedback