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

_util

Objet utilitaire

Méthode :

• getNotifiers(String [,String])

  Renvoie des ID de courriel en fonction d'une règle de notification.

  Le premier argument prend en charge les règles de notification prédéfinies suivantes, placées entre guillemets :

  • "ADMIN". Envoie le courriel à l'administrateur qui a initialisé la tâche.
  • "USER". Envoie le courriel à l'utilisateur dans le contexte actuel.
  • "USER_MANAGER". Envoie le courriel au gestionnaire de l'utilisateur dans le contexte actuel.

  Vous pouvez également référencer une règle de notification personnalisée créée avec l'API de règle de notification. Pour plus d'informations, reportez-vous au manuel de programmation pour Java.

  Le deuxième argument est facultatif. Vous pouvez l'utiliser pour transmettre une ou plusieurs paires nom/valeur définies par l'utilisateur dans une règle de notification personnalisée. Séparez chaque paire nom/valeur par une virgule, au format suivant :

  "name1=value1,name2=value2..."
  

Exemples :

<% 

_to = _util.getNotifiers("ADMIN");_cc = "";
%>
<% 
_to = _util.getNotifiers("MYRULE","type=loan,district=3");
_cc = "";
%>

Notification au gestionnaire d'un utilisateur

Vous pouvez utiliser la règle de notification USER_MANAGER pour envoyer un courriel au gestionnaire d'un utilisateur. CA Identity Manager utilise cette règle dans les modèles de courriel prenant en charge la certification des droits de l'utilisateur.

Remarque : La règle de notification USER_MANAGER s'applique uniquement aux événements ou aux tâches qui créent ou gèrent un utilisateur unique.

Etant donné le grand nombre de méthodes différentes permettant de spécifier une relation utilisateur-gestionnaire dans un répertoire d'utilisateurs, l'adaptateur de notification au gestionnaire d'utilisateurs par défaut résout cette relation en fonction d'une expression d'attribut spécifiée dans le deuxième paramètre de la méthode getNotifiers().

Exemple :

<% 
_to = _util.getNotifiers("USER_MANAGER","ManagerLookup=managerattribute");
_cc = "";
%>

L'adaptateur de notification au gestionnaire d'utilisateurs prend en charge deux options de recherche :

• managerattribute = <Manager AttributeName>- où l'objet utilisateur conserve un attribut qui indique le nom unique ou l'ID d'utilisateur du gestionnaire de cet utilisateur.
• commonattribute = <AttributeName> - où l'utilisateur et son gestionnaire partagent une valeur d'attribut commune, telle que Service.

Configurez ces options de recherche dans les propriétés diverses d'un environnement dans la console de gestion CA Identity Manager.

Pour configurer la règle de notification USER_MANAGER :

1. Dans la console de gestion CA Identity Manager, sélectionnez Identity Manager Environments (Environnements CA Identity Manager). Puis, sélectionnez l'environnement pour lequel vous configurez la notification par courriel.
2. Sélectionnez Paramètres avancés (Advanced Settings), Miscellaneous Properties (Propriétés diverses).
3. Dans la page Miscellaneous Properties (Propriétés diverses), suivez la procédure de configuration pour l'option de recherche que vous voulez utiliser :
   • Pour utiliser l'option de recherche managerattribute=<Manager AttributeName> :
     1. Dans le champ Propriété, saisissez managerattribute.
     2. Dans le champ Valeur, saisissez l'attribut qui stocke le nom unique ou l'ID d'utilisateur du gestionnaire.
     3. Cliquez sur Ajouter.
     4. Cliquez sur Enregistrer.
   • Pour utiliser l'option de recherche commonattribute=<AttributeName> :
     1. Dans le champ Propriété, saisissez commonattribute.
     2. Dans le champ Valeur, saisissez l'attribut commun à l'utilisateur et à son gestionnaire.
     3. Cliquez sur Ajouter.
     4. Dans le champ Propriété, saisissez
        ismanagerfilter.
     5. Dans le champ Valeur, saisissez une expression de recherche à l'aide de la syntaxe suivante :

        <attribute> <operator> <filter>

        Par exemple, le titre est égal à gestionnaire.

     6. Cliquez sur Ajouter.
     7. Cliquez sur Enregistrer.

Vous pouvez également écrire un adaptateur personnalisé et créer vos propres règles pour notifier le gestionnaire d'un utilisateur. Reportez-vous au Manuel de programmation Java.