_eventContextInformation

Notifications par courriel › Utilisation des modèles de courriel › Modèles de courriel personnalisés › API de modèle de courriel › _eventContextInformation

_eventContextInformation

Contient des informations sur l'événement généré par la tâche actuelle, telles que le nom de l'événement et le statut d'approbation. Ces informations sont appelées informations de contexte de l'événement.

L'objet _eventContextInformation est créé à partir de la classe ExposedEventContextInformation dans le package com.netegrity.imapi.

Cet objet est disponible pour les courriels basés sur des modèles approuvés, en attente et rejetés. Pour plus d'informations sur ces modèles, consultez la section Modèles de courriel.

Méthodes : toutes les méthodes suivantes renvoient une chaîne.

Méthode	Description
getAdminName()	Renvoie le nom de l'utilisateur ayant soumis la tâche qui a généré l'événement. Désapprouvée dans CA Identity Manager 5.6. Utilisez l'une des méthodes héritées suivantes : getAdministrator() getAdminFriendlyName()
getApprovalStatus()	Renvoie le statut d'approbation de l'événement. Une des valeurs suivantes : APPROVAL_STATUS_APPROVED APPROVAL_STATUS_REJECTED
getApprovalTime()	Renvoie l'heure d'approbation de l'événement.
getEventName()	Renvoie le nom de l'événement. Pour obtenir une liste de noms d'événement, consultez la section Evénements CA Identity Manager.
getOrgName()	Renvoie le nom convivial de l'organisation dans laquelle la tâche est exécutée. Désapprouvée dans CA Identity Manager 5.6. Utilisez la méthode héritée getObjectOrganizationFriendlyName().
getPassword()	Si les objets principaux sont de type USER, renvoie le mot de passe de l'utilisateur.
getPrimaryObjectTypeName()	Renvoie le type d'objet principal. Types d'objet principal renvoyés : ACCESSROLE ACCESSTASK ADMINROLE ADMINTASK GROUP ORGANIZATION USER
getPrimaryObjectName()	Renvoie le nom de l'objet principal affecté par l'événement. Un objet principal est l'objet directement affecté par l'événement. Un objet secondaire est lié à l'objet principal, le cas échéant. Exemple : Le type d'objet principal pour CreateUserEvent est USER. L'objet secondaire est celui dans lequel l'utilisateur est créé, c'est-à-dire ORGANIZATION. Le type d'objet principal pour CreateAdminRoleEvent est ADMINROLE. Cet objet n'est pas lié à d'autres objets ; ainsi aucun objet secondaire n'existe. Avec un objet principal de type USER, getPrimaryObjectName() peut renvoyer John Jones.
getSecondaryObjectTypeName()	Si un objet secondaire a été affecté par l'événement, renvoie le type d'objet. Types d'objet secondaire renvoyés : ACCESSROLE ACCESSTASK ADMINROLE ADMINTASK GROUP ORGANIZATION USER
getSecondaryObjectName()	Si un objet secondaire a été affecté par l'événement, renvoie le nom de l'objet. Pour obtenir des informations sur les objets principaux et secondaires, consultez getPrimaryObjectName(). Avec un objet secondaire de type ORGANIZATION, la méthode getSecondaryObjectName() peut renvoyer RH.

Remarque : Les méthodes en _eventContextInformation sont fournies via l'interface ExposedEventContextInformation. Etant donné que ExposedEventContextInformation hérite des méthodes de l'API CA Identity Manager principale, _eventContextInformation peut également appeler ces méthodes à partir d'un modèle de courriel, avec les méthodes figurant dans le tableau ci-dessus. Pour plus d'informations sur ces méthodes héritées, consultez la section Méthodes supplémentaires.

Exemple : Notification par courriel sur un événement En attente :

<% 

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

Potentiel corps du courriel :

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

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

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

Remarque : La valeur du champ De provient du fichier email.properties. Pour modifier la valeur, modifiez le fichier suivant :

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

où <iam_im.ear> est l'emplacement d'installation de CA Identity Manager dans le domaine du serveur d'applications. Par exemple :

Pour WebLogic :

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

Pour JBoss :

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

Pour WebSphere :

<rép_outils_admin_im>\WebSphere-ear\iam_im.ear

Pour ajouter des informations supplémentaires sur l'utilisateur affecté par l'événement au courriel dans l'exemple précédent, ajoutez le texte similaire au suivant :

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

Potentiel corps du courriel :

From: lsmith@security.com [mailto:lsmith@security.com] 
To: vimperioso@security.com
Subject: 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