3 Configuration de votre système PeopleSoft. Novell pour PeopleSoft
Novell Confidential Manual (FRA) 28 October 2003
3
Configuration de votre système PeopleSoft
Utilisez les informations présentées à la section suivante pour configurer votre système PeopleSoft afin de partager et synchroniser les données avec Novell
®
eDirectory
TM
.
« Installation du programme PeopleSoft Service Agent (PSA) », page 21
« Exécution du programme de test de Message Agent », page 29
« Installation du serveur d’événements », page 33
Installation du programme PeopleSoft Service Agent (PSA)
La procédure d’installation du programme PSA varie selon les versions de PeopleSoft.
« Installation de PSA pour PeopleSoft 7.5 », page 22
« Installation de PSA pour PeopleSoft 8.1 », page 26
Remarque : dans ces sections, 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.
Installation de PSA pour PeopleSoft 7.5
Si vous utilisez PeopleSoft 7.5, exécutez les tâches suivantes pour installer le programme PSA :
« Extraction des fichiers PSA », page 21
« Installation du programme PeopleSoft Service Agent (PSA) », page 22
« Copie du projet d’intégration Novell dans une base de données DMO cible », page 23
« Établissement de la sécurité pour les objets PSA dans PeopleSoft 7.5 », page 25
Extraction des fichiers PSA
Le projet PSA est fourni sous la forme d’un projet à extraction automatique. Pour extraire le projet, procédez comme suit :
1
Exécutez dirxml_driver_36.exe depuis l’emplacement que vous avez spécifié pour l’installation des composants de PeopleSoft. L’emplacement par défaut est Novell\nds\ps.
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.
Le projet PSA est maintenant prêt à être installé dans votre environnement PeopleSoft.
Configuration de votre système PeopleSoft
21
Novell Confidential Manual (FRA) 28 October 2003
Installation du programme PeopleSoft Service Agent (PSA)
Pour pouvoir installer et configurer les objets PeopleSoft, 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 un mot de passe uniques pour implémenter ces objets.
Pour appliquer l’ensemble d’objets PSA fourni, suivez les procédures PeopleSoft standard de mise
à niveau. Pour des informations sur les procédures de mise à niveau PeopleSoft, reportez-vous à la documentation PeopleSoft.
Installation de PSA pour PeopleSoft 7.5
Data Mover est un outil d’application qui permet d’importer des objets PeopleSoft externes dans une base de données PeopleSoft 7.5. En appliquant la procédure PeopleSoft standard de mise à niveau, vous pouvez utiliser Data Mover pour déplacer Identity Manager pour les projets
PeopleSoft dans l’environnement PeopleSoft de votre entreprise.
Un script Data Mover (DMS) est fourni avec le pilote. Ce script importe les objets nouveaux et modifiés dans les tables du dictionnaire des données. N’exécutez ce script que sur une base de données AUD (Application Update Database - base de données de mise à jour d’application) rafraîchie. Le rafraîchissement de la base de données permet de résoudre tout conflit entre les objets fournis et ceux qui existent déjà dans la base de données AUD.
Avertissement : si le script DMS est exécuté sur une base de données autre que la base de données AUD, il se peut qu’il échoue ou qu’il écrase les données existantes. L’exécution du script directement sur la base de données de développement PeopleSoft endommage cette dernière.
Vérifiez dans le répertoire C:\PSA que les fichiers DMS ont bien été copiés pendant l’installation des composants. Il s’agit du répertoire par défaut utilisé par le programme d’installation. Si vous avez modifié ce paramètre pendant l’installation, vérifiez le répertoire que vous avez indiqué. Les
étapes ci-après constituent la procédure par défaut pour importer les objets PeopleSoft externes :
1
2
3
4
Dans le menu Démarrer, cliquez sur Programmes > PeopleSoft > Data Mover.
Loguez-vous à la base de données AUD.
Cliquez sur File > Open (Fichier > Ouvrir).
Recherchez le fichier de votre installation > sélectionnez le script DMS avec le numéro de version adéquat. (Par exemple, DIRXML_DRIVER_PSA_36IMP.DMS.)
Il doit être identique à celui de la base de données PeopleSoft.
5
Dans la boîte de dialogue de syntaxe Data Mover, vérifiez que les fichiers d’entrée et les fichiers journaux pointent sur le répertoire qui contient les fichiers de données (.dat) sur l’unité locale.
L’exemple ci-après illustre la syntaxe fournie :
SET OUTPUT c:\PSA\AU_CHECK.DAT;
SET INPUT c:\PSA\PSA-PS75\DIRXML_DRIVER_PSA_36IMP.DAT;
SET LOG c:\PSA\DIRXML_DRIVER_PSA_36IMP.LOG;
SET NO TRACE;
SET IGNORE_DUPS;
EXPORT AU_CHECK;
IMPORT *;
22
Guide d’implémentation du pilote DirXML pour PeopleSoft
Novell Confidential Manual (FRA) 28 October 2003
6
Sélectionnez File > Run Script (Fichier > Exécuter le script).
Dans le rapport qui s’affiche dans le volet d’état inférieur, vérifiez que l’importation a réussi.
Si l’importation échoue, vérifiez que les chemins d’entrée et de sortie pointent sur les répertoires adéquats.
7
Fermez Data Mover.
Copie du projet d’intégration Novell dans une base de données DMO cible
Votre base de données DMO cible contient le catalogue système, les structures du dictionnaire des données et un exemple de données d’application. Lors du transfert d’une base de données AUD vers une base de données DMO cible, les objets du dictionnaire des données de la base de données
AUD sont copiés dans le dictionnaire de données de la base de données cible.
Une fois l’opération de copie terminée, vous devez créer la base de données. Cette opération permet de créer les tables physiques ou vues dans la base de données sous-jacente pour que les objets deviennent accessibles. Pour exécuter cette procédure, vous devez vous loguer en tant qu’utilisateur doté de droits d’administration.
Nous vous recommandons de procéder comme suit :
Utilisez une copie propre d’une base de données DMO cible pour cette procédure.
Si vous appliquez une copie à une base de données qui contient des données de production, faites-en une copie et effectuez une comparaison avant d’appliquer la copie de la base de données cible.
Exécutez une installation et testez-la avec une base de données DMO cible.
Effectuez cette opération avant de modifier la configuration et d’appliquer la base de données
à un environnement de développement ou de production.
Pour copier le projet dans une base de données DMO cible, procédez comme suit :
1
2
3
Dans le menu Démarrer, cliquez sur Programmes > PeopleSoft > PeopleTools.
Loguez-vous à la base de données AUD.
Cliquez sur Go > PeopleTools > Application Designer > File > Open (Aller > Application
Designer > Fichier > Ouvrir).
4
5
Cliquez sur Object Type (Type d’objet), puis sur Project (Projet).
Cliquez sur Selection Criteria, Name (Critères de sélection, Nom), tapez
DIRXML_DRIVER_PSA_36, puis cliquez sur Select (Sélectionner).
6
7
8
Cliquez sur le projet, puis sur Select (Sélectionner).
Cliquez sur Tools > Upgrade > Copy (Outils > Mettre à niveau > Copier).
Tapez le nom de la base de données DMO cible (dans laquelle le projet sera copié), l’ID d’opérateur et le mot de passe, puis cliquez sur OK.
Veillez à sélectionner le projet et tous les objets qu’il contient.
9
Cochez la case Export Project (Exporter le projet) pour exporter les objets vers la base de données cible, puis cliquez sur Copy (Copier).
Tous les objets de la base de données AUD sont copiés dans la base de données DMO cible.
10
Fermez la fenêtre Application Designer.
Configuration de votre système PeopleSoft
23
Novell Confidential Manual (FRA) 28 October 2003
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.
1
2
Dans le menu Démarrer, cliquez sur Programmes > PeopleSoft > PeopleTools.
Loguez-vous à la base de données DMO cible en utilisant un nom d’utilisateur administrateur doté de droits d’administration et de développement.
5
6
3
4
Dans Application Designer, cliquez sur File (Fichier), puis sur Open (Ouvrir).
Sélectionnez le projet DIRXML_DRIVER_PSA_36, puis cliquez sur Open (Ouvrir).
Cliquez sur 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).
7
Cliquez sur Build (Créer) pour créer des exemples de tables de projet. Une fois les tables de projet créées, cliquez sur Close (Fermer) pour fermer la fenêtre Build Progress (Progression de la création).
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.
8
9
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).
10
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).
À présent, vous devez établir les rôles et lancer le flux. Reportez-vous à
« Établissement des rôles et lancement du flux », page 24 .
Établissement des rôles et lancement du flux
Un rôle est une classe d’utilisateurs qui exécutent le même le type de travail. Ce sont les procédures d’entreprise qui déterminent généralement l’activité exécutée par un rôle.
L’administrateur eDirectory a été désigné comme le rôle qui exécute les événements d’ajout, de mise à jour et de suppression/désactivation. Cela signifie que le flux doit être activé et qu’un utilisateur à rôle doit être assigné au rôle d’administrateur eDirectory. Pour activer un flux, procédez comme suit :
1
Cliquez sur Go > PeopleTools > Workflow Administrator (Aller > PeopleTools > Workflow
Administrator).
2
Cliquez sur Use > Workflow System Defaults > Defaults (Utiliser > Paramètres par défaut du système de flux > Paramètres par défaut).
3
4
Cochez la case Worklist Active (Liste de travail active).
Si vous utilisez une messagerie et d’autres formes de communication électroniques, cochez les cases correspondantes.
5
Vérifiez qu’un utilisateur du rôle par défaut (généralement Admin WF) est également assigné et cliquez sur Save (Enregistrer). Si un flux n’est pas en cours d’utilisation par d’autres processus, assignez alors cet utilisateur au rôle d’administrateur eDirectory.
Vous devez maintenant assigner des droits de sécurité aux nouveaux objets. Reportez-vous à
« Établissement de la sécurité pour les objets PSA dans PeopleSoft 7.5 », page 25 .
24
Guide d’implémentation du pilote DirXML pour PeopleSoft
Novell Confidential Manual (FRA) 28 October 2003
Établissement de la sécurité pour les objets PSA dans PeopleSoft 7.5
Vous pouvez assigner des droits de sécurité à tous les nouveaux volets et toutes les nouvelles pages qui ont été ajoutés à un projet. Utilisez un compte de type administrateur pour établir la sécurité.
Application de la sécurité pour les nouveaux objets PSA
1
Cliquez sur Go > PeopleTools > Security Administrator (Aller > PeopleTools >
Administrateur de sécurité).
2
Cliquez sur File > Open (Fichier > Ouvrir). Sélectionnez ALLPANLS dans Operator Class
(Classe d’opérateur), puis cliquez sur OK.
3
4
5
Cliquez sur l’icône Menu Items (Éléments de menu) dans le volet gauche.
Cliquez sur Insert > Menu Name (Insérer > Nom de menu).
Double-cliquez sur DirXML_Administrator_36, cliquez sur Select All (Sélectionner tout), puis sur OK.
6
7
8
Cliquez sur Select All (Sélectionner tout), puis sur OK.
Enregistrez.
Vous pouvez maintenant quitter l’interface Security Administrator (Administrateur de sécurité).
Vérification de l’accès aux objets PSA
Une fois la sécurité appliquée aux nouveaux objets PSA, utilisez l’exemple d’application pour vérifier que vous pouvez accéder aux données, les modifier et les enregistrer.
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. 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.
Pour tester des exemples d’application PeopleSoft, procédez comme suit :
1
Connectez-vous en tant qu’administrateur à la base de données PeopleSoft en mode à deux niveaux.
2
Dans Application Designer, cliquez sur Go > DirXML Administrator 36 EP (Aller > DirXML
Administrator 36 EP).
3
4
Sélectionnez Use > DirXML Sample Department (Utiliser > Exemple de service DirXML).
Cliquez sur une ligne de champ Department (Service) vide pour ajouter un exemple de service et une description.
5
6
Cliquez sur Save (Enregistrer) pour ajouter le service.
Sélectionnez Use > DirXML Sample People > Add (Utiliser > Exemple de personne
DirXML > Ajouter).
7
8
Indiquez un numéro d’ID pour la nouvelle personne, puis cliquez sur OK.
Entrez les données dans les divers champs associés à cet ID, puis cliquez sur Save
(Enregistrer).
Les champs obligatoires sont : First Name (Prénom), Last Name (Nom), Birth Date
(Date de naissance), Status (État), Title (Titre) et Department ID (ID de service).
Configuration de votre système PeopleSoft
25
Novell Confidential Manual (FRA) 28 October 2003
9
Pour vérifier qu’une transaction d’ajout a été créée, accédez au menu Worklist Maintenance
(Gestion de la liste de travail) de eDirectory. Cliquez sur Use > eDirectory Worklist
Maintenance > eDirectory Worklist (Utiliser > Gestion de la liste de travail eDirectory > Liste de travail eDirectory). Vous pouvez maintenant rechercher l’ID que vous venez de créer.
10
11
Cliquez sur le bouton Search (Rechercher).
Double-cliquez sur l’événement que vous avez créé. Vérifiez dans les volets que les données que vous avez entrées y figurent.
12
Fermez le client PeopleSoft.
Maintenant que vous avez exécuté les tâches requises pour l’installation et la configuration du programme PSA, passez à l’étape
« Exécution du programme de test de Message Agent », page 29 .
Installation de PSA pour PeopleSoft 8.1
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 26
2.
« Importation du projet PSA dans la base de données PeopleSoft », page 26
3.
« Création de définitions d’enregistrement de projet », page 27
4.
« Test des exemples d’application PeopleSoft », page 27
Remarque : dans ces sections, 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.
Extraction des fichiers PSA
Le projet PSA est fourni sous la forme d’un projet à extraction automatique. Pour extraire le projet, procédez comme suit :
1
Exécutez DIRXML_DRIVER_36.EXE depuis l’emplacement que vous avez spécifié pour l’installation des composants de PeopleSoft. L’emplacement par défaut est Novell\NDS\PS.
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.
Le projet PSA est maintenant prêt à être installé dans votre environnement PeopleSoft.
Importation du projet PSA dans la base de données PeopleSoft
Depuis la version 8 de PeopleSoft, les projets sont fournis dans une structure de répertoires cache similaire à la structure du cache existant 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.
Pour importer le projet PSA dans la base de données PeopleSoft, procédez comme suit :
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).
26
Guide d’implémentation du pilote DirXML pour PeopleSoft
Novell Confidential Manual (FRA) 28 October 2003
3
Cliquez sur Browse (Parcourir) et sélectionnez le répertoire du projet PSA : C:\PSA\PSA-
PSA8\.
4
5
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.
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).
4
Cliquez sur Build (Créer) pour créer des exemples de tables de projet. Une fois les tables de projet créées, cliquez sur Close (Fermer) pour fermer la fenêtre Build Progress (Progression de la création).
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).
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. 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.
Pour tester des exemples d’application PeopleSoft, procédez comme suit :
1
Connectez-vous en tant qu’administrateur à la base de données PeopleSoft en mode à deux niveaux.
2
Dans Application Designer, sélectionnez Go > DirXML Administrator36 (Aller >
Administrateur36 DirXML).
3
Dans le menu DirXML Administrator (Administrateur DirXML), sélectionnez Use >
DirXML Sample Department (Utiliser > Exemple de service DirXML).
4
Cliquez sur une ligne de champ Department (Service) vide pour ajouter un exemple de service et une description.
5
6
Cliquez sur Save (Enregistrer) pour ajouter le service.
Dans le menu DirXML Administrator 36 (Administrateur 36 DirXML), cliquez sur Use >
DirXML Sample People > Add (Utiliser > Exemple de personne DirXML > Ajouter).
7
Indiquez un numéro d’ID, puis cliquez sur OK.
Configuration de votre système PeopleSoft
27
Novell Confidential Manual (FRA) 28 October 2003
8
Entrez les données dans les divers champs associés à cet ID, puis cliquez sur Save
(Enregistrer).
Les champs obligatoires sont : First Name (Prénom), Last Name (Nom), Birth Date (Date de naissance), Status (État), Title (Titre) et Department ID (ID de service).
9
Pour vérifier qu’une transaction d’ajout a été créée, cliquez sur Use > eDirectory Worklist
Maintenance > eDirectory Worklist (Utiliser > Gestion de la liste de travail eDirectory > Liste de travail eDirectory).
10
Cliquez sur le bouton Search (Rechercher) pour rechercher l’utilisateur que vous avez ajouté.
11
Double-cliquez sur l’événement pour afficher les détails le concernant.
28
Guide d’implémentation du pilote DirXML pour PeopleSoft
Novell Confidential Manual (FRA) 28 October 2003
12
Une fois que vous avez vérifié que les événements ont été correctement configurés, vérifiez que vous pouvez modifier les données et les enregistrer. Cliquez sur Use > eDirectory
Subscriber (Utiliser > eDirectory Subscriber).
13
Cliquez sur le bouton Search (Rechercher) pour localiser l’exemple de personne que vous avez créé.
14
Entrez un exemple de valeur (ou modifiez une valeur existante) dans le champ du numéro de téléphone, puis cliquez sur Save (Enregistrer).
15
Cliquez sur Use > eDirectory Query > DirXMLQuery01 (Utiliser > eDirectory Query
>DirXMLQuery01).
16
Cliquez sur le bouton Search (Rechercher), puis double-cliquez sur votre exemple de personne.
17
Vérifiez que le numéro de téléphone que vous avez ajouté ou modifié a changé.
18
Vous pouvez maintenant quitter le client PeopleSoft.
Maintenant que vous avez réalisé les étapes nécessaires pour configurer le programme PSA,
passez à « Exécution du programme de test de Message Agent », page 29 .
Exécution du programme de test de Message Agent
Vous pouvez tester les agents de messages de PeopleSoft suivants :
DIRXML_TRANS01
DIRXML_SCHEMA01
DIRXML_SCHEMA01_UPDATE
DIRXML_SCHEMA01_QUERY
Pour obtenir des informations de dépannage détaillées sur le système de test de Message Agent, reportez-vous au
Chapitre 4, « Dépannage du pilote », page 37
.
Configuration de votre système PeopleSoft
29
Novell Confidential Manual (FRA) 28 October 2003
Test de PeopleSoft Message Agent DIRXML_TRANS01
Dirxml_trans01.ist vérifie que Message Agent reçoit des événements de la liste de travail.
Remarque : les fichiers de script dont le nom est suivi du chiffre 8 sont destinés à PeopleSoft 8.1. Les autres scripts IST sont destinés à PeopleSoft 7.5.
1
2
Cherchez le répertoire C:\PSA\PSA-P75\ ou C:\PSA\PSA-P8\.
Copiez le programme de test correspondant à un agent de messages dans le répertoire
{ps_home}\bin\client\winx86.
Version de PeopleSoft
PeopleSoft 7.5
PeopleSoft 8.1
Programme de test
psmtst32v75.exe
psmtst32v80.exe
3
4
5
6
7
8
Créez sur le bureau un raccourci pour le programme de test de Message Agent.
Affichez les propriétés du programme et vérifiez que le fichier .IST n’est pas en lecture seule.
Double-cliquez sur le programme de test.
Cliquez sur File > Open (Fichier > Ouvrir).
Cliquez sur le fichier dirxml_trans01.ist, puis sur Open (Ouvrir).
Vérifiez que la chaîne de connexion, l’ID d’opérateur et le mot de passe appropriés sont listés pour la connexion au serveur d’application.
9
Cliquez sur Execute! (Exécuter).
Si Message Agent fonctionne correctement, la liste des champs clés de traitement est renseignée.
Vous trouverez ci-dessous un exemple de script :
Connect 137.65.147.162:7000,PS,PS; StartMessage
DIRXML_TRANS01,DIRXML_TRANS01; ProcessMessage; GetOutPutall; Disconnect;
Dans ce script, la chaîne de connexion est 137.65.147.162:7000. L’ID utilisateur et le mot de passe sont PS.
Vous pouvez maintenant fermer la fenêtre DIRXML_TRANS01. Ne fermez pas le programme de test de Message Agent car vous allez l’utiliser aux étapes suivantes.
Test de PeopleSoft Message Agent DIRXML_SCHEMA01
Dirxml_schema.ist vérifie que tous les champs contenus dans la définition du processus d’entreprise DIRXML_SCHEMA01 sont transmis à Message Agent.
3
4
5
1
2
Double-cliquez sur le programme de test de messages.
Cliquez sur File > Open (Fichier > Ouvrir).
Cliquez sur le fichier dirxml_schema01.ist, puis sur Open (Ouvrir).
Vérifiez que la chaîne de connexion, l’ID d’opérateur et le mot de passe appropriés sont listés.
Modifiez les champs INSTANCEID, INSTSTATUS, ACTIVITY NAME et EVENTNAME.
30
Guide d’implémentation du pilote DirXML pour PeopleSoft
Novell Confidential Manual (FRA) 28 October 2003
Pour obtenir ces informations, recherchez la personne et affichez le volet DIRXML_SCHEMA01 dans le volet eDirectory Work List Maintenance (Gestion de la liste de travail eDirectory), comme illustré ci-après :
Ces champs doivent correspondre à l’événement pour lequel vous essayez de recevoir les données de sortie. À partir des résultats du test précédent, copiez et collez les valeurs appropriées. Ces résultats ont été générés lors du test de dirxml_trans01.ist.
6
7
Cliquez sur Save (Enregistrer).
Cliquez sur Execute! (Exécuter).
Si Message Agent fonctionne correctement, tous les champs qui sont renseignés dans
PeopleSoft le sont également dans la sortie.
Vous trouverez ci-dessous un exemple de script :
Connect 137.65.147.182:7000,PS,PS; StartMessage
DIRXML_SCHEMA01,DIRXML_SCHEMA01; Setfield
BUSPROCNAME=DIRXML_INTEGRATION; Setfield ACTIVITYNAME=DIRXML_EVENT1;
Setfield EVENTNAME=ADD; Setfield WORKLISTNAME=DIRXML_ADD; Setfield
INSTANCEID=5; Setfield INSTSTATUS=0; Setfield COMMENTSHORT=Selected;
ProcessMessage; GetOutPutall; Disconnect;
8
Fermez les fichiers journaux.
Test de PeopleSoft Message Agent DIRXML_SCHEMA01_UPDATE
Dirxml_schema01_update.ist teste les mises à jour de l’enregistrement PeopleSoft
DIRXML_SCHEMA01_UPDATE. Ce processus teste les événements qui proviennent de eDirectory plutôt que de PeopleSoft.
3
4
1
2
Double-cliquez sur le programme de test de messages.
Cliquez sur File > Open (Fichier > Ouvrir).
Cliquez sur le fichier dirxml_schema01_update.ist, puis sur Open (Ouvrir).
Vérifiez que la chaîne de connexion, l’ID d’opérateur et le mot de passe appropriés sont listés.
Configuration de votre système PeopleSoft
31
Novell Confidential Manual (FRA) 28 October 2003
5
Modifiez ASSOC ID, NDS ID, NDS CONTEXT et les champs Description.
Ils doivent correspondre à l’employé que vous essayez de mettre à jour.
6
7
Cliquez sur Save (Enregistrer).
Cliquez sur Execute! (Exécuter).
Si Message Agent fonctionne correctement, les champs eDirectory d’ID, de nom distinctif, d’adresse électronique et de description correspondant à l’employé sélectionné sont utilisés pour renseigner la page eDirectory Subscriber (Canal Abonné eDirectory). Cette page correspond au volet NDS Data Update (NDS de mise à jour des données) pour PeopleSoft 7.5.
Vous trouverez ci-dessous un exemple de script :
Connect 137.65.139.178:7000,PS,PS; StartMessage
DIRXML_SCHEMA01_UPDATE,DIRXML_SCHEMA01_UPDATE; SetField Assoc ID=8964;
SetField NDS ID=GHORNBE; SetField NDS CONTEXT=NCS.PRV.NOVELL; SetField
Description=Updated; SetField email=unknown; ProcessMessage;
GetOutPutall; Disconnect;
8
Fermez le fichier journal.
Test de PeopleSoft Message Agent DIRXML_SCHEMA01_QUERY
DirXML_schema01_query.ist teste la fonction d’interrogation pour le pilote à partir de
PeopleSoft. Ce processus teste la capacité à récupérer des données de PeopleSoft en fonction du champ ASSOC ID.
Les champs de sortie définis sur l’objet Interrogation doivent être équivalents à ceux définis sur l’objet DIRXML_SCHEMA01.
La principale différence entre ces deux objets réside dans les champs d’entrée clés. Seul l’ID de cet objet est le champ clé (par exemple Assoc ID).
3
4
1
2
5
Double-cliquez sur le programme de test de messages.
Cliquez sur File > Open (Fichier > Ouvrir).
Cliquez sur le fichier dixml_schema01_query.ist, puis sur Open (Ouvrir).
Vérifiez que la chaîne de connexion, l’ID d’opérateur et le mot de passe appropriés sont listés.
Modifiez la valeur de Assoc ID.
Il doit correspondre à l’employé auquel vous tentez d’accéder.
6
Cliquez sur Execute! (Exécuter).
Si Message Agent fonctionne correctement, tous les champs qui sont renseignés dans
PeopleSoft le sont également dans la sortie.
Vous trouverez ci-dessous un exemple de script :
Connect 137.65.139.178:7000,PS,PS; StartMessage
DIRXML_SCHEMA01_QUERY,DIRXML_SCHEMA01_QUERY; SetField Assoc ID=8964;
ProcessMessage; GetOutPutall; Disconnect
7
Fermez le fichier journal.
Maintenant que vous avez testé vos agents de messages PeopleSoft, installez le serveur d’événements. Reportez-vous à
« Installation du serveur d’événements », page 33
.
32
Guide d’implémentation du pilote DirXML pour PeopleSoft
Novell Confidential Manual (FRA) 28 October 2003
Installation du serveur d’événements
Installation et configuration manuelles du serveur d’événements
Généralement, le serveur d’événements est installé au moment de l’exécution du programme d’installation. Si l’un des cas suivants s’est produit, installez ou configurez manuellement le raccourci sur le bureau pour le serveur d’événements :
Vous n’avez pas installé le serveur d’événements lors de l’installation des autres composants.
Plusieurs chemins de répertoire n’étaient pas disponibles pendant l’installation.
Installation du serveur d’événements
Les étapes suivantes supposent que eDirectory a été installé sur l’unité C du serveur dans le répertoire \novell\remoteloader\.
1
Copiez les programmes ci-après dans le répertoire c:\novell\nds.
Nps75eventserver.exe pour PeopleSoft 7.5
Nps81eventserver.exe pour PeopleSoft 8.1
2
Créez un raccourci sur le bureau pour l’application du serveur d’événements.
Important : si vous exécutez plusieurs pilotes PeopleSoft, créez un raccourci pour chaque serveur d’événements.
3
Éditez la ligne de commande dans le champ Target (Cible).
Le graphique ci-après illustre ce champ :
Cliquez avec le bouton droit de la souris sur le raccourci > cliquez sur Propriétés > Raccourci.
Entrez les paramètres du raccourci. Dans le tableau suivant, {PS_Home} est la racine de la structure de répertoires PeopleSoft.
Paramètres Plate-forme
PeopleSoft
PeopleSoft 7.5
PeopleSoft 8.1
C:\Novell\NDS\NPS75EventServer.exe -c -s:16386
-p:PS_Home\bin\client\winx86
C:\Novell\NDS\NPS81EventServer.exe -c -s:16394
-p:PS_Home\bin\client\winx86
Configuration de votre système PeopleSoft
33
Novell Confidential Manual (FRA) 28 October 2003
Le paramètre -c configure le serveur d’événements pour qu’il fonctionne en tant qu’application de la console. Lorsque vous utilisez ce paramètre, configurez les propriétés suivantes pour la fenêtre DOS :
Barre de défilement
Une présentation de couleur différente
Le serveur d’événements communique avec le pilote via une interface Windows Sockets ou un port d’écoute. Le tableau ci-après liste le numéro de socket fourni pour chaque serveur d’événements. Si ces chiffres entrent en conflit avec des sockets déjà utilisés dans votre entreprise, utilisez un autre ensemble de ports.
Serveur d’événements Port
Serveur d’événements PeopleSoft 7.5
16386
Serveur d’événements PeopleSoft 8.1
16394
Puisque chaque serveur d’événements exige quatre sockets ou ports consécutifs, les numéros de socket qui identifient les différents serveurs d’événements doivent respecter un intervalle d’au moins quatre chiffres.
Le serveur d’événements doit établir les communications avec PeopleSoft Message Agent.
Pour cela, il se connecte aux fichiers DLL de PeopleSoft Message Agent.
Ces fichiers DLL se trouvent généralement dans le répertoire
PS_HOME\BIN\CLIENT\WINX86.
Pour le raccourci NPS75EventServer, voici un exemple de chemin d’accès aux fichiers DLL de PeopleSoft Message Agent :
-p:d:\psoft\hr757\bin\client\winX86
. Dans cet exemple, PS_HOME est égal à d:\psoft\hr757.
4
Saisissez ce qui suit dans le champ Start In (Démarrer dans) :
c:\Novell\NDS
Il s’agit du répertoire dans lequel eDirectory est installé. La figure ci-après illustre ce champ :
5
6
Sélectionnez Apply (Appliquer) puis cliquez sur OK.
Ouvrez l’application via le raccourci.
Vous pouvez personnaliser la barre de défilement et les couleurs dans l’onglet Property (Propriété) de la fenêtre.
34
Guide d’implémentation du pilote DirXML pour PeopleSoft
Novell Confidential Manual (FRA) 28 October 2003
Arrêt du serveur d’événements
Il peut s’avérer nécessaire d’arrêter le serveur d’événements pour rafraîchir la connectivité de
PeopleSoft, recycler le serveur ou effectuer un débogage. Lorsque vous l’arrêtez, le serveur d’événements envoie une commande d’arrêt au module d’interface pilote, qui s’arrête avant que le serveur d’événements ne se ferme.
Pour arrêter le serveur d’événements depuis la fenêtre de la console, procédez comme suit :
1
2
Sélectionnez la fenêtre du serveur d’événements.
Entrez Q.
Important : pour arrêter le serveur d’événements, cliquez sur l’icône Exit (Quitter) dans la fenêtre. Mais ne faites cette action que si le module d’interface pilote n’est pas en cours d’exécution. Avant de cliquer sur l’icône, arrêtez le module d’interface pilote à partir du menu Propriétés de l’ensemble de pilotes DirXML.
Installation du serveur d’événements en tant que service
Vous pouvez installer le serveur d’événements en tant que service Windows NT ou Windows 2000.
Généralement, l’installation du serveur d’événements a lieu pendant l’installation du pilote.
Au cours de l’installation, deux autres raccourcis sont créés sur le bureau. Ils permettent de créer ou de supprimer le serveur d’événements en tant que service.
Pour installer le serveur d’événements en tant que service, procédez comme suit :
1
Vérifiez que le serveur d’événements est disponible.
Sur une machine locale, vérifiez que NPSxEvent Server.exe est enregistré en local sur la machine.
Si vous installez le serveur d’événements sur un serveur distant, sur lequel eDirectory n’est pas installé, copiez les fichiers dirxmllib.dll et expat.dll du répertoire novell\nds dans le répertoire à partir duquel le serveur d’événements sera exécuté.
Remarque : le client PeopleSoft doit toujours être installé sur le serveur sur lequel le serveur d’événements sera exécuté.
L’adresse IP du serveur distant est utilisée au moment de configurer le serveur d’événements dans la boîte de dialogue Paramètres du pilote.
2
À l’invite de commande, accédez au répertoire dans lequel le fichier exécutable est stocké et entrez la commande suivante :
NPS75EventServer.exe -i -s:16386 -p: PS_HOME\bin\client\winx86
Selon votre environnement et la configuration de votre serveur, il est possible que le numéro de socket et le chemin du fichier Psmsg.dll de PeopleSoft soient différents.
3
Dans le menu Démarrer, cliquez sur Paramètres > Panneau de configuration > Services >
Serveur d’événements DirXML pour PS 7.5 (ou la version adéquate).
4
Cliquez sur Démarrage > sélectionnez le bouton d’option Automatique pour démarrer automatiquement le serveur d’événements au login, puis cliquez sur Démarrer.
Pour arrêter le service, procédez comme suit :
1
2
Dans le menu Démarrer, cliquez sur Paramètres > Panneau de configuration > Services.
Sélectionnez le service, puis cliquez sur Arrêter.
Configuration de votre système PeopleSoft
35
Novell Confidential Manual (FRA) 28 October 2003
Désinstallation manuelle du serveur d’événements en tant que service
Vous pouvez désinstaller ou supprimer le serveur d’événements en tant que service. Pour cela, suivez les mêmes étapes que pour l’installation du serveur d’événements, mais à l’étape 2, remplacez le paramètre -i par le paramètre -u.
Entrez, par exemple, NPS75EventServer.exe -u -s:16386 -p: PS_HOME\bin\client\winx86
Remarque : il n’y a aucune fenêtre pour la console lorsque le serveur d’événements s’exécute en tant que service. Toutes les informations de débogage sont disponibles uniquement dans le journal DSTRACE.
36
Guide d’implémentation du pilote DirXML pour PeopleSoft
