Notificações por email › Como usar modelos de email › Modelos de email personalizados › API de modelo de email › util

util

Objeto utilitário.

Método:

• getNotifiers(String [,String])

  Retorna IDs de email com base em uma regra de notificação.

  O primeiro argumento oferece suporte às seguintes regras de notificação predefinidas, entre aspas:

  • "ADMIN". Envia o email ao administrador que iniciou a tarefa.
  • "USER". Envia email ao usuário no contexto atual.
  • "USER_MANAGER". Envia o email ao gerente do usuário no contexto atual.

  Você também pode fazer referência a uma regra de notificação personalizada que você cria com a API de regra de notificação. Para obter informações, consulte o Guia de Programação do Java.

  O segundo argumento é opcional. Você pode usá-lo para passar um ou mais pares de nome/valor definidos pelo usuário a uma regra de notificação personalizada. Separe cada par de nome/valor com uma vírgula, no seguinte formato:

  "nome1=valor1,nome2=valor2,..."
  

Exemplos:

<% 

_to = _util.getNotifiers("ADMIN");_cc = "";
%>
<% 
_to = _util.getNotifiers("MYRULE","type=loan,district=3");
_cc = "";
%>

Notificando um gerenciador de usuários

Você pode usar a regra de notificação USER_MANAGER para enviar email a gerenciador de usuário. O CA Identity Manager usa essa regra no modelos de email que ofereçam suporte à certificação dos direitos dos usuários.

Observação: a Regra de notificação USER_MANAGER se aplica somente a eventos ou tarefas que criam ou gerenciam um único usuário.

Como existem várias maneiras de especificar uma relação entre usuário e gerenciador em um diretório de usuários, o Adaptador de notificação de gerenciador de usuários padrão resolve essa relação com base em uma expressão de atributo especificada no segundo parâmetro do método getNotifiers ().

Exemplo:

<% 
_to = _util.getNotifiers("USER_MANAGER","ManagerLookup=managerattribute");
_cc = "";
%>

O Adaptador de notificação de gerenciador de usuários oferece suporte a duas opções de pesquisa:

• managerattribute =<Nome_do_atributo do gerenciador>- onde o objeto User mantém um atributo que indica o DN ou UserID do gerenciador do usuário
• commonattribute = <Nome_do_atributo> - onde o usuário e o gerenciador do usuário compartilham um valor de atributo comum, como "departamento"

É possível configurar essas opções de pesquisa em Miscellaneous Properties de um ambiente no Management Console do CA Identity Manager.

Para configurar a regra de notificação USER_MANAGER:

1. No Management Console do CA Identity Manager, selecione Environment do CA Identity Manager. Em seguida, selecione o ambiente para o qual você está configurando a notificação por email.
2. Selecione Advanced Settings>Miscellaneous Properties.
3. Na página Miscellaneous Properties, conclua as etapas de configuração para a opção de pesquisa que deseja usar:
   • Para usar a opção de pesquisa managerattribute=<Nome_do_atributo do gerenciador>:
     1. No campo Property, digite managerattribute.
     2. No campo Value, insira o atributo que armazena o DN ou a ID de usuário do gerenciador.
     3. Clique em Adicionar.
     4. Clique em Salvar.
   • Para usar a opção de pesquisa commonattribute=<Nome_do_atributo>:
     1. No campo Property, digite commonattribute.
     2. No campo Value, insira o atributo que o usuário e o gerenciador de usuários têm em comum.
     3. Clique em Adicionar.
     4. No campo Property, digite
        ismanagerfilter.
     5. No campo Value, insira uma expressão de pesquisa usando a seguinte sintaxe:

        <atributo> <operador> <filtro>

        Por exemplo, título EQUALS gerenciador

     6. Clique em Adicionar.
     7. Clique em Salvar.

Você também pode criar um adaptador personalizado e suas próprias regras para notificar um gerenciador de usuários. Consulte o Guia de Programação do Java.