W4 SAP Connector for Java
Contents
1. j d MA Stedio BL x Fis Goen Adeg ation G n ration Gu he Graer de ant T Center geug de nent X O x briar omgterg Sl Fon are de mut tisation Sep Peremene Order ren 1h X SCH gagno as Supp 964 F a R ap 425 LS rammeanat da tera a d ip Procssrer 1 as ap Adti 3 Zi ego D tes 1 ed Aprtcetera 0 D D B aZ PA CG pot Update SAP AP reuk ath cabo H gt Gh Sap Pordhase Order iren 1 X Ox gt Vases degree X x Proge t Veur wn JL re IL ane JL sue IL ane moteur per g ina Le Proprates da ie procedure arcurt Craie Mano Les Pac Nem Gap Purchene Order coewerts Chaire Ma Local Pec pod Chare Nomo Locws Put HE de riviin ebe Cute Nom Loca Pii mocoa Ent de p c ion ete ere Mano local Pisc Cescrgt an marty Crete Mano iccal Pec rares Chaire Nano Local Pubic 2 zap ciy Chara Nom Loca Pic zt 8 wirken unity Chaire Nano Local Pubic 6 Gpcutes Prorte Fig 2 2 Proc dure de test Cette proc dure ses activit s et ses r les sont disponibles dans le r pertoire docs sap samples du CD ROM D installation Utilisez Process Composer pour les cr er sur le serveur W4 Engine 2 3 2 4 2 4 1 Identification de la BAPI solliciter Pour identifier la BAPI solliciter utilisez les outils standards propos s par SAP tels que le SAP GUI G n ration d un fichier XML mod le La g n ration du fichier XML mod le s effectue dans la console2. lt SAPW4 NAME BAPI REQUIREMENTS CREATE TYPE RFC gt lt IMPORT gt lt FIELD NAME SKIP_ITEMS WITH ERROR gt lt FIELD gt lt IMPORT gt lt TABLES gt lt TABLE NAME REQUIREMENTS ACCOUNT ASSIGNMENT gt lt ROW INDEX 0 gt lt FIELD NAME PREQ NO gt lt FIELD gt lt FIELD NAME PREQ ITEM gt 00000 lt FIELD gt lt FIELD NAME SERIAL NO gt 00 lt FIELD gt lt FIELD NAME DELETE IND gt lt FIELD gt lt FIELD NAME CREATED ON gt 0000 00 00 lt FIELD gt lt FIELD NAME CREATED BY gt lt FIELD gt lt FIELD NAME PREQ QTY gt 0 lt FIELD gt lt FIELD NAME DISTR_PERC gt 0 lt FIELD gt lt FIELD NAME G L ACCT gt lt FIELD gt lt FIELD NAME BUS AREA gt lt FIELD gt lt FIELD NAME COST CTR gt lt FIELD gt lt FIELD NAME PROJ NO gt lt FIELD gt lt FIELD NAME SD DOC gt lt FIELD gt lt FIELD NAME SDOC_ITEM gt 000000 lt FIELD gt lt FIELD NAME SCHED LINE gt 0000 lt FIELD gt lt FIELD NAME ASSET NO gt lt FIELD gt lt EXPORT gt 5 lt FIELD NAME NUMBER gt lt FIELD gt lt EXPORT gt lt SAPW4 gt Sauvegardez ce fichier l aide du menu File Save dans le r pertoire lt WEngine_Home gt connector sap xSapGui request sous le nom BAPI_REQUIREMENTS _CREATE xmi W4 SAP Connector for Java Manuel d utilisation 18 Fermez l onglet result en utilisant le menu File Close Fermez l onglet request en utilisant le menu File Close
3. 25 Adaptation et test du modele Ouvrez le fichier lt W4Engine Home gt connector sap xSapGui request BAPI REQUIREMENTS CREATE xmla l aide du menu File Open Request Dans le cas de cette BAPI conserver l ensemble des champs n est pas n cessaire Pour d terminer les champs a conserver il faut avoir une consid ration double d une part connaitre les champs que l utilisateur va saisir dans la proc dure W4 et d autre part remplir les champs obligatoires lt xml version 1 0 encoding ISO 8859 1 gt lt SAPW4 NAME BAPI_REQUIREMENT_CREATE gt lt TABLES gt lt TABLE NAME REQUIREMENT ITEMS gt lt ROW INDEX 1 gt lt FIELD NAME DOC TYPE gt lt FIELD gt lt FIELD NAME PREQ NAME gt lt FIELD gt lt FIELD NAME PUR GROUP gt lt FIELD gt lt FIELD NAME PURCH ORG gt lt FIELD gt lt FIELD NAME SHORT TEXT gt lt FIELD gt lt FIFLD NAME MATERIAL gt lt FIELD gt lt FIELD NAME PLANT gt lt FIELD gt lt FIELD NAME MAT GRP gt lt FIELD gt lt FIELD NAME QUANTITY gt 0 lt FIELD gt lt FIELD NAME UNIT gt TO lt FIELD gt lt FIELD NAME DELIV_DATE gt 0000 00 00 lt FIELD gt lt FIELD NAME RES REQ ID gt X lt FIELD gt lt FIELD NAME PREQ O gt lt FIELD gt lt FIELD NAME PREQ IT
4. l unit d affichage la date de livraison le montant de la demande Cette tape est assign e l initiateur du dossier BZ ta Poe L tape de mise a jour de SAP est de type automatique puisque c est derri re elle que s ex cute W4 Connectors for SAP Cette tape est assign e en mode Acteur avec la charge de travail la plus faible relativement au contenu de la variable de proc dure sapActor Cette variable doit avoir pour valeur par d faut sapAgent c est dire le nom de l acteur SAP IMPORTANT Lanotification par courrier lectronique doit tre activ e cette tape C est gr ce ce m canisme qu un flux XML va tre g n r et transmis W4 Connectors for SAP Enfin l tape de notification permet a l utilisateur d obtenir le num ro de sa demande d achat dans SAP ou de conna tre le code de l erreur qui est survenue lors de la mise jour de SAP A partir de la il est possible d en d duire les variables de la proc dure label pour l article acheter comments pour le commentaire quantity pour la quantit unity pour l unit d affichage deliveryDate variable de type date pour la date de livraison amount pour le montant de la demande pold pour l identifiant de la demande d achat dans SAP retMessage pour le code retour de l appel SAP sapActor pour l assignation de l tape Mise jour de SAP valeur par d faut sapAgent m MO M m m m m m
5. pazevord userpedt lanyusge en 2sap 4 6 Bx QAP Session Fig 2 6 Requ te de g n ration 1 2 Son contenu est le suivant lt xml version 1 0 encoding ISO 8859 1 gt lt SAPW4 NAME BAPI REQUIREMENTS CREATE TYPE RFC_DEF gt IMPORTANT Tousles messages XML ont pour racine SAPW4 Dans le cadre de la g n ration de mod le de message il suffit de sp cifier deux attributs a la balise SAPW4 NAME et TYPE L attribut NAME contient le nom de la BAPI appeler L attribut TYPE permet de sp cifier s il s agit de l appel la BAPI ou de la demande de g n ration de mod le Dans le premier cas l attribut a la valeur RCF dans le second cas la valeur indiquer est RFC DEF Pour effectuer la g n ration du fichier mod le utilisez le bouton Invoke ua lt 7 version 1 0 encodinye 190 6359 1 7 gt lt SATU4 RANE DATT FEQUISITION_CHEATE TYPE RIT LEF gt CAP Fig 2 7 Requ te de g n ration 2 2 Un nouvel onglet Result appara t Son contenu doit ressembler celui ci il est d pendant de la version du syst me SAP lt xml version 1 0 encoding ISO 8859 1 gt
6. suivants WA Connectors for SAP LS 1 22 a l acteur sapAgent a ler le sapConnector a la console xSapGui Installation des fichiers POUR PROC DER L INSTALLATION DES FICHIERS 1 Copiez le fichier waJavaSapConnector lt zip tar gz gt situ dans le r pertoire insta1l1 du CD ROM d installation dans le r pertoire d installation de W4 Engine 2 D compressez ce fichier dans le r pertoire d installation de W4 Engine en acceptant de remplacer les r pertoires existants Installation du SAP JCo Le SAP JCo se pr sente sous la forme d un fichier zip t l chargeable sur le site de SAP Par exemple la version 2 1 6 du SAP JCo pour plate forme Windows x86 Intel 32 bits se trouve dans un fichier nomm sapjco ntintel 2 1 6 zip Les fichiers n cessaires l utilisation du JCo sont situ s la racine du fichier zip Il s agit d une biblioth que java fichier jar et de deux trois pour les versions ant rieures la version 1 1 biblioth ques syst mes fichiers DLL pour Windows Ces fichiers se nomment s pour les JCo de versions 1 1 ou ant rieures jCO jar librf c32 d11 jRFC11 dllet jRFC12 d11 s pour les versions post rieures la 1 1 sapjco jar librf c32 d1l et sapjcorfc dll Ces fichiers ne sont pas install s par d faut pour des raisons de licence ce qui signifie que le connecteur SAP W4 n est pas utilisable directement La biblioth que JCo Java fichier sapjco jar pour une version 2 1 6 par
7. un commit apr s l appel d une BAPI Certaines BAPI ne fonctionnent pas en auto commit c est dire que si elles sont appel es sans que cela soit suivi d un commit rien ne semble s tre produit sur SAP Pour indiquer a W4 Connectors for SAP qu il doit proc der un commit apr s l appel d une BAPI il faut ajouter l attribut COMMIT yes dans la balise lt SAPW4 gt lt xml version 1 0 encoding ISO 8859 1 gt lt SAPW4 NAME BAPI REQUIREMENT CREATE COMMIT yes TYPE RFC gt 25 Chapitre 2 Cas d utilisation Illustrations Principe de fonctionnement 73 Proc dure de test 14 Console xSAPGui 15 Ouverture d une session dans le xSapGui 1 2 16 Ouverture d une session dans le xSapGui 2 2 16 Requ te de g n ration 1 2 17 Requ te de g n ration 2 2 18 W4 SAP Connector for Java Manuel d utilisation 26 27 Illustrations Acteur sapAgent W4 SAP Connector 7 8 BAPI 12 Console xSapGui W4 SAP Connector 7 Console W4 Java Connectors 8 EXML jar jCO jar jRFC11 dll jRFC12 dll JVM LD_LIBRARY_PATH 7 LIBPATH librfc32 dil NON NN 7 7 W4 SAP Connector for Java Manuel d utilisation Index 28 monitor bat W4 Java Connectors 8 PATH 7 R le jconnector 8 R le sapConnector 9 R le sapConnector W4 SAP Connector 7 R le sapConnectorRole 8 10 SAP 6 SAP Java Connector 6 SAP JCo 7 SAP JCo W4 SAP Connector 6 SAP R 3 12 sapConnector properti
8. AL gt case label value lt FIELD gt lt Division gt lt FIELD NAME PLANT gt 0001 lt FIELD gt lt Groupe de marchandise gt lt FIELD NAME MAT GRP gt 01 lt FIELD gt lt Quantit gt lt FIELD NAME QUANTITY gt case quantity value lt FIELD gt lt UQ gt lt FIELD NAME UNIT gt case unity value lt FIELD gt lt Date de livraison gt lt FIELD d 211 Chapitre 2 Cas d utilisation 26 2 2 7 NAME DELIV DATE gt case deliveryDate value year case deliveryDate value month case deliveryDate value day lt FIELD gt lt Type requisition X gt lt FIELD NAME RES REQ ID gt X lt FIELD gt lt FIELD NAME PREQ NO gt lt FIELD gt lt FIELD NAME PREQ ITEM gt 00010 lt FIELD gt lt FIELD NAME DOC CAT gt lt FIELD gt lt prix valorisation gt lt FIELD NAME C AMT BAPI gt case amount value lt FIELD gt lt unite de prix gt lt FIELD NAME PRICE UNIT gt 1 lt FIELD gt lt ROW gt 7 lt TABLE gt lt TABLES gt lt SAPW4 gt Dans la proc dure SAP Purchase Order le traitement du message du flux XML renvoy par le connecteur SAP a pour effet de terminer la t che Update SAP Il faut donc sauvegarder dans le message envoy W4 Connectors for SAP l identifiant de la t che qu il faudra par la suite terminer C est cela
9. EM gt 00000 lt FIELD gt lt FIELD NAME DOC CAT gt lt FIELD gt lt FIELD NAME C AMT BAPI gt 0 lt FIELD gt lt FIELD NAME PRICE UNIT gt 0 lt FIELD gt lt ROW gt lt TABLE gt lt TABLES gt lt SAPW4 gt Wwe Zu Une fois le fichier pur il est possible de remplir les champs avec des valeurs de test comme le montre l exemple ci dessous Il d montre galement qu il est possible d ajouter des commentaires pour pr ciser la nature de ces champs lt xml version 1 0 encoding ISO 8859 1 gt lt SAPW4 NAME BAPI REQUIREMENT CREATE TYPE RFC gt lt TABLES gt 7 7 lt TABLE NAME REQUIREMENT ITEMS gt lt ROW INDEX 1 gt lt FIELD NAME DOC_TYPE gt NB lt FIELD gt lt type de document gt lt FIELD NAME PREQ NAME gt W4 lt FIELD gt lt Demandeur gt 7 lt FIELD AME PUR_GROUP gt 001 lt FIELD gt lt groupe acheteur gt lt FIELD NAME PURCH ORG gt lt FIELD gt ua 19 Chapitre 2 Cas d utilisation re lt organisation d achats gt lt FIELD NAME SHORT TEXT gt Ceci est une d achat lt FIELD gt lt D signation gt lt FIELD NAME MATERIAL gt chaise lt FIE
10. LD gt lt Material gt lt FIELD NAME PLANT gt 0001 lt FIELD gt lt Division gt lt FIELD NAME MAT GRP gt 01 lt FIELD gt lt Groupe de marchandise gt lt FIELD NAME QUANTITY gt 10 lt FIELD gt lt Quantit gt lt FIELD NAME UNIT gt TO lt FIELD gt lt UQ gt lt FIELD NAME DELIV DATE gt 2002 12 24 lt FIELD gt lt Date de livraison gt lt FIELD NAME RES REQ ID gt X lt FIELD gt lt Type requisition X gt lt FIELD NAME PREQ NO gt lt FIELD gt lt FIELD NAME PREQ ITEM gt 00010 lt FIELD gt lt FIELD NAME DOC_CAT gt lt FIELD gt lt FIELD NAME C AMT BAPI gt 1000 lt FIELD gt lt prix valorisation gt lt FIELD NAME PRICE UNIT gt 100 lt FIELD gt lt unite de prix gt lt ROW gt lt TABLE gt lt TABLES gt lt SAPW4 gt Ce fichier est ex cutable dans le xSapGui par le biais du bouton Invoke 2 6 Introduction du dynamisme demande Il s agit ici de remplacer les valeurs de test par les valeurs qui seront saisies par l utilisateur dans l interface web En d autres termes il faut utiliser le langage W4 pour rendre le flux XML dynamique lt xml version 1 0 encoding ISO 8859 1 gt lt SAPW4 NAME BAPI REQUIREMENT CREATE gt lt TABLES gt lt TABLE NAME REQUIREMENT ITEM
11. ML dans le cadre de la proc dure SAP Purchase Order Elle transforme le flux XML en un appel l API XML ENDTASK Elle passe en param tres de cet appel les donn es suivantes retourn es par SAP num ro SAP de la demande d achat dans la variable POID a laconcat nation de tous les messages d erreur dans la variable RETMESSAGE Test Pour cr er un dossier partir de la proc dure Sap Purchase Order utilisez l interface classique de W4 Engine disponible l adresse http lt serverName gt W4Public index html Dans le menu de navigation cliquez sur l ic ne workflow classique Puis dans le menu de gauche de l cran suivant cliquez sur le lien dossier Appuyez ensuite sur le bouton cr er dans le menu sup rieur Dans le formulaire qui vous sera alors pr sent donnez comme valeur Sap Purchase Order au champ proc dure puis cliquez sur le bouton Cr er un dossier et d marrer la t che initiale 3 29 L cran de saisie de la demande d achat est alors g n r Remplissez les champs du formulaire puis cliquez sur le bouton Terminer Utilisez ensuite le moniteur du serveur de connecteurs pour suivre l ex cution du traitement Pour plus de d tails sur le moniteur du serveur de connecteurs veuillez consulter le Manuel d utilisation de W4 Connectors for Java Une fois ce traitement termin vous devriez avoir une nouvelle t che dans votre corbeille intitul e SAP result notification Utilisation avanc e d clencher
12. S gt lt ROW INDEX 1 gt lt type de document gt lt FIELD NAME DOC_TYPE gt NB lt FIELD gt lt Demandeur gt lt FIELD NAME PREQ NAME gt W4 lt FIELD gt lt groupe acheteur gt lt FIELD NAME PUR GROUP gt 001 lt FIELD gt lt organisation d achats gt lt FIELD NAME PURCH ORG gt lt FIELD gt lt D signation gt lt FIELD NAME SHORT TEXT gt case comments value lt FI lt Material gt lt FIELD NAME MATERIAL gt case label value lt FIELD gt lt Division gt lt FIELD NAME PLANT gt 0001 lt FIELD gt lt Groupe de marchandise gt lt FIELD NAME MAT GRP gt 01 lt FIELD gt lt Quantit gt W4 SAP Connector for Java Manuel d utilisation ELD gt 20 lt FIELD NAME QUANTITY gt case quantity value lt FIELD gt lt UQ gt lt FIELD NAME UNIT gt case unity value lt FIELD gt lt Date de livraison gt lt FIELD NAME DELIV DATE gt case deliveryDate value year case deliveryDate value month case deliveryDate value day lt FIELD gt lt Type requisition X gt lt FIELD NAME RES REQ ID gt X lt FIELD gt lt FIELD NAME PREQ NO gt lt FIELD gt lt FIELD NAME PREQ ITEM gt 00010 lt FIELD gt lt FIELD NAME DOC CAT gt lt FIELD gt lt prix valorisatio
13. W4 SAP CONNECTOR FOR JAVA Les prochain Se een ont disponibles www myw4 W4 SAP CONNECTOR FOR JAVA MANUEL D UTILISATION R f rence W4SC_USER_020 FR 2006 2010 W4 Tous droits r serv s L acquisition du pr sent document conf re un droit d utilisation incessible non exclusif et personnel et non un droit de propri t L utilisation la copie la reproduction et la distribution du pr sent document sont permises a condition 1 que la mention de droits d auteur ci dessus figure sur toutes les copies et que cette mention de droits d auteur et la pr sente mention d autorisation apparaissent conjointement 2 que le pr sent document ne soit utilis qu des fins d information et non commerciales 3 que le pr sent document ne soit modifi de quelque mani re que ce soit Tous les produits et marques cit s sont la propri t de leurs titulaires respectifs Les informations contenues dans ce document pourront faire l objet de modifications sans pr avis Sommaire Installation et mise a jour Conditions pr alables 6 Installation 6 Installation des fichiers 7 Installation du SAP JCo 7 Acteurs et r les W4 Engine 8 Test de l installation 8 Configuration 8 Mise jour 9 Cas d utilisation Principe de fonctionnement 12 Pr sentation de la proc dure de test 13 Identification de la BAPI solliciter 15 G n ration d un fichier XML mod le 15 Ouverture d une session dans le xSapGui 15 La requ te
14. de g n ration 17 Adaptation et test du mod le 19 Introduction du dynamisme 20 V hiculer des r f rences crois es 21 Sauvegarde du fichier sur le serveur W4 Engine 22 Traitement du message retour via des feuilles de style XSL 22 Test 23 W4 SAP Connector for Java Manuel d utilisation 4 5 Utilisation avanc e d clencher un commit apr s l appel d une BAPI 24 Sommaire Installation et mise jour Ce chapitre pr sente les conditions pr alables l installation et l utilisation de W4 Connectors for SAP ainsi que les tapes d installation de mise a jour et de configuration Conditions pr alables Pour installer et utiliser W4 Connectors for SAP vous devez disposer d un moteur W4 Engine op rationnel de version 6 0 ou ult rieure disposer d un serveur de connecteurs Java W4 op rationnel de version 6 0 ou ult rieure disposer d une version du SAP Java Connector JCo adapt e la version de SAP cibl e ainsi qu la plate forme ex cutant le serveur de connecteurs Java WA tre en mesure d acc der un syst me SAP version 4 5D ou sup rieur disposer d un utilisateur SAP pouvant ex cuter des appels RFC conna tre le fonctionnement des BAPI avoir install le JCo de SAP sur le serveur W4 Engine avoir la connaissance du langage W4 avoir la connaissance des API XML de W4 Engine avoir la connaissance de XSL et XSLT Installation Le programme d installation installe les l ments
15. er W4 Connectors for SAP pour l utilisation d une BAPI ou d une fonction Mise jour Fichiers POUR PROC DER LA MISE JOUR DES FICHIERS 1 Effectuez une sauvegarde du r pertoire lt W4Engine Home gt connector et surtout du fichier lt W4Engine Home gt connector lib resources sapConnector properties contenant la configuration en cours de W4 Connectors for SAP 2 Copiez le fichier w4davaSapConnector lt zip tar gz gt dans le r pertoire d installation de W4 Engine 3 D compressez ce fichier en acceptant de remplacer les r pertoires et fichiers existants ICE Une installation existante ayant a priori un JCo fonctionnel et bien configur il n est pas n cessaire de configurer a nouveau cette partie Dans le cas contraire veuillez vous reporter a la section 1 2 2 Installation du SAP JCo page 7 Configuration du serveur de connecteurs Java W4 Veuillez vous reporter a la section Serveur de connecteurs Java W4 sous 1 3 Configuration page 8 Configuration du connecteur XML W4 Veuillez vous reporter a la section Connecteur XML W4 sous 1 3 Configuration page 8 Restaurer la configuration ant rieure du connecteur SAP W4 Remplacez le fichier lt W4Engine Home gt connector lib resources sapConnector properties par la version pr c dente sauvegard e lors de l tape de mise jour des fichiers sous Fichiers page 9 IMPORTANT Le nom du r le utilis par d faut par les acteurs cr s pour utilise
16. es 8 9 sapjco jar 7 8 sapjco ntintel 2 1 6 zip 7 sapjcorfc dil 7 W4 Java Connectors console 8 W4 SAP Connector installation 6 W4 SAP Connector mettre a jour 9 W4 SAP Connector principe de fonctionnement 12 xalan jar 8 xerces jar 8 xml langue W4 Java Connectors 8 xsapkernel jar 8 2 Index W4 SAP CONNECTOR FOR JAVA MANUEL D UTILISATION R f rence W4SC_USER_020 FR Pour toute remarque ou suggestion concernant ce document vous pouvez contacter le support technique W4 en pr cisant la r f rence du document par le service de traitement des dossiers Supportflow sur MyW4 com l adresse suivante http support myw4 com a Par courrier lectronique support w4global com a Par t l phone 33 0 820 320 762
17. exemple doit tre plac e dans le r pertoire lt W4Engine HOME gt connector lib Les deux ou trois biblioth ques li es la plate forme 1ibrfc32 d11 et sapjcorfc d1l1 pour la version 2 1 6 par exemple doivent tre copi es dans le r pertoire lt W4Engine Home gt connector lib native Afin que ces biblioth ques syst mes soient utilisables elles doivent tre d clar es dans l environnement utilisateur Le r pertoire lt W4Engine Home gt connector lib native doit donc tre ajout la variable d environnement PATH sous Windows LD_LIBRARY_PATH sous Solaris et Linux et LIBPATH sous AIX IMPORTANT Tenterde d clarer ces eg he e par l emploi du java library path de la JVM ne fonctionnera pas En effet librfc32 dil sera trouv e MS pas sapjcorfc dil L unique solution pr conis e par SAP est l environnement utilisateur BZ 1 28 1 2 4 La Acteurs et roles W4 Engine DANS L INTERFACE D ADMINISTRATION DE W4 ENGINE 1 Cr ez un nouveau r le sapConnectorRole 2 Cr ez un nouvel acteur sapAgent avec pour mot de passe sapAgent peut tre chang via le fichier sapConnector properties et pour langue xm1Assignez l acteur xmlAgent les r les suivants jconnector et sapConnectorRole Test de l installation POUR TESTER LE BON FONCTIONNEMENT DE L INSTALLATION 1 Lancez la console du serveur de connecteurs monitor bat 2 V rifiez qu une ligne sapConnector apparait 3 V rifiez qu aucun message d erre
18. ion ind pendamment de leurs multiples syst mes d information et de capitaliser sur les investissements existants W4 Connectors for SAP a la capacit d appeler toute BAPI ou fonction SAP Les correspondances entre les donn es de W4 Engine et les donn es de SAP sont d crites dans des mod les XML g n rables la vol e Son principe de fonctionnement est le suivant 2 2 The W4 Engine sends the aml file when atak is roned for SAP actor Wa SAP Connector reads the ami file and cals the SAP Jiwa Connecter The java structure j cent back by the KO is turn into XML HWA XML AM Fig 2 1 Principe de fonctionnement alt chats The XML Connector applies an XSL File to the smi result dara in order to tum it into W4 XML APIs Il est recommand d utiliser W4 Connectors for SAP pour l criture de donn es dans SAP Pour la lecture de donn es et leurs affichages dans des pages JSP ou ASP SAP recommande de r pliquer les donn es SAP dans un syst me de gestion de base de donn es Pr sentation de la proc dure de test La proc dure de test Sap Purchase Order comporte cinq noeuds un noeud de d but un noeud de saisie de la demande d achat un noeud de mise jour de SAP un noeud de notification un noeud de fin A l tape de saisie de la demande d achat l utilisateur saisit les donn es suivantes le num ro de l article un commentaire facultatif la quantit
19. n gt lt FIELD NAME C AMT BAPI gt case amount value lt FIELD gt lt unite de prix gt lt FIELD NAME PRICE UNIT gt 1 lt FIELD gt lt ROW gt lt TABLE gt lt TABLES gt lt SAPW4 gt Dans l exemple ci dessus les valeurs de test sont remplac es par le contenu de variables de dossier 261 V hiculer des r f rences crois es L int gration entre W4 Engine et SAP suppose pour que ces deux applications dialoguent qu elles partagent au moins une r f rence crois e C est ce m canisme qui permet W4 Engine de savoir a quoi doit tre corr l e la r ponse fournie par SAP lt xml version 1 0 encoding ISO 8859 1 gt lt SAPW4 NAME BAPI REQUIREMENT CREATE gt lt CONTEXT gt lt TASKID gt TASKID lt TASKID gt lt CONTEXT gt lt TABLES gt lt TABLE NAME REQUIREMENT ITEMS gt lt ROW INDEX 1 gt 7 lt type de document gt lt FIELD NAME DOC TYPE gt NB lt FIELD gt lt i Demandeur gt lt FIELD NAME PREQ NAME gt W4 lt FIELD gt lt groupe acheteur gt lt FIELD NAME PUR GROUP gt 001 lt FIELD gt lt organisation d achats gt lt FIELD NAME PURCH ORG gt lt FIELD gt lt D signation gt lt FIELD NAME SHORT TEXT gt case comments value lt FIELD gt lt Material gt lt FIELD NAME MATERI
20. que sert la balise lt CONTEXT gt Sauvegarde du fichier sur le serveur W4 Engine Sauvegardez ce fichier sous le nom sapPo update xml1 html et placez le dans le r pertoire lt W4Engine Home gt Activities Le nom de ce fichier correspond au nom de l activit associ e au noeud Update SAP de la proc dure Sap Purchase Order Sa double extension est due au fait que l acteur sapAgent a pour langue xm1 Traitement du message retour via des feuilles de style XSL W4 Connectors for SAP transforme le flux XML en appel SAP puis s rialise les objets r sultats sur un nouveau flux XML voir fonctionnement g n ral ci dessus Ce flux XML est interpr t par le connecteur XML Dans le cas de W4 Connectors for SAP le flux transf r au connecteur XML ne correspond pas au format des API XML de W4 Engine Il faut donc le transformer dans ce format C est ce que permettent de faire les feuilles de style XSL Le connecteur XML offre la possibilit d appliquer une feuille de style au message XML qu il re oit et cela bien s r avant qu il ne lance son interpr tation Les feuilles de style sont stock es dans le r pertoire lt W4EngineHome gt connector xm1l xs1 Elles doivent respecter la convention de nommage suivante lt nomActeurXML gt xsl Si par exemple un message XML est re u de l acteur sapAgent le connecteur XML v rifiera la pr sence d une feuille de style nomm e sapAgent xs1 28 Si aucune feuille de style n est t
21. r le connecteur SAP a chang partir de la version 1 3 Ainsi si vos acteurs utilisaient le r le sapConnector il faut modifier ou ajouter le cas ch ant la cl lt instance_name gt w4 role dans le fichier lt Waengine _Home gt connector lib resources sapConnector properties et lui donner la valeur sapConnector Ce r le nomm sapConnector par d faut pour les versions 1 2 et ant rieures est nomm sapConnectorRole par d faut pour les versions 1 3 et sup rieures En effet cette cl donne le r le que le connecteur SAP W4 va exiger des acteurs SAP afin d accepter leurs messages 11 Chapitre 1 Installation et mise jour 2 Cas d utilisation L objectif ici est de cr er une proc dure de test simple qui permettra de passer des demandes d achat dans SAP depuis W4 Engine La d marche sera la suivante s identification de la BAPI que l on souhaite solliciter travers le connecteur s g n ration d un fichier XML mod le a adaptation du mod le ses besoins et test a introduction du dynamisme g n ration dynamique du flux XML a mise au point de la feuille de style XSL qui sera appliqu e au message XML retourn par SAP a test Principe de fonctionnement W4 Connectors for SAP ouvre la communication avec tous les objets m tiers de SAP R 3 En fournissant un environnement de travail simple et intuitif adapt l e business il permet aux entreprises de faire voluer leurs processus de gest
22. rouv e le connecteur XML interpr tera directement le message XML Cela provoquera immanquablement une erreur dans le cas ou le flux a t mis par W4 Connectors for SAP lt xml version 1 0 gt lt xsl stylesheet version 1 0 xmlns xsl http www w3 org 1999 XSL Transform gt lt xsl template match gt lt WFMESSAGE gt lt TASKREF gt lt ID gt lt xsl value of select SAPW4 CONTEXT TASKID gt lt ID gt lt TASKREFMETHOD gt lt ENDTASK gt lt TVARIABLE gt lt POID gt lt STRING gt lt xsl value of select SAPW4 EXPORT FIELD NAME NUMBER gt lt STRING gt POID gt RETMESSAGE gt lt STRING gt lt xsl value of select SAPWA TABLES URN ROW FIELD NAME MSG TEXT gt l value of select SAPW4 E RETURN ROW LDS z alue of select SAPW4 E RETURN ROW _NO gt lt STRING gt lt RETMESSAGE gt lt TVARIABLE gt lt ENDTASK gt lt TASKREFMETHOD gt lt TASKREF gt lt WFMESSAGE gt lt xsl template gt TABLE NAME msg id lt x E T Z TABLES TABLE FIELD NAME msd no lt xs TABLES TABLE FIELD NAME 2 ZearKeaNn DW ve D lt AP Wel Q lt xsl stylesheet gt La feuille XSL ci dessus permet de traiter le message envoy au connecteur X
23. ur n a t consign dans les fichiers journaux du serveur de connecteurs Java W4 Pour plus de d tails sur la console monitor bat veuillez consulter le Manuel d utilisation de W4 Connectors for Java Configuration Serveur de connecteurs Java W4 Une configuration du serveur de connecteurs Java W4 est n cessaire afin de pouvoir utiliser W4 Connectors for SAP Cette configuration s effectue dans le fichier w4server cfg r f rencez s ils ne le sont pas d j les fichiers sapj co jar xsapkernel jar et EXML jar au niveau de la cl lt instance_name gt java_classpath Typiquement on ajoutera a cette cl les l ments suivants s lt W4Engine_Home gt connector lib EXML jar lt W4Engine_Home gt connector lib xsapkernel jar a lt W4Engine_Home gt connector lib sapjcojar Connecteur XML W4 Afin d viter des incompatibilit s avec les java endorsed dirs Java il faut effectuer les op rations suivantes si cela n est pas d j fait d placez dans le r pertoire lt W4Engine Home gt connector lib endorsed les fichiers xalan jar et xerces jar situ s dans le r pertoire lt W4Engine Home gt connector lib s modifiezla cl lt instance_name gt java_classpathdu fichier w4server cfgafin de mettre jour le nouveau r pertoire de ces deux fichiers A ce stade le connecteur SAP W4 est fonctionnel d s le prochain red marrage du serveur de connecteurs Java W4 Connectors for SAP Il est n cessaire de configur
24. xSAPGui 2 SAP Connector Cent Bic x tot Fig 2 3 Console xSAPGui Cet utilitaire est situ dans le r pertoire lt W4Engine Home gt connector sap Pour lancer la console double cliquez sur xSapGui bat si vous utilisez un poste Windows ou sur xSapGui sh si vous tes sur un poste Unix Ouverture d une session dans le xSapGui Ouvrez le fichier lt W4Engine Home gt connector sap xSapGui session mySession xml Pour cela dans xSapGui s lectionnez File Open SAP Session a Fig 2 4 Ouverture d une session dans le xSapGui 1 2 Son contenu est le suivant lt SAPSession hostname sapHost systemnumber 00 client 300 userid userw4 password userpwd language en gt sap 4 6 B lt SAPSession gt Pour chaque attribut de la balise SAPSession indiquez les valeurs correspondant votre syst me SAP larposge en gt sap 4 6 Bc SAAR Session Fig 2 5 Ouverture d une session dans le xSapGui 2 2 W4 SAP Connector for Java Manuel d utilisation 16 2 4 2 Pour lancer ensuite la connexion s lectionnez le bouton Connect La requ te de g n ration Ouvrez le fichier lt W4Engine Home gt connector sap xSapGui request BAPI REQUIREMENTS CREATE DEF xml Pour cela ouvrez xSapGui et s lectionnez File Open Request 22 SAP Commocter Cont Jeg Fe He J l ve ei Oren k Eat d Akt Session 2 hortrame rapticat oystemmmber 00 clients 300 aseride asered
Download Pdf Manuals
Related Search