Novell Confidential Manual (FRA) 28 October 2003
4
Dépannage du pilote
Cette section décrit les problèmes potentiels et les codes d’erreur que vous pouvez rencontrer lors de la configuration ou de l’utilisation du pilote.
Résolution des erreurs
Le serveur d’événements ne se charge pas.
Vérifiez la variable d’environnement path afin de vous assurer que le client PeopleSoft et le répertoire de Identity Manager figurent dans son chemin.
Le pilote ne démarre pas.
Vérifiez que le serveur d’événements est en cours d’exécution.
Vérifiez que le fichier npsshim.dll est accessible.
Vérifiez que les paramètres de connexion sont corrects.
Le pilote ne communique pas avec le serveur d’événements
Vérifiez que le serveur d’événements a été démarré en premier.
Vérifiez que plusieurs copies du serveur d’événements et du pilote ne sont pas en cours d’exécution.
Vérifiez que la connexion n’a pas été interrompue précédemment.
Vous devrez peut-être redémarrer Novell
®
eDirectory
TM
puis redémarrer les composants du pilote.
Le serveur d’événements reçoit des erreurs de Message Agent.
Vérifiez que les API sont correctement configurées. (Utilisez le programme de test de
Message Agent.)
Vérifiez que le serveur d’applications est en cours d’exécution.
Vérifiez la connectivité avec Message Agent.
Dépannage du pilote
37
Novell Confidential Manual (FRA) 28 October 2003
Vérifiez que vous disposez de la chaîne de connexion correcte pour le serveur d’applications
PeopleSoft :
Vous pouvez utiliser NOM_D’HÔTE:PORT ou IP:PORT pour une seule instance du serveur d’applications ou
Utilisez le mode de reprise après échec //NOM_D’HÔTE:PORT,//NOM_D’HÔTE:PORT où la première entrée est le premier serveur d’applications et la deuxième entrée est le deuxième serveur d’applications auquel le pilote tente de se connecter.
Vérifiez que l’orthographe des noms des API de Message Agent est correcte. Ces noms respectent la casse.
Vérifiez que la mise à jour de la transaction de liste de travail ne génère pas d’erreur.
Vérifiez qu’il n’y a pas d’erreurs dans le serveur d’applications.
Vérifiez qu’il n’y a pas d’erreurs dans la passerelle SMTP.
Vérifiez l’usage du mot de passe du pilote. Il peut respecter la casse selon votre plate-forme.
Les attributs ne sont pas rafraîchis sur l’objet d’assignation de données.
Vérifiez que les API de Message Agent fonctionnent correctement.
Vérifiez que les API de liste de travail et de mise à jour des données fonctionnent correctement
(DIRXML_SCHEMA01 et DIRXML_SCHEMA01_UPDATE).
Le pilote semble ne traiter que les transactions.
Les transactions semblent être lues dans la liste de travail, mais le pilote ne traite rien. Les messages se répètent. Le texte de sortie suivant peut apparaître sur la console du serveur d’événements :
Record Count: 5
Processing record 1 of 5.
Processing record 2 of 5.
Processing record 3 of 5.
Processing record 4 of 5.
Processing record 5 of 5.
Pourtant, aucune donnée n’est traitée. Les transactions de la liste de travail sont bien lues mais les données ne sont pas extraites des transactions. Vérifiez que vous pouvez lire les données dans la définition de message par défaut DIRXML_SCHEMA01. Vous devez également effectuer les opérations suivantes :
Vérifiez que vous pouvez lire une transaction particulière avec le programme de test des messages.
Vérifiez que vous n’obtenez qu’un seul enregistrement lorsque vous accédez à la même transaction en ligne.
Vérifiez que le champ ACTIONDTTM a été supprimé en tant que champ d’entrée sur l’API.
38
Guide d’implémentation du pilote DirXML pour PeopleSoft
Novell Confidential Manual (FRA) 28 October 2003
Les données ne s’affichent pas sur le canal Éditeur de eDirectory.
Vérifiez que la règle et les filtres d’assignation sont correctement configurés.
Vérifiez que les API fonctionnent correctement et qu’elles produisent des données.
Les données ne sont pas mises à jour sur le canal Abonné de PeopleSoft.
Vérifiez que la règle et les filtres d’assignation sont correctement configurés.
Vérifiez que les API fonctionnent correctement.
Aucune transaction n’est publiée via le canal Éditeur.
Vérifiez que la case de synchronisation par défaut de eDirectory est cochée.
Vérifiez que la file d’attente inclut des transactions actives prêtes à être traitées.
Vérifiez que les paramètres du pilote pointent sur la base de données PeopleSoft correcte.
Par exemple, les transactions ne sont pas traitées si elles se trouvent dans la base de données
PROD et si le pilote pointe toujours sur la base de données test (celle-ci est configurée pour
être exécutée avec le pilote mais elle ne contient pas de transactions).
Les transactions ne sont pas placées dans la file d’attente de PeopleSoft.
Vérifiez que PeopleCode fonctionne correctement.
Vérifiez que vous n’êtes pas en mode Correction lors de l’exécution des mises à jour.
Aucune donnée n’est renvoyée lors de l’exécution du programme de test des messages.
Aucune donnée n’est renvoyée, notamment lorsque vous exécutez le programme de test des messages. Des erreurs telles que « No Text Available. » (Aucun texte disponible) peuvent s’afficher.
Généralement, cette erreur a deux raisons :
Les éléments d’entrée clés ne pointent pas sur l’enregistrement de recherche dans la définition d’assignation des champs de l’activité.
Les éléments de champ pointent sur une référence non valide.
Vérifiez que les éléments d’entrée clés sont associés à l’entrée de l’enregistrement de recherche dans la définition d’assignation des champs et pas directement à la table. Vérifiez également que les éléments de champ sont assignés à la définition d’enregistrement de champ adéquate, qui existe dans le tampon de l’application. Vérifiez que des éléments de données existent sur une page dans l’application et que les liaisons sont correctement configurées.
Dépannage du pilote
39
Novell Confidential Manual (FRA) 28 October 2003
Les transactions sont laissées dans l’état sélectionné et ne sont pas traitées.
Vérifiez que toutes les activités de message peuvent être traitées et que les états peuvent être mis à jour et prendre la valeur 2 (worked) (traitée) ou 4 (error) (erreur).
Si la messagerie électronique est configurée dans PeopleSoft et si la passerelle SMTP est hors service, une erreur peut se produire et provoquer l’échec de la mise à jour de la liste des transactions. Vérifiez que tous les traitements en ligne de l’application fonctionnent correctement. Les données PeopleCode jointes à la mise à jour peuvent parfois échouer, provoquant ainsi l’échec de la transaction. Si la connectivité du système est perdue, la base de données ou le serveur d’applications est mis hors service et le traitement de la transaction par le pilote est abandonné. Celle-ci est alors laissée à l’état « selected » (sélectionnée) avec l’état 1.
Réception d’erreurs sur le canal Éditeur lors du traitement d’une transaction.
Voici des exemples d’erreurs et des informations sur leur signification :
Operation vetoed by Create policy (L’opération s’est heurtée à un veto de la règle de création).
Des données requises sont peut-être manquantes dans la règle de création ou d’autres critères de la règle de création comportent une erreur.
generateKeyPair: -216 DSERR_PASSWORD_TOO_SHORT
L’attribut utilisé pour le mot de passe initial ne respecte pas la règle, mais l’objet Utilisateur sera néanmoins créé.
Unable to read current state of 8101 (Impossible de lire l’état actuel de 8101).
Aucune association n’existe pour cette identité.
nameToID: -601 ERR_NO_SUCH_ENTRY
Erreur possible dans la règle de placement avec désignation d’un objet Conteneur non valide.
No DN generated by Placement policy (Aucun nom distinctif généré par la règle de placement)
Données peut-être manquantes ou non valides provoquant la création d’aucun nom distinctif valide.
Les relations avec Message Agent ne fonctionnent pas.
Si les données n’apparaissent pas dans les attributs, si elles ne sont pas publiées dans PeopleSoft ou si des données sont manquantes, vous devriez commencer par examiner les relations avec l’agent de messages. Procédez comme suit :
Vérifiez que l’API reçoit les données du tampon de PeopleSoft. (Utilisez le programme de test de l’agent de messages et suivez les quatre étapes du processus du pilote pour tester toutes les
API.)
Voici, pour les activités fournies avec Message Agent, le processus à suivre pour tester les scripts de Message Agent à l’aide du programme de test. L’objectif de ce test est de valider, entièrement et étape par étape, le processus qu’utilise le pilote pour s’interfacer avec
PeopleSoft, récupérer des transactions et mettre à jour l’environnement PeopleSoft. Toutes les applications auxquelles sont connectées les activités de message doivent être testées en ligne via PeopleTools avant de tester les scripts de Message Agent :
1
Vérifiez qu’il n’existe qu’une transaction active/disponible prête à être traitée dans la liste de travail.
40
Guide d’implémentation du pilote DirXML pour PeopleSoft
Novell Confidential Manual (FRA) 28 October 2003
2
3
4
Exécutez le script dirxml_trans01.ist pour récupérer la transaction dans la liste de travail.
Vérifiez que les éléments clés de la transaction sont renvoyés et qu’ils sont uniques.
Exécutez le deuxième script, DIRXML_SCHEMA01, et remplacez les valeurs de l’élément clé par les valeurs récupérées à l’étape 2 ci-dessus après l’exécution du script dirxml_trans01.ist. Modifiez l’état INSTSTATUS à 1 pour représenter la mise à jour de la transaction PeopleSoft à l’état sélectionné.
5
Vérifiez que tous les éléments de données apparaissent comme souhaité.
Si des éléments sont manquants, il est probable que les données récupérées sur l’une des pages dans l’application posent problème. Vérifiez les pages ...DATA1X, ...DATA2X et ...DATA3X dans l’application associée. Même si les données apparaissent sur la page, elles ne figurent pas toujours dans les résultats de l’exécution du script en raison d’un problème dans la définition d’affichage.
La non-visibilité des données peut aussi être liée au fait que le sens du processus n’est pas configuré sur la sortie pour l’assignation de champs dans la définition d’activité.
6
Répétez les étapes 4 et 5 en exécutant à nouveau le script pour la même transaction tout en passant l’état à 2 (worked) (traitée) et à 4 (error) (erreur).
Lorsqu’il traite une transaction, le pilote lui assigne toujours l’état 1 (selected) (sélectionnée).
Une fois qu’elle est traitée, il lui attribue l’état 2 (worked) (traitée) ou 4 (error) (erreur). En cas d’erreur, le champ de commentaire est également mis à jour. Veillez à tester toutes les mises à jour possibles et à vérifier en ligne que la mise à jour a bien eu lieu et comme souhaité.
7
Exécutez le script DIRXML_SCHEMA01_UPDATE pour un objet particulier. Pour un employé donné, spécifiez par défaut l’EMPLID de cet employé. Les champs NDS ID et NDS
CONTEXT sont mis à jour dans PeopleSoft sur l’enregistrement DIRXML_TRANS01 lorsque le pilote termine le traitement d’une transaction récupérée auprès du canal Éditeur.
Si cette opération échoue, le pilote ne peut pas terminer la mise à jour de l’état qui intervient aux étapes précédentes. La mise à jour de ces champs n’est effectuée qu’à des fins de documentation ou pour rendre ces champs disponibles ailleurs dans PeopleSoft, ou pour les utiliser dans un message électronique généré par un flux PeopleSoft, etc. Cette fonction peut
être désactivée à l’aide d’un paramètre prioritaire défini dans la page des paramètres de propriétés dans la configuration du pilote.
Remarque : exécutez le script plusieurs fois en remplaçant le contenu des champs Description et Email
ID et/ou de tout autre champ qui a pu être ajouté à la table DIRXML_TRANS01 et à cette définition, et qui sont configurés pour être mis à jour par le pilote sur le canal Abonné, c’est-à-dire de eDirectory vers
PeopleSoft.
8
Exécutez le script DIRXML_SCHEMA01_QUERY pour confirmer que les éléments de données pour un objet particulier sont accessibles.
Ces éléments doivent aussi être configurés sur sortie, sauf pour la valeur d’entrée clé. Les
éléments listés ici sur l’assignation des champs doivent correspondre à ceux qui figurent dans la définition DIRXML_SCHEMA01. La seule différence étant les champs d’entrée clés. Sur cette activité, il existe normalement un champ d’entrée clé pour l’objet auquel le système accède. Ce qui équivaut à EMPLID pour la configuration livrée avec la base de données HR.
Dépannage du pilote
41
Novell Confidential Manual (FRA) 28 October 2003
Lorsque tous les scripts du programme de test de l’agent de messages ont été entièrement testés avec validation de tous les processus pour lesquels le pilote est configuré, le pilote ne devrait plus rencontrer de difficultés pour accéder à PeopleSoft via Message Agent. Il existe d’autres problèmes types, notamment :
l’adresse IP et port de connectivité pour le serveur d’applications,
l’ID et le mot de passe,
l’assignation du nom correct à toutes les activités dans les paramètres du pilote.
N’oubliez pas qu’il y a trois phases de test de base :
1. Tester tous les processus manuellement en ligne à l’aide des applications PeopleSoft telles que configurées.
2. Tester tous les processus à l’aide des quatre scripts de test du programme de test de Message
Agent.
3. Tester le pilote lorsqu’il se connecte aux activités via Message Agent.
42
Guide d’implémentation du pilote DirXML pour PeopleSoft
