eventContextInformation

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

eventContextInformation

Contém informações sobre o evento gerado pela tarefa atual, como nome do evento e status de aprovação. Essas informações são chamadas de informações de contexto do evento.

O objeto _eventContextInformation é criado a partir da classe ExposedEventContextInformation no pacote com.netegrity.imapi.

Esse objeto está disponível para mensagens de email com base em modelos Aprovados, Pendentes e Recusados. Para obter informações sobre esses modelos, consulte Modelos de email.

Métodos: todos os métodos a seguir retornam uma sequência de caracteres.

Método	Descrição
getAdminName()	Retorna o nome da pessoa que enviou a tarefa que gerou o evento. Substituído no CA Identity Manager 5.6. Use um dos seguintes métodos herdados: getAdministrator() getAdminFriendlyName()
getApprovalStatus()	Retorna o status de aprovação do evento. Um destes valores: APPROVAL_STATUS_APPROVED APPROVAL_STATUS_REJECTED
getApprovalTime()	Retorna a hora em que o evento foi aprovado.
getEventName()	Retorna o nome do evento. Para obter uma lista de nomes de eventos, consulte Eventos do CA Identity Manager.
getOrgName()	Retorna o nome amigável da organização na qual a tarefa está sendo executada. Substituído no CA Identity Manager 5.6. Use o método herdado getObjectOrganizationFriendlyName().
getPassword()	Se os objetos principais forem do tipo USER, retorna a senha do usuário.
getPrimaryObjectTypeName()	Retorna o tipo de objeto principal. Tipos de objeto principal retornados: ACCESSROLE ACCESSTASK ADMINROLE ADMINTASK GROUP ORGANIZATION USER
getPrimaryObjectName()	Retorna o nome do objeto principal afetado pelo evento. Um objeto principal é o objeto afetado diretamente pelo evento. Um objeto secundário é o objeto ao qual o objeto principal está vinculado, se houver. Por exemplo: O tipo de objeto principal para CreateUserEvent é USER. O objeto secundário é o objeto em que o usuário foi criado, isto é, ORGANIZATION. O tipo de objeto principal para CreateAdminRoleEvent é ADMINROLE. Esse objeto não está vinculado a outros objetos, portanto, não há objeto secundário. Com um objeto principal do tipo USER, getPrimaryObjectName() pode retornar John Jones.
getSecondaryObjectTypeName()	Se um objeto secundário foi afetado pelo evento, retorna o tipo de objeto. Tipos de objeto secundário retornados: ACCESSROLE ACCESSTASK ADMINROLE ADMINTASK GROUP ORGANIZATION USER
getSecondaryObjectName()	Se um objeto secundário foi afetado pelo evento, retorna o nome do objeto. Consulte getPrimaryObjectName() para obter informações sobre objetos principal e secundário. Com um objeto secundário do tipo ORGANIZATION, o método getSecondaryObjectName() pode retornar RH.

Observação: os métodos em _eventContextInformation são fornecidos por meio da interface ExposedEventContextInformation. Como ExposedEventContextInformation herda métodos na API principal do CA Identity Manager, _eventContextInformation também pode chamar esses métodos de um modelo de email, juntamente com os métodos na tabela acima. Para obter mais informações sobre esses métodos herdados, consulte Métodos adicionais.

Exemplo - notificação por email sobre um evento Pendente:

<% 

_cc = "" ;_bcc = ""; 
_subject = _eventContextInformation.getEventName() +
                                             " Approval Request";
%>
<!--- Start of Body --->
<html>
<body text="Navy">

The following item has been added to your work list for approval:
<br><br><br>
Event: <b><%=_eventContextInformation.getEventName()%></b> <br>
<%=_eventContextInformation.getPrimaryObjectTypeName()%>:
<b><%=_eventContextInformation.getPrimaryObjectName()%></b><br>
In <%=_eventContextInformation.getSecondaryObjectTypeName()%>: 
<b><%=_eventContextInformation.getSecondaryObjectName()%></b><br>
</body>
</html>

Possível corpo do email:

De: lsmith@security.com [mailto:lsmith@security.com] 
Para: vimperioso@security.com
Assunto: CreateUserEvent Approval Request

The following item has been added to your work list for approval:

Event: CreateUserEvent
USER: Richard Ferrigamo
In ORGANIZATION: Mortgages & Loans

Observação: o valor do campo De é derivado do arquivo email.properties. Para alterar o valor, edite o seguinte arquivo:

<iam_im.ear>\config\com\netegrity\config\email.properties

onde <iam_im.ear> é o local de instalação do CA Identity Manager no domínio do servidor de aplicativo. Por exemplo:

Para WebLogic:

<base_do_WebLogic>\user_projects\<domain>\applications\iam_im.ear

Para JBoss:

<base_do_Identity Manager>\jboss-3.2.2\server\default\deploy\iam_im.ear

Para WebSphere:

<dir_ferramentas_administrativas_im>\WebSphere-ear\iam_im.ear

Para adicionar mais informações sobre o usuário afetado pelo evento ao email no exemplo anterior, adicione texto semelhante ao seguinte:

<% user = _eventContextInformation.getEvent().getUser(); %>
<b>User information:</b><br>
Last Name: <b><%=user.getAttribute("%LAST_NAME%")%></b><br>   
First Name: <b><%=user.getAttribute("%FIRST_NAME%")%></b><br>
Full Name: <b><%=user.getAttribute("%FULL_NAME%")%></b><br>
Email: <b><%=user.getAttribute("%EMAIL%")%></b><br>
Organization Membership: <b><%=user.getAttribute("%ORG_MEMBERSHIP%")%></b><br>

Possível corpo do email:

De: lsmith@security.com [mailto:lsmith@security.com] 
Para: vimperioso@security.com
Assunto: CreateUserEvent Approval Request

The following item has been added to your work list for approval:

Event: CreateUserEvent
USER: Richard Ferrigamo
In ORGANIZATION: Mortgages & Loans
User information:
Last Name: Ferrigamo
First Name: Richard
Full Name: Richard Ferrigamo
Email: rferrigamo@mybank.org
Organization Membership: Mortgages & Loans