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.
Si le pilote ne se charge pas, vérifiez la présence des messages d'erreur suivants dans DSTrace :
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.
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.
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.
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 plate-forme appropriée.
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.
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.
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® eDirectoryTM si vous utilisez une configuration locale ou le chargeur distant si vous utilisez une configuration distante.
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.
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.
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.
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.
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.
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.
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éé.
Vérifiez que les paramètres du pilote contiennent le numéro de client et le répertoire IDoc appropriés.
Commencez par tester l'interface ALE et IDoc. Pour plus d'informations, reportez-vous à votre documentation SAP.
Si l'interface IDoc échoue :
Si l'interface IDoc réussit :
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.
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.
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 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 %.