1 Présentation du pilote DirXML pour PeopleSoft. Novell pour PeopleSoft
Novell Confidential Manual (FRA) 28 October 2003
1
Présentation du pilote DirXML pour PeopleSoft
Une application PeopleSoft se compose de deux éléments principaux :
PeopleTools, qui est une infrastructure
Un ou plusieurs modules
Notamment Gestion des Ressources Humaines, Finances, Enseignement supérieur et CRM
(Customer Resource Management - Gestion de la relation client).
Le pilote DirXML
®
pour PeopleSoft interagit avec PeopleSoft au niveau de PeopleTools.
L’utilisation de définitions d’objet au sein des modules PeopleSoft et d’une collection d’objets préconfigurés vous permet d’activer PeopleSoft de manière à exécuter les opérations suivantes :
Intercepter des événements dans n’importe quel module PeopleSoft.
Fournir les événements interceptés à Novell
®
eDirectory
TM
.
Collecter et traiter les données fournies.
Fournir les données via une interface PeopleTools.
Le pilote crée un lien automatisé entre PeopleSoft et eDirectory. À mesure que des enregistrements sont ajoutés, modifiés ou désactivés dans PeopleSoft, les tâches réseau associées à ces événements peuvent être traitées automatiquement.
Par exemple, lorsque des embauches, ré-embauches, cessations d’emploi et mises à jour du personnel ont lieu dans le module Gestion des Ressources Humaines, les tâches qui en résultent sont souvent créées à l’intention du service Informatique. Ces tâches peuvent inclure la configuration, la modification ou la désactivation d’un compte utilisateur eDirectory ou la création d’un compte de messagerie ou d’un compte de domaine. Il ne s’agit là que de quelques exemples de processus d’entreprise que ce pilote permet d’automatiser et de gérer.
Avantages
Comme l’illustrent les exemples suivants, le pilote permet d’automatiser et de mettre à jour les processus d’entreprise. Vous pouvez réaliser les opérations suivantes :
Création automatique d’un compte eDirectory lorsqu’une personne est embauchée ou lorsqu’un étudiant entre en stage.
Suppression ou désactivation automatique des comptes eDirectory lorsqu’un employé quitte l’entreprise.
Synchronisation bidirectionnelle des données entre PeopleSoft et eDirectory.
Contrôle de l’exactitude et de la cohérence des ID eDirectory.
Définition de règles de création de mots de passe (date de naissance, numéro de sécurité sociale ou combinaison du prénom et du nom, par exemple).
Présentation du pilote DirXML pour PeopleSoft
9
Novell Confidential Manual (FRA) 28 October 2003
Via eDirectory, intégration facile entre PeopleSoft et diverses applications (eDirectory, Lotus
Notes*, Netscape*, Exchange, Active Directory*, par exemple).
Création d’autres objets eDirectory associés à un objet PeopleSoft (codes de compte ou enregistrements de service, par exemple).
Synchronisation d’attributs entre PeopleSoft et eDirectory.
Synchronisation des données de eDirectory vers PeopleSoft.
Le pilote comprend les éléments suivants :
Le programme Serveur d’événements
Le module d’interface pilote
Le programme PeopleSoft Service Agent (PSA)
Un fichier de configuration de pilote
Vous pouvez configurer le programme PSA et les objets du pilote pour améliorer les processus de votre entreprise. Avant d’installer et de configurer le pilote, vous devez évaluer et définir ces processus. Au cours de l’installation, vous procédez à la configuration des règles applicables au pilote afin d’automatiser ces processus chaque fois que cela est possible.
Fonctionnalités du pilote
Le pilote offre les fonctions suivantes :
Prise en charge de plusieurs infrastructures PeopleTools
Un programme Serveur d’événements distinct est disponible pour chaque version de
PeopleTools. Ce programme se connecte au module d’interface pilote dans un socket
Windows*.
Le traitement distant entre le module d’interface et le serveur d’événements est également possible. Ce qui signifie que le serveur d’événements peut être exécuté sur une machine distincte de celle du module d’interface pilote.
Traitement amélioré des erreurs
Le serveur d’événements peut être exécuté à partir d’une fenêtre DOS sur un ordinateur
équipé de Windows NT*. L’écran affiche des messages de débogage au moment où un
événement est traité. Ces messages renseignent sur l’état de la transaction affichée sur le serveur d’événements, ce qui vous permet de déterminer avec précision la transaction qui est en cours de traitement.
Fonction DSTRACE étendue.
Les messages DSTRACE contiennent une description détaillée de l’événement et du traitement de ce dernier.
Prise en charge de la fonction d’interrogation par Identity Manager.
Vous pouvez appliquer une règle de concordance à la fois pour le canal Éditeur et pour le canal
Abonné. S’il n’existe aucune association entre l’objet Utilisateur eDirectory et l’employé
PeopleSoft, le moteur DirXML exécute une règle de concordance et demande qu’une requête fusionne les attributs des deux objets.
Vous pouvez aussi interroger PeopleSoft sur les valeurs d’attribut nécessaires pour manipuler ou traiter des données dans une règle, sans avoir à copier les données dans eDirectory.
10
Guide d’implémentation du pilote DirXML pour PeopleSoft
Novell Confidential Manual (FRA) 28 October 2003
Paramètres de ligne de commande pour le serveur d’événements
Les paramètres de ligne de commande définissent comment exécuter le serveur d’événements et se connecter au module d’interface pilote, et déterminent si le serveur d’événements doit
être installé en tant que service. Ces paramètres désignent également le chemin de l’environnement du client PeopleSoft. Pour plus d’informations, reportez-vous à
« Installation du programme PeopleSoft Service Agent (PSA) », page 21 .
Fonction de démarrage automatique
Vous pouvez configurer le pilote pour qu’il démarre automatiquement. Il suffit pour cela d’installer le serveur d’événements en tant que service Windows et de configurer l’indicateur de démarrage automatique sur le pilote. Pour plus d’informations, reportez-vous à
« Installation et configuration manuelles du serveur d’événements », page 33
.
Prise en charge de l’interrogation de schéma.
Le pilote peut interroger les schémas eDirectory et PeopleSoft sur les attributs qui peuvent
être utilisés dans la règle de concordance ou interroger PeopleSoft sur les objets définis en tant qu’objets de règle dans l’objet Pilote.
Nouvelles fonctionnalités de Identity Manager 2
Pour plus d’informations sur les nouvelles fonctionnalités de Identity Manager, reportez-vous à
« What’s New in Identity Manager 2? » (Nouveautés de Identity Manager 2) dans le
Nsure Identity
Manager 2 Administration Guide (Guide d’administration Nsure Identity Manager 2)
(http://www.novell.com/documentation/french/dirxml20/admin/data/alxnk27.html) .
Composants du pilote
Le pilote utilise les composants suivants :
PeopleSoft Service Agent (PSA)
Module d’interface (shim) pilote
Fichier d’importation XML
Serveur d’événements
PeopleSoft Message Agent (fourni via PeopleSoft)
Composant
PSA
Pour PeopleSoft 7.5
dirxml_driver 3_6 psa.exe
Module d’interface (shim) pilote npsshim.dll
Fichier d’importation
XML peoplesoft36.xml
Serveur d’événements nps75eventserver.exe
Pour PeopleSoft 8.1
dirxml_driver 3_6 psa.exe
npsshim.dll
peoplesoft36.xml
nps81eventserver.exe
Présentation du pilote DirXML pour PeopleSoft
11
Novell Confidential Manual (FRA) 28 October 2003
Configuration de pilote
Le pilote est chargé de notifier au moteur DirXML les événements de modification d’objet qu’il reçoit de PeopleSoft. Le pilote se compose d’un programme serveur d’événements et du fichier
NPSSHIM.DLL.
Le pilote contient un canal Éditeur et un canal Abonné. Le canal Abonné reçoit les événements eDirectory au format XML envoyés par le moteur DirXML. Le pilote convertit ensuite ces documents en un flux de données adéquat, les transmet au serveur d’événements et met à jour
PeopleSoft via l’interface Message Agent.
Le canal Éditeur reçoit les événements PeopleSoft au format XML depuis le serveur d’événements et les envoie au moteur DirXML pour que celui-ci les publie à son tour vers eDirectory via le canal
Éditeur. Le moteur traite le document en appliquant de façon séquentielle toutes les règles configurées en fonction du flux de processus standard.
Chaque règle exécute une transformation sur le document XML. Le moteur traite le document d’événements en fonction des règles et du filtre trouvés dans l’objet Éditeur du pilote.
Module d’interface (shim) pilote
Le module d’interface pilote gère la communication entre le serveur d’événements et le moteur
DirXML. Pour cette version du pilote, le module d’interface s’appelle NPSSHIM.DLL.
Serveur d’événements
Le serveur d’événements est un processus exécutable autonome. Il établit et gère la connectivité entre le module d’interface pilote et PeopleSoft Message Agent.
Le serveur d’événements communique avec le pilote via une interface de socket et avec Message
Agent via les API propriétaires de PeopleSoft Message Agent.
C’est un composant bidirectionnel sur les canaux Éditeur et Abonné. Le canal Éditeur interroge
Message Agent sur les transactions. Lorsque des transactions sont disponibles, le serveur d’événements lit les données d’enregistrement via Message Agent et transforme le format propriétaire des enregistrements PeopleSoft en une représentation au format XML. Les enregistrements XML sont envoyés au pilote pour être soumis à eDirectory.
De la même manière, le canal Abonné reçoit du pilote les événements eDirectory au format XML et les transforme au format propriétaire PeopleSoft. Les données d’événement sont ensuite envoyées à Message Agent pour être publiées via le canal Éditeur dans la base de données
PeopleSoft.
PeopleSoft Service Agent
L’agent PSA (PeopleSoft Service Agent) est un logiciel que vous recevez en tant que projet
PeopleSoft. Un agent PSA est une collection d’objets. Cette collection personnalise le module
PeopleSoft auquel sont appliqués les objets.
Vous pouvez installer les composants de l’agent PSA puis les configurer pour n’importe quelle application PeopleSoft.
12
Guide d’implémentation du pilote DirXML pour PeopleSoft
Novell Confidential Manual (FRA) 28 October 2003
L’agent PSA a une triple fonction :
Il intercepte les événements au moment où ils se produisent dans PeopleSoft.
Il place une transaction dans la liste de travail pour les événements interceptés.
Il fournit la transaction (accompagnée de données pertinentes et à jour) au pilote via
Message Agent.
L’agent PSA comprend un échantillon de tous les objets nécessaires à PeopleSoft pour que ses modules PeopleSoft puissent avoir une connectivité à double sens avec le serveur d’événements.
Publication des données dans eDirectory
La publication d’événements via le canal Éditeur vers eDirectory commence avec les mises à jour dans PeopleSoft. À mesure que ces mises à jour ont lieu, des transactions sont placées dans une file d’attente de liste de travail. Ces événements sont ensuite mis à la disposition de eDirectory via le serveur d’événements.
Lorsque le serveur d’événements reçoit des transactions de PeopleSoft, il transforme les données pour obtenir un document XML qu’il transmet au module d’interface pilote. Ce dernier transmet le document au moteur DirXML, qui traite la transaction dans eDirectory en fonction des règles définies dans le pilote.
L’état de la transaction qui figure dans la liste de travail est également mis : la valeur worked
(traité) ou error (erreur) lui est affectée. Lors de la mise à jour de l’état dans PeopleSoft, d’autres données PeopleCode peuvent être traitées pour déclencher l’envoi de notifications par message
électronique aux utilisateurs ayant un rôle de flux PeopleSoft défini. Le message électronique contient des informations sur les transactions réussies mais aussi sur celles qui reçoivent des erreurs.
Description des événements
Les mises à jour ou opérations qui se produisent dans PeopleSoft entraînent l’exécution de déclencheurs de flux. Ces déclencheurs placent des transactions dans une file d’attente de liste de travail PeopleSoft. Des champs clés sont assignés à chaque transaction afin que le pilote identifie la transaction de manière unique.
L’un de ces champs clés est Nom de l’événement. Les noms d’événement sont assignés en fonction d’une opération de PeopleSoft. Le pilote contrôle la file d’attente et repère les transactions qui satisfont aux critères de traitement.
Il s’agit notamment des critères suivants :
Les transactions doivent avoir l’état 0.
L’opération, la date et l’heure doivent être inférieures ou égales à la date et à l’heure en cours.
Après avoir reçu l’événement, le serveur d’événements le convertit en document XML et l’envoie au module d’interface pilote. Ce dernier transmet le document XML au moteur DirXML. Le moteur applique ensuite les règles correspondant à ce type d’événement (en fonction du champ
Nom de l’événement). Le pilote transforme le document XML en commandes eDirectory, puis il envoie les événements à eDirectory.
Présentation du pilote DirXML pour PeopleSoft
13
Novell Confidential Manual (FRA) 28 October 2003
ADD
La solution fournie prend en charge les événements de flux suivants. Par défaut, un événement dans PeopleSoft est égal à un événement ou document de fonction XML.
Événement PeopleSoft
ADD
UPD
DIS
Opération PeopleSoft type Événement de fonction
XML
Ajouter Nouvel employé, nouvel étudiant, nouveau code de compte, nouvel enregistrement.
Toute modification apportée aux données. Par exemple, un champ sur un volet est modifié.
Modifier
Cessation d’emploi. Un enregistrement devient inactif ou désactivé.
Supprimer
Pour déclencher l’événement correspondant au type de document XML qui doit être généré, vous devez configurer PeopleSoft de manière appropriée. Sans une configuration adéquate et l’examen de vos processus d’entreprise, une cessation d’emploi (opération) peut déclencher un événement de mise à jour au lieu d’un événement de suppression. Le document XML résultant sera un document de modification au lieu d’un document de suppression.
La configuration du pilote livrée identifie deux champs (ID de messagerie électronique et
Description) sur le canal Abonné. Ces champs synchronisent les données entre eDirectory et
PeopleSoft. D’autres champs PeopleSoft peuvent être publiés de eDirectory vers PeopleSoft via le canal Abonné en fonction des besoins de votre entreprise. Pour des informations sur le canal
Abonné, reportez-vous à
« Publication des données depuis eDirectory via le canal Abonné », page 16 .
L’événement d’ajout est généralement déclenché par l’ajout d’un nouvel enregistrement. Pour le module Gestion des Ressources Humaines, cela correspond à l’embauche d’un employé. La création d’un nouvel enregistrement Embauche dans PeopleSoft entraîne les étapes suivantes :
1. Une définition de flux est déclenchée.
2. Une transaction d’ajout est écrite dans la liste de travail.
3. Le pilote lit la liste de travail pour obtenir une transaction, qui est accompagnée des données spécifiées par l’utilisateur.
4. Le pilote transforme le flux de données en un document XML.
5. Le pilote transmet le document au moteur DirXML.
6. Le moteur applique les règles qui ont été configurées.
7. Le moteur crée un objet eDirectory.
La règle SSCreate est configurée en tant qu’exemple de règle de création. Elle permet de créer l’objet Utilisateur. Vous pouvez aussi y définir les règles eDirectory pour le nom commun ou le mot de passe de login initial, ainsi que d’autres règles de création.
En fonction des besoins de votre entreprise, vous pouvez appliquer d’autres configurations à l’agent PSA pour fournir des éléments de données supplémentaires. Vous pouvez aussi configurer les règles pour qu’elles répondent aux objectifs de l’entreprise.
14
Guide d’implémentation du pilote DirXML pour PeopleSoft
Novell Confidential Manual (FRA) 28 October 2003
UPD
DIS
Au cours du traitement d’un événement d’ajout, le système crée une association entre l’enregistrement PeopleSoft de l’employé et l’objet eDirectory. Pendant la création de l’objet, le système crée une association entre l’objet eDirectory et la clé unique de PeopleSoft. Pour le module Gestion des Ressources Humaines, le champ EmplID est utilisé comme champ clé et enregistré dans l’attribut d’association sur l’objet Utilisateur.
Lorsqu’un objet est créé, divers attributs ou éléments de données définis dans PeopleSoft peuvent
être transmis par l’interface et utilisés pour placer l’objet. La règle de placement sur l’objet Pilote utilisera ces valeurs.
Les événements UPD (mise à jour) sont généralement déclenchés lorsque des données d’un champ
PeopleSoft spécifié sont modifiées. Un flux est déclenché par l’utilisation de PeopleCode et un
événement de mise à jour est écrit dans la liste de travail. Le pilote, appliquant le même processus que celui de la transaction ADD, récupère la transaction et applique les règles correspondantes.
Dans la solution fournie, la règle eventXform permet d’appliquer ces événements. Les règles peuvent varier en fonction des besoins de l’entreprise.
Analysez les processus de votre entreprise pour déterminer les champs PeopleSoft qui doivent être synchronisés et utilisés pour les règles dans eDirectory.
Par exemple, l’emplacement, le service ou l’entreprise d’un utilisateur peuvent déterminer l’emplacement de l’objet Utilisateur de cette personne dans eDirectory. Si un de ces champs est mis à jour dans PeopleSoft, l’objet Utilisateur eDirectory doit être déplacé vers le conteneur adéquat en fonction de ces nouvelles informations.
Les champs PeopleSoft peuvent aussi être stockés dans eDirectory en tant qu’attributs. Numéros de téléphone, services, noms préférés, titres de poste et emplacements comptent parmi les champs courants qui peuvent être partagés par les deux systèmes. Analysez les processus de votre entreprise pour définir les assignations de données nécessaires entre les systèmes.
L’événement DIS est généralement déclenché par la désactivation d’enregistrements. De nombreuses opérations exécutées dans PeopleSoft représentent un processus de désactivation.
Dans le module Gestion des Ressources Humaines, cet événement se produit lorsqu’un employé quitte l’entreprise. Lorsqu’un enregistrement de cessation d’emploi est créé dans PeopleSoft, le système déclenche un flux et écrit une entrée dans la liste de travail.
Important : le déclenchement d’une transaction de suppression génère un document XML de suppression.
L’entreprise peut choisir de supprimer, de désactiver ou de désactiver et déplacer le compte eDirectory. Comme pour le processus de modification/mise à jour, la règle eventXform est fournie afin de montrer comment un document XML de suppression est transformé en document de modification.
Remarque : par défaut, lorsque le canal Éditeur traite un événement, l’ID et le DN (nom distinctif) eDirectory sont mis à jour dans PeopleSoft. Vous pouvez désactiver ce processus en mettant à jour les propriétés XML du pilote.
Présentation du pilote DirXML pour PeopleSoft
15
Novell Confidential Manual (FRA) 28 October 2003
Publication des données depuis eDirectory via le canal Abonné
PeopleSoft est le processus expert pour les événements d’ajout et de suppression/désactivation.
Par conséquent, le pilote par défaut permet les mises à jour dans PeopleSoft uniquement sur le canal Abonné.
Dans la mesure où PeopleSoft est une base de données relationnelle (et non hiérarchique), les processus de déplacement et de réassignation de nom ne sont généralement pas applicables. Si ces processus se produisent dans eDirectory pour un objet pour lequel le pilote est défini sur le canal
Abonné, le pilote les convertit en événement de modification. Cette opération lui permet de mettre
à jour l’ID eDirectory et le nom distinctif eDirectory dans PeopleSoft, à condition que le processus de mise à jour ne soit pas désactivé.
Le pilote oublie, via le canal Abonné, les événements de modification qui se produisent dans eDirectory. PeopleSoft est conçu pour être le propriétaire expert des données contenues dans la solution fournie. Par conséquent, si un objet Utilisateur est créé dans eDirectory, aucun enregistrement d’employé n’est créé dans PeopleSoft à l’aide de la configuration par défaut.
Les éléments de données PeopleSoft qui sont publiés de eDirectory vers PeopleSoft via le canal
Abonné doivent :
se trouver sur le filtre du canal Abonné ;
exister dans la définition de message DIRXML_SCHEMA01_UPDATE et la définition de message DIRXML_SCHEMA01 dans PeopleSoft (ou définitions équivalentes).
Lorsque le pilote est averti d’une modification à un attribut sélectionné dans son filtre Abonné, il envoie l’événement au serveur d’événements. Ce dernier formate l’événement puis met à jour
PeopleSoft en communiquant par l’intermédiaire de PeopleSoft Message Agent. Les données provenant de eDirectory peuvent être placées sur un volet ou une page dans PeopleSoft.
Puisque leur mise à jour et leur gestion se font hors de PeopleSoft, il convient de leur assigner la propriété Display Only (Affichage seul) dans PeopleSoft. Il n’est pas conseillé de permettre à un même élément de donnée d’être modifié à l’intérieur et à l’extérieur de PeopleSoft. Il faudrait pour cela que l’élément soit défini sur les deux canaux (Éditeur et Abonné) du pilote.
Vous pouvez mettre des données à jour dans PeopleSoft en fonction d’un enregistrement
PeopleSoft existant. Pour cela, vous devez écrire les données PeopleCode adéquates pour que les
éléments de données mis à jour dans la définition d’enregistrement DIRXML_STAGE01 soient aussi copiés vers l’enregistrement souhaité dans l’environnement PeopleSoft.
16
Guide d’implémentation du pilote DirXML pour PeopleSoft
