62
Novell www.novell.com Novell Confidential Manual (FRA) 28 October 2003 Pilote DirXML ® pour SAP* User 1.0.2 30 avril 2004 GUIDE D’IMPLÉMENTATION

Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Embed Size (px)

Citation preview

Page 1: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell

m

Novell Confidential Manual (FRA) 28 October 2003

w w w . n o v e l l . c o

Pilote DirXML® pour SAP* User

1 . 0 . 2

3 0 a v r i l 2 0 0 4G

U ID E D ’ I MP L É M E NT A T IO N
Page 2: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Mentions légalesNovell exclut toute garantie relative au contenu ou à l’utilisation de cette documentation. En particulier, Novell ne garantit pas que cette documentation est exhaustive ni exempte d’erreurs. Novell se réserve en outre le droit de réviser cette publication à tout moment et sans préavis.

Par ailleurs, Novell exclut toute garantie relative à tout logiciel, notamment toute garantie, expresse ou implicite, que le logiciel présenterait des qualités spécifiques ou qu’il conviendrait à un usage particulier. Novell se réserve en outre le droit de modifier à tout moment tout ou partie des logiciels Novell, sans notification préalable de ces modifications à quiconque.

L’exportation ou la réexportation de ce produit est interdite dès lors qu’elle enfreint les lois et réglementations applicables, y compris, de façon non limitative, les réglementations des États-Unis en matière d’exportation ou la législation en vigueur dans votre pays de résidence.

Copyright © 2000-2004 Novell, Inc. Tous droits réservés. Cette publication ne peut être reproduite, photocopiée, stockée sur un système de recherche documentaire ou transmise, même en partie, sans le consentement écrit explicite préalable de l’éditeur.

Brevets en cours d’homologation.

Novell, Inc.1800 South Novell PlaceProvo, UT 84606États-Unis

www.novell.com

Guide d’implémentation du pilote DirXML pour SAP User30 avril 2004

Documentation en ligne : pour accéder à la documentation en ligne de ce produit (et d’autres produits Novell) et obtenir les mises à jour, consultez le site www.novell.com/documentation.

Page 3: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Marques commerciales de NovelleDirectory est une marque de Novell, Inc.DirXML est une marque déposée de Novell, Inc. aux États-Unis et dans d’autres pays.NetWare est une marque déposée de Novell, Inc. aux États-Unis et dans d’autres pays.Novell est une marque déposée de Novell, Inc. aux États-Unis et dans d’autres pays.Novell Directory Services est une marque déposée de Novell, Inc. aux États-Unis et dans d’autres pays.Nsure est une marque de Novell, Inc.

Autres marques commercialesToutes les marques commerciales de fabricants tiers appartiennent à leur propriétaire respectif.

Page 4: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Page 5: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Sommaire

À propos de ce guide 7

1 Présentation du pilote DirXML pour SAP User 9Présentation des concepts de pilote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Canal Éditeur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Canal Abonné . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Assignation d’attributs de la base de données de gestion SAP User à eDirectory . . . . . . . . . . . . . . . . . . 12Associations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Présentation des composants du pilote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Configurations de pilote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Module d’interface pilote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Utilitaire de test de SAP User Java Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Nouvelles fonctionnalités . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

2 Installation du pilote 15Conditions préalables concernant le pilote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Planification de l’installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Installation du pilote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Informations de configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Importation de la configuration du pilote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Extension du schéma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Activation du pilote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

3 Présentation des technologies ALE 21Technologie ALE (Application Link Enabling - Activation de liens d’application) . . . . . . . . . . . . . . . . . . . . . 21

Clients et systèmes logiques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Type de message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Type IDoc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Modèle de distribution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Profils de partenaires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Définition de port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Port de fichier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Port TRFC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23CUA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

4 Configuration du système SAP 25Configuration du système SAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Définition des systèmes d’envoi et de réception . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Création d’un modèle de distribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Création d’une définition de port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Profils de partenaires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Activation de CUA (Central User Administration) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Définition des paramètres de distribution de champ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30Création d’un utilisateur de communication (CPIC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Sommaire 5

Page 6: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

5 Utilisation de l’outil de test de SAP Java Connector 31À propos de l’utilitaire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Conditions préalables à l’exécution de l’utilitaire. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Composants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Exécution et évaluation du test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Présentation des messages d’erreur du test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

6 Présentation de la configuration par défaut du pilote 39Utilisation des règles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Modification des règles et des filtres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Obtention des données d’adresse de société pour des objets Utilisateur. . . . . . . . . . . . . . . . . . . . . . . . . 45

7 Dépannage du pilote 47Utilisation de l’outil DSTrace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Erreurs de chargement du pilote. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47Erreurs d’initialisation du pilote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48Aucun fichier IDoc ni document IDoc TRFC n’est généré lors de la création ou de la modification

d’un objet SAP User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Les utilisateurs créés dans SAP ne peuvent pas se loguer au système SAP (CUA en cours d’utilisation) . . . . . . 49Le pilote ne reconnaît pas les fichiers IDoc dans le répertoire . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50Les fichiers IDoc ne sont pas écrits sur le pilote (configuration de port TRFC) . . . . . . . . . . . . . . . . . . . . 50Le pilote ne parvient pas à s’authentifier auprès de SAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50Erreurs d’installation et de configuration de JCO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50Erreur lors de l’assignation d’unités au répertoire IDoc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

A Exemple de document XML reçu du pilote 53

B Notes de configuration et de déploiement 55Types d’objet SAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Types d’utilisateur : LOGONDATA:USTYP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Options du contrôleur de sorties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Types de communication : ADDCOMREM:COMM TYPE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56Formats de date : DEFAULTS:DATAFM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56Formats de décimales : DEFAULTS:DCPFM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56Tests assistés par ordinateur (CATT, Computer Aided Test) : DEFAULTS:CATTKENNZ . . . . . . . . . . . . . . . . 56Type de commentaire de communication pour les assignations de table . . . . . . . . . . . . . . . . . . . . . . . . . 57Codes de langue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Paramètres de configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58Commentaires et notes de conception . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

6 Guide d’implémentation du pilote DirXML pour SAP User

Page 7: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

À propos de ce guide

Ce guide s’adresse aux administrateurs de Novell® Nsure Identity Manager, aux développeurs et aux administrateurs SAP, et à toutes les personnes qui implémentent le pilote DirXML 1.0 pour la gestion des utilisateurs du logiciel SAP.

Ce guide contient les sections suivantes :

Chapitre 1, « Présentation du pilote DirXML pour SAP User », page 9

Chapitre 2, « Installation du pilote », page 15

Chapitre 3, « Présentation des technologies ALE », page 21

Chapitre 4, « Configuration du système SAP », page 25

Chapitre 5, « Utilisation de l’outil de test de SAP Java Connector », page 31

Chapitre 6, « Présentation de la configuration par défaut du pilote », page 39

Chapitre 7, « Dépannage du pilote », page 47

Mises à jour de la documentation

Pour obtenir la version la plus récente du Guide d’implémentation du pilote DirXML pour SAP User, reportez-vous au site Web de documentation sur les pilotes NsureTM (http://www.novell.com/documentation/french/dirxmldrivers).

Conventions utilisées dans la documentation

Le terme pilote fait référence à tous les composants du pilote DirXML pour SAP User, et non à un composant spécifique.

Dans cette documentation, le symbole « supérieur à » (>) est parfois utilisé pour séparer deux opérations dans une étape de procédure ainsi que deux éléments dans un chemin de références croisées.

Le symbole de marque (®, TM, etc.) indique une marque de Novell. L’astérisque (*) indique une marque commerciale de fabricant tiers.

Commentaires de l’utilisateur

Vos commentaires et suggestions sur le présent guide et sur les autres documents qui accompagnent le pilote nous intéressent. Pour nous contacter, envoyez-nous un message électronique à l’adresse suivante : [email protected].

À propos de ce guide 7

Page 8: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

8 Guide d’implémentation du pilote DirXML pour SAP User

Page 9: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

1 Présentation du pilote DirXML pour SAP User

Le pilote DirXML® 1.0 pour la gestion des utilisateurs dans SAP, ci-après désigné « le pilote », crée une liaison automatique entre Novell® eDirectory® et les systèmes de gestion SAP User (BASIS ou Web Application Server). Cette technologie permet à une entreprise d’organiser le flux des données en fonction de ses besoins particuliers, tout en évitant la pratique fastidieuse et source d’erreur qui consiste à ressaisir les mêmes données dans plusieurs bases. À mesure que des enregistrements d’objets Utilisateur sont ajoutés, modifiés, désactivés ou supprimés dans SAP ou dans eDirectory, les tâches réseau associées à ces événements peuvent être traitées automatiquement.

Le pilote permet aux administrateurs de propager les données Utilisateur entre des systèmes SAP et d’autres applications et bases de données d’entreprise, sans recourir à des solutions d’intégration personnalisées. Les administrateurs peuvent décider quelles données seront partagées et comment elles seront présentées au sein de leurs entreprises respectives.

Cette section contient les informations suivantes :

« Présentation des concepts de pilote », page 9

« Présentation des composants du pilote », page 13

« Nouvelles fonctionnalités », page 14

Présentation des concepts de piloteLe pilote est un produit de synchronisation bidirectionnelle entre les systèmes SAP R/3 et Enterprise R/3 d’un côté et eDirectory de l’autre. Cet environnement utilise les langages XML et XSLT pour offrir des fonctionnalités de transformation qui convertissent les données et événements eDirectory en données SAP et vice versa.

eDirectory fonctionne comme un hub : les applications et annuaires lui envoient leurs modifications via le canal Éditeur, et eDirectory envoie des modifications aux applications et aux annuaires configurés pour les recevoir sur le canal Abonné. Deux flux principaux de données sont ainsi générés : l’un sur le canal Éditeur, l’autre sur le canal Abonné.

Canal ÉditeurLe système SAP envoie les informations relatives à l’objet Utilisateur sous la forme de fichiers IDoc USERCLONE sur le canal Éditeur à l’aide des technologies ALE (Application Link Enabling) et CUA (Central User Administration). Si nécessaire, et si la configuration le permet, le système SAP peut propager toutes les données d’événement d’ajout, de suppression, de verrouillage, de déverrouillage et de modification d’objets dans eDirectory Le pilote lit les données IDoc et les convertit au format XML. Pour plus d’informations sur la manière dont le pilote traite les fichiers IDoc, reportez-vous à « Lecture de fichiers IDoc par le pilote », page 11.

Présentation du pilote DirXML pour SAP User 9

Page 10: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Le canal Éditeur soumet ensuite les documents XML au moteur DirXML, qui les achemine à son tour vers eDirectory via le canal Éditeur. Grâce à eDirectory et à d’autres pilotes DirXML, il est possible de partager les données avec d’autres applications et annuaires d’entreprise. Ces autres applications peuvent ajouter des données, qui seront à leur tour retransmises vers les enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface).

Selon la configuration choisie pour le port ALE, le canal Éditeur interroge la base de données SAP et reçoit les modifications éventuelles via un port de fichier ou une connexion TRFC.

Le diagramme suivant illustre la configuration du port de fichier. L’ensemble du fichier IDoc est stocké sur le système hôte SAP avec la configuration du port de fichier.

Le diagramme suivant illustre la configuration du port TRFC. Dans le cas d’une configuration TRFC, un fichier IDoc « déclencheur » minimal est stocké sur le système hôte du pilote. Le pilote analyse les données IDoc et utilise ces informations pour lire l’objet Utilisateur actuel. Il analyse ensuite les champs de données spécifiés lors de sa configuration, puis assure un transport sécurisé des données vers eDirectory. Seuls les éléments de données spécialement sélectionnés par l’administrateur système sont transportés du système hôte SAP à eDirectory.

Canal Éditeur : Configuration de port FileAcheminement des données SAP vers d'autres applications

SAP Basis ou SAP WAS

CUA (Central User Administration)

HÔTE SAP

Le pilote ajoute ou met à jour les données dans eDirectory.

Doc XML

SAP est configuré pour acheminer vers un client externe via le port File.

Fichiers Idoc USERCLONE

C:/IDOCS/0_400_n

Connexion SSL

NovelleDirectory

Moteur DirXML Novell

Service du chargeur distant

HÔTE DirXML

Chargeur distant DirXML

Pilote DirXML

Le pilote est configuré pour rechercher dans le répertoire IDOC à certains intervalles des documents liés à un numéro de client précis.

Le pilote filtre et convertit les données significatives au format XML.

Les fichiers IDOC sont envoyés au système de fichiers hôte avec des références de numéros de client.

10 Guide d’implémentation du pilote DirXML pour SAP User

Page 11: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Lecture de fichiers IDoc par le pilote

Le pilote lit uniquement les fichiers IDoc sortants qui portent le numéro de client spécifié lors de sa configuration. La confidentialité des autres fichiers IDoc éventuellement générés par une autre configuration de pilote ou une autre intégration ALE est ainsi assurée. Seuls les attributs IDoc qui ont été définis dans le filtre Éditeur du pilote sont acheminés vers eDirectory via le canal Éditeur.

Le format d’un fichier IDoc correctement acheminé via le canal Éditeur est le suivant :

<(I)nput or (O)utput>_<client number>_<consecutive IDoc number>

Exemple :

O_300_0000000000001001

Une fois le fichier IDoc traité et les attributs indiqués acheminés via le canal Éditeur, le nom du fichier IDoc est modifié afin de refléter l’état des processus d’acheminement. Le tableau suivant énumère les états des fichiers IDoc et indique les extensions correspondantes :

Il convient de déterminer l’opération requise, le cas échéant, une fois le fichier IDoc acheminé via le canal Éditeur.

Remarque : La suppression de l’extension du nom de fichier rend le fichier IDoc disponible pour un nouveau traitement.

État d’IDoc Extension du nom de fichier

En cours de traitement mais non acheminé via le canal Éditeur

.proc

Traité et acheminé via le canal Éditeur .done

Traité avec une erreur ou un avertissement .fail ou .warn

Traité et conservé en vue d’un traitement ultérieur .futr

Traité avec des données altérées ou incorrectes .bad

Canal Éditeur : Configuration TRFCAcheminement des données SAP vers d'autres applications

SAP Basis ou SAP WAS

CUA (Central User Administration)

Le pilote ajoute ou met à jour les données dans eDirectory.

Chargeur distant DirXML

Pilote DirXML

Serveur TRFC

Doc XML

Connexion SSL

NovelleDirectory

Moteur DirXML Novell

Service du chargeur distant

HÔTE DirXML

SAP est configuré pour acheminer vers un client externe via le port TRFC.

Le pilote est configuré pour recevoir des fichiers IDocs via la passerelle SAP. Le pilote peut s'exécuter sur l'hôte SAP ou à distance.

Le pilote filtre et convertit les données significatives au format XML.

HÔTE SAP

Fichiers IDoc USERCLONE

Présentation du pilote DirXML pour SAP User 11

Page 12: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Canal AbonnéLe canal Abonné reçoit les événements eDirectory au format XML envoyés par le moteur DirXML. Le pilote convertit alors ces documents au format de données approprié puis met à jour SAP via l’interface BAPI. eDirectory n’envoie des modifications qu’aux applications configurées pour les recevoir via le canal Abonnés.

Pour transmettre des données d’eDirectory vers le système SAP, le pilote utilise les fonctions SAP BAPI. Le niveau de fonctionnalité dépend de la version de R/3. Par défaut, le pilote est configuré pour prendre en charge un système SAP 4.6C qui utilise des messages USERCLONE03. (Pour déterminer le niveau des messages USERCLONE disponibles sur votre système SAP, exécutez la transaction WE60 et spécifiez le nom d’objet USERCLONEnn.) En tant qu’administrateur SAP, vous pouvez sélectionner les attributs des infotypes qui peuvent être modifiés.

Assignation d’attributs de la base de données de gestion SAP User à eDirectoryL’assignation de schéma permet à Identity Manager de convertir les éléments de données qui circulent entre la base de données de gestion SAP User et eDirectory. Le schéma d’objet SAP User est fondé sur le type de message SAP USERCLONE. L’assignation de schéma contient tous les attributs des divers infotypes de données du type de message USERCLONE.

Plusieurs des infotypes USERCLONE peuvent être instanciés à plusieurs reprises dans les enregistrements Utilisateur. Les infotypes tels que ADDTEL (numéro de téléphone) et ACTIVITYGROUPS (rôles) correspondent à des champs de table et peuvent contenir plusieurs valeurs. D’autres infotypes, par exemple ADDRESS et LOGONDATA, sont des champs de structure, instanciés une seule fois, mais auxquels peuvent être associés plusieurs champs. Enfin, les autres champs sont des champs simples qui contiennent un seul élément de données.

L’administrateur du système eDirectory peut configurer le pilote pour recevoir tous ces champs de données et pour traiter les données de différentes manières. L’assignation de schéma représente les éléments de données qui peuvent être synchronisés dans le système SAP.

Le format des éléments d’assignation est le suivant :

<Segment Infotype Name>:<Infotype Field>// Table/Structure

ou

<Segment Infotype Name>:<Infotype Field>// Simple data

Canal AbonnéRemplissage de SAP avec des données provenant d'autres applications

SAP Basis ou SAP WAS

Chargeur distant DirXML

Pilote DirXMLDoc

BAPI

HÔTE SAP

Données qui proviennent d'autres applications et qui sont acheminées vers le pilote SAP via le canal Abonné.Doc

XML

Le pilote convertit les docs XML dans BAPI (l'API native de SAP) et ajoute, supprime ou modifie les données dans SAP. Le pilote peut s'exécuter sur l'hôte SAP ou à distance.

12 Guide d’implémentation du pilote DirXML pour SAP User

Page 13: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Voici quelques exemples d’assignations entre les attributs SAP User et eDirectory.

Le pilote peut synchroniser des données à plusieurs instances (par exemple, TELEPHONE), mais ne garantit pas la spécification d’une valeur principale. Il est également possible de ne spécifier que Table ou Structure dans une assignation de schéma. Cette capacité est utile si la structure contient un seul champ de données ou si vous souhaitez synchroniser tous les champs de données d’une table ou d’une structure vers eDirectory. Dans ces instances, le pilote délimite les valeurs des données de champ à l’aide d’un point-virgule (;).

AssociationsAu cours du processus de synchronisation, des associations se créent entre les objets SAP et eDirectory. Pour l’objet SAP User, un nom unique de 12 caractères (par client) doit être créé. Toutefois, eDirectory et les autres applications n’ont pas besoin de partager ce nom unique. Identity Manager permet d’appliquer les différentes règles d’assignation de nom aux objets d’une organisation en utilisant l’attribut DirXML-Association.

L’attribut DirXML-Association peut avoir plusieurs valeurs. Par conséquent, si Identity Manager est utilisé pour synchroniser un objet entre plusieurs applications, tous les ID (ou associations) uniques de l’objet peuvent être stockés dans cet attribut de l’objet eDirectory.

L’association d’ID unique lie des objets contenus dans SAP aux objets correspondants dans eDirectory. L’association s’effectue à chaque événement Ajouter ou Concordance. Cette association permet au pilote d’exécuter des tâches ultérieures sur l’objet approprié.

Le champ DirXML-Associations est stocké dans l’objet eDirectory, dans la page de propriétés DirXML.

Présentation des composants du piloteCette section contient des informations sur les composants de pilote suivants :

« Configurations de pilote », page 14

« Module d’interface pilote », page 14

« Utilitaire de test de SAP User Java Connector », page 14

Attribut eDirectory Attribut SAP User

Given Name ADDRESS:FIRSTNAME

Surname ADDRESS:LASTNAME

sapRoles ACTIVITYGROUPS:AGR_NAME

buildingName ADDRESS:BUILDING_P

floor ADDRESS:FLOOR_P

Internet EMail Address ADDSMTP:E_MAIL

OU ADDRESS:DEPARTMENT

Pager ADDPAG:PAGER

sapAlias ALIAS:USERALIAS

Présentation du pilote DirXML pour SAP User 13

Page 14: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Configurations de piloteAprès avoir installé NsureTM Identity Manager 2 et le pilote, vous créez un ou plusieurs objets Pilote. Chaque objet Pilote représente une instance du pilote DirXML pour SAP User. Grâce au fichier de configuration du pilote, vous êtes rapidement à pied d’œuvre avec un minimum d’opérations de personnalisation : en effet, vous pouvez créer un objet Pilote avec des règles, des filtres et des paramètres de pilote préconfigurés.

Le fichier de configuration du pilote s’appelle SAPUser.xml.

Module d’interface piloteLe module d’interface pilote, parfois appelé connecteur, gère les communications entre la base de données SAP User et le moteur DirXML.

Utilitaire de test de SAP User Java ConnectorPour pouvoir utiliser le pilote, vous devez télécharger l’utilitaire de test SAP JCO et l’installer. L’utilitaire de test SAP User Java* Connector (JCO) permet de déceler les éventuels problèmes d’installation et de configuration de JCO avant de configurer le pilote. Vous pouvez exécuter l’utilitaire de test JCO pour valider l’installation du client JCO et résoudre les problèmes de configuration avant de configurer le pilote.

Cet utilitaire permet de valider l’installation du client JCO et la connectivité avec le système hôte SAP, et de tester l’accessibilité des interfaces SAP User BAPI utilisées par le pilote. Pour plus d’informations, reportez-vous à Chapitre 5, « Utilisation de l’outil de test de SAP Java Connector », page 31.

Nouvelles fonctionnalitésPour de plus amples informations sur les nouvelles fonctionnalités d’Identity Manager 2, reportez-vous au Nsure Identity Manager 2 Administration Guide (Guide d’administration de Nsure Identity Manager 2) (http://www.novell.com/documentation/french/dirxml20/admin/data/alxnk27.html).

14 Guide d’implémentation du pilote DirXML pour SAP User

Page 15: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

2 Installation du pilote

Dans le cadre de l’installation et de la configuration du pilote, procédez aux opérations suivantes :

« Planification de l’installation », page 15

« Informations de configuration », page 16

« Installation du pilote », page 16

« Extension du schéma », page 19

« Activation du pilote », page 20

Ces tâches sont décrites plus en détail dans cette section. Après avoir installé le pilote, passez à la section Chapitre 3, « Présentation des technologies ALE », page 21 pour en savoir plus sur la configuration requise du système SAP.

Conditions préalables concernant le piloteLe pilote exige les conditions préalables suivantes. Veillez à vous conformer à ces critères avant d’installer le pilote.

Novell® NsureTM Identity Manager 2.

Le système hôte sur lequel s’exécute le module d’interface pilote doit utiliser la technologie client SAP Java Connector (JCO), version 1.1x ou 2.x installée pour assurer la connectivité avec le système SAP.

Ce client, gratuitement accessible aux clients SAP et développeurs partenaires par l’intermédiaire de SAP, est fourni pour la plupart des systèmes d’exploitation serveur. Vous pouvez télécharger le JCO sur le site SAP Connectors (Connecteurs SAP) (http://service.sap.com/connectors).

Remarque : le pilote pouvant être configuré pour utiliser une interface de chargeur distant avec les canaux Éditeur et Abonné, aucun critère ne stipule d’installer le pilote sur le système hôte SAP ou eDirectory.

JDK*/JRE version 1.3.1 ou ultérieure.

Module SAP Server version 4.5B ou ultérieure.

Le pilote fonctionne sur tous les systèmes hôte SAP R/3 ou Enterprise R/3.

Planification de l’installationAvant d’installer et d’utiliser le pilote, il convient de déterminer le type d’installation que vous souhaitez utiliser : locale ou distante.

Utilisation d’une installation locale

L’installation locale permet d’installer le pilote sur le même ordinateur hôte qu’Identity Manager.

Installation du pilote 15

Page 16: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Utilisation d’une installation distante

L’installation distante installe le pilote sur un autre ordinateur qu’Identity Manager et eDirectoryTM, ou l’exécute sur le même ordinateur mais dans un espace de traitement réservé. Les installations distantes peuvent avoir recours au codage SSL pour assurer la confidentialité des données entre le pilote et le moteur DirXML®. Cette configuration est préconisée dans tous les cas où il n’est pas possible ou pas souhaitable d’exécuter le pilote sur le même hôte qu’eDirectory et Identity Manager.

Installation du piloteVous installez le pilote avec le programme d’installation de Novell Nsure Identity Manager 2. Pour des instructions d’installation, reportez-vous au Novell Nsure Identity Manager 2 Administration Guide (Guide d’administration de Novell Nsure Identity Manager 2) (http://www.novell.com/documentation/french/dirxml20/index.html).

Cette section explique comment importer la configuration du pilote pour le pilote DirXML pour la gestion SAP User. Lorsque vous avez importé la configuration, vous pouvez utiliser iManager pour configurer et gérer le pilote.

Cette section contient les informations suivantes :

« Informations de configuration », page 16

« Importation de la configuration du pilote », page 19

« Activation du pilote », page 20

Informations de configurationLors de l’importation du fichier de configuration du pilote, vous êtes invité à fournir les informations suivantes.

Nom du paramètre Description

Nom du pilote Nom réel à utiliser pour le pilote.

Conteneur d’objets Utilisateur

Nom de l’objet Unité organisationnelle eDirectory dans lequel les utilisateurs provenant du système SAP sont placés.

Serveur d’applications SAP

Nom d’hôte ou adresse IP permettant de se connecter au serveur d’applications SAP approprié. Ce paramètre est appelé « Application Server » (Serveur d’applications) dans les propriétés de login de SAP.

ID utilisateur SAP Identificateur de l’utilisateur employé par ce pilote pour se loguer au système SAP. Ce paramètre est appelé « User » (Utilisateur) dans l’écran de login de SAP.

Mot de passe SAP User

Mot de passe utilisé par ce pilote pour se loguer au système SAP. Ce paramètre est appelé « Password » (Mot de passe) dans l’écran de login de SAP.

Type de port du canal Éditeur

Sélectionnez TRFC si le pilote doit instancier un serveur JCO pour recevoir des émissions de données distribuées par le système SAP ALE. Sélectionnez FILE si le pilote lit les fichiers IDoc au format texte distribués par le système SAP ALE. Toute autre valeur désactive la fonctionnalité du canal Éditeur.

Numéro de système SAP

Numéro du système SAP sur le serveur d’applications SAP. Ce paramètre est appelé « System Number » (Numéro de système) dans les propriétés de login de SAP.

16 Guide d’implémentation du pilote DirXML pour SAP User

Page 17: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Numéro de client SAP

Numéro de client à utiliser sur le serveur d’applications SAP. Ce paramètre est appelé « Client » dans l’écran de login de SAP.

Code de langue de la session SAP

Code de la langue utilisée par le pilote pour cette session SAP. Ce paramètre est appelé « Language » (Langue) dans l’écran de login de SAP.

Codage du jeu de caractères

Code du jeu de caractères utilisé pour convertir les données des chaînes d’octets IDoc au format Unicode*. Si la valeur indiquée est nulle, le pilote utilise les données JVM par défaut de l’hôte.

Publier toutes les valeurs des tables de communication

Indiquez 0 si seule la valeur principale des tables de communication doit être synchronisée. Indiquez 1 pour synchroniser toutes les valeurs.

Publier les données relatives à l’adresse de la société

Par défaut, un enregistrement utilisateur SAP ne contient pas d’informations relatives à l’adresse de la société Ces données sont conservées dans une table associée. Utilisez ce paramètre pour spécifier si vous voulez que le pilote récupère ces données dans l’enregistrement de la société approprié. Quelle que soit l’option spécifiée, les informations relatives à l’adresse de la société ne peuvent pas être mises à jour dans SAP.

Entrez 1 pour compléter les informations sur l’adresse de la société de l’utilisateur pour les requêtes du canal Éditeur et Abonné.

Entrez 0 pour ne pas utiliser cette fonctionnalité.

Demander à l’utilisateur de modifier les mots de passe définis

Deux méthodes permettent de configurer le canal Abonné pour définir un mot de passe utilisateur. Saisissez 1 si vous souhaitez que les mots de passe soient changés au prochain login des utilisateurs ou 0 pour désactiver cette fonction.

Commentaires de la table de communication

Le commentaire de table de communication est un texte que le pilote associe à toutes les entrées ajoutées par le canal Abonné à la table de communication. Cette méthode permet notamment de déterminer l’origine d’une entrée lorsque les valeurs sont affichées dans l’interface SAP. Si ce champ n’est pas renseigné, aucun commentaire n’est ajouté aux entrées de la table.

ID de passerelle SAP

Si le type de port sélectionné pour le canal Éditeur est TRFC, ce paramètre spécifie la passerelle qui distribue les données de l’utilisateur au pilote. Si vous n’utilisez pas TRFC, ce paramètre est ignoré.

ID de programme TRFC

Si le type de port sélectionné pour le canal Éditeur est TRFC, ce paramètre identifie le programme serveur JCO du pilote pour la passerelle SAP. Si vous n’utilisez pas TRFC, ce paramètre est ignoré. Notez que l’ID de programme est un identificateur texte sensible à la casse.

Répertoire des fichiers IDoc de l’Éditeur

Répertoire du système de fichiers dans lequel les fichiers IDoc SAP User sont placés par le système SAP ALE (configuration de port FILE) ou par le pilote (configuration TRFC).

Configurer le flux de données

Le flux de données peut être configuré avec l’une des options suivantes :

Bi-directionnel : SAP HR eDirectory sont des sources expertes des données synchronisées entre elles.

SAP vers eDirectory : SAP est la source experte.

eDirectory vers SAP : eDirectory est la source experte.

Installer le pilote comme Distant/Local

Configurez le pilote pour l’utiliser avec le service de chargeur distant en sélectionnant l’option Distant, ou choisissez Local pour configurer une utilisation locale. Si vous sélectionnez Local, vous pouvez ignorer les paramètres suivants.

Nom d’hôte et port distants

Spécifiez le nom d’hôte ou l’adresse IP et le numéro de port de l’emplacement sur lequel le service de chargeur distant a été installé et s’exécute pour ce pilote. Le port par défaut est 8090.

Nom du paramètre Description

Installation du pilote 17

Page 18: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Les paramètres de pilote supplémentaires ci-après sont configurés avec leur valeur par défaut lors de l’importation. Vous pouvez toutefois les modifier dans iManager, en cliquant sur l’onglet Configuration du pilote de l’objet Pilote.

Mot de passe du pilote

Ce mot de passe est utilisé par le chargeur distant pour s’authentifier auprès du serveur Identity Manager. Il doit être identique au mot de passe spécifié en tant que mot de passe de l’objet pilote sur le chargeur distant.

Mot de passe à distance

Le mot de passe du chargeur distant permet de contrôler l’accès à l’instance du chargeur distant. Il doit être identique au mot de passe du chargeur distant spécifié sur le chargeur distant Identity Manager.

Nom du paramètre Description

Intervalle d’interrogation (en secondes)

Spécifie la fréquence à laquelle le canal Éditeur recherche les fichiers IDocs non traités. La valeur par défaut est de 10 secondes.

Option de gestion des événements à venir

Le comportement de cette option dépend des valeurs de la date « Valid From » (Début de validité) de l’attribut Logon Data de l’enregistrement Utilisateur (LOGONDATA:GLTGV), lorsque les fichiers IDoc sont traités par le canal Éditeur. Il n’est pas indispensable de placer ce champ dans le filtre Éditeur pour que ce traitement s’effectue.

Ce paramètre peut prendre quatre valeurs :

0 - tous les attributs sont traités par le pilote lorsque le fichier IDoc est disponible. Aucun traitement ultérieur n’a lieu.

1 - le pilote traite uniquement les attributs datés du jour même ou d’une date antérieure lorsque que le fichier IDoc est disponible. Les attributs d’infotype portant une date ultérieure sont mis en cache dans un fichier « .futr » en vue d’un traitement ultérieur.

2 - le pilote fusionne les options 1 et 2. Tous les attributs sont traités et datés lorsque le fichier IDoc est disponible. Tous les attributs d’infotype portant une date ultérieure sont mis en cache dans un fichier « .futr » en vue d’un traitement ultérieur.

3 - le pilote traite tous les événements lorsque le fichier IDoc est disponible. Tous les attributs d’infotype portant une date ultérieure sont mis en cache dans un fichier « .futr » en vue d’un nouveau traitement le lendemain. Ce processus se poursuit jusqu’à ce que les attributs soient envoyés une dernière fois à la date ultérieure indiquée.

Si un port TRFC est configuré pour être utilisé par le canal Éditeur, cette option permet au pilote d’activer la fonctionnalité de suivi SAP JCO. Indiquez 0 pour désactiver cette fonction. Saisissez 1 pour l’activer. Les fichiers de trace sont générés dans le répertoire racine de DirXML ou du chargeur distant ; ils sont reconnaissables à leur extension « .trc ». La valeur par défaut est 0.

Générer fichiers de trace TRFC

Si un port TRFC est configuré pour être utilisé par le canal Éditeur, cette option permet au pilote d’activer la fonctionnalité de suivi SAP JCO. Indiquez 0 pour désactiver cette fonction. Saisissez 1 pour l’activer. Les fichiers de trace sont générés dans le répertoire racine de DirXML ou du chargeur distant ; ils sont reconnaissables à leur extension « .trc ». La valeur par défaut est 0.

Nom du paramètre Description

18 Guide d’implémentation du pilote DirXML pour SAP User

Page 19: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Importation de la configuration du piloteL’assistant de création de pilote vous aide à importer le fichier de configuration du pilote de base. Ce fichier crée et configure les objets et les règles nécessaires au bon fonctionnement du pilote.

Les instructions suivantes vous expliquent comment créer le pilote et importer la configuration du pilote.

1 Dans Novell iManager, cliquez sur Utilitaires DirXML > Créer un pilote.

2 Sélectionnez un ensemble de pilotes.

Si vous placez ce pilote dans un nouvel ensemble de pilotes, vous devez spécifier un nom d’ensemble de pilotes, un contexte et un serveur associé.

3 Sélectionnez l’option Importer une configuration de pilote du serveur, puis sélectionnez GroupWise.xml.

Les fichiers de configuration du pilote sont installés sur le serveur Web lorsque vous installez DirXML. Pendant l’importation, vous devez fournir les paramètres du pilote et d’autres informations. Pour plus de détails, reportez-vous à « Informations de configuration », page 16.

4 Spécifiez les paramètres du pilote, puis cliquez sur OK pour importer le pilote.

Lorsque l’importation est terminée, vous pouvez définir des équivalences de sécurité et exclure les rôles administratifs de la réplication.

L’objet Pilote doit posséder des droits eDirectory suffisants sur tout objet qu’il lit ou écrit. L’attribution de ces droits s’effectue en accordant l’équivalence de sécurité à l’objet Pilote. Le pilote doit avoir un accès en lecture/écriture sur les utilisateurs, les bureaux de poste, les ressources et les listes de distribution, ainsi que des droits Créer, Lire et Écrire sur le conteneur du bureau de poste. Il doit généralement disposer du même niveau de sécurité qu’Admin.

5 Passez en revue les objets Pilote dans l’écran Résumé, puis cliquez sur Terminer.

Extension du schémaPour utiliser la configuration par défaut, vous devez étendre le schéma eDirectory. Cette opération facilite l’administration des fonctions de gestion des utilisateurs des systèmes SAP R/3 et Enterprise R/3. Nous recommandons d’appliquer un ensemble d’extensions de schéma à l’arborescence eDirectory en vue de la synchronisation avec le système SAP.

Tandis que SAP développait ses propres utilitaires d’administration des utilisateurs reposant sur LDAP, un jeu standard d’extensions de schéma était mis au point pour être utilisé avec Novell eDirectory. Ces extensions se trouvent dans le fichier R3-Novell-Ldif-Schema-extension.ldif. Ce fichier doit être appliqué à eDirectory à l’aide de l’utilitaire Novell ICE (Import Conversion Export).

Outre le fichier d’extension de schéma au format LDIF, les extensions de schéma sont également disponibles dans le fichier sapuser.sch (fichier standard d’eDirectory).

Si vous souhaitez étendre le schéma à l’aide du fichier LDIF, les instructions suivantes vous aideront à exécuter l’utilitaire ICE. Pour plus d’informations, reportez-vous à la documentation de l’utilitaire Import Conversion Export (http://www.novell.com/documentation).

1 Ouvrez l’assistant d’importation/exportation NDS.

2 Sélectionnez Import LDIF File (Importer un fichier LDIF), puis cliquez sur Next (Suivant).

3 Recherchez le fichier R3-Novell-Ldif-Schema-extension.ldif, puis cliquez sur Next (Suivant).

Installation du pilote 19

Page 20: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

4 Fournissez les informations de connexion LDAP concernant le service Novell LDAP, puis cliquez sur Next (Suivant).

5 Cliquez sur Finish (Terminer) pour lancer le processus d’extension..

Activation du piloteL’activation doit être effectuée dans un délai de 90 jours à compter de l’installation, sinon le pilote ne fonctionnera pas.

Pour plus d’informations sur l’activation, reportez-vous à la section Activating Novell Identity Manager Products (Activation des produits de Novell Identity Manager) du Novell Nsure Identity Manager 2 Administration Guide (Guide d’administration de Novell Nsure Identity Manager 2).

20 Guide d’implémentation du pilote DirXML pour SAP User

Page 21: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

3 Présentation des technologies ALE

Cette section explique comment la technologie ALE (Application Link Enabling - Activation de liens d’application) assure la communication entre Identity Manager et les systèmes SAP.

Technologie ALE (Application Link Enabling - Activation de liens d’application)

La technologie ALE (Application Link Enabling - Activation de liens d’application) permet les communications entre SAP et des systèmes externes comme Novell® eDirectoryTM. ALE comprend divers composants. Si vous souhaitez distribuer automatiquement les données de modification de l’objet Utilisateur depuis le système SAP vers eDirectory, vous devez configurer les systèmes ALE et CUA. Si votre procédure d’intégration nécessite uniquement la lecture et l’écriture de données sur le système SAP, cette configuration n’est pas nécessaire.

En configurant le système SAP pour activer le pilote, prenez en compte les composants ALE suivants et leur relation avec le pilote :

« Clients et systèmes logiques », page 22

« Type de message », page 22

« Type IDoc », page 22

« Modèle de distribution », page 22

« Profils de partenaires », page 23

« Port », page 23

« Définition de port », page 23

« Port de fichier », page 23

CUA

Reportez-vous à « Configuration du système SAP », page 25 pour obtenir des instructions de configuration de ces paramètres système SAP.

Présentation des technologies ALE 21

Page 22: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Clients et systèmes logiquesDans la configuration SAP du pilote, un système logique est une représentation d’un système SAP ou externe. Le système logique permet de distribuer des données de et vers SAP. Pour utiliser ALE, tout système SAP doit avoir un système logique de base associé à un client. Il existe une relation de un à un entre le client et le système logique.

Le pilote utilise une interface ALE sortante. Dans ce type d’interface, le système logique de base devient l’expéditeur des messages sortants et le récepteur des messages sortants. Un utilisateur SAP doit être logué au système logique de base/client pour pouvoir modifier la base de données (par exemple, lors de la modification des profils Utilisateur ou des préférences de login). Un système logique/client doit également être défini pour le client récepteur. Ce système logique agit comme récepteur des messages sortants.

Type de messageUn type de message représente le type des données échangées entre les deux systèmes. Pour ce pilote, le type de message USERCLONE est utilisé. Un type de message caractérise les données envoyées entre les systèmes et se rapporte à la structure de ces données ; il est également appelé type IDoc (par exemple, USERCLONE03).

Type IDocLe type IDoc (Intermediate Document - Document intermédiaire) représente la structure des données associées à un type de message. La technologie ALE utilise des fichiers IDoc pour échanger des données entre des systèmes logiques. Un fichier IDoc est un objet qui contient les données d’un type de message particulier. Les fichiers IDoc se composent de trois types d’enregistrements :

1. l’enregistrement de contrôle,

2. l’enregistrement de données,

3. l’enregistrement d’état.

L’enregistrement de contrôle contient des informations sur le fichier IDoc, par exemple son type, le type de message, les systèmes émetteur et récepteur ou la direction.

L’enregistrement de données contient les données d’application. Un tel enregistrement comprend plusieurs champs qui décrivent le contenu de l’objet.

L’enregistrement d’état contient des données sur l’état du traitement du fichier IDoc.

Modèle de distributionLe modèle de distribution est un outil qui stocke des informations sur le flux des types de message entre les systèmes. Un modèle de distribution doit être configuré lors de la configuration du pilote. Après avoir défini les deux systèmes logiques et compris le rôle des types de message et des fichiers IDoc, vous pouvez configurer votre modèle de distribution.

Le modèle de distribution détermine les types de messages qui peuvent être envoyés d’un système logique à un autre.

22 Guide d’implémentation du pilote DirXML pour SAP User

Page 23: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Profils de partenairesLes profils de partenaires définissent les composants utilisés dans un processus sortant. Certains de ces composants comprennent le type IDoc, le type de message, la taille IDoc, le mode et la personne à avertir en cas d’erreurs.

PortUn port est le lien de communication entre les deux systèmes logiques.

Définition de portDans un processus sortant, une définition de port permet de définir le mode de transfert des documents vers le système cible.

Port de fichierUn port de fichier peut être utilisé dans la solution d’intégration. Les fichiers IDocs sont transférés vers un fichier situé dans un répertoire du système de fichiers accessible par le système hôte SAP.

Port TRFCLe mécanisme TRFC (Transactional Remote Function Call) peut être utilisé dans la solution d’intégration. Les fichiers IDoc sont transférés vers un processus d’application spécifique (par exemple le pilote) via la passerelle SAP.

CUALe processus CUA (Central User Administration) est assuré par SAP pour distribuer et gérer les données des objets Utilisateur entre un système logique SAP central et un ou plusieurs systèmes logiques clients. Les systèmes logiques clients peuvent être des systèmes SAP ou externes. CUA repose sur la technologie ALE.

Présentation des technologies ALE 23

Page 24: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

24 Guide d’implémentation du pilote DirXML pour SAP User

Page 25: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

4 Configuration du système SAP

Configurez le système SAP de manière à activer le traitement des fichiers IDoc USERCLONE par ALE et CUA pour acheminer en temps réel les modifications des données SAP User vers eDirectory via le canal Éditeur. Novell® suit les recommandations générales de SAP pour la configuration des technologies BAPI et ALE pour cette solution d’intégration.

Configuration du système SAPDans le cadre de la configuration du système SAP, procédez aux étapes suivantes dans l’ordre indiqué :

1. « Définition des systèmes d’envoi et de réception », page 25

2. « Création d’un système logique », page 26

3. « Assignation d’un client au système logique », page 26

4. « Création d’un modèle de distribution », page 26

5. « Création d’une définition de port », page 27

6. « Profils de partenaires », page 28

7. « Modification de la définition de port », page 29

8. « Activation de CUA (Central User Administration) », page 29

9. « Définition des paramètres de distribution de champ », page 30

10. « Création d’un utilisateur de communication (CPIC) », page 30

Remarque : les instructions suivantes concernent la version 4.6C de SAP. Si vous utilisez une version précédente de SAP, le processus de configuration est le même, mais l’interface SAP diffère.

Définition des systèmes d’envoi et de réceptionPour la messagerie, les systèmes d’envoi et de réception doivent être définis. Pour pouvoir distribuer les données entre les systèmes vous devez d’abord définir les systèmes d’envoi et de réception en tant que systèmes logiques uniques.

Pour cette solution particulière, il est recommandé de définir deux systèmes logiques. Un système logique représente le pilote et joue le rôle du système récepteur. L’autre représente le système SAP et joue le rôle du système expéditeur. Un seul de ces clients étant utilisé comme source de données (c’est-à-dire, le client/système logique sur lequel les données SAP User sont stockées et les « opérations » se produisent), il n’est pas nécessaire d’assigner un client au système logique récepteur.

Remarque : selon votre environnement SAP actuel, la création d’un système logique peut s’avérer inutile. Il vous suffira peut-être de modifier un modèle de distribution existant en ajoutant le type de message USERCLONE à une vue de modèle configurée précédemment. Pour plus d’informations, reportez-vous à « Création d’un modèle de distribution », page 26.

Configuration du système SAP 25

Page 26: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Toutefois, il est important de suivre les recommandations de SAP relatives aux systèmes logiques et à la configuration de votre réseau ALE. Les instructions ci-dessous supposent la création de nouveaux systèmes logiques et d’une nouvelle vue de modèle.

Création d’un système logique

1 Dans SAP, saisissez le code de transaction BD54.

2 Cliquez sur New Entries (Nouvelles entrées).

3 Saisissez un nom facilement identifiable pour représenter le système SAP expéditeur. SAP conseille d’adopter le format suivant pour les systèmes logiques qui représentent des clients R/3 : systemIDCLNTclient number (par exemple, ADMCLNT100).

4 Saisissez une description pour le système logique (par exemple, Système central pour la distribution des objets SAP User).

5 Ajoutez un nom de système logique représentant le système récepteur DirXML externe (par exemple, DIRXMLDRV).

6 Saisissez une description pour le système logique (par exemple, Intégration de la gestion des utilisateurs DirXML).

7 Enregistrez vos entrées.

Assignation d’un client au système logique

1 Dans SAP, saisissez le code de transaction SCC4.

2 Cliquez sur Table View > Display > Change (Vue tableau > Afficher > Modifier) pour passer du mode d’affichage au mode de modification.

3 Sélectionnez le client à partir duquel les informations Utilisateur doivent être distribuées (par exemple, 100).

4 Cliquez sur Goto > Details > Client Details (Atteindre > Détails > Détails du client).

5 Dans le champ Logical System (Système logique), sélectionnez le système logique expéditeur à assigner à ce client (par exemple, ADMCLNT100).

6 Enregistrez vos entrées.

Création d’un modèle de distributionLe modèle de distribution contient des informations essentielles sur le flux de messages. La vue du modèle définit les systèmes qui communiqueront entre eux et les messages qu’ils se transmettront mutuellement. Le modèle de distribution constitue la base de la distribution et la contrôle directement.

Pour créer un modèle de distribution, procédez comme suit :

1 Vérifiez que vous êtes logué au système émetteur/client.

2 Dans SAP, saisissez le code de transaction BD64. Vérifiez que le mode de modification est activé ; pour cela, cliquez sur Table View > Display > Change (Vue tableau > Afficher > Modifier).

3 Cliquez sur Edit > Model View > Create (Édition > Vue du modèle > Créer).

4 Saisissez une rapide description du modèle de distribution (par exemple, Distribution client 100 vers DirXML).

5 Saisissez le nom technique du modèle (par exemple, SAP2DIRXML).

26 Guide d’implémentation du pilote DirXML pour SAP User

Page 27: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

6 Acceptez les dates de début et de fin par défaut ou spécifiez des valeurs valides. Cliquez sur la coche pour enregistrer votre entrée.

7 Sélectionnez la vue que vous avez créée, puis cliquez sur Add BAPI (Ajouter une interface BAPI).

8 Dans le champ Sender/Client (Expéditeur/Client), saisissez le nom du système logique expéditeur (par exemple, ADMCLNT100).

9 Dans le champ Receiver/Client (Récepteur/Client), ajoutez le nom du système logique récepteur (par exemple, DIRXMLDRV).

10 Dans le champ Obj. Name/Interface (Nom d’objet/Interface), ajoutez le nom de l’objet USER.

Remarque : veillez à ajouter le nom de l’objet USER en majuscules.

11 Dans le champ Method (Méthode), ajoutez Clone (Cloner).

12 Dans le champ Obj. Name/Interface (Nom d’objet/Interface), ajoutez le nom d’objet UserCompany.

13 Cliquez sur la coche pour enregistrer vos entrées BAPI.

14 Enregistrez les entrées du modèle de distribution.

Création d’une définition de portLe port constitue le canal de communication auquel sont envoyés les fichiers IDoc. Le port décrit la liaison technique qui existe entre les systèmes d’envoi et de réception.

Le pilote peut être configuré pour prendre en charge une connexion via un port TRFC ou pour lire des fichiers IDoc distribués via un port de fichier. Par défaut, la configuration du pilote suppose que vous utilisez le port TRFC.

Définition de port TRFC

Avant de créer une définition de port TRFC, vous devez créer une destination RFC. Pour créer une destination RFC, procédez comme suit :

1 Dans SAP, saisissez le code de transaction SM59.

2 Cliquez sur l’icône Create (Créer).

3 Nommez les destinations RFC (par exemple, DIRXML USER DRIVER).

4 Sélectionnez le type de connexion T (pour une connexion TCP/IP).

5 Ajoutez une description de la destination (par exemple, Serveur JCO dans le pilote Utilisateur DirXML).

6 Enregistrez vos entrées.

7 Sélectionnez l’option Registration (Enregistrement) ou Registered Server Program (Programme serveur enregistré). Saisissez l’ID de programme à utiliser pour le pilote DirXML. Dans la configuration par défaut du pilote, cette valeur est DirXMLUser.

8 Enregistrez vos entrées.

Le port TRFC permet de déterminer le programme RFC vers lequel les fichiers IDoc sont envoyés.

1 Dans SAP, saisissez le code de transaction WE21.

2 Sélectionnez Transactional RFC (TRFC), puis cliquez sur l’icône Create (Créer).

Configuration du système SAP 27

Page 28: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

3 Sélectionnez Own Port Option Name (Nom de l’option d’appartenance du port).

3a Entrez un nom de port (par exemple, DIRXMLPORT).

3b Saisissez une description du port (par exemple, Port vers le pilote Utilisateur DirXML).

3c Sélectionnez une version (par exemple les types d’enregistrement IDoc SAP version 4.X).

3d Indiquez la destination RFC. Il s’agit du nom de la destination RFC représentant le pilote (par exemple, DIRXML USER DRIVER)

4 Enregistrez vos entrées.

Définition de port de fichier

1 Dans SAP, saisissez le code de transaction WE21.

2 Sélectionnez File (Fichier), puis cliquez sur l’icône Create (Créer).

2a Entrez un nom de port (par exemple, DIRXMLFILE).

2b Saisissez une description du port (par exemple, Port de fichier vers le pilote Utilisateur DirXML).

2c Sélectionnez une version (par exemple SAP version 4.X).

3 Définissez le fichier sortant :

3a Sélectionnez un répertoire physique. Il s’agit du répertoire dans lequel vous souhaitez placer les fichiers IDoc. Vous devrez peut-être créer ce répertoire.

Saisissez le nom du répertoire dans lequel sont écrits les fichiers à destination de l’extérieur, par exemple : \\sapdev\nov\sys\global\sapndsconnector.

3b Saisissez le module de fonction. Le fichier IDoc est ainsi nommé selon un format spécifique. Exemple : edi_path_create_client_docnum.

4 Enregistrez vos modifications.

Remarque : il est inutile de configurer les trois autres onglets de propriétés de port (propriétés de déclencheur, de fichier entrant et de fichier d’état).

Profils de partenairesLe système crée automatiquement un profil de partenaire, mais vous pouvez également mettre à jour ce profil manuellement.

Remarque : si vous utilisez un modèle de distribution et un profil de partenaire existants, il est inutile de générer automatiquement un profil de partenaire. Vous pouvez modifier ce profil existant afin d’inclure l’interface BAPI USERCLONE.

1 Dans SAP, saisissez le code de transaction BD82.

2 Sélectionnez la vue de modèle. Il doit s’agir de la vue précédemment créée à la section « Création d’un modèle de distribution », page 26.

3 Vérifiez que les cases d’option Transfer IDoc immediately (Transférer immédiatement IDoc) et Trigger Immediately (Déclencher immédiatement) sont sélectionnées.

4 Cliquez sur l’icône Execute (Exécuter).

Remarque : ignorez les messages d’erreur ou d’avertissement qui s’affichent en rouge à l’ouverture de l’écran d’état. Les problèmes qu’ils signalent seront résolus lorsque vous modifierez la définition du port, à la section suivante.

28 Guide d’implémentation du pilote DirXML pour SAP User

Page 29: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Modification de la définition de port

Lorsque vous avez généré un profil de partenaire, la définition de port a peut-être été saisie de manière incorrecte. Pour que votre système fonctionne correctement, vous devez modifier la définition de port.

1 Dans SAP, saisissez le code de transaction WE20.

2 Sélectionnez le type de partenaire LS.

3 Sélectionnez le profil de partenaire récepteur (par exemple, DIRXMLDRV).

4 Cliquez sur l’icône Create Outbound Parameter (Créer un paramètre sortant), puis sélectionnez le type de message USERCLONE.

5 Remplacez le port récepteur par le nom du port de fichier ou TRFC défini précédemment (par exemple, DIRXMLPORT ou DIRXMLFILE).

6 Dans le champ Output Mode (Mode sortant), sélectionnez Transfer IDoc Immediately (Transférer IDoc immédiatement) pour envoyer les fichiers IDoc dès qu’ils sont créés.

7 Dans la section IDoc Type (Type IDoc), sélectionnez le type Basic (Élémentaire) et le type USERCLONE approprié :

Pour SAP 4.5, sélectionnez USERCLONE01.

Pour SAP 4.6a, sélectionnez USERCLONE02.

Pour SAP 4.6c, sélectionnez USERCLONE03.

Pour SAP 6.10 ou une version ultérieure, sélectionnez USERCLONE04.

8 Enregistrez vos entrées.

9 Cliquez sur l’icône Create Outbound Parameter (Créer un paramètre sortant), puis sélectionnez le type de message CCLONE.

10 Remplacez le port récepteur par le nom du port de fichier ou TRFC défini précédemment (par exemple, DIRXMLPORT ou DIRXMLFILE).

11 Dans le champ Output Mode (Mode sortant), sélectionnez Transfer IDoc Immediately (Transférer IDoc immédiatement) pour envoyer les fichiers IDoc dès qu’ils sont créés.

12 Dans la section IDoc Type (Type IDoc), sélectionnez le type Basic (Élémentaire) et le type CCLONE approprié. (Pour toutes les versions de SAP, sélectionnez CCLONE01.)

13 Enregistrez vos entrées.

Activation de CUA (Central User Administration)CUA (Central User Administration) est le processus chargé d’activer le modèle de distribution.

1 Dans SAP, saisissez le code de transaction SCUA.

2 Dans la boîte de dialogue Maintain System Landscape (Gestion de l’infrastructure du système), sélectionnez la vue de modèle de distribution créée précédemment (par exemple, SAP2DIRXML).

3 Enregistrez vos entrées.

Le message « Unable to distribute the system landscape to system DIRXMLDRV » (Impossible de distribuer l’infrastructure du système vers le système DIRXMLDRV) s’affiche. Il s’agit d’un message d’information et non d’une erreur ou d’un problème à résoudre.

Configuration du système SAP 29

Page 30: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Définition des paramètres de distribution de champPar défaut, tous les champs de données de l’objet Utilisateur sont configurés en vue d’un contrôle global. Cela signifie que les modifications ne peuvent être effectuées que sur le système central (le client expéditeur) avant d’être distribuées vers les systèmes enfants. Ce paramètre est acceptable sauf si vous souhaitez distribuer des informations de rôle et de profil au pilote. Pour permettre cette distribution, vous devez modifier les paramètres de distribution de champ.

1 Dans SAP, saisissez le code de transaction SCUM.

2 Cliquez sur l’onglet Roles (Rôles).

3 Sélectionnez l’option Local dans les champs Role Assignment (Assignation de rôle) et Reference User (Utilisateur de référence).

4 Cliquez sur l’onglet Profiles (Profils).

5 Sélectionnez l’option Local pour le fichier Auth.profiles.

6 Enregistrez vos entrées.

Là encore, le message « Unable to distribute... » (Impossible de distribuer...) s’affiche. Il ne s’agit ni d’une erreur, ni d’un problème à résoudre.

Création d’un utilisateur de communication (CPIC)Les utilisateurs ne dépendent pas des clients. Vous devez créer un utilisateur système avec accès CPIC pour chaque client qui utilisera le pilote.

1 Dans SAP, saisissez le code de transaction SU01.

2 Dans User Maintenance (Maintenance des utilisateurs), entrez un nom d’utilisateur dans la boîte de dialogue User (Utilisateur) (par exemple, DIRXML_CPIC), puis cliquez sur l’icône Create (Créer).

3 Cliquez sur l’onglet Address (Adresse), puis renseignez les champs concernant le nom de famille (Last_DirXML).

4 Cliquez sur l’onglet Logon Data (Données de connexion), puis définissez le mot de passe initial et le type d’utilisateur CPIC (Communication).

5 Cliquez sur l’onglet Profiles (Profils), puis ajoutez les exemples de profils SAP_ALL, SAP_NEW et S_A.CPIC. Vous pouvez utiliser d’autres profils.

6 Cliquez sur l’onglet Systems (Systèmes). Ajoutez le nom logique du système expéditeur (par exemple, ADMCLNT100). L’utilisateur CPIC peut ainsi s’authentifier sur le système client.

7 Cliquez sur Save (Enregistrer).

Remarque : au début, vous pouvez créer un utilisateur de boîte de dialogue afin de tester votre configuration système SAP. En cas de problème lors du traitement, vous pouvez analyser cet utilisateur à l’aide de l’outil de débogage. Vous devez également vous connecter au système SAP pour définir le mot de passe de cet utilisateur. Une fois que le système a été testé et qu’il fonctionne correctement, vous devez créer un utilisateur CPIC pour des mesures de sécurité.

30 Guide d’implémentation du pilote DirXML pour SAP User

Page 31: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

5 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 à Novell® eDirectoryTM. SAP JCO est un client SAP qui crée des branchements à 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.

L’utilitaire de test de SAP Java Connector permet de déceler les éventuels problèmes d’installation et de 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 utilisées par le pilote.

Vérifiez que vous utilisez JDK/JRE version 1.3.1 ou ultérieure.

Les instructions suivantes s’appliquent à JCO 1.1.x et 2.x.

Cette section contient les informations suivantes :

« À propos de l’utilitaire », page 31

« Exécution et évaluation du test », page 32

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

À propos de l’utilitaireL’utilitaire de test JCO procède aux vérifications suivantes :

Il vérifie la présence du fichier jco.jar ou sapjco.jar, qui contient l’interface JCO exportée.

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

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

Il s’assure que les paramètres d’authentification auprès du système cible SAP 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.

Conditions préalables à l’exécution de l’utilitaireAvant d’exécuter l’utilitaire de test JCO, vous devez installer le client SAP JCO correspondant à la plate-forme voulue. Vous pouvez télécharger JCO à 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.

Utilisation de l’outil de test de SAP Java Connector 31

Page 32: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

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

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 ou sapjco.jar. Pour les plates-formes UNIX*, définissez l’emplacement des bibliothèques de prise en charge natives comme valeur pour la variable LD_LIBRARY_PATH ou LIBPATH. 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 la gestion des utilisateurs du logiciel SAP.

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.

ComposantsL’utilitaire de test JCO est constitué du fichier UserJCOTest.class. Le format d’un fichier de commandes ou script d’exécution varie en fonction de la plate-forme sur laquelle le client JCO est installé.

Le contenu de base du fichier comprend un chemin d’accès vers le 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 UserJCOTest.class. Un exemple de fichier script UNIX et de fichier de commandes Win32 figure ci-dessous. Dans cet exemple, jco.jar ou sapjco.jar se trouve dans le répertoire exécutable du fichier UserJCOTest.class et du fichier de commandes :

Win32 jcotest.bat filejava -classpath $CLASSPATH;. UserJCOTest

Unix jcotest filejava UserJCOTest

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 du fichier jco.jar ou sapjco.jar et que le nom de la classe de test, UserJCOTest, 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 :

1 Dans Windows Explorer, double-cliquez sur UserJCOTEST.BAT.ouÀ partir d’une ligne de commande, exécutez le script UserJCOTEST.BAT.

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

1 À partir de votre shell préféré, exécutez le fichier script userjcotest.

Remarque : il est possible qu’à l’exécution du programme de test, un message d’erreur apparaisse avant l’affichage des résultats du test. Cela indique une installation incorrecte des composants du client JCO. Les messages d’erreur pour chaque plate-forme sont expliqués à la section « Présentation des messages d’erreur du test », page 34.

32 Guide d’implémentation du pilote DirXML pour SAP User

Page 33: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

É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----------------------------------------

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 des délimiteurs [], est indiquée. Si vous omettez d’indiquer une valeur en réponse à une invite, le test est interrompu. Entrez les informations suivantes à l’invite :

Nom ou adresse IP du serveur d’applications

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 affiche des messages d’erreur accompagnés des solutions suggérées ou 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) :

**All expected platform support is verified correct.

JCO Test Summary----------------Full JCO/BAPI Functionality has been verified.The following parameters may be used for driver configuration

Authentication ID: UsernameAuthentication Context: SAP Host Name/IP AddressApplication Password: User password

SAP System Number: System NumberSAP User Client Number: Client NumberSAP User Language: Language Code

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 driver functionality.

Utilisation de l’outil de test de SAP Java Connector 33

Page 34: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Procédures post-test

Une fois que l’utilitaire de test JCO a exécuté tous les tests avec succès, vous pouvez commencer à configurer le pilote. Vérifiez que le fichier jco.jar ou sapjco.jar est copié à l’emplacement dans lequel le fichier sapusershim.jar a été installé.

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

Présentation des messages d’erreur du testLes informations de cette section permettent d’analyser les messages d’erreur qui pourraient s’afficher au cours du test User 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 comparables à celles décrites ci-après. JCO étant modifié régulièrement, les messages peuvent différer légèrement des exemples fournis.

« Erreurs générales », page 34

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

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

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

« Erreurs sur les systèmes HP-UX », page 37

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)

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’applications)

Ce message indique qu’une des valeurs, ou les deux, entrées pour le nom du serveur d’applications ou l’adresse IP et le numéro du système sont incorrectes.

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)

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).)

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.

34 Guide d’implémentation du pilote DirXML pour SAP User

Page 35: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Erreurs sur les systèmes Win32

Erreurs sur les systèmes IBM-AIX

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 ’<valeur>’ 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.

Message d’erreur Problème

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

Le fichier de commandes userjcotest.bat est absent.

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 ou sapjco.jar n’est pas à l’emplacement indiqué dans le fichier de commandes userjcotest.bat.

Exception while initializing JCO client. (Exception lors de l’initialisation du client JCO.) java.lang.UnsatisfiedLinkError: no jRFC12 in java.library.path (pas de jRFC12 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 native de 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 native de 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.

Message d’erreur Problème

ksh: userjcotest: not found. (introuvable.) Le fichier de script userjcotest est introuvable dans ce répertoire.

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

Le fichier jco.jar ou sapjco.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 ou sapjco.jar ne correspond pas au nom réel du fichier.

Message d’erreur Problème

Utilisation de l’outil de test de SAP Java Connector 35

Page 36: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Erreurs sur les systèmes Solaris

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 native de 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: <chemin>/libjRFC12.so: A file or directory in the path name does not exist (Fichier ou répertoire introuvable). Verify proper installation of JCO Native support libraries packaged with JCO client. (Vérifiez l’installation des bibliothèques de prise en charge native de JCO 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.

Message d’erreur Problème

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

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

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

Le fichier jco.jar ou sapjco.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 ou sapjco.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 (pas de jRFC12 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 native de 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 auquel réside le fichier.

Exception while initializing JCO client. (Exception lors de l’initialisation du client JCO.) java.lang.UnsatisfiedLinkError: <chemin>/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 de prise en charge native de 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.

Message d’erreur Problème

36 Guide d’implémentation du pilote DirXML pour SAP User

Page 37: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Erreurs sur les systèmes HP-UX

Erreurs sur les systèmes Linux

Message d’erreur Problème

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

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

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

Le fichier jco.jar ou sapjco.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 ou sapjco.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.MiddlewareRFC no sapjcorfc in java.library.path (sapjcorfc 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 native de JCO fournies avec le client JCO.)

Le fichier libjRFC12.sl livré avec le client JCO n’est pas installé ou est installé à un emplacement incorrect. Vous devez configurer une variable d’environnement SHLIB_PATH pour indiquer l’emplacement auquel 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. Verify proper installation of JCO Native support libraries packaged with JCO client. (Vérifiez l’installation des bibliothèques de prise en charge native de JCO livrées avec le client JCO.)

Le fichier librfccm.sl 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.sl ou configurer la variable d’environnement SHLIB_PATH de façon à spécifier l’emplacement du fichier.

Message d’erreur Problème

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

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

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

Le fichier jco.jar ou sapjco.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 ou sapjco.jar ne correspond pas au nom réel du fichier.

Utilisation de l’outil de test de SAP Java Connector 37

Page 38: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

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 native de 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 auquel 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<chemin>/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 de prise en charge native de 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.

Message d’erreur Problème

38 Guide d’implémentation du pilote DirXML pour SAP User

Page 39: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

6 Présentation de la configuration par défaut du pilote

Cette section explique l’utilisation, par la configuration par défaut du pilote, des règles et des filtres. Inspirez-vous de cette présentation pour créer vos propres règles et filtres adaptés à des implémentations spécifiques à votre entreprise.

Utilisation des règlesLes règles peuvent être entièrement configurées pour une utilisation dans n’importe quel environnement d’entreprise. Bien que chaque entreprise soit différente, la configuration par défaut du pilote comprend l’organisation SAP-Utilisateurs dans l’arborescence Novell® eDirectoryTM.

Le pilote par défaut est également configuré pour être avant tout un pilote du canal Abonné. L’objectif principal est donc de créer des comptes SAP User à partir des informations collectées dans eDirectory.

Modification des règles et des filtresVous devez modifier les règles et les filtres pour qu’ils fonctionnent dans votre environnement d’entreprise spécifique. Nous recommandons d’effectuer les modifications dans l’ordre suivant :

Modifiez les filtres des canaux Éditeur et Abonné pour y inclure des attributs supplémentaires à synchroniser.

Modifiez la règle d’assignation pour inclure tous les attributs définis dans les filtres des canaux Abonné et Éditeur.

Modifiez la règle InputTransform.

Modifiez la règle OutputTransform.

Modifiez la règle de placement du canal Éditeur.

Modifiez la règle de concordance du canal Éditeur.

Modifiez la règle de création du canal Éditeur.

Modifiez la règle de transformation de commande du canal Éditeur.

Modifiez la règle de concordance du canal Abonné.

Présentation de la configuration par défaut du pilote 39

Page 40: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Filtre du canal Éditeur

Le filtre du canal Éditeur contient l’ensemble de classes et d’attributs dont les mises à jour sont acheminées, via le canal Éditeur, depuis le système SAP vers eDirectory.

Remarque : pour utiliser la configuration par défaut du pilote, n’excluez pas du filtre les attributs CommExec, Organizational Role ou Organizational Unit. De même, ne supprimez pas les attributs suivants de l’objet Classe utilisateur : Given Name, Surname et workforceID.

Le tableau suivant comprend quelques exemples de classes et d’attributs qui figurent dans le filtre du canal Éditeur.

Filtre du canal Abonné

Le filtre du canal Abonné contient l’ensemble de classes et d’attributs que le système SAP reçoit depuis eDirectory. Pour modifier le filtre du canal Abonné, ajoutez tous les attributs au filtre à synchroniser.

Remarque : ne supprimez pas l’attribut workforceID du filtre du canal Abonné. Il s’agit en effet de l’attribut que le pilote utilise pour localiser et modifier les utilisateurs.

La configuration par défaut du pilote autorise les attributs de l’objet Classe utilisateur suivants sur le filtre du canal Abonné.

Classes Attributs

Utilisateur Login Disabled

sapProfiles

sapRoles

sapUsername

birthName OU sapRoles

buildingName pager sapSncGuiFlag

commType roomNumber sapSncName

company sapAlias sapSpool

costCenter sapCATT sapStartMenu

Facsimile Telephone Number sapClass sapTimeZone

firstPrefix sapCompanyKey sapUsername

floor sapDateFormat sapUserType

Full Name sapDecimalFormat sapValidFrom

Given Name sapGroups sapValidTo

inHouseMail sapLanguage secondName

Initials sapLoginLanguage secondPrefix

initialsSlg sapParameters Surname

Internet Email Address sapPrintParam1 Telephone Number

Login Disabled sapPrintParam2 telexNumber

middleName sapPrintParam3 Title

mobile sapProfiles titleAcademic1

nickname sapRefUser titleAcademic2

40 Guide d’implémentation du pilote DirXML pour SAP User

Page 41: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Règle d’assignation de schéma

La règle d’assignation de schéma est référencée par l’objet Pilote et s’applique à la fois au canal Abonné et au canal Éditeur. L’objet de cette règle est d’assigner des noms de schéma (en particulier, des noms d’attributs et de classes) entre eDirectory et la base de données SAP User. Toute modification ou suppression d’entrées existantes dans la règle d’assignation de schéma anéantirait la configuration par défaut et le mode de traitement des règles. L’ajout de nouvelles assignations d’attributs est discrétionnaire. Les assignations suivantes sont incluses avec la configuration par défaut du pilote.

La classe Utilisateur est configurée pour une synchronisation bidirectionnelle entre SAP et eDirectory. Toute modification apportée dans un système sera répercutée dans l’autre.

Tous les attributs des filtres Éditeur et Abonné doivent être assignés, sauf s’ils servent uniquement au traitement de règles.

Les valeurs du champ SAP User (Utilisateur SAP) peuvent être classées en trois types :

1. Champs simples : ces valeurs ne sont pas regroupées avec d’autres champs. La syntaxe utilisée pour l’assignation de schéma est <nom_champ>.

2. Champs de structure : ces valeurs sont regroupées avec d’autres informations décrivant un ensemble plus vaste de données d’instance unique. La syntaxe utilisée pour l’assignation de schéma dans ces champs est <nom_structure>:<nom_champ>. Par exemple, ADDRESS:TELEPHONE.

3. Champs de table : ces valeurs sont comparables à celles des champs de structure, mais elles peuvent regrouper plusieurs instances des données structurées. La syntaxe utilisée pour l’assignation de schéma dans ces champs est <nom_table>:<nom_champ>. Par exemple, ADDTEL:TELEPHONE.

Le tableau suivant énumère les assignations d’attribut les plus courantes de la classe Utilisateur et leur description, en admettant l’hypothèse que seule la partie principale des données de communication de structure est requise (par exemple, ADD:TELEPHONE). Pour assigner tous les champs d’une structure, ne spécifiez que le nom de la structure ou de la table dans l’assignation (par exemple, ADDTEL). Le pilote synchronise alors le champ de données principal (dans cet exemple, TELEPHONE) sur le canal Abonné. Il synchronise ensuite tous les champs de données en utilisant le délimiteur point-virgule (« ; ») sur le canal Éditeur.

La règle d’assignation de schéma dépend dans une large mesure de l’extension du schéma standard d’eDirectory. Les extensions utilisées par le pilote se présentent sous la forme d’un fichier LDIF créé par SAP en vue d’être utilisé avec les interfaces d’annuaire SAP dans le cadre de la gestion des utilisateurs. Ce fichier est fourni dans le pilote. Pour plus de détails, reportez-vous à « Extension du schéma », page 19.

Assignations par défaut pour le pilote :

Classe eDirectory Classe SAP Description SAP

Utilisateur US USER

Attribut eDirectory Description du champ SAP User (Utilisateur SAP)

Champ SAP User (Utilisateur SAP)

birthName Nom de naissance d’une personne

ADDRESS:BIRTH_NAME

Présentation de la configuration par défaut du pilote 41

Page 42: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

buildingName Bâtiment (numéro ou code) ADDRESS:BUILDING_P

commType Type de communication (clé) (Gestion centralisée de l’adresse)

ADDRESS:COMM_TYPE

company Adresse de la société, clé inter-système

COMPANY:COMPANY

costCenter Centre de coûts DEFAULTS:KOSTL

Facsimile Telephone Number

Numéro de télécopie : indicatif + numéro

ADDFAX:FAX

firstPrefix Civilité ADDRESS:PREFIX1

floor Étage ADDRESS:FLOOR_P

Full Name Nom complet de la personne ADDRESS:FULLNAME

Given Name Prénom ADDRESS:FIRSTNAME

inHouseMail Adresse postale ADDRESS:INHOUSE_ML

Initials Initiale centrale ou initiales personnelles

ADDRESS:INITIALS

InitialsSig Nom abrégé utilisé pour la correspondance

ADDRESS:INITS_SIG

Internet EMail Address Adresse électronique (SMTP) ADDSMPT:E_MAIL

Login Disabled Compte utilisateur verrouillé LOCKUSER 1

middleName Deuxième prénom d’une personne

ADDRESS:MIDDLEWARE

nickname Surnom ou nom d’usage ADDRESS:NICKNAME

OU Division ADDRESS:DEPARTMENT

pager Numéro d’alphapage ADDPAG:PAGER

roomNumber Numéro de chambre ou d’appartement

ADDRESS:ROOM_NO_P

sapAlias Alias d’utilisateur Internet ALIAS:USERALIAS

sapCATT CATT : état de test DEFAULTS:CATTKENNZ

sapClass Groupe d’utilisateurs pour la maintenance de la base de données utilisateurs

LOGONDATA:CLASS

sapCompanyKey Adresse de la société, clé inter-système

COMPANY:COMPANY

sapDateFormat Format de date DEFAULTS:DATFM

Attribut eDirectory Description du champ SAP User (Utilisateur SAP)

Champ SAP User (Utilisateur SAP)

42 Guide d’implémentation du pilote DirXML pour SAP User

Page 43: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

1 L’attribut LOCKUSER n’existe pas réellement dans SAP. Le pilote utilise ce pseudo-attribut pour déterminer à quel moment appeler les fonctions BAPI USER_LOCK et USER_UNLOCK.

sapDecimalFormat Notation décimale DEFAULTS:DCPFM

sapGroups Groupe d’utilisateurs pour la maintenance de la base de données utilisateurs

GROUPS:USERGROUP

sapLanguage Clé de langue ADDRESS:LANGU_P

sapLoginLanguage Language DEFAULTS:LANGU

sapParameters Obtention/définition d’ID et de valeurs de paramètre

PARAMETER

sapPrintParam1 Paramètre d’impression 1 DEFAULTS:SPLG

sapPrintParam2 Paramètre d’impression 2 DEFAULTS:SPDB

sapPrintParam3 Paramètre d’impression 3 DEFAULTS:SPDA

sapProfiles Nom de profil PROFILES:BAPIPROF

sapRefUser Nom d’utilisateur dans la fiche utilisateur

REF_USER:REF_USER

sapRoles Nom de rôle ACTIVITYGROUPS:AGR_NAME

sapSpool Spoule : périphérique de sortie DEFAULTS:SPLD

sapStartMenu Menu de démarrage DEFAULTS:START_MENU

sapTimeZone Fuseau horaire LOGONDATA:TZONE

sapUserType Type d’utilisateur USERNAME:BAPINAME

sapValidFrom Début de validité de l’utilisateur LOGONDATA:USTYP

sapValidTo Fin de validité de l’utilisateur LOGONDATA:GLTGV

secondName Deuxième prénom d’une personne

LOGONDATA: GLTGB

secondPrefix Civilité ADDRESS:SECONDNAME

Surname Nom de famille ADDRESS:PREFIX2

Telephone Number Numéro de téléphone : indicatif + numéro

ADDRESS:LASTNAME

telexNumber Numéro de télex ADDTLX:TELEX_NO

Title Fonction ADDRESS:FUNCTION

titleAcademic1 Titre académique : forme écrite ADDRESS:TITLE_ACA1

titleAcademic2 Titre académique : forme écrite ADDRESS:TITLE_ACA2

Attribut eDirectory Description du champ SAP User (Utilisateur SAP)

Champ SAP User (Utilisateur SAP)

Présentation de la configuration par défaut du pilote 43

Page 44: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Règle de transformation d’entrée

Vous modifiez la règle de transformation d’entrée pour implémenter les procédures propres à votre entreprise. La règle de transformation d’entrée est appliquée pour entraîner une transformation des données reçues du module d’interface pilote.

L’application de la règle constitue la première étape du traitement d’un document XML reçu du module d’interface pilote. La règle convertit la syntaxe des attributs SAP en une syntaxe adaptée à eDirectory.

La configuration par défaut du pilote inclut un modèle unique qui permet d’effectuer l’opération suivante :

Lorsqu’un objet Utilisateur est créé dans SAP, l’attribut sapUsername, comportant le nouveau nom d’utilisateur, est réécrit dans l’objet Utilisateur associé d’eDirectory.

Modification de la règle de transformation de la sortie

Vous modifiez la règle de transformation de la sortie pour implémenter les procédures propres à votre entreprise. La règle de transformation de la sortie est référencée par l’objet Pilote et s’applique à la fois au canal Abonné et au canal Éditeur. L’objectif de la règle de transformation de la sortie est d’effectuer toute transformation finale nécessaire sur les documents XML envoyés au pilote par Identity Manager et retournés au pilote par Identity Manager.

La configuration par défaut du pilote inclut des modèles qui permettent d’effectuer les opérations ci-dessous.

Décodage de la syntaxe de chaîne au format de base 64 octets utilisée pour la valeur de l’attribut eDirectory telexNumber vers un format de type chaîne Java via le paramètre de codage du jeu de caractères configuré dans le pilote.

Transformation de la valeur du pseudo-attribut LOCKUSER du format vrai/faux au format 1/0.

Transformation du format structuré de l’attribut eDirectory Facsimile Telephone Number au format chaîne utilisé dans le champ de table ADDFAX:FAX.

Règle de placement du canal Éditeur

La règle de placement du canal Éditeur est appliquée à un document d’événement d’ajout d’objet pour déterminer le placement du nouvel objet dans la structure hiérarchique d’eDirectory.

Cette règle place tous les objets Utilisateur dans un conteneur eDirectory spécifié au cours de l’installation.

Règle de concordance du canal Éditeur

La règle de concordance du canal Éditeur est appliquée à un document d’événement de modification d’objet. Les règles de concordance établissent des liens entre une entrée existante dans eDirectory et une entrée existante dans le système SAP. La règle de concordance tente de trouver un objet existant correspondant à l’objet qui génère l’événement selon les critères indiqués dans la règle.

Le pilote par défaut vérifie les concordances en fonction des attributs Given Name et Surname.

44 Guide d’implémentation du pilote DirXML pour SAP User

Page 45: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Règle de création du canal Éditeur

La règle de création du canal Éditeur est appliquée lorsqu’un nouvel objet doit être ajouté à eDirectory. La configuration par défaut du pilote comporte des règles de création pour les éléments suivants :

Création d’un objet Utilisateur (les attributs Surname et Given Name sont requis).

Génération d’un nom d’objet (CN) en fonction des attributs Given Name et Surname.

Configuration du mot de passe initial avec la valeur de l’attribut Surname d’un utilisateur.

Règle de concordance du canal Abonné

La règle de concordance du canal Abonné est appliquée à un document d’événement de modification d’objet. Les règles de concordance établissent des liens entre une entrée existante dans eDirectory et une entrée existante dans le système SAP. La règle de concordance tente de trouver un objet existant correspondant à l’objet qui génère l’événement selon les critères indiqués dans la règle.

Le pilote par défaut vérifie les concordances en fonction des attributs Given Name et Surname. (Les noms de schéma corrects pour SAP sont assignés avant la soumission au pilote.)

Règle de création du canal Abonné

La règle de création du canal Abonné est appliquée lorsque vous souhaitez ajouter un nouvel objet à eDirectory. La configuration par défaut du pilote comporte des règles de création pour les éléments suivants :

Génération d’un nom d’objet (sapUsername) en fonction des attributs Given Name et Surname.

Configuration du mot de passe initial avec la valeur PASSWORD.

Configuration de la valeur de sapRoles par défaut SAP_ESSUSER.

Obtention des données d’adresse de société pour des objets Utilisateur

Plusieurs attributs de l’objet SAP User (Utilisateur SAP) sont associés à l’objet Company Address (Adresse de la société) assigné à l’utilisateur. Par défaut, ces attributs ne sont jamais fournis dans les distributions BAPI ou IDoc de données Utilisateur issues du serveur d’applications SAP. Ces champs ne peuvent pas non plus être lus depuis l’objet Utilisateur dans SAP. Les informations d’adresse de société sont conservées dans une table d’enregistrements associés du type ADDRESSORG. Le pilote peut récupérer ces données dans la table ADDRESSORG si nécessaire.

Le paramètre du pilote concernant l’acheminement des données d’adresse de société, <nsap-use-addressorg>, prend la valeur 1 par défaut. Le fait de spécifier la valeur 1 pour ce paramètre permet de récupérer les données dans la table ADDRESSORG si les attributs de la table figurent dans le filtre Éditeur ou s’ils se trouvent dans des éléments <read-attr> d’un document d’interrogation. Bien qu’il soit possible de récupérer ces données à partir du système SAP, les données ADDRESSORG ne peuvent pas être ajoutées, modifiées ou supprimées du système SAP via le pilote. Si la valeur de ce paramètre est 0, les champs d’adresse de société sont récupérés directement à partir de l’objet Utilisateur. Comme mentionné précédemment, ces champs sont vides par défaut.

Présentation de la configuration par défaut du pilote 45

Page 46: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Pour implémenter entièrement la fonction de récupération d’adresse, vous devez configurer le pilote pour recevoir les événements de modification de la table ADDRESSORG. À la réception de ces événements, le pilote obtient une liste de tous les objets Utilisateur assignés à la table ADDRESSORG modifiée et émet les événements modifiés comportant les nouvelles données pour chaque utilisateur concerné.

Pour générer des événements de modification ADDRESSORG, vous devez modifier le modèle de distribution ALE sur le serveur d’applications SAP afin qu’il intègre la distribution BAPI Company Clone (Clone de société) (CCLONE). Pour plus d’informations, reportez-vous à « Création d’un modèle de distribution », page 26 et à « Modification de la définition de port », page 29.

Les champs d’objet Utilisateur suivants peuvent être affectés par cette fonction.

NAME HOUSE_NO2

NAME_2 STR_SUPPL1

NAME_3 STR_SUPPL2

NAME_4 STR_SUPPL3

C_O_NAME BUILDING

CITY DISTRICT

CITY_NO FLOOR

DISTRICT ROOM_NO

DISTRICT_NO COUNTRY

POSTL_COD1 COUNTRYIOS

POSTL_COD2 LOCATION

POSTL_COD3 LANGU_ISO

PO_BOX REGION

PO_BOX_CIT SORT1

PBOXCIT_NO TIME_ZONE

DELIV_DIS TAXJURCODE

TRANSPZONE STR_ABBR

STREET HOUSE_NO

STREET_NO

46 Guide d’implémentation du pilote DirXML pour SAP User

Page 47: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

7 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 47

« Erreurs d’initialisation du pilote », page 48

« Error connecting to SAP host (Erreur de connexion à l’hôte SAP) », page 48

« Aucun fichier IDoc ni document IDoc TRFC n’est généré lors de la création ou de la modification d’un objet SAP User », page 49

« Les utilisateurs créés dans SAP ne peuvent pas se loguer au système SAP (CUA en cours d’utilisation) », page 49

« Le pilote ne reconnaît pas les fichiers IDoc dans le répertoire », page 50

« Le pilote ne parvient pas à s’authentifier auprès de SAP », page 50

« Erreurs d’installation et de configuration de JCO », page 50

« Erreur lors de l’assignation d’unités au répertoire IDoc », page 51

Utilisation de l’outil DSTraceVous pouvez dépanner le pilote à l’aide de l’utilitaire DSTrace. Pour configurer les options de l’utilitaire, vous devez sélectionner Modifier > 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, 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 piloteSi 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.sapusershim.SAPDriver Shim

Il s’agit d’une erreur fatale qui se produit lorsque sapusershim.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 47

Page 48: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

java.lang.ClassNotFoundException:com.novell.nds.dirxml.drivers.sapusershim.SAPDriver Shim

Il s’agit d’une erreur fatale qui se produit lorsque le nom de classe de sapusershim.jar est incorrect. Vous devez vous assurer que le nom de classe Java est défini dans l’onglet Module pilote dans une installation locale et que le paramètre -class est défini dans une configuration de chargeur distant.

Le nom de classe correct est .novell.nds.dirxml.driver.sapusershim.SAPDriverShim

Erreurs d’initialisation du piloteVous verrez peut-être les erreurs d’initialisation suivantes du pilote 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 ou sapjco.jar de SAP Java Connector ou les bibliothèques de prise en charge native de JCO sont absents ou à un emplacement incorrect.

Vérifiez que la version de jco.jar ou sapjco.jar correspondant à la plate-forme se trouve dans le même répertoire que sapusershim.jar.

Vérifiez également que les bibliothèques de prise en charge native de JCO sont présentes et correctement configurées. Utilisez les instructions d’installation de JCO pour la plate-forme 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 native 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:<chemin de classes>:fatal librfccm.so:échec de l’ouverture:) No such file or directory (Fichier ou répertoire inexistant)

Cette erreur se produit lorsque la bibliothèque de prise en charge RFC native de SAP Java Connector (JCO) librfccm.so est absente 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 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 lorsqu’il est impossible de localiser les composants SAP Java Connector (JCO). Elle se produit généralement si le pilote ou le chargeur distant n’a pas été redémarré après la configuration de JCO. Redémarrez Novell® eDirectoryTM si vous utilisez une configuration locale ou le chargeur distant, pour une configuration distante.

Error connecting to SAP host (Erreur de connexion à l’hôte SAP)

Cette erreur se produit lorsque les informations d’authentification ou de connexion SAP ne sont pas correctement configurées. Vérifiez que les valeurs des options Authentification et Paramètres du pilote sont correctes pour l’authentification auprès du système hôte SAP.

48 Guide d’implémentation du pilote DirXML pour SAP User

Page 49: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

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 des paramètres du pilote ne désigne pas d’emplacement valide dans le système de fichiers. Vérifiez que ce paramètre indique le répertoire du système SAP configuré dans le sous-système SAP ALE pour les résultats des fichiers IDoc.

No connection to remote loader (Aucune connexion au chargeur distant)

Cette erreur se produit lorsque les informations du paramètre de connexion au chargeur distant sont incorrectes. Configurez les informations de connexion qui conviennent pour la connexion distante au système sur lequel s’exécute le chargeur distant.

Authentication handshake failed, Remote Loader message: (Échec d’établissement de connexion pour authentification, message du chargeur distant :) "Invalid loader password". (« 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: (Échec d’établissement de connexion pour authentification :) Received invalid driver object password (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 la corriger, il convient de définir des mots de passe identiques pour les deux objets Pilote.

Aucun fichier IDoc ni document IDoc TRFC n’est généré lors de la création ou de la modification d’un objet SAP User

Vérifiez que les processus ALE et CUA sont correctement configurés et que vous avez correctement entré les données.

Les données Utilisateur sont distribuées au pilote uniquement si CUA a été correctement configuré et si le système logique représentant le pilote est sélectionné pour la distribution sous l’onglet Systems (Systèmes) de la boîte de dialogue SAP User Maintenance (Maintenance des utilisateurs SAP).

Les utilisateurs créés dans SAP ne peuvent pas se loguer au système SAP (CUA en cours d’utilisation)

Lorsque vous créez des utilisateurs dans le système central CUA, vous devez associer manuellement les objets Utilisateur aux systèmes clients auprès desquels ils s’authentifient. Pour ce faire, modifiez l’objet Utilisateur dans la boîte de dialogue SAP User Maintenance (Maintenance des utilisateurs SAP), puis ajoutez un système logique client approprié sous l’onglet Systems (Systèmes). Ce problème ne devrait pas se poser lors de la création d’utilisateurs sur des systèmes CUA non centraux.

Dépannage du pilote 49

Page 50: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Le pilote ne reconnaît pas les fichiers IDoc dans le répertoireCommencez par tester l’interface ALE et CUA. 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é. Vous devez valider le chemin d’accès au répertoire et vous assurer 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 l’accord d’interchange et qu’il se trouve dans les paramètres de sortie du système récepteur.

Si l’interface IDoc réussit :

À l’aide de la transaction SCUA, vérifiez que le modèle de distribution sélectionné est celui qui convient.

À l’aide de la transaction SCUM, vérifiez que la distribution des données du champ User (Utilisateur) est configurée correctement.

Les fichiers IDoc ne sont pas écrits sur le pilote (configuration de port TRFC)Commencez par tester l’interface ALE et CUA. Pour plus d’informations, reportez-vous à votre documentation SAP.

Si les données ne sont pas reçues alors que la distribution des fichiers IDoc réussit :

Vérifiez que le pilote est configuré pour recevoir des données de la passerelle SAP appropriée.

Vérifiez que l’ID de programme du pilote est unique.

À l’aide de la transaction WE21, vérifiez que le port SAP est configuré pour distribuer les données vers le système logique qui représente le pilote.

Si l’interface IDoc réussit :

À l’aide de la transaction SCUA, vérifiez que le modèle de distribution sélectionné est celui qui convient.

À l’aide de la transaction SCUM, vérifiez que la distribution des données du champ User (Utilisateur) est configurée correctement.

Le pilote ne parvient pas à s’authentifier auprès de SAPVérifiez d’abord que vous avez configuré tous les paramètres du pilote et entré tous les bons mots de passe. Si le système SAP est le système central d’une configuration CUA, vérifiez que l’objet Utilisateur employé pour l’authentification est correctement associé au système logique client. Reportez-vous à « Les utilisateurs créés dans SAP ne peuvent pas se loguer au système SAP (CUA en cours d’utilisation) », page 49.

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 31.

50 Guide d’implémentation du pilote DirXML pour SAP User

Page 51: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Erreur lors de l’assignation d’unités au répertoire IDoc Vous pourrez voir l’erreur suivante dans DSTrace si le paramètre de répertoire IDoc spécifie un conteneur de système de fichiers local incorrect ou s’il spécifie un lecteur assigné à 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-UM Channel = publisher Status = fatal Message = <description>SAP Document Poller initialization failed: com.novell.nds.dirxml.driver.sapusershim.SAPDocumentPollerInitFailure: Specified Publisher IDoc Directory is invalid.</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 fichier en dehors de son propre système, y compris le répertoire IDoc.

Dépannage du pilote 51

Page 52: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

52 Guide d’implémentation du pilote DirXML pour SAP User

Page 53: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

A Exemple de document XML reçu du pilote

L’exemple suivant est un document XML typique reçu de la configuration par défaut du pilote.

<nds dtdversion="1.0" ndsversion="8.5"> <source> <product build="20030509_1030" instance="SAP-USER-REMOTE-46C" version="1.0">DirXML Driver for User Management of SAP Software</product><contact>Novell, Inc.</contact> </source> <input xmlns:sapshim="http://www.novell.com/dirxml/drivers/sapusershim"> <modify class-name="US" event-id="O_001_0000000000216097" src-dn="SSAMPLE" timestamp="20030509"> <association>JWriter</association> <modify-attr attr-name="PROFILES:BAPIPROF"> <remove-all-values/> </modify-attr> <modify-attr attr-name="USERNAME:BAPIBNAME"> <remove-all-values/> </modify-attr> <modify-attr attr-name="ACTIVITYGROUPS:AGR_NAME"> <remove-all-values/> </modify-attr> <modify-attr attr-name="PROFILES:BAPIPROF"> <add-value> <value>SAP_ALL</value> <value>SAP_NEW</value> </add-value> </modify-attr> <modify-attr attr-name="USERNAME:BAPIBNAME"> <add-value> <value>JWriter</value> </add-value> </modify-attr> <modify-attr attr-name="ACTIVITYGROUPS:AGR_NAME"> <add-value> <value>SAP_EMPLOYEE</value> </add-value> </modify-attr> </modify> </input></nds>

Exemple de document XML reçu du pilote 53

Page 54: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Quelques caractéristiques à noter :

Tous les documents XML reçus du système SAP 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 dans l’espace de nom SAP (c’est-à-dire, US = Utilisateur). 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 nom 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 (nom_structure_ou_table:nom_attribut).

Comme les attributs à valeurs multiples ne peuvent pas être assignés de façon cohérente entre systèmes, l’élément <remove-all-values> est utilisé avant toutes les balises <add-value>. Cela indique au moteur DirXML qu’il doit supprimer toutes les valeurs existantes de l’attribut avant d’assigner les nouvelles valeurs. Si cette fonction n’est pas souhaitée, il est possible d’utiliser l’une des règles 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 (par exemple, 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 qu’elles le resteront jusqu’à la date maximale de SAP. Tous les segments de données peuvent avoir des tampons horaires de validité différents et/ou postdatés.

Toutes les valeurs sont au format chaîne.

54 Guide d’implémentation du pilote DirXML pour SAP User

Page 55: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

B Notes de configuration et de déploiement

Les informations suivantes peuvent être utiles pour modifier la configuration du pilote ou pour mieux comprendre le comportement du système SAP. Bon nombre d’entre elles concernent les restrictions des valeurs de données dans l’enregistrement Utilisateur. Il est recommandé d’étudier attentivement la configuration du système, certaines valeurs pouvant avoir été modifiées ou étendues par l’administrateur de SAP.

Types d’objet SAP Les types d’objet SAP suivants peuvent être référencés dans les opérations <query> de SAP.

Types d’utilisateur : LOGONDATA:USTYPA - Dialog (A - Boîte de dialogue)

C - Communication (CPIC) (C - Communication [CPIC])

D - System (BDC) (D - Système [BDC])

S - Service

L - Reference (L - Référence)

Options du contrôleur de sorties

USER Type d’objet : US

Activity Groups Type d’objet : AG

Standard Roles Type d’objet : AC

Company Type d’objet : U

User Groups Type d’objet : UG

G - Output immediately (G - Sortir immédiatement) DEFAULTS: SPDB

H - Don’t output immediately (H - Ne pas sortir immédiatement)

DEFAULTS: SPDB

D - Delete after output (D - Supprimer après sortie) DEFAULTS: SPDA

K - Don’t delete after output (K - Ne pas supprimer après sortie)

DEFAULTS: SPDA

Notes de configuration et de déploiement 55

Page 56: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Types de communication : ADDCOMREM:COMM TYPEINT - EMail Address type (SMTP) (INT - Type d’adresse électronique [SMTP])

LET - Letter (Standard Post) (LET - Lettre [courrier postal])

PAG - Pager (PAG - Alphapage)

FAX - Facsimile (FAX - Télécopie)

PRT - Printer (PRT - Imprimante)

RML - Remote Mail (RML - Messagerie distante)

TEL - Telephone (TEL - Téléphone)

TLX - Telex (TLX - Télex)

TTX - Teletex (TTX - Télétexte)

SSF - Secure Store and Forward (SSF - Stockage et transmission sécurisés)

Formats de date : DEFAULTS:DATAFM1. DD.MM.YYYY (JJ.MM.AAAA)

2. MM/DD/YYYY (MM/JJ/AAAA)

3. MM-DD-YYYY (MM-JJ-AAAA)

4. YYYY.MM.DD (AAAA.MM.JJ)

5. YYYY/MM/DD (AAAA/MM/JJ)

6. YYYY-MM-DD (AAAA-MM-JJ)

Formats de décimales : DEFAULTS:DCPFM

Tests assistés par ordinateur (CATT, Computer Aided Test) : DEFAULTS:CATTKENNZ

"X" - The decimal divider is a dot, and the thousands divider is a comma (NN,NNN.NN) ("X" - Le séparateur de décimales est un point et le séparateur des milliers est une virgule [NN,NNN.NN])

"Y" - The decimal divider is a comma, and the thousands divider is a blank (NNN NNN,NN) ("X" - Le séparateur de décimales est une virgule et le séparateur des milliers est un espace [NNN NNN,NN])

" " - The decimal divider is a comma, and the thousands divider is a dot (NN.NNN,NN) (" " - Le séparateur de décimales est une virgule et le séparateur des milliers est un point [NN.NNN,NN])

"X" - CATT: Test status set (CATT : état de test défini)

" " - CATT: Test status not set (CATT : état de test non défini)

"." - CATT: CATT status set (CATT : état CATT défini)

56 Guide d’implémentation du pilote DirXML pour SAP User

Page 57: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Type de commentaire de communication pour les assignations de table

Codes de langue

Table : ADDTEL Type de commentaire : TEL Champ clé : TELEPHONE

Table : ADDFAX Type de commentaire : FAX Champ clé : FAX

Table : ADDPAG Type de commentaire : PAG Champ clé : PAGER

Table : ADDSMTP Type de commentaire : INT Champ clé : E_MAIL

Table : ADDTTX Type de commentaire : TTX Champ clé : TELETEX

Table : ADDPRT Type de commentaire : PRT Champ clé : PRINT_DEST

Table : ADDTLX Type de commentaire : TLX Champ clé : TELEX_NO

Table : ADDRML Type de commentaire : RML Champ clé : R_MAIL

Table : ADDURI Type de commentaire : URI Champ clé : URI

Lange Code à deux lettres Code à une lettre

Afrikaans AF a

Arabe AR A

Bulgare BG W

Tchèque CS C

Danois DA K

Allemand DE D

Grec EL G

Anglais EN E

Espagnol ES S

Estonien ET 9

Finnois FI U

Français FR F

Hébreu HE B

Croate HR 6

Hongrois HU H

Indonésien ID i

Notes de configuration et de déploiement 57

Page 58: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Paramètres de configurationLa longueur du commentaire associé aux paramètres de configuration est limitée à 50 octets.

Italien IT I

Japonais JA J

Coréen KO 3

Lithuanien LT X

Letton LV Y

Malais MS 7

Hollandais NL N

Norvégien NO O

Polonais PL L

Portugais PT P

Roumain RO 4

Russe RU R

Slovaque SK Q

Slovène SL 5

Serbe SR 0 (zéro)

Suédois SV V

Thaïlandais TH 2

Turc TR T

Ukrainien UK 8

Réservé client Z1 Z

Chinois traditionnel ZF M

Chinois ZH 1

Lange Code à deux lettres Code à une lettre

58 Guide d’implémentation du pilote DirXML pour SAP User

Page 59: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Commentaires et notes de conceptionLorsque vous indiquez un nom d’utilisateur ou de société dans un appel BAPI, le champ de nom doit être renseigné en majuscules, même si cette restriction n’est pas spécifiée.

Dans BAPI_USER_CHANGE (table ADDRESS)

L’attribut COMM-TYPE dans SAP a des valeurs définies acceptables. Une entrée incorrecte génère une exception ainsi que le message d’erreur "The communication type <commType> is not defined" (Le type de communication <commType> n’est pas défini). Les champs valides contiennent les abréviations des types de communication pris en charge sur l’hôte SAP.

Les attributs TITLE_ACA1 et TITLE_ACA2 ont des valeurs prédéfinies acceptables. Une entrée incorrecte entraîne la déclaration d’une chaîne nulle ("") pour cette valeur dans SAP.

Les attributs PREFIX1 et PREFIX2 ont des valeurs prédéfinies acceptables. Une entrée incorrecte entraîne la déclaration d’une chaîne nulle ("") pour cette valeur dans SAP.

L’attribut TEL1_NUMBR est lié au numéro de téléphone principal, ou standard, de la table de communication Telephone.

Dans BAPI_USER_CHANGE (table ADDFAX)

L’attribut Facsimile Telephone Number dans eDirectory est un attribut structuré. Une transformation de sortie le convertit au format d’attribut simple.

Dans BAPI_USER_CHANGE (table ADDTEL)

Doit avoir un attribut CONSNUMBER (qui peut être le numéro de celui que vous souhaitez modifier ou tout autre nouveau numéro différent de 000).

Le champ STD_NO doit avoir la valeur X si vous synchronisez un seul champ ou si le numéro est le seul présent.

Le champ de données principal est TELEPHONE. Les numéros de téléphone sont toujours assignés à ADDTELEPHONE si aucun champ n’est spécifié dans l’assignation d’attribut.

Dans BAPI_USER_CHANGE (table ADDTLX)

Par défaut, cette table est assignée à l’attribut Organizational Person; telexNumber. La syntaxe utilisée, OCTET_STRING, est codée par Identity Manager au format Base64. Une fonction Java fournie dans le fichier sapusershim.jar du pilote peut décoder ces données vers un format chaîne approprié dans le cadre de la transformation des sorties avant de les soumettre à SAP. Si vous utilisez le pilote sur un système distant, placez le module d’interface pilote dans le même conteneur de système de fichiers que la bibliothèque DirXML dans le cadre de la transformation d’entrée pour le canal Éditeur.

Le champ de données principal est TELEX_NO.

D’autres règles s’appliquent, comme décrit pour la table ADDTEL.

Dans BAPI_USER_CHANGE (table ADDFAX)

Cette table contient un champ unique, USERGROUP. Il s’agit du champ principal par défaut s’il n’est pas spécifié dans l’assignation.

Le champ de données principal est FAX.

D’autres règles s’appliquent, comme décrit pour la table ADDTEL.

Notes de configuration et de déploiement 59

Page 60: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Dans BAPI_USER_CHANGE (table GROUPS)

Cette table contient un champ unique, USERGROUP. Il s’agit du champ principal par défaut s’il n’est pas spécifié dans l’assignation.

Dans BAPI_USER_CHANGE (structure ALIAS)

Cette table contient un champ unique, USERALIAS. Il s’agit du champ principal par défaut s’il n’est pas spécifié dans l’assignation.

Le champ BAPIALIAS de la structure ALIASX doit prendre la valeur X si la structure ALIAS est modifiée.

Le système SAP garantit l’unicité des noms d’alias parmi tous les utilisateurs. Si une valeur d’alias est déjà assignée à un autre utilisateur, la modification échoue.

Dans BAPI_USER_CHANGE (structure REF_USER)

Cette table contient un champ unique, REF_USER. Il s’agit du champ principal par défaut s’il n’est pas spécifié dans l’assignation.

La valeur spécifiée pour REF_USER doit être un objet Utilisateur existant sur le client SAP et l’indicateur du type Reference User (Utilisateur de référence) doit être configuré avec la valeur Reference (User Type L) (Référence [Type d’utilisateur L]).

Dans BAPI_USER_CHANGE (structure DEFAULTS)

Le champ SPDB accepte uniquement les valeurs G (GO ou Sortir immédiatement), H (Ne pas sortir immédiatement) ou une chaîne nulle "" (qui définit automatiquement la valeur sur H). Toutes les autres valeurs génèrent un message d’erreur. La casse doit être respectée dans ce champ.

Le champ SPDA accepte uniquement les valeurs D (Supprimer après impression), K (Ne pas supprimer après impression) ou une chaîne nulle "" (qui définit automatiquement la valeur sur K). Toutes les autres valeurs génèrent un message d’erreur. La casse doit être respectée dans ce champ.

Le champ KOSTL (Cost center [Centre de coûts]) est automatiquement tronqué à une longueur de 8 octets par le système SAP.

Le champ SPLG ne semble pas utilisé. Toutes les valeurs sont acceptées mais ne sont reliées à aucun attribut affiché dans l’interface SAP.

Le champ START_MENU peut comporter n’importe quelle valeur ne dépassant pas 30 caractères, qu’il existe ou non un menu valide pour la valeur configurée.

Le champ SPLD (Output Controller [Contrôleur de sortie]) accepte uniquement la valeur chaîne nulle ("") ou un périphérique de sortie correct figurant dans la liste déroulante du champ dans l’interface SAP. Les valeurs incorrectes provoquent un message d’erreur.

Le champ LANGU doit être configuré avec l’un des codes de langue à une lettre définis à la section « Codes de langue », page 57 ou avec une chaîne nulle (""). Par défaut, la chaîne nulle spécifie la langue par défaut du système SAP. La casse doit être respectée dans ce champ. Les champs non définis provoquent un message d’erreur.

60 Guide d’implémentation du pilote DirXML pour SAP User

Page 61: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

Dans BAPI_USER_CHANGE (structure LOGONDATA)

Le champ USTYP accepte uniquement les valeurs User Type (Type d’utilisateur) correctes définies à la section « Types d’utilisateur : LOGONDATA:USTYP », page 55 ou une chaîne nulle (""). Toute autre entrée génère une exception ou le message d’erreur "Invalid user type<type>" (Type d’utilisateur <type> incorrect).

Le champ TZONE accepte uniquement les valeurs valides accessibles depuis la liste déroulante de l’interface SAP. Toute autre entrée génère une exception et le message d’erreur "Invalid time zone" (Fuseau horaire incorrect). Le paramètre Time Zone (Fuseau horaire) figure sous l’onglet Defaults (Par défaut) de la boîte de dialogue Display User (Afficher l’utilisateur) du client SAP.

Le champ CLASS représente le paramètre User Group for Authorization Check (Groupe d’utilisateurs pour la vérification d’autorisation) de l’objet Utilisateur. Seuls les champs accessibles depuis la liste déroulante de l’interface SAP sont acceptés. Une entrée incorrecte génère une exception et le message d’erreur "User group <class> does not exist" (La <classe> du groupe d’utilisateurs n’existe pas).

Les valeurs GLTGV (date de début de validité) et GLTGB (date de fin de validité) existent en tant qu’ensemble de données.

Si seule la date de début est définie, BAPI doit également configurer une date de fin (GLTGB) ultérieure sur le même modèle ; toutefois la valeur GLTGB ne doit pas être vérifiée dans la structure LOGONDATA.

La date de début doit toujours être antérieure à la date de fin.

L’entrée d’une date incorrecte génère une exception et le message d’erreur "Invalid time interval: Begin date after end date." (Intervalle de temps incorrect : la date de début est postérieure à la date de fin.)

Dans BAPI_USER_CHANGE (table GROUPS)

Seuls les groupes valides de la table SAP User Groups peuvent être ajoutés à un utilisateur. Une entrée incorrecte génère une exception et le message d’erreur "User group <name> does not exist" (Le <nom> du groupe d’utilisateurs n’existe pas).

Dans BAPI_USER_CHANGE (table ADDCOMREM)

Les champs LANGU et LANGU_ISO sont configurés avec la valeur du paramètre de langue du pilote.

Le champ CONSNUMBER doit correspondre au champ CONSNUMBER des éléments de données de communication associés.

Notes de configuration et de déploiement 61

Page 62: Novell Pilote DirXML pour SAP* User · enregistrements SAP User via l’interface standard SAP BAPI (Business Application Programming Interface). Selon la configuration choisie pour

Novell Confidential Manual (FRA) 28 October 2003

62 Guide d’implémentation du pilote DirXML pour SAP User