Argomento precedente: _util.Argomento successivo: _taskContextInformation.


_eventContextInformation.

Contiene informazioni sull'evento generato dall'attività corrente, come il nome dell'evento e lo stato di approvazione. Queste informazioni vengono chiamate informazioni di contesto dell'evento.

L'oggetto _eventContextInformation viene creato dalla classe di ExposedEventContextInformation nel pacchetto com.netegrity.imapi.

Questo oggetto è disponibile per messaggi di posta elettronica basati sui modelli Approvato, In sospeso e Rifiutato. Per informazioni su questi modelli, consultare la sezione Modelli di messaggio di posta elettronica.

Metodi: tutti i metodi seguenti restituiscono una stringa.

di autenticazione

Descrizione

getAdminName()

Restituisce il nome della persona che ha inoltrato l'attività che ha generato l'evento.

Obsoleto in CA Identity Manager 5.6. Utilizzare uno dei seguenti metodi ereditati:

  • getAdministrator()
  • getAdminFriendlyName()

getApprovalStatus()

Ripristina lo stato di approvazione dell'evento. Uno di questi valori:

APPROVAL_STATUS_APPROVED
APPROVAL_STATUS_REJECTED

getApprovalTime()

Ripristina la data/ora di approvazione dell'evento.

getEventName()

Restituisce il nome dell'evento.

Per un elenco dei nomi di evento, consultare la sezione Eventi di CA Identity Manager.

getOrgName()

Restituisce il nome descrittivo dell'organizzazione in cui l'attività viene eseguita.

Obsoleto in CA Identity Manager 5.6. Utilizzare il metodo ereditato getObjectOrganizationFriendlyName().

getPassword()

Se l'oggetto primario è di tipo USER, restituisce la password dell'utente.

getPrimaryObjectTypeName()

Restituisce il tipo di oggetto primario.

Tipi di oggetto primario restituiti:

ACCESSROLE
ACCESSTASK
ADMINROLE
ADMINTASK
GROUP
ORGANIZATION
USER

getPrimaryObjectName()

Restituisce il nome dell'oggetto primario interessato dall'evento.

Un oggetto primario è l'oggetto direttamente interessato dall'evento. Un oggetto secondario è l'oggetto a cui l'oggetto primario è associato, se presente.

Ad esempio:

  • Il tipo di oggetto primario per CreateUserEvent è USER. L'oggetto secondario è l'oggetto in cui l'utente viene creato, ovvero ORGANIZATION.
  • Il tipo di oggetto primario per CreateAdminRoleEvent è ADMINROLE. Questo oggetto non è associato ad altri oggetti, pertanto non esiste nessun oggetto secondario.

Con un oggetto primario di tipo USER, è possibile che getPrimaryObjectName() restituisca John Jones.

getSecondaryObjectTypeName()

Se un oggetto secondario è stato interessato dall'evento, restituisce il tipo di oggetto.

Tipi di oggetto secondari restituiti:

ACCESSROLE
ACCESSTASK
ADMINROLE
ADMINTASK
GROUP
ORGANIZATION
USER

getSecondaryObjectName()

Se un oggetto secondario è stato interessato dall'evento, restituisce il nome dell'oggetto.

Consultare getPrimaryObjectName() per informazioni sugli oggetti primari e secondari.

Con un oggetto secondario di tipo ORGANIZATION, è possibile che il metodo getSecondaryObjectName() restituisca HR.

Nota: i metodi in _eventContextInformation vengono forniti tramite l'interfaccia ExposedEventContextInformation. Poiché ExposedEventContextInformation eredita i metodi nell'API di base di CA Identity Manager, _eventContextInformation può chiamare questi metodi anche da un modello di messaggio di posta elettronica, insieme ai metodi contenuti nella tabella riportata sopra. Per ulteriori informazioni su questi metodi ereditati, consultare la sezione Metodi aggiuntivi.

Esempio--Notifica di posta elettronica per un evento In sospeso:

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

L'elemento seguente è stato aggiunto all'elenco di lavoro per l'approvazione:
<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>

Corpo del messaggio di posta elettronica possibile:

Da: lsmith@security.com [mailto:lsmith@security.com] 
A: vimperioso@security.com
Oggetto: Richiesta di approvazione CreateUserEvent

L'elemento seguente è stato aggiunto all'elenco di lavoro per l'approvazione:

Event: CreateUserEvent
USER: Richard Ferrigamo
In ORGANIZATION: Mutui e prestiti

Nota: il valore del campo Da deriva dal file email.properties. Per modificare il valore, modificare il file seguente:

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

dove <iam_im.ear> è la posizione di installazione di CA Identity Manager nel dominio del server applicazioni, ad esempio:

Per WebLogic:

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

Per JBoss:

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

Per WebSphere:

<im_admin_tools_dir >\WebSphere-ear\iam_im.ear

Per aggiungere informazioni aggiuntive sull'utente interessato dall'evento al messaggio di posta elettronica dell'esempio precedente, aggiungere del testo simile al seguente:

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

Corpo del messaggio di posta elettronica possibile:

Da: lsmith@security.com [mailto:lsmith@security.com] 
A: vimperioso@security.com
Oggetto: Richiesta di approvazione CreateUserEvent

L'elemento seguente è stato aggiunto all'elenco di lavoro per l'approvazione:

Event: CreateUserEvent
USER: Richard Ferrigamo
In ORGANIZATION: Mutui e prestiti
Informazioni utente:
Cognome: Ferrigamo
Nome: Richard
Nome completo: Richard Ferrigamo
Indirizzo di posta elettronica: rferrigamo@mybank.org
Appartenenza organizzazione: Mutui e prestiti