Utilisation de l’outil DSTrace. Novell pour SAP HR
Novell Confidential Manual (FRA) 28 October 2003
6
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.
« Erreurs de chargement du pilote », page 49
« Erreurs d’initialisation du pilote », page 50
« Error connecting to SAP host (Erreur de connexion à l’hôte SAP) », page 50
« Attribute Mapping Error (Erreur d’assignation d’attribut) », page 51
« Le pilote ne reconnaît pas les fichiers IDoc dans le répertoire », page 52
« Les fichiers IDoc ne sont pas écrits dans le répertoire », page 52
« Le pilote ne parvient pas à s’authentifier auprès de SAP », page 52
« Erreurs d’installation et de configuration de JCO », page 52
« Erreur lors de l’assignation d’unités au répertoire IDoc », page 53
Utilisation de l’outil DSTrace
Vous pouvez dépanner le pilote à l’aide de l’utilitaire DSTrace. Pour configurer les options de l’utilitaire, sélectionnez Éditer > Propriétés > Pilotes DirXML.
Pour chaque événement ou opération reçu(e), le pilote renvoie un document XML qui contient un rapport d’état. Si l’opération ou l’événement n’aboutit pas, le rapport d’état contient aussi une raison et un message texte qui décrit la condition d’erreur. Si le résultat est fatal, le pilote s’arrête.
Après avoir configuré l’utilitaire DSTrace, vous pouvez contrôler la présence d’erreurs sur le système.
Erreurs de chargement du pilote
Si le pilote ne se charge pas, vérifiez la présence des messages d’erreur suivants dans DSTrace :
java.lang.ClassNotFoundException:com.novell.nds.dirxml.driver.SAPShim.SAPDriver Shim
Il s’agit d’une erreur fatale qui se produit lorsque SAPShim.jar n’est pas installé correctement.
Vérifiez que le fichier est au bon emplacement pour une configuration de chargeur distant ou local.
Dépannage du pilote
49
Novell Confidential Manual (FRA) 28 October 2003
java.lang.ClassNotFoundException:com.novell.nds.dirxml.driver.SAPShim.SAPDriver Shim
Il s’agit d’une erreur fatale qui se produit lorsque le nom de classe de SAPShim.jar est incorrect.
Vérifiez que le nom de classe Java est défini dans l’onglet Module pilote (installation locale) et que le paramètre -class est défini dans une configuration de chargeur distant.
Le nom correct de la classe est com.novell.nds.dirxml.driver.SAPShim.SAPDriverShim.
Erreurs d’initialisation du pilote
Vous verrez peut-être les erreurs d’initialisation du pilote suivantes dans l’utilitaire DSTrace.
Une explication de chaque erreur est donnée, avec les solutions recommandées.
com/sap/mw/jco/JCO
Cette erreur se produit lorsque le fichier JCO.jar de SAP Java Connector ou les bibliothèques de prise en charge natives de JCO sont absents ou à un emplacement incorrect.
Vérifiez que la version de JCO.jar correspondant à la plate-forme figure dans le même répertoire que SAPShim.jar.
Vérifiez également que les bibliothèques de prise en charge natives de JCO sont présentes et qu’elles correctement configurées. Utilisez les instructions d’installation de JCO pour la plateforme appropriée.
no jRFC12 in java.library.path (pas de jRFC12 dans java.library.path)
Cette erreur se produit lorsque la bibliothèque de prise en charge RFC12 native de SAP Java
Connector (JCO) est absente ou à un emplacement incorrect. Vérifiez que les bibliothèques de prise en charge natives de JCO sont présentes et correctement configurées. Utilisez les instructions d’installation de JCO pour la plate-forme appropriée.
/usr/jdk1.3.1/lib/sparc/libjRFC12.so:<classpath info>:fatal librfccm.so:open failed: (/usr/jdk1.3.1/lib/sparc/ libjRFC12.so:<classpath info>:fatal librfccm.so:échec de l’ouverture:) No such file or directory (Fichier ou répertoire inexistant)
Cette erreur se produit lorsque le fichier librfccm.so de la bibliothèque de prise en charge RFC native de SAP Java Connector (JCO) est absent ou à un emplacement incorrect. Cet exemple d’erreur provient d’un système Solaris.
Vérifiez que les bibliothèques de prise en charge native de JCO sont présentes et qu’elles sont correctement configurées. Suivez les instructions d’installation de JCO pour la plate-forme appropriée.
com.novell.nds.dirxml.engine.VRDException
Cette erreur survient lorsque les composants JCO (Java Connector) de SAP sont introuvables. Elle se produit généralement si le pilote ou le chargeur distant n’ont pas été redémarrés après la configuration du JCO. Redémarrez Novell
®
eDirectory
TM
si vous utilisez une configuration locale ou le chargeur distant si vous utilisez une configuration distante.
Error connecting to SAP host (Erreur de connexion à l’hôte SAP)
Cette erreur se produit lorsque les informations relatives à l’authentification ou à la connexion de
SAP ne sont pas correctement configurées. Vérifiez que les valeurs des paramètres d’authentification et de pilote sont correctes pour l’authentification auprès du système hôte SAP.
50
Guide d’implémentation du pilote DirXML pour SAP HR
Novell Confidential Manual (FRA) 28 October 2003
nsap-pub-directory parameter is not a directory (Le paramètre nsap-pub-directory n’est pas un répertoire)
Cette erreur se produit lorsque le paramètre Répertoire IDoc de l’objet Éditeur dans Configuration de l’objet Éditeur ne précise pas un emplacement valide du système de fichiers. Vérifiez que ce paramètre indique bien le répertoire du système SAP configuré dans le sous-système ALE SAP pour la sortie du fichier IDoc.
No connection to remote loader (Aucune connexion au chargeur distant)
Cette erreur se produit lorsque les informations relatives au paramètre de connexion du chargeur distant sont incorrectes. Configurez les bonnes informations de connexion pour la connexion distante au système sur lequel s’exécute le chargeur distant.
Authentication handshake failed, Remote Loader message: "Invalid loader password." (Échec d’établissement de connexion pour authentification, message du chargeur distant : « Mot de passe du chargeur incorrect. »)
Cette erreur se produit lorsque le mot de passe du chargeur distant configuré sur le système distant ne correspond pas au mot de passe du chargeur distant sur l’objet Pilote.
Définissez des mots de passe concordants pour les deux chargeurs distants. Dans ConsoleOne
®
ou iManager, vérifiez que le mot de passe de l’application et les mots de passe du chargeur distant sont définis en même temps.
Authentication handshake failed: Received invalid driver object password (Échec d’établissement de connexion pour authentification : Réception d’un mot de passe d’objet Pilote incorrect)
Cette erreur se produit lorsque le mot de passe du pilote configuré sur le système distant ne correspond pas au mot de passe de l’objet Pilote. Pour corriger cette erreur, attribuez deux mots de passe identiques à l’objet Pilote.
Attribute Mapping Error (Erreur d’assignation d’attribut)
Si la boîte de dialogue d’ajout de la règle d’assignation ne contient aucune donnée pour les APP
(application properties of class mappings - propriétés de l’application définies dans l’assignation de classe), le pilote ne trouve pas le fichier de métadonnées de schéma HRMD_A.
Vous devez vérifier que le répertoire des fichiers de métadonnées et les paramètres du pilote du fichier IDoc HR principal sont définis sur un emplacement valide du système de fichiers et qu’ils contiennent le nom d’IDoc approprié. Vérifiez que le fichier de métadonnées pour le type IDoc configuré est dans l’emplacement du système de fichiers. Par exemple, si le paramètre IDoc HR principal a la valeur par défaut HRMD_A03, vérifiez que HRMD_A03.meta existe dans le répertoire des fichiers de métadonnées.
Les modifications effectuées dans SAP ne génèrent pas de fichier IDoc ni de document de modification
Vérifiez que les processus ALE et de pointeur de modification sont correctement configurés et que vous avez correctement entré les données.
Pour insérer ou modifier des données, il faut passer par l’intermédiaire des menus Edit > Create
(Édition> Créer) ou Edit > Change (Édition > Modifier). Si vous introduisez une erreur ou une modification en remplaçant un enregistrement existant et en l’enregistrant, le document de modification n’est pas créé.
Dépannage du pilote
51
Novell Confidential Manual (FRA) 28 October 2003
Le pilote ne reconnaît pas les fichiers IDoc dans le répertoire
Vérifiez que les paramètres du pilote contiennent le numéro de client et le répertoire IDoc appropriés.
Les fichiers IDoc ne sont pas écrits dans le répertoire
Commencez par tester l’interface ALE et IDoc. Pour plus d’informations, reportez-vous à votre documentation SAP.
Si l’interface IDoc échoue :
À l’aide de la transaction WE21, vérifiez que le port de fichier est correctement configuré.
Validez le chemin d’accès au répertoire et vérifiez que le bouton d’option Transfer IDoc
Immediately (Transférer le fichier IDoc immédiatement) est sélectionné.
À l’aide de la transaction WE20, vérifiez que le port de fichier approprié est sélectionné dans le profil de partenaire. Par ailleurs, vérifiez qu’il se trouve dans les paramètres de sortie du système récepteur.
Si l’interface IDoc réussit :
Vérifiez que les pointeurs de modification ont été configurés.
Vérifiez que les processus planifiés ne sont pas trop proches les uns des autres. Par exemple, si un travail est en cours et qu’un autre commence, le second travail risque d’être annulé parce que le premier est toujours en cours d’exécution.
Le pilote ne parvient pas à s’authentifier auprès de SAP
Vérifiez d’abord que vous avez configuré tous les paramètres du pilote et que vous avez entré tous les bons mots de passe.
Si vous utilisez la configuration Canal Éditeur uniquement du pilote, vérifiez que vous avez entré les bons paramètres. Si vous avez déjà utilisé un pilote de publication des données via les canaux
Éditeur et Abonné, vérifiez que tous les fichiers ont été remplacés par les fichiers de publication via le canal Éditeur uniquement.
Si vous exécutez le pilote à distance, vérifiez que le chargeur distant a été lancé, avant de démarrer le pilote.
Erreurs d’installation et de configuration de JCO
Pour des instructions détaillées sur l’utilisation de l’outil de test JCO et l’analyse des messages d’erreur, reportez-vous à
« Utilisation de l’outil de test de SAP Java Connector », page 33
.
52
Guide d’implémentation du pilote DirXML pour SAP HR
Novell Confidential Manual (FRA) 28 October 2003
Erreur lors de l’assignation d’unités au répertoire IDoc
Vous verrez peut-être l’erreur suivante dans DS Trace (Suivi DS) si le paramètre du répertoire IDoc indique un conteneur du système de fichiers local invalide ou s’il indique un lecteur assigné sur un système distant.
*** NDS Trace Utility - BEGIN Logging *** Fri Sep 13 15:45:59 2002
DirXML Log Event -------------------
Driver = \FLIBBLE_TREE\n\Driver Set\SAP-HR
Channel = publisher
Status = fatal
Message = <description>SAP Document Poller initialization failed (Échec de l’initialisation de l’observateur de documents SAP.): com.novell.nds.dirxml.driver.SAPShim.SAPDocumentPollerInitFailure: Specified Publisher IDoc
Directory is invalid. (Le répertoire IDoc Éditeur spécifié est incorrect.)</description>
*** NDS Trace Utility - END Logging *** Fri Sep 13 15:46:31 2002
Cette erreur se produit parce que le service du système d’exploitation Windows contrôle les droits du système local, pas les droits d’un utilisateur. Ainsi, le système Windows local ne dispose pas des droits d’accès aux ressources d’un fichier en dehors de son propre système, y compris le répertoire IDoc.
Le pilote configuré comme « Canal Éditeur seulement » essaie toujours de se connecter au système SAP.
Le pilote est conçu pour utiliser une connexion à SAP même lorsqu’il est configuré comme pilote en « Canal Éditeur seulement ». Une partie de l’interface du canal Éditeur a la capacité de répondre aux requêtes <query> provenant du moteur DirXML. Ces requêtes peuvent être générées par le moteur lui-même (en convertissant un événement <modify> en un événement<add>) ou par une règle. Si les paramètres de connexion SAP existent, le pilote tente de lire les attributs sur le système
SAP afin de répondre à ces requêtes. Le pilote utilise toujours les données dans un fichier IDoc publié comme source principale pour répondre à ces requêtes. Mais si les attributs du filtre Éditeur n’existent pas dans le fichier IDoc, les données obtenues suite aux opérations de lecture sont utilisées à la place des données manquantes.
Cette connexion vérifie également la validité des tampons horaires des infotypes souhaités pendant le traitement des fichiers d’événement IDocs postdatés. C’est une fonction extrêmement importante qui devrait toujours être activée si des options de traitement postdaté sont choisies dans la configuration du pilote. Sa désactivation pourrait entraîner la propagation d’événements anciens ou obsolètes qui ont été remplacés par la suite.
Si vous n’avez pas de connexion au serveur SAP, configurez le pilote et supprimez l’ID d’authentification, le contexte d’authentification et le mot de passe de l’application (si vous utilisez une connexion du chargeur distant, re-saisissez le mot de passe du chargeur distant lorsque vous procédez à ces modifications). Dans ce cas, les données du fichier IDoc traitées sont utilisées comme source experte de données fiables à 100 %.
Dépannage du pilote
53
Novell Confidential Manual (FRA) 28 October 2003
54
Guide d’implémentation du pilote DirXML pour SAP HR
Novell Confidential Manual (FRA) 28 October 2003
A
Exemple de document XML reçu du pilote
L’exemple suivant représente un document XML typique qui a fait l’objet d’une analyse à partir de HRMD_A numéro O_200_0000000000008134.
<nds dtdversion="1.0" ndsversion="8.5">
<source>
<product build="20020916_0956" instance="SAP-HR" version "1.0a">DirXML
Pilote pour SAP/HR</product>
<contact>Novell, Inc.</contact>
</source>
<input xmlns:sapshim="http://www.novell.com/dirxml/drivers/SAPShim">
<modify class-name="P" event-id="O_200_0000000000008134" src-
dn="00000049" timestamp="20011204-99991231">
<association>00000049</association>
<modify-attr attr-name="P0001:STELL:none:141:8">
<remove-all-values/>
<add-value>
<value timestamp="20011018-99991231">50000055</value>
</add-value>
</modify-attr>
<modify-attr attr-name="P0000:STAT2:none:79:1">
<remove-all-values/>
<add-value>
<value timestamp="20011018-99991231">3</value>
</add-value>
</modify-attr>
<modify-attr attr-name="P0002:NACHN:none:84:25">
<remove-all-values/>
<add-value>
<value timestamp="19960421-99991231">Jones</value>
</add-value>
</modify-attr>
<modify-attr attr-name="P0002:VORNA:none:134:25">
<remove-all-values/>
<add-value>
<value timestamp="19960421-99991231">Paul</value>
</add-value>
</modify-attr>
<modify-attr attr-name="P0006:STRAS:1:103:30">
<remove-all-values/>
<add-value>
<value timestamp="20010101-99991231">123 Main Street</value>
</add-value>
</modify-attr>
</modify>
</input>
</nds>
Exemple de document XML reçu du pilote
55
Novell Confidential Manual (FRA) 28 October 2003
Quelques caractéristiques à noter :
Tous les documents XML reçus du système SAP HR sont convertis en documents <modify>.
Cette conversion se produit parce qu’il est impossible de déterminer si l’objet décrit par le document a été modifié ou est nouveau. Toute autre modification ou conversion du document est effectuée par l’intermédiaire de règles et du moteur DirXML
®
.
L’élément <modify> contient le nom de classe de l’objet décrit (c’est-à-dire que P=Personne).
L’attribut event-id contient le numéro du fichier IDoc duquel les données sont dérivées.
L’attribut src-dn contient la valeur de l’ID d’objet SAP. L’attribut timestamp contient la date
à laquelle le pilote a traité le fichier IDoc.
Les données de l’élément <association> contiennent toujours l’ID d’objet SAP.
L’élément <modify-attr> contient le nom d’attribut (attr-name) décrit au format SAP
(Segment:Attribute Name:SubType:Value Offset:Value Length).
Les attributs à valeurs multiples ne peuvent être assignés de manière cohérente dans les systèmes, l’élément <remove-all-values> est utilisé avant toutes les balises <add-value>.
Cela indique au moteur DirXML qu’il faut supprimer toutes les valeurs existantes de l’attribut avant d’assigner la nouvelle valeur. Si cette fonction n’est pas souhaitée, il est possible d’utiliser l’une des règles XSLT pour modifier le document.
L’élément <value> contient un attribut timestamp qui indique le tampon horaire BEGIN
VALIDITY-END VALIDITY du segment de données de l’attribut (c’est-à-dire que le tampon horaire défini pour les données du segment P001 est 20011018-99991231). Cela signifie que les données sont devenues valides le 18 octobre 2001 et le restent jusqu’à la date maximale de SAP. Tous les segments de données peuvent avoir des tampons horaires de validité différents ou postdatés.
Toutes les valeurs sont au format chaîne.
56
Guide d’implémentation du pilote DirXML pour SAP HR
Download
Public link updated
The public link to your chat has been updated. You may view and manage your chat links after registration here.
