Utilisation de l’outil de test de SAP Java Connector. Novell pour SAP HR

PDF

Dokument

Novell Confidential Manual (FRA) 28 October 2003

Édition de SAPRFC.INI et de LOGON.TXT

Suivez les instructions du fichier readme.txt afin de configurer ces fichiers pour une utilisation sur votre système SAP.

Utilisation de l’outil de test de SAP Java Connector

Le pilote utilise les technologies SAP Java Connector (JCO) et BAPI (Business Application

Programming Interface) pour se connecter et intégrer les données à eDirectory. SAP JCO est un client SAP qui crée des connexions de service à un système SAP R/3. Une fois le pilote connecté au système R/3, il appelle des méthodes sur les objets de gestion du système R/3 via l’interface BAPI.

Cet utilitaire vous permet de vérifier l’installation et la configuration de JCO avant de configurer le pilote. Cet utilitaire sert à valider l’installation et la connectivité avec le client SAP JCO, ainsi qu’à tester l’accessibilité des interfaces BAPI HR utilisées par le pilote.

Pour configurer le pilote, vous devez au préalable télécharger SAP JCO et l’installer. Pour des instructions d’installation, reportez-vous à la documentation qui accompagne SAP JCO.

Il peut y avoir des modifications mineures des composants JCO lorsque le connecteur est mis

à jour par SAP. Reportez-vous toujours à la documentation d’installation de SAP pour avoir les instructions de configuration correctes.

Fonctions de l’utilitaire

L’utilitaire de test SAP JCO procède aux vérifications suivantes :

Il vérifie que le fichier jco.jar, qui contient l’interface JCO exportée, est présent.

Il vérifie que les bibliothèques de prise en charge natives JCO sont correctement installées.

Il s’assure que les paramètres de connexion au système cible SAP R/3 sont corrects.

Il s’assure que les paramètres d’authentification auprès du système cible SAP R/3 sont corrects.

Il vérifie que le code de langue sélectionné est valide.

Il vérifie que les interfaces BAPI utilisées par le pilote DirXML sont présentes selon la version du système cible SAP R/3.

Conditions préalables à l’exécution de l’utilitaire

Avant d’exécuter l’utilitaire de test JCO, vous devez installer le client SAP JCO correspondant à la plate-forme voulue. Le JCO ne peut être obtenu qu’à partir du site Web SAP Service Marketplace

(http://www.sap-ag.de/services) . Le téléchargement est gratuit pour les clients ou les partenaires

SAP, mais vous devez vous loguer.

Suivez les instructions d’installation pour votre plate-forme. Chaque installation exige de définir une ou deux variables d’environnement, comme CLASSPATH, pour désigner l’emplacement du fichier jco.jar. Pour les plates-formes UNIX, définissez la variable LD_LIBRARY_PATH ou

LIBPATH comme emplacement des bibliothèques de prise en charge natives. Vérifiez que ces variables sont définies dans l’environnement du shell pour exécuter ce test et pour utiliser par la suite le pilote DirXML pour SAP HR.

Configuration du système SAP

Novell Confidential Manual (FRA) 28 October 2003

Vous devez également vérifier que votre variable d’environnement PATH est définie de façon à inclure le chemin d’accès à votre fichier exécutable Java. Pour les plates-formes Win32, les variables d’environnement sont définies par l’intermédiaire de l’option Système du Panneau de configuration. Sur les systèmes UNIX, modifiez le fichier .profile ou .bash_profile approprié pour inclure et exporter ces variables de chemin d’accès.

Composants

L’utilitaire de test JCO comprend un fichier JCOTest.class. Vous devez créer un fichier de commandes ou de script pour exécuter le test. Le format du fichier de commandes ou script varie selon la plate-forme sur laquelle le client JCO est installé.

Le contenu de base du fichier comprend un chemin d’accès au fichier exécutable Java (ou simplement java si votre variable PATH est configurée de façon appropriée), ainsi que le nom du fichier JCOTest.class. Un exemple de fichier script UNIX et de fichier de commandes Win32 figure ci-dessous ; dans cet exemple, jCO.jar se trouve dans le répertoire exécutable du fichier

JCOTest.class et du fichier de commandes :

Win32 jcotest.bat file java -classpath $CLASSPATH;. JCOTest

Unix jcotest file java JCOTest

Vous devez désigner les noms de chemins d’accès à l’aide de la notation à barres obliques adéquate et utiliser le délimiteur de chemin de classe approprié à la plate-forme. N’oubliez pas non plus que, sur les plates-formes UNIX, la distinction majuscules/minuscules s’applique pour le nom des fichiers jCO.jar ou sapjco.jar et que le nom de la classe de test, JCOTest, doit être indiqué dans la casse appropriée sur toutes les plates-formes.

Exécution et évaluation du test

Exécution du test

Pour exécuter l’utilitaire de test JCO sur une plate-forme Win32 :

Dans l’Explorateur Windows, double-cliquez sur votre fichier .bat.

Exécutez votre script .bat à partir de l’invite de commande.

Pour exécuter l’utilitaire de test JCO sur une plate-forme UNIX :

À partir de votre shell préféré, exécutez votre fichier script jcotest.

Remarque :

à l’exécution du programme de test, un message d’erreur apparaîtra peut-être avant l’affichage des résultats du test. Cela dénote une installation incorrecte des composants du client JCO. Les messages d’erreur pour chaque plate-forme sont expliqués dans

« Présentation des messages d’erreur du test », page 36 .

Évaluation du test

Si le client JCO est installé correctement, le texte suivant est affiché en sortie :

**The SAP JCO client installation has been verified to be correct.

Version of the JCO-library: version information

Input SAP Server Connection Information

----------------------------------------

Guide d’implémentation du pilote DirXML pour SAP HR

Novell Confidential Manual (FRA) 28 October 2003

Vous êtes alors invité à fournir des informations pour les procédures de connexion et d’authentification. Toutes les données doivent être fournies, sauf si une valeur par défaut, identifiée par les délimiteurs [], est indiquée. Si vous omettez d’indiquer une valeur en réponse à une invite, le test est interrompu. Indiquez les informations suivantes lorsque vous y êtes invité :

Nom ou adresse IP du serveur d’application

Numéro du système[00]

Numéro de client

Utilisateur

Mot de passe

Code de langue [EN]

Les valeurs que vous fournissez sont les mêmes que celles qui pourraient servir à une authentification via le client SAPGUI. En fonction de la validité des données entrées, le test soit affiche des messages d’erreur accompagnés des solutions suggérées, soit se déroule jusqu’à ce qu’il soit terminé. À la fin du test, un message d’état est affiché. Si le test révèle que les fonctions requises par le pilote DirXML sont complètes, le message d’état suivant apparaît (il décrit les valeurs valides utilisables comme paramètres de configuration pour le pilote DirXML pour SAP HR) :

**All expected platform support is verified correct.

JCO Test Summary

----------------

Full JCO/BAPI Functionality has been verified.

The following parameters may be used for SAP HR Driver Configuration

Authentication ID: Username

Authentication Context: SAP Host Name/IP Address

Application Password: User password

Publisher Channel Only? 1

SAP System Number: System Number

SAP User Client Number: Client Number

SAP User Language: Language Code

Master HR IDoc: Default IDoc type for SAP R/3 version

Si le test indique que les fonctions requises par le pilote DirXML ne sont pas disponibles, le message d’état suivant est affiché :

**There are <number> required BAPI functions NOT supported on this platform.

JCO Test Summary

----------------

JCO/BAPI functionality issues have been detected that will prevent proper SAP

HR Driver functionality.

Procédures post-test

Une fois tous les tests de l’utilitaire de test JCO réussis, il est possible de configurer le pilote

DirXML pour SAP HR en vue de son exécution. Vérifiez que le fichier jco.jar est copié à l’emplacement dans lequel le fichier sapshim.jar a été installé.

Sur les systèmes UNIX, vérifiez que les variables d’environnement utilisées pour mener à bien le test JCO se trouvent également dans l’environnement du pilote. Si ces conditions sont remplies, le pilote ne devrait comporter aucune erreur liée à JCO.

Configuration du système SAP

Novell Confidential Manual (FRA) 28 October 2003

Présentation des messages d’erreur du test

Les informations de cette section permettent d’analyser les messages d’erreur qui pourraient s’afficher au cours du test JCO. Certaines erreurs s’appliquent à toutes les plates-formes, tandis que d’autres dépendent d’une plate-forme particulière.

Le test a été exécuté sur les plates-formes citées ci-dessous. Les autres plates-formes UNIX prises en charge par JCO sont configurées de la même manière et les erreurs générées par une installation et une configuration incorrectes de JCO doivent être les mêmes que les erreurs décrites pour

IBM*-AIX* et Solaris*.

« Erreurs générales », page 36

« Erreurs sur les systèmes Win32 », page 36

« Erreurs sur les systèmes IBM-AIX », page 37

« Erreurs sur les systèmes Solaris », page 38

« Erreurs sur les systèmes Linux », page 38

Erreurs générales

Message d’erreur Problème

Error connecting to SAP host: (Erreur de connexion à l’hôte SAP) com.sap.mw.jco.JCO$Exception: (102)

Ce message indique que la ou les valeurs entrées pour le nom du serveur d’application ou l’adresse IP et le numéro du système sont incorrectes.

RFC_ERROR_COMMUNICATION: Connect to SAP gateway failed

Check values of Application Server Name/IP Address and System

Number (Échec de la connexion à la passerelle SAP. Vérifiez le nom/l’adresse IP et le numéro de système du serveur d’application)

Vérifiez que ces valeurs correspondent aux informations qui figurent dans la page Properties (Propriétés) de la boîte de dialogue de login SAP utilisée pour la connexion au système SAP R/3.

Error authenticating to SAP host: (Erreur d’authentification auprès de l’hôte SAP) com.sap.mw.jco.JCO$Exception: (103)

La référence d’authentification n’est pas valide. Vérifiez que les valeurs indiquées dans les champs Numéro de client, Utilisateur et Mot de passe sont correctes.

RFC_ERROR_LOGON_FAILURE: You are not authorized to logon to the target system (error code 1) (Vous n’êtes pas autorisé à vous loguer au système cible (code d’erreur 1)).

Error connecting to SAP host: (Erreur de connexion à l’hôte SAP) com.sap.mw.jco.JCO$Exception: (101)

RFC_ERROR_PROGRAM: Language '<value>' not availableCheck value of Language Code (La langue <value> n’est pas disponible. Vérifiez la valeur du code de langue)

Le code de langue sélectionné n’est pas valide ou n’est pas installé sur le système SAP R/3.

Erreurs sur les systèmes Win32

Message d’erreur Problème

'jcotest' is not recognized as an internal or external command, operable program, or batch file ('jcotest' n’est pas reconnu comme commande interne ou externe, programme exécutable ou fichier de commandes).

Le fichier de commandes jcotest.bat est absent.

Guide d’implémentation du pilote DirXML pour SAP HR

Novell Confidential Manual (FRA) 28 October 2003

Message d’erreur Problème

Exception in thread "main" (Exception dans le thread "main") java.lang.NoClassDefFoundError: com/sap/mw/jco/

JCO$AbapExceptionor Exception in thread "main" (ou Exception dans le thread "main") java.lang.NoClassDefFoundError: com/sap/ mw/jco/JCO$Exception

Le fichier jco.jar n’est pas à l’emplacement indiqué dans le fichier de commandes jcotest.bat.

Exception while initializing JCO client. (Exception lors de l’initialisation du client JCO) java.lang.UnsatisfiedLinkError: no jRFC12 in java.library.path (jRFC12 introuvable dans java.library.path) Verify proper installation of JCO Native support libraries packaged with JCO client (Vérifiez l’installation des bibliothèques JCO fournies avec le client JCO).

Le fichier jRFC12.dll livré avec le client JCO n’est pas installé ou est installé à un emplacement incorrect.

L’emplacement par défaut de jRFC12.dll et de libRfc32.dll est /WINNT/system32.

Exception while initializing JCO client. (Exception lors de l’initialisation du client JCO) java.lang.UnsatisfiedLinkError:

C:\WINNT\system32\jrfc12.dll: Can't find dependent libraries

(Bibliothèques dépendantes introuvables) Verify proper installation of JCO Native support libraries packaged with JCO client (Vérifiez l’installation des bibliothèques de prise en charge natives JCO fournies avec le client JCO).

Le fichier librfc32.dll livré avec le client JCO n’est pas installé ou est installé à un emplacement incorrect.

L’emplacement par défaut de jRFC12.dll et de libRfc32.dll est /WINNT/system32.

Erreurs sur les systèmes IBM-AIX

Message d’erreur

ksh: jcotest: not found (introuvable).

Problème

Le fichier de script jcotest est introuvable dans ce répertoire.

Exception in thread "main" (Exception dans le thread "main") java.lang.NoClassDefFoundError: com/sap/mw/jco/

JCO$AbapExceptionorException in thread "main" (ou Exception dans le thread "main") java.lang.NoClassDefFoundError: com/sap/ mw/jco/JCO$Exception

Le fichier jco.jar ne se trouve pas à l’emplacement spécifié dans le fichier de script jcotest ou la casse utilisée pour spécifier jco.jar ne correspond pas au nom réel du fichier.

Exception while initializing JCO client. (Exception lors de l’initialisation du client JCO) java.lang.UnsatisfiedLinkError: no jRFC12 (libjRFC12.a or .so) in java.library.path (jRFC12

(libjRFC12.a ou .so) introuvable dans java.library.path) Verify proper installation of JCO Native support libraries packaged with

JCO client (Vérifiez l’installation des bibliothèques de prise en charge natives JCO fournies avec le client JCO).

Le fichier libjRFC12.so livré avec le client JCO n’est pas installé ou est installé à un emplacement incorrect. Vous devez configurer une variable d’environnement LIBPATH pour indiquer l’emplacement auquel réside le fichier.

Exception while initializing JCO client. (Exception lors de l’initialisation du client JCO) java.lang.UnsatisfiedLinkError: <path>/ libjRFC12.so : A file or directory in the path name does not exist (Un fichier ou répertoire du nom du chemin d’accès n’existe pas). Verify proper installation of JCO Native support libraries packaged with

JCO client (Vérifiez l’installation des bibliothèques fournies avec le client JCO).

Le fichier librfccm.o livré avec le client JCO n’est pas installé ou est installé à un emplacement incorrect. Vous devez copier ce fichier au même emplacement que libjRFC12.so ou configurer la variable d’environnement

LIBPATH de façon à indiquer l’emplacement auquel réside le fichier.

Configuration du système SAP

Novell Confidential Manual (FRA) 28 October 2003

Erreurs sur les systèmes Solaris

Message d’erreur Problème

ksh: jcotest: not found (introuvable). orbash: jcotest: command not found (commande introuvable)

Le fichier de script jcotest est introuvable dans ce répertoire.

Exception in thread "main" (Exception dans le thread "main") java.lang.NoClassDefFoundError: com/sap/mw/jco/

JCO$AbapExceptionorException in thread "main" (ou Exception dans le thread "main") java.lang.NoClassDefFoundError: com/sap/ mw/jco/JCO$Exception

Le fichier jco.jar ne se trouve pas à l’emplacement spécifié dans le fichier de script jcotest ou la casse utilisée pour spécifier jco.jar ne correspond pas au nom réel du fichier.

Exception while initializing JCO client (Exception lors de l’initialisation du client JCO) java.lang.UnsatisfiedLinkError: no jRFC12 in java.library.path (jRFC12 introuvable dans java.library.path) Verify proper installation of JCO Native support libraries packaged with JCO client (Vérifiez l’installation des bibliothèques JCO fournies avec le client JCO).

Le fichier libjRFC12.so livré avec le client JCO n’est pas installé ou est installé à un emplacement incorrect. Vous devez configurer une variable d’environnement

LD_LIBRARY_PATH pour indiquer l’emplacement sur lequel réside le fichier.

Exception while initializing JCO client (Exception lors de l’initialisation du client JCO) java.lang.UnsatisfiedLinkError:

<path>/libjRFC12.so: ld.so.1: <search-path>: fatal: librfccm.so: open failed: (échec de l’ouverture :) No such file or directory

(Fichier ou répertoire introuvable) Verify proper installation of JCO

Native support libraries packaged with JCO client (Vérifiez l’installation des bibliothèques JCO fournies avec le client JCO).

Le fichier librfccm.so livré avec le client JCO n’est pas installé ou est installé à un emplacement incorrect. Vous devez copier le fichier dans le même emplacement que libjRFC12.so ou configurer la variable d’environnement

LD_LIBRARY_PATH de façon à spécifier l’emplacement du fichier.

Erreurs sur les systèmes Linux

Message d’erreur

ksh: jcotest: not found (introuvable). orbash: jcotest: command not found (commande introuvable)

Problème

Le fichier de script jcotest est introuvable dans ce répertoire.

Exception in thread "main" (Exception dans le thread "main") java.lang.NoClassDefFoundError: com/sap/mw/jco/

JCO$AbapExceptionorException in thread "main" (ou Exception dans le thread "main") java.lang.NoClassDefFoundError: com/sap/ mw/jco/JCO$Exception

Le fichier jco.jar ne se trouve pas à l’emplacement spécifié dans le fichier de script jcotest ou la casse utilisée pour spécifier jco.jar ne correspond pas au nom réel du fichier.

Exception while initializing JCO client (Exception lors de l’initialisation du client JCO). java.lang.ExceptionInInitializerError:

JCO.classInitialize(): Could not load middleware layer (Impossible de charger la couche intermédiaire) com.sap.mw.jco.rfc.MiddlewareRFCno jRFC12 in java.library.pathVerify proper installation of JCO Native support libraries packaged with JCO client (Vérifiez l’installation des bibliothèques de prise en charge natives JCO fournies avec le client

JCO).

Le fichier libjRFC12.so livré avec le client JCO n’est pas installé ou est installé à un emplacement incorrect. Vous devez configurer une variable d’environnement

LD_LIBRARY_PATH pour indiquer l’emplacement sur lequel réside le fichier.

Exception while initializing JCO client (Exception lors de l’initialisation du client JCO). java.lang.ExceptionInInitializerError:

JCO.classInitialize(): Could not load middleware layer (Impossible de charger la couche intermédiaire)

'com.sap.mw.jco.rfc.MiddlewareRFC<path>/libjRFC12.so: librfccm.so: cannot open shared object file (impossible d’ouvrir le fichier d’objet partagé): No such file or directory (Fichier ou répertoire introuvable) Verify proper installation of JCO Native support libraries packaged with JCO client (Vérifiez l’installation des bibliothèques JCO fournies avec le client JCO).

LD_LIBRARY_PATH de façon à spécifier l’emplacement du fichier.

Guide d’implémentation du pilote DirXML pour SAP HR