Tema anterior: _utilTema siguiente: _taskContextInformation


_eventContextInformation

Contiene información sobre el evento que genera la tarea actual, como el nombre del evento y estado de la aprobación. A esta información se la denomina "información de contexto" para el evento.

El objeto _eventContextInformation se crea a partir de la clase ExposedEventContextInformation en el paquete com.netegrity.imapi.

Este objeto está disponible para los mensajes de correo electrónico basados en plantillas Aprobado, pendiente y Rechazado. Para obtener información sobre estas plantillas, consulte Plantillas de correo electrónico.

Métodos: todos los siguientes métodos devuelven una cadena.

Método

Descripción

getAdminName()

Devuelve el nombre de la persona que ha enviado la tarea que ha generado el evento.

Desaprobado en CA IdentityMinder 5.6. Utilice uno de los siguientes métodos heredados:

  • getAdministrator()
  • getAdminFriendlyName()

getApprovalStatus()

Devuelve el estado de la aprobación del evento. Uno de estos valores:

APPROVAL_STATUS_APPROVED
APPROVAL_STATUS_REJECTED

getApprovalTime()

Devuelve la hora a la que se aprobó el evento.

getEventName()

Devuelve el nombre del evento.

Para obtener una lista de nombres de event, consulte Eventos de CA IdentityMinder.

getOrgName()

Devuelve el nombre descriptivo de la organización donde la tarea se está ejecutando.

Desaprobado en CA IdentityMinder 5.6. Utilice el método heredado getObjectOrganizationFriendlyName().

getPassword()

Si el tipo de los objetos primarios es USER, devuelve la contraseña del usuario.

getPrimaryObjectTypeName()

Devuelve el tipo de objeto primario.

Tipos de objeto primario que se devuelven:

ACCESSROLE
ACCESSTASK
ADMINROLE
ADMINTASK
GROUP
ORGANIZATION
USER

getPrimaryObjectName()

Devuelve el nombre del objeto primario al que afecta el evento.

Un objeto primario es el objeto al que afecta directamente el evento. Un objeto secundario es el objeto al que se ha vinculado el objeto primario, si hay alguno.

Por ejemplo:

  • El tipo de objeto primario para CreateUserEvent es USER. El objeto secundario es el objeto en el que se crea el usuario; es decir, ORGANIZATION.
  • El tipo de objeto primario para CreateAdminRoleEvent es ADMINROLE. Este objeto no se vincula a otros objetos, por lo que existen objetos secundarios.

Con un objeto primario del tipo USER, getPrimaryObjectName() podría devolver José García.

getSecondaryObjectTypeName()

Si existe un objeto secundario al que afectó el evento, se devuelve el tipo de objeto.

Tipos de objeto secundarios que se devuelven:

ACCESSROLE
ACCESSTASK
ADMINROLE
ADMINTASK
GROUP
ORGANIZATION
USER

getSecondaryObjectName()

Si existe un objeto secundario al que afectó el evento, se devuelve el nombre del objeto.

Consulte getPrimaryObjectName() para obtener información sobre los objetos principales y secundarios.

Con un objeto secundario del tipo ORGANIZATION, el método getSecondaryObjectName() podría devolver HR.

Nota: Se proporciona los métodos _eventContextInformation a través de la interfaz ExposedEventContextInformation. Como ExposedEventContextInformation hereda métodos en la API de CA IdentityMinder principal, _eventContextInformation puede llamar también a estos métodos a partir de una plantilla de correo electrónico, junto con los métodos de la tabla anterior. Para obtener más información sobre estos métodos heredados, consulte Métodos adicionales.

Ejemplo: notificación de correo electrónico sobre eventos Pendiente:

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

Se ha agregado el siguiente elemento a la lista de trabajos para la aprobación:
<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>

Posible cuerpo de correo electrónico:

From: lsmith@security.com [mailto:lsmith@security.com] 
To: vimperioso@security.com
Subject: CreateUserEvent Approval Request

Se ha agregado el siguiente elemento a la lista de trabajos para la aprobación:

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

Nota: El valor del campo Desde se obtiene del archivo email.properties. Para cambiar el valor, editar el siguiente archivo:

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

donde <iam_im.ear> es la ubicación de instalación de CA IdentityMinder en el dominio de servidor de aplicaciones. Por ejemplo:

Para WebLogic:

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

Para JBoss:

<Identity Manager_home>\jboss-3.2.2\server\default\deploy\iam_im.ear

Para WebSphere:

<im_admin_tools_dir >\WebSphere-ear\iam_im.ear

Para agregar información adicional sobre el usuario al que afecta el evento para el correo electrónico en el ejemplo anterior, agregue un texto que se parezca al siguiente:

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

Posible cuerpo de correo electrónico:

From: lsmith@security.com [mailto:lsmith@security.com] 
To: vimperioso@security.com
Subject: CreateUserEvent Approval Request

Se ha agregado el siguiente elemento a la lista de trabajos para la aprobación:

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