Vorheriges Thema: _utilNächstes Thema: _taskContextInformation


_eventContextInformation

Enthält Informationen zum Ereignis, das von der aktuellen Aufgabe generierte wurde, zum Beispiel Ereignisname und Genehmigungsstatus. Diese Informationen werden als Kontextinformationen für das Ereignis bezeichnet.

Das _eventContextInformation-Objekt wird aus der ExposedEventContextInformation-Klasse in Paket "com.netegrity.imapi" erstellt.

Dieses Objekt ist für E-Mail-Nachrichten verfügbar, die auf Vorlagen mit den Status "Genehmigt", "Ausstehend" und "Abgelehnt" basieren. Weitere Informationen zu diesen Vorlagen finden Sie unter E-Mail-Vorlagen.

Methoden: Alle folgenden Methoden geben eine Zeichenfolge zurück.

methode

Beschreibung

getAdminName()

Gibt den Namen der Person zurück, die die Aufgabe gesendet hat, die das Ereignis generiert hat.

Veraltete Methode in CA Identity Manager 5.6. Verwenden Sie eine der folgenden geerbten Methoden:

  • getAdministrator()
  • getAdminFriendlyName()

getApprovalStatus()

Gibt den Genehmigungsstatus des Ereignisses zurück. Einen dieser Werte:

APPROVAL_STATUS_APPROVED
APPROVAL_STATUS_REJECTED

getApprovalTime()

Gibt den Zeitpunkt zurück, zu dem das Ereignis genehmigt wurde.

getEventName()

Gibt den Namen des Ereignisses zurück.

Eine Liste der Ereignisnamen finden Sie unter "CA Identity Manager-Ereignisse".

getOrgName()

Gibt den Anzeigenamen der Organisation zurück, in der die Aufgabe ausgeführt wird.

Veraltete Methode in CA Identity Manager 5.6. Verwenden Sie die geerbte Methode "getObjectOrganizationFriendlyName()".

getPassword()

Wenn die primären Objekte vom Typ USER sind, wird das Kennwort des Benutzers zurückgegeben.

getPrimaryObjectTypeName()

Gibt den Typ des primären Objekts zurück.

Zurückgegebene primäre Objekttypen:

ACCESSROLE
ACCESSTASK
ADMINROLE
ADMINTASK
GROUP
ORGANIZATION
USER

getPrimaryObjectName()

Gibt den Namen des primären Objekts zurück, das vom Ereignis betroffen ist.

Ein primäres Objekt ist das Objekt, das vom Ereignis direkt betroffen ist. Ein sekundäres Objekt ist ggf. das Objekt, an welches das primäre Objekt gebunden ist.

Beispiel:

  • Der primäre Objekttyp für CreateUserEvent ist USER. Das sekundäre Objekt ist das Objekt, in dem der Benutzer erstellt wird - also ORGANIZATION.
  • Der primäre Objekttyp für CreateAdminRoleEvent ist ADMINROLE. Dieses Objekt ist nicht an andere Objekte gebunden, sodass kein sekundäres Objekt vorhanden ist.

Bei einem primären Objekt des Typs USER könnte mit getPrimaryObjectName() John Jones zurückgegeben werden.

getSecondaryObjectTypeName()

Gibt den Objekttyp zurück, wenn sich das Ereignis auf ein sekundäres Objekt ausgewirkt hat.

Zurückgegebene sekundäre Objekttypen:

ACCESSROLE
ACCESSTASK
ADMINROLE
ADMINTASK
GROUP
ORGANIZATION
USER

getSecondaryObjectName()

Gibt den Objektnamen zurück, wenn sich das Ereignis auf ein sekundäres Objekt ausgewirkt hat.

Weitere Informationen zu primären und sekundären Objekten finden Sie unter "getPrimaryObjectName()".

Bei einem sekundären Objekt des Typs ORGANIZATION könnte die getSecondaryObjectName()-Methode HR zurückgeben.

Hinweis: Die Methoden in "_eventContextInformation" werden über die ExposedEventContextInformation-Schnittstelle angegeben. Da ExposedEventContextInformation Methoden in der CA Identity Manager-Kern-API erbt, können auch diese Methoden mit _eventContextInformation aus einer E-Mail-Vorlage aufgerufen werden - zusammen mit den Methoden in der Tabelle oben. Weitere Informationen zu diesen geerbten Methoden finden Sie unter Zusätzliche Methoden.

Beispiel: E-Mail-Benachrichtigung über ein Ereignis mit dem Status "Ausstehend":

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

Das folgende Element wurde Ihrer Arbeitsliste zur Genehmigung hinzugefügt:
<br><br><br>
Ereignis: <b><%=_eventContextInformation.getEventName()%></b> <br>
<%=_eventContextInformation.getPrimaryObjectTypeName()%>:
<b><%=_eventContextInformation.getPrimaryObjectName()%></b><br>
In <%=_eventContextInformation.getSecondaryObjectTypeName()%>: 
<b><%=_eventContextInformation.getSecondaryObjectName()%></b><br>
</body>
</html>

Möglicher E-Mail-Text:

Vom: lsmith@security.com [mailto:lsmith@security.com] 
An: vimperioso@security.com
Betreff: CreateUserEvent-Genehmigungsanfrage

Das folgende Element wurde Ihrer Arbeitsliste zur Genehmigung hinzugefügt:

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

Hinweis: Der Wert des Felds "Von" wird aus der email.properties-Datei abgeleitet. Um den Wert zu ändern, bearbeiten Sie die folgende Datei:

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

wobei <iam_im.ear> das Installationsverzeichnis von CA Identity Manager in der Anwendungsserverdomäne ist, zum Beispiel:

Für WebLogic:

<WebLogic_Basisverzeichnis>\user_projects\<Domäne>\applications\iam_im.ear

Für JBoss:

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

Für WebSphere:

<im_admin_tools_dir >\WebSphere-ear\iam_im.ear

Um zusätzliche Informationen zum Benutzer, der vom Ereignis betroffen ist, in der E-Mail im vorherigen Beispiel hinzuzufügen, fügen Sie Text hinzu, der in etwa dem Folgenden entspricht:

<% user = _eventContextInformation.getEvent().getUser(); %>
<b>Benutzerinformationen:</b><br>
Nachname: <b><%=user.getAttribute("%LAST_NAME%")%></b><br>   
Vorname: <b><%=user.getAttribute("%FIRST_NAME%")%></b><br>
Vollständiger Name: <b><%=user.getAttribute("%FULL_NAME%")%></b><br>
E-Mail: <b><%=user.getAttribute("%EMAIL%")%></b><br>
Organization Membership (Organisationsmitgliedschaft): <b><%=user.getAttribute("%ORG_MEMBERSHIP%")%></b><br>

Möglicher E-Mail-Text:

Vom: lsmith@security.com [mailto:lsmith@security.com] 
An: vimperioso@security.com
Betreff: CreateUserEvent-Genehmigungsanfrage

Das folgende Element wurde Ihrer Arbeitsliste zur Genehmigung hinzugefügt:

Ereignis: CreateUserEvent
USER: Richard Ferrigamo
In ORGANIZATION: Mortgages & Loans
Benutzerinformationen:
Nachname: Ferrigamo
Vorname: Richard
Vollständiger Name: Richard Ferrigamo
E-Mail: rferrigamo@mybank.org
Organization Membership (Organisationsmitgliedschaft): Mortgages & Loans