Novell Confidential Manual (FRA) 28 October 2003
5
Dépannage du pilote
Cette section décrit les problèmes et les codes d’erreur que vous pouvez rencontrer lors de la configuration ou de l’utilisation du pilote.
« Le pilote ne démarre pas. », page 47
« Les attributs ne sont pas rafraîchis sur l’objet d’assignation de données. », page 47
« Les données ne s’affichent pas sur le canal Éditeur de eDirectory. », page 47
« Erreur : vérifiez l’adresse IP du serveur d’applications et le numéro du port Jolt », page 48
« Les données ne sont pas mises à jour sur le canal Abonné de PeopleSoft. », page 48
« Aucune transaction n’est publiée via le canal Éditeur. », page 48
« Les transactions ne sont pas placées dans la file d’attente de PeopleSoft. », page 48
« Aucune donnée n’est renvoyée lors de l’exécution du programme de test de l’interface de composant. », page 48
« Les transactions sont laissées dans l’état « Process » (À traiter) et ne sont pas traitées. », page 49
« Erreurs sur le canal Éditeur lors du traitement d’une transaction », page 49
« Les relations avec l’interface de composant ne fonctionnent pas », page 50
Le pilote ne démarre pas.
Vérifiez que nps8shim.dll est accessible.
Vérifiez que les paramètres de connexion sont corrects.
Les attributs ne sont pas rafraîchis sur l’objet d’assignation de données.
Vérifiez que les interfaces de composant fonctionnent correctement.
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.
Dépannage du pilote
47
Novell Confidential Manual (FRA) 28 October 2003
Erreur : vérifiez l’adresse IP du serveur d’applications et le numéro du port Jolt
Vérifiez que PeopleSoft se connecte correctement à la JVM. Exécutez le fichier jnitest.exe à partir du répertoire de l’API externe de PeopleSoft : pshome\bin\client\winx86_api\.
Avant de configurer le pilote, vous devez installer l’API externe PeopleSoft (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 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.
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 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.
Aucune donnée n’est renvoyée lors de l’exécution du programme de test de l’interface de composant.
Généralement, cette erreur a deux raisons :
Les éléments d’entrée clés ne pointent pas sur l’enregistrement de recherche
Les éléments de champ pointent sur une référence non valide
Assurez-vous que les éléments d’entrée clés sont associés à l’entrée de l’enregistrement de recherche et que les éléments de champ sont assignés à la définition d’enregistrement de champ adéquate, qui existe dans le tampon du composant. Vérifiez également que des éléments de données existent sur une page dans le composant et que les liaisons sont correctement configurées.
48
Guide d’implémentation du pilote DirXML pour PeopleSoft
Novell Confidential Manual (FRA) 28 October 2003
Les transactions sont laissées dans l’état « Process » (À traiter) et ne sont pas traitées.
Vérifiez que tous les objets CI peuvent être traités et que l’état peut être mis à jour avec l’état
Success (S), Working (W) ou Error (E).
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 transaction.
Vérifiez que tous les traitements en ligne de l’application fonctionnent correctement.
Les données PeopleCode jointes à la mise à jour peuvent parfois échouer et provoquer 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 dans l’état selected (sélectionnée) avec l’état 1.
Remarque : si un traitement de notification est requis, nous vous recommandons d’utiliser le service de notification Identity Manager au lieu du traitement SMTP tel que configuré dans PeopleSoft.
Erreurs sur le canal Éditeur lors du traitement d’une transaction
La liste suivante fournit des exemples d’erreurs et leur signification :
Operation vetoed by the 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.
Dépannage du pilote
49
Novell Confidential Manual (FRA) 28 October 2003
Les relations avec l’interface de composant ne fonctionnent pas
Si des données n’apparaissent pas dans les attributs, ne sont pas publiées vers PeopleSoft via le canal Éditeur ou sont manquantes, contrôlez les relations avec l’interface de composant.
Vérifiez d’abord que l’API reçoit les données du tampon de PeopleSoft.
Une fois que tous les CI ont été entièrement testés et que tous les processus pour lesquels le pilote est configuré ont été validés, le pilote ne devrait plus avoir de problème pour accéder à PeopleSoft via les CI. 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.
Pour résoudre ces problèmes, effectuez les trois tests de base suivants :
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 interfaces de composant.
3. Tester la connexion du pilote à l’API à l’aide des interfaces de composant.
50
Guide d’implémentation du pilote DirXML pour PeopleSoft
