Novell Confidential Manual (FRA) 28 October 2003
2
Configuration de votre environnement
PeopleSoft
Cette section explique le fonctionnement du programme PSA (PeopleSoft Service Agent) et la configuration de votre environnement PeopleSoft.
« Utilisation du programme PeopleSoft Service Agent (PSA) », page 15
« Installation de l’exemple de projet PSA », page 17
« Interfaces de composant », page 23
« Configuration de PeopleCode pour déclencher des transactions », page 25
Utilisation du programme PeopleSoft Service Agent (PSA)
L’agent PSA représente un ensemble d’objets PeopleTools qui vous permettent de capturer des transactions provenant de PeopleSoft et de fournir les données au serveur. L’agent PSA vous permet d’implémenter rapidement une solution Identity Manager sans perturber le système
PeopleSoft. L’agent PSA fourni n’interrompt pas les objets ou les processus PeopleSoft existants et n’a aucun impact sur eux.
Dans cette section, vous trouverez des informations concernant l’installation et la configuration des deux principaux composants PSA.
« L’infrastructure de l’interface de composant pour Identity
Manager », page 16
et
« Exemple d’application », page 16 .
Cette version de l’agent PSA fonctionne avec n’importe quelle base de données PeopleSoft avec le niveau de version de PeopleTools requis. Pour pouvoir installer l’agent PSA, vous devez disposer d’un ID utilisateur et d’un mot de passe PeopleSoft avec des droits d’administrateur ou de développeur. Vous pouvez créer un ID utilisateur et mot de passe uniques pour implémenter ces objets.
Vous devez également vous assurer que l’API externe de PeopleSoft est installée. Pour plus
d’informations, reportez-vous à « Installation d’une API externe de PeopleSoft », page 16
.
Configuration de votre environnement PeopleSoft
15
Novell Confidential Manual (FRA) 28 October 2003
L’infrastructure de l’interface de composant pour Identity Manager
Utilisez l’infrastructure de l’interface de composant et les appels de fonction PeopleCode pour spécifier le mode de traitement des transactions (par exemple, nouvel employé, cessation d’emploi, changement de service, etc.) Les interfaces de composant remplacent les définitions
d’agent de messages. Pour plus d’informations, reportez-vous à « Configuration de PeopleCode pour déclencher des transactions », page 25 .
Exemple d’application
Le projet PSA propose un exemple d’application que vous pouvez installer sur votre système
PeopleSoft à des fins de configuration et de test.
En fonction de vos besoins, vous devez configurer les processus internes pour déclencher des
événements dans les tables de transaction en reproduisant les données PeopleCode fournies ou en fusionnant les composants dans votre environnement PeopleSoft. Pour plus d’informations, reportez-vous à
« Installation de l’exemple de projet PSA », page 17
Installation d’une API externe de PeopleSoft
Avant de configurer le pilote, vous devez installer le logiciel d’API externe de PeopleSoft
(PSEXTAPI) fourni par PeopleSoft si vous utilisez des systèmes PeopleSoft 8.1.x. Si vous utilisez
PeopleSoft 8.4x, vous n’avez pas besoin d’installer PSEXTAPI.
Le logiciel PSEXTAPI nécessite une machine virtuelle Java* car les appels envoyés au serveur d’applications sont effectués via Jolt. La machine virtuelle Java (JVM*) doit être installée sur le système d’exploitation sur lequel est exécuté le module d’interface de pilote (NPS8Shim.dll). Si vous ne disposez pas de la JVM, vous pouvez la télécharger à partir du Centre de téléchargement de Microsoft (http://www.microsoft.com/downloads) (msjavx86.exe) ; vous pouvez également utiliser la machine virtuelle Java fournie avec le JDK* 1.2.2 de Sun. Pour des informations complémentaires, reportez-vous à votre documentation PeopleSoft.
16
Guide d’implémentation du pilote DirXML pour PeopleSoft
Novell Confidential Manual (FRA) 28 October 2003
Pour installer le logiciel PSEXTAPI :
1
2
Exécutez le fichier setup.exe à partir de pshome\setup\PsExtAp
Modifiez le chemin de l’environnement pour inclure le répertoire
{pshome}\bin\client\winx86_api\.
3
Redémarrez votre poste de travail.
Vérification de la connexion de PeopleSoft à la JVM
Vous devez vérifier que PeopleSoft se connecte correctement à la JVM. Pour cela, exécutez le fichier jnitest.exe à partir du répertoire de l’API externe de PeopleSoft
{pshome}\bin\client\winx86_api\.
Installation de l’exemple de projet PSA
Exécutez les tâches suivantes pour installer l’exemple de projet à des fins de test et de configuration :
1.
« Extraction des fichiers PSA », page 17
2.
« Importation du projet PSA dans la base de données PeopleSoft », page 17
3.
« Création de définitions d’enregistrement de projet », page 18
4.
« Application de la sécurité sur le projet PSA », page 19
5.
« Test des exemples d’application PeopleSoft », page 20
Extraction des fichiers PSA
Si vous n’avez pas installé l’agent PSA lors d’installation initiale du pilote, recherchez le CD du produit ou téléchargez le fichier, accédez au serveur d’applications PeopleSoft, puis exécutez le fichier install.exe. Une fois les fichiers PSA copiés sur le serveur d’applications PeopleSoft, effectuez les opérations ci-dessous :
1
Recherchez le dossier PSA et exécutez le fichier DIRXML DRIVER 4_0 psa.exe pour extraire les fichiers PSA.
2
Cliquez sur Next (Suivant), sélectionnez le répertoire cible, puis cliquez sur Next (Suivant) pour extraire les fichiers PSA.
3
Cliquez sur Finish (Terminer) pour quitter le processus d’extraction.
Importation du projet PSA dans la base de données PeopleSoft
Le projet PSA est fourni sous la forme d’un projet à extraction automatique. Depuis la version 8 de PeopleSoft, les projets sont fournis dans une structure de répertoires cache similaire à la structure de cache qui existe dans PeopleSoft. Dans les versions précédentes de PeopleSoft, vous deviez utiliser le script de Data Mover et effectuer une comparaison, mais ce processus n’est plus nécessaire.
Remarque : toutes les références à des chemins spécifiques représentent les valeurs par défaut indiquées durant les procédures d’installation. Appliquez les changements nécessaires le cas échéant.
Configuration de votre environnement PeopleSoft
17
Novell Confidential Manual (FRA) 28 October 2003
Pour PeopleSoft 8.1
1
Connectez-vous en tant qu’administrateur à la base de données PeopleSoft en mode à deux niveaux.
2
Dans Application Designer, sélectionnez File > Copy Project From File (Fichier > Copier le projet à partir du fichier).
3
4
5
Cliquez sur Browse (Parcourir) et sélectionnez le répertoire du projet PSA : c:\psa\psa-psa8.
Cliquez sur Copy (Copier).
Avec tous les types d’objet sélectionnés, cliquez sur Copy (Copier) pour copier tous les composants du projet dans la base de données PeopleSoft.
Pour PeopleSoft 8.4
1
Connectez-vous en tant qu’administrateur à la base de données PeopleSoft en mode à deux niveaux.
2
Dans Application Designer, sélectionnez Tools > Copy Project From File (Outils > Copier le projet à partir du fichier).
3
4
5
Cliquez sur Browse (Parcourir) et sélectionnez le répertoire du projet PSA : c:\psa\psa-psa8\.
Cliquez sur Copy (Copier).
Avec tous les types d’objet sélectionnés, cliquez sur Copy (Copier) pour copier tous les composants du projet dans la base de données PeopleSoft.
Création de définitions d’enregistrement de projet
Une fois que vous avez importé le projet dans la base de données PeopleSoft, créez des définitions d’enregistrement de projet, puis des vues de projet.
Pour PeopleSoft 8.1 et 8.4
1
Loguez-vous à PeopleSoft en utilisant un nom d’utilisateur administrateur doté de droits d’administration et de développement.
2
3
Dans Application Designer, sélectionnez Build > Project (Créer > Projet).
Dans Build Options (Options de création), cliquez sur Create Tables (Créer des tables) et sur
Execute SQL Now (Exécuter SQL maintenant). Une fois les tables de projet créées, cliquez sur Close (Fermer) pour fermer la fenêtre Build Progress (Progression de la création).
4
Cliquez sur Build (Créer) pour créer des exemples de tables de projet.
Vous devez créer les tables de projet avant de créer les vues. Ces dernières sont créées en fonction des informations des champs de table.
5
6
Dans Application Designer, sélectionnez Build > Project (Créer > Projet).
Dans Build Options (Options de création), cliquez sur Create Views (Créer des vues) et sur
Execute SQL Now (Exécuter SQL maintenant).
7
Cliquez sur Build (Créer) pour créer des exemples de vues de projet. Une fois les vues créées, cliquez sur Close (Fermer) pour fermer la fenêtre Build Progress (Progression de la création).
18
Guide d’implémentation du pilote DirXML pour PeopleSoft
Novell Confidential Manual (FRA) 28 October 2003
Application de la sécurité sur le projet PSA
Appliquez la sécurité au programme PSA pour que le pilote puisse accéder aux tables de transaction de PeopleSoft. Pour cela, créez le rôle d’administrateur DirXML puis assignez-le à l’utilisateur administratif. Vous pouvez assigner le rôle à un compte existant ou créer un nouveau compte spécifiquement destiné à la sécurité du programme PSA.
Pour PeopleSoft 8.1
1
Dans Application Designer, cliquez sur Go > PeopleTools > Maintain Security (Aller >
PeopleTools > Gérer la sécurité).
2
3
Cliquez sur Use > Roles > General > Add (Utiliser > Rôles > Général > Ajouter)
Dans le champ Add Role (Ajouter le rôle), saisissez DirXML Administration 4
(Administration de DirXML 4), puis cliquez sur OK.
4
Dans le champ Description, saisissez DirXML Administration 4 (Administration de
DirXML 4).
5
Cliquez sur l’onglet Permission Lists (Listes d’autorisations) puis sur la flèche de déroulement.
6
Pour la valeur Permission List (Liste d’autorisations), saisissez DIRXML, puis cliquez sur OK.
Le champ Description est automatiquement complété.
7
8
Cliquez sur Save (Enregistrer).
Cliquez sur Use > User Profiles > General > Update/Display (Utiliser > Profils utilisateur >
Généraux > Mettre à jour/Afficher).
9
10
11
Saisissez votre nom d’utilisateur administratif comme ID d’utilisateur, puis cliquez sur OK.
Cliquez sur l’onglet Roles (Rôles), puis sur la dernière ligne pour ajouter des données.
Ajoutez le rôle Administration de DirXML 4 à cet utilisateur, puis cliquez sur Save
(Enregistrer).
12
Fermez et redémarrez les clients et applications PeopleSoft.
Pour PeopleSoft 8.4
1
2
Loguez-vous au portail PeopleSoft.
Cliquez sur PeopleTools > Security > Permissions & Roles > Roles (PeopleTools > Sécurité >
Autorisations et rôles > Rôles).
3
Cliquez sur Add a New Value (Ajouter une nouvelle valeur), puis indiquez un nom de rôle
(par exemple Administrateur DirXML).
6
7
4
5
Saisissez une description du rôle.
(Facultatif) Saisissez une description détaillée du rôle.
Cliquez sur l’onglet Permission List (Liste d’autorisations)
Recherchez et sélectionnez la liste des autorisations de DirXML puis cliquez sur Save
(Enregistrer).
8
Attribuez le rôle DirXML Administrator (Administrateur DirXML) à votre utilisateur administratif en cliquant sur PeopleTools > Security > User Profiles > User Profiles
(PeopleTools > Sécurité > Profils utilisateur > Profils utilisateur).
Configuration de votre environnement PeopleSoft
19
Novell Confidential Manual (FRA) 28 October 2003
9
Cliquez sur Search (Rechercher) pour trouver le profil utilisateur auquel vous souhaitez ajouter le rôle DirXML Administrator (Administrateur DirXML), puis cliquez sur User ID
(ID Utilisateur).
10
11
Cliquez sur l’onglet Role (Rôle), puis sur Add (Ajouter) pour ajouter un nouveau rôle.
Recherchez le rôle, cliquez sur DirXML Administrator (Administrateur DirXML) pour l’ajouter, puis sur Save (Enregistrer).
Test des exemples d’application PeopleSoft
Vous pouvez effectuer des tests pour vous assurer que des transactions sont créées en entrant une nouvelle personne à l’aide de l’exemple d’application Identity Manager pour PeopleSoft. Cet exemple utilise des services ; vous devez donc créer un exemple de service, puis ajouter une personne (en l’assignant à ce service) pour vérifier que l’application fonctionne. Les informations suivantes expliquent comment tester vos exemples d’applications.
Pour PeopleSoft 8.1
1
Dans Application Designer, sélectionnez Go > DirXML > DirXML Administrator (Aller >
DirXML > Administrateur DirXML).
2
Dans le menu DirXML Administrator (Administrateur DirXML), sélectionnez Use >
DirXML Sample Department (Utiliser > Exemple de service DirXML).
3
Cliquez sur une ligne de champ Department (Service) vide pour ajouter un exemple de service, une description et des valeurs de DN DirXML.
4
5
Cliquez sur Save (Enregistrer) pour ajouter le service.
Dans le menu DirXML Administrator (Administrateur DirXML), sélectionnez Use >
DirXML Sample People > Add (Utiliser > Exemple de personne DirXML > Ajouter).
6
7
Cliquez sur le bouton ADD (Ajouter) ; un ID valide s’affichera par défaut.
Saisissez les données dans les divers champs associés à cet ID, puis cliquez sur Save
(Enregistrer).
L’astérisque indique un champ obligatoire.
8
Pour valider la création d’une transaction ADD, sélectionnez Use > DirXML
TRANSACTION01 (Utiliser > DirXML TRANSACTION01).
9
10
Cliquez sur le bouton Search (Rechercher).
Vérifiez que la transaction a bien été créée et sélectionnez-la.
20
Guide d’implémentation du pilote DirXML pour PeopleSoft
Novell Confidential Manual (FRA) 28 October 2003
11
Cliquez sur Use > DirXML Schema 01 > DirXML Schema (Utiliser > Schéma 01 DirXML >
Schéma 01A DirXML).
12
13
14
Vérifiez les données de schéma sur le premier onglet (Schema 01 A).
Vérifiez que vous pouvez mettre à jour les champs du second onglet (DirXML Schema 01 B).
Cliquez sur Use > DirXML Trans by Associations (Utiliser > Trans DirXML par associations) pour vérifier que vous pouvez visualiser les données.
15
Cliquez sur Use > DirXML Driver Defaults (Utiliser > Paramètres par défaut du pilote
DirXML ) pour vérifier que vous pouvez visualiser la séquence de transactions.
16
Vérifiez que les autres applications de tables de transactions fonctionnent en cliquant sur
Use > DirXML Transaction 02 (03, 04 etc.) (Utiliser > Transaction DirXML 02 (03, 04 etc.))
Vous pouvez créer des tables de transaction supplémentaires (Transaction 02, Transaction 03, et ainsi de suite.) Mais l’exemple d’application fourni n’est pas configuré pour les utiliser.
Configuration de votre environnement PeopleSoft
21
Novell Confidential Manual (FRA) 28 October 2003
Pour PeopleSoft 8.4
1
2
Loguez-vous au portail PeopleSoft.
Cliquez sur Structure & Content > DirXML_Administrator (Structure & Contenu >
Administrateur DirXML).
Si le menu DirXML_Administrator (Administrateur DirXML) n’apparaît pas, supprimez le cache du serveur d’applications et redémarrez-le.
3
Cliquez sur DirXML Sample Department (Exemple de service DirXML).
4
5
6
Indiquez un exemple de service, puis cliquez sur Save (Enregistrer).
Cliquez sur DirXML Sample People (Exemple de personne DirXML).
Indiquez un exemple d’utilisateur, puis cliquez sur Save (Enregistrer) et vérifiez que les données de l’utilisateur apparaissent dans toutes les tables de transactions.
22
Guide d’implémentation du pilote DirXML pour PeopleSoft
Novell Confidential Manual (FRA) 28 October 2003
Interfaces de composant
« Accès aux transactions et aux données via les interfaces de composant », page 23
« Configuration de PeopleCode pour déclencher des transactions », page 25
Accès aux transactions et aux données via les interfaces de composant
Le pilote accède aux transactions en attente de traitement dans la table de transactions via l’objet
CI défini dans PeopleTools. Chaque interface de composant est assignée à un composant particulier. Les composants sont créés afin d’accéder aux tables de transaction et aux données de schéma. Les objets de schéma représentent toutes les données nécessaires qui doivent être fournies pour un type de données selon l’ID associé. Ces objets permettent également au pilote de mettre à jour des données PeopleSoft.
Le pilote utilise uniquement un CI de transaction pour accéder aux transactions. Chaque transaction est assignée à un CI de schéma par défaut, même si un traitement défini dans une règle peut nécessiter une requête vers d’autres CI de schéma définis dans la règle d’assignation de schéma du pilote.
Dans les paramètres du pilote, vous devez spécifier le nom de l’objet CI tel que défini dans
PeopleSoft. Cet objet CI est assigné à un composant prédéfini permettant au pilote d’accéder aux transactions à partir d’une table de transaction. Vous trouverez ci-dessous le CI d’une table de transaction :
Configuration de votre environnement PeopleSoft
23
Novell Confidential Manual (FRA) 28 October 2003
Vous trouverez ci-dessous le CI d’un composant de schéma :
Le pilote utilise un paramètre défini pour déterminer le sous-type de transaction qu’il doit traiter.
En tant que développeur PeopleSoft, vous déterminez cette valeur lors de la configuration d’un appel de fonction PeopleCode pour déclencher une transaction en ligne ou lors de la création d’une transaction via un processus de traitement par lots. Si le paramètre n’existe pas, le pilote traite toutes les transactions disponibles via le CI. Si le paramètre existe, le pilote limite le traitement au type de transaction spécifié dans la chaîne du sous-type.
La fonction PeopleCode DIRXML_TRANS doit toujours être placée dans le processus
PeopleCode SavePostChange sur la définition de l’enregistrement. N’oubliez pas de déclarer la fonction avant de l’appeler.
Important : dans les nouvelles versions de PeopleTools, les règles concernant les noms des champs ont été modifiées. PeopleTools 8.4.1 comporte deux modifications significatives :
1. Les espaces ne sont plus autorisés dans les noms des champs de CI.
2. L’API de CI est maintenant sensible à la casse. Les noms des champs et leurs valeurs ne s’adaptent plus car le tri respecte la casse. Par exemple, un champ nommé « CN » est trié avant avant un champ nommé
« City ». Si vous essayez d’accéder à la valeur de « City », vous obtiendrez la valeur de « CN ». Le schéma par défaut des CI utilisées par le pilote utilise à présent des conventions de dénomination qui éliminent cette erreur de tri inhabituelle. Cette question est particulièrement importante pour toutes les modifications ou ajouts de noms de champs personnalisés pour une implémentation précédente du pilote.
24
Guide d’implémentation du pilote DirXML pour PeopleSoft
Novell Confidential Manual (FRA) 28 October 2003
Configuration de PeopleCode pour déclencher des transactions
Le programme PSA contient un certain nombre d’objets PeopleTools qui permettent à PeopleSoft d’intercepter les événements dans une table de transaction. Le pilote accède ensuite aux tables de transaction via les objets d’interface de composant. Le pilote demande régulièrement les transactions qui doivent être traitées en fonction de leurs sous-types de pilote. Il traitera uniquement les transactions dont la date/l’heure est inférieure ou égale à la date/l’heure actuelle et dont l’état indique leur disponibilité. Le pilote traite également les transactions une par une à partir de la table de transaction avant d’obtenir une nouvelle transaction.
Le pilote crée ensuite un document XML à l’aide des données récupérées et les transmet au moteur
DirXML pour le traitement. Il met à jour l’état de la transaction et les messages applicables de la table de transaction dans PeopleSoft lorsque le moteur DirXML a terminé le traitement. Lorsque des événements se produisent dans eDirectory, le pilote se connecte à l’interface CI correspondante et met à jour la table PeopleSoft intermédiaire.
Pour déclencher des transactions, utilisez PeopleCode dans l’application PeopleSoft. Ce document suppose que vous savez écrire du PeopleCode. Si vous avez besoin d’une aide supplémentaire, merci de vous reporter à la documentation PeopleSoft.
Le pilote nécessite la transaction et le composant de schéma pour traiter les transactions. Pour plus d’informations sur l’appel de la fonction PeopleSoft qui crée des enregistrements de transaction, reportez-vous à
« Personnalisation de l’agent PSA par le déclenchement de transactions », page 31 .
Composant de transaction
Le composant de transaction permet au pilote de demander des transactions par sous-type de pilote, date et heure, et type d’événement. Le pilote demande une seule transaction en vue du traitement et obtient l’ID d’association de l’enregistrement en cours de traitement.
Lorsque le pilote sélectionne la première transaction à traiter, il définit l’état de la transaction sur
« In Process » (Traitement en cours). Ensuite, le pilote extrait le nom de l’événement qu’il utilise pour créer un document XML d’ajout, de modification ou de suppression. Le pilote utilise les valeurs de l’ID de schéma et de l’ID d’association pour accéder au schéma CI approprié et aux informations d’enregistrement appropriées qui sont associées à l’objet ID d’association.
Lorsque le moteur DirXML a traité la transaction, le pilote met à jour l’état de la transaction et le champ Comment (Commentaire) (en cas d’erreur ou de message d’avertissement.)
Configuration de votre environnement PeopleSoft
25
Novell Confidential Manual (FRA) 28 October 2003
Composant de schéma
Le composant de schéma permet au pilote de récupérer des données pour un enregistrement particulier et de mettre à jour la table PeopleSoft intermédiaire pour cet enregistrement. Lorsque le pilote a récupéré le nom de l’ID d’association et du CI de schéma, il accède à l’objet Schéma correspondant.
Lorsque le pilote accède au composant de schéma, il utilise la valeur reçue dans l’ID d’association et la valeur de clé pour récupérer les données de l’environnement PeopleSoft. Il utilise également ce composant afin de mettre à jour les données PeopleSoft pour l’enregistrement appartenant à la valeur de clé associée.
Par exemple, vous pouvez traiter les transactions pour les employés avec l’ID d’association=EMPLID et la valeur de clé=0001.
Le pilote accède au composant de schéma avec une valeur de clé de 0001. Il récupère tous les
éléments du composant qui ont été définis pour cet employé sur ce composant spécifique. Le pilote convertit ensuite la collecte de données transaction par transaction dans des documents XML qui seront lus par le moteur DirXML. Si une commande d’écriture différée est traitée ou un événement est publié via le canal Abonné, le pilote utilise ce composant pour mettre à jour la table intermédiaire avec les informations correspondantes dans les données PeopleSoft pour cet employé particulier.
Lorsque le pilote crée un nouvel objet, il crée une valeur d’association contenant l’ID d’association. Lorsque le pilote charge des CI de schéma, chaque objet Schéma agit comme sa propre classe d’objets. La règle d’assignation utilise l’assignation de classe selon les cas. Cela permet au pilote de connaître quel objet Schéma dans PeopleSoft est utilisé pour un élément particulier, ainsi que la façon de mettre à jour les données à appliquer dans PeopleSoft.
Test des interfaces de composant
Le programme Component Tester (Test des composants), qui fait partie du téléchargement, garantit que votre logiciel client PeopleTools est installé et configuré correctement sur l’ordinateur qui héberge le pilote.
Pour plus d’informations, reportez-vous au dossier Component Tester et à sa documentation.
26
Guide d’implémentation du pilote DirXML pour PeopleSoft
