SAP Connector (JCo 2)
 | SAP Connector (JCo 2): Ermöglicht die Übermittlung von Daten vom X4 ESB an ein SAP R/3-System. Er ruft einen beliebigen Remote Function Call (RFC) bzw. einen beliebigen BAPI-Funktionsbaustein in einem SAP-System auf. Zudem können IDocs an SAP R/3 versandt werden. |
Eigenschaften (Properties)
| Operation | Bestimmt, welche Operation der Funktions-Adapter durchführt Mögliche Werte: |
Parameter
| Adapter | Hauptklasse des Adapters (nicht verändern!) Mögliche Werte: |
| x4.connectionPoolEnabled | Connection Pooling verwenden |
| x4.connectionPoolUID | ID des Connection Pools. Der SAP-Adapter kann einen bereits existierenden Connection Pool verwenden, wenn dieselben Verbindungsparameter und dieselbe ID des Connection Pools gesetzt wurden. |
| x4.connectionPoolMax | Maximale Anzahl definierter Verbindungen im Connection Pool |
| x4.transactionEnabled | Transaktionale Verarbeitung aktivieren oder deaktivieren. |
| x4.transactionID | Transaktions-ID; alle Operationen des SAP-Adapters innerhalb eines Prozesses werden als eine Transaktion ausgeführt und besitzen dieselbe Transaktions-ID. Der SAP-Adapter kann eine bereits gestartete Transaktion verwenden, wenn sie dieselben Transaktionsparameter und dieselbe Transaktions-ID besitzen. |
| jco.client.client | SAP-spezifischer Parameter: SAP-Mandant |
| jco.client.user | SAP-spezifischer Parameter: Benutzername |
| jco.client.passwd | SAP-spezifischer Parameter: Passwort |
| jco.client.lang | SAP-spezifischer Parameter: Anmeldesprache |
| jco.client.sysnr | SAP-spezifischer Parameter: SAP-System-Nummer |
| jco.client.ashost | SAP-spezifischer Parameter: SAP-Applikations-Server |
| jco.client.mshost | SAP-spezifischer Parameter: SAP-Nachrichten-Server |
| jco.client.gwhost | SAP-spezifischer Parameter: Gateway Host |
| jco.client.gwserv | SAP-spezifischer Parameter: Gateway Service |
| jco.client.r3name | SAP-spezifischer Parameter: R/3-Name |
| jco.client.group | SAP-spezifischer Parameter: Gruppe der SAP-Applikations-Server |
| jco.client.tpname | SAP-spezifischer Parameter: Programm-ID einer externen Server-Anwendung |
| jco.client.tphost | SAP-spezifischer Parameter: Host der externen Server-Anwendung |
| jco.client.type | SAP-spezifischer Parameter: Art des entfernten Hosts Mögliche Werte:
|
| jco.client.trace | SAP-spezifischer Parameter: RFC-Trace Mögliche Werte:
|
| jco.client.codepage | SAP-spezifischer Parameter: Anfängliche Codepage in SAP-Notation |
| jco.client.abap_debug | SAP-spezifischer Parameter: ABAP-Debugging Mögliche Werte:
|
| jco.client.use_sapgui | SAP-spezifischer Parameter: Name einer grafischen SAP-Benutzeroberfläche, die verwendet werden soll |
| jco.client.getsso2 | SAP-spezifischer Parameter: SSO-Ticket nach der Anmeldung erhalten Mögliche Werte:
|
| jco.client.mysapsso2 | SAP-spezifischer Parameter: Name des SAP-Cookies Version 2, der als Anmeldungs-Ticket verwendet werden soll |
| jco.client.x509cert | SAP-spezifischer Parameter: Name des X509-Zertifikats, das als Anmeldungs-Ticket verwendet werden soll |
| jco.client.lcheck | SAP-spezifischer Parameter: Anmelde-Überprüfung beim Öffnen Mögliche Werte:
|
| jco.client.grt_data | SAP-spezifischer Parameter: Zusätzliche Daten für die grafische SAP-Benutzeroberfläche |
| jco.client.use_guihost | SAP-spezifischer Parameter: Host, zu dem die entfernte grafische SAP-Benutzeroberfläche weitergeleitet werden soll |
| jco.client.use_guiserv | SAP-spezifischer Parameter: Dienst, zu dem die entfernte grafische SAP-Benutzeroberfläche weitergeleitet werden soll |
| jco.client.use_guiprogid | SAP-spezifischer Parameter: Programm-ID des Servers, der die entfernte grafische SAP-Benutzeroberfläche startet |
| jco.client.snc_mode | SAP-spezifischer Parameter: Secure network connection (SNC)-Modus Mögliche Werte:
|
| jco.client.snc_partnername | SAP-spezifischer Parameter: SNC-Partner, z. B. p:CN=R3, O=XYZ-INC, C=EN |
| jco.client.snc_qop | SAP-spezifischer Parameter: SNC-Sicherheits-Level Mögliche Werte:
|
| jco.client.snc_myname | SAP-spezifischer Parameter: SNC-Name (überschreibt den Standard-SNC-Partner) |
| jco.client.snc_lib | SAP-spezifischer Parameter: Pfad zu einer Bibliothek, die den SNC-Dienst bereitstellt |
| jco.client.dest | SAP-spezifischer Parameter: R/2-Ziel (destination) |
| jco.client.saplogon_id | SAP-spezifischer Parameter |
| jco.client.extiddata | SAP-spezifischer Parameter: Daten zur externen Authentifizierung (PAS) |
| jco.client.extidtype | SAP-spezifischer Parameter: Art der externen Authentifizierung (PAS) |
Eine vollständige Beschreibung aller (Verbindungs-) Parameter finden Sie in der SAP JCo 2-Dokumentation.
Statuswerte
1 | Die Operation wurde erfolgreich ausgeführt. |
-1 | Die Operation ist aufgrund eines technischen Fehlers fehlgeschlagen. |
RFC/BAPI aufrufen
Input
Der Adapter erwartet ein Input-XML-Dokument nach folgendem Muster, das den entsprechenden Funktionsbaustein ggf. mit Inputdaten und den betroffenen Tabellen aufruft:
<X4SAP>
<bapicall name="BAPI-Name" id="IDoc-ID">
<input>
<INPUT>
<!--Parameter und Parameterwerte -->
</INPUT>
</input>
<table>
<!--Tabellen-->
</table>
</bapicall>
</X4SAP>Beispiel
Um BAPI IDOCTYPE_READ_COMPLETE in SAP aufzurufen, erwartet dieser Adapter folgendes Input-XML-Dokument:
<X4SAP>
<bapicall name="IDOCTYPE_READ_COMPLETE" id="IDoc-ID">
<input>
<INPUT>
<PI_CIMTYP />
<PI_IDOCTYP> <!--IDoc-Typ--> </PI_IDOCTYP>
<PI_RELEASE>SY-S</PI_RELEASE>
<PI_VERSION>3</PI_VERSION>
</INPUT>
</input>
<table>
<TABLES>
<PT_FIELDS>
<SEGMENTTYP />
<FIELDNAME />
<INTLEN />
<EXTLEN />
<FIELD_POS />
<BYTE_FIRST />
<BYTE_LAST />
<ROLLNAME />
<DOMNAME />
<DATATYPE />
<DESCRP />
<ISOCODE />
<VALUETAB />
</PT_FIELDS>
<PT_FVALUES>
<STRNAME />
<FIELDNAME />
<FLDVALUE_L />
<FLDVALUE_H />
<DESCRP />
</PT_FVALUES>
<PT_MESSAGES>
<MESTYP />
<DESCRP />
<IDOCTYP />
<CIMTYP />
<RELEASED />
</PT_MESSAGES>
<PT_SEGMENTS>
<NR />
<SEGMENTTYP />
<SEGMENTDEF />
<QUALIFIER />
<SEGLEN />
<PARSEG />
<PARPNO />
<PARFLG />
<MUSTFL />
<OCCMIN />
<OCCMAX />
<HLEVEL />
<DESCRP />
<GRP_MUSTFL />
<GRP_OCCMIN />
<GRP_OCCMAX />
<REFSEGTYP />
</PT_SEGMENTS>
</TABLES>
</table>
</bapicall>
</X4SAP>IDoc senden
Input
Um ein IDoc an SAP zu senden, ein XML-Dokument wie das folgende als Input für den Adapter verwenden:
<X4SAP>
<X4IDoc type="MATMAS02" description="">
<X4Mandatory>
<X4RecipientPartnerType>LS</X4RecipientPartnerType>
<X4RecipientPartnerNumber>X4_T</X4RecipientPartnerNumber>
<X4RecipientPartnerFunction />
<X4SenderPort>SAPT01</X4SenderPort>
<X4SenderPartnerType>LS</X4SenderPartnerType>
<X4SenderPartnerNumber>ST01_200</X4SenderPartnerNumber>
<X4SenderPartnerFunction />
<X4SenderAddress />
<X4SenderLogicalAddress />
<X4MsgType>
<MSGTYPE>MATMAS02</MSGTYPE>
</X4MsgType>
</X4Mandatory>
<X4Structure>
<MATMAS02>
<IDOC BEGIN="1">
<EDI_DC40 SEGMENT="1">
<TABNAM>EDI_DC40</TABNAM>
<MANDT/>
<DOCNUM/>
<DOCREL/>
<STATUS/>
<DIRECT/>
<OUTMOD/>
<EXPRSS/>
<TEST/>
<IDOCTYP>MATMAS02</IDOCTYP>
<CIMTYP/>
<MESTYP>MATMAS</MESTYP>
<MESCOD/>
<MESFCT/>
<STD/>
<STDVRS/>
<STDMES/>
<SNDPOR>SAPJCOIDOC</SNDPOR>
<SNDPRT>LS</SNDPRT>
<SNDPFC/>
<SNDPRN>JCOCLNT000</SNDPRN>
<SNDSAD/>
<SNDLAD/>
<RCVPOR/>
<RCVPRT>LS</RCVPRT>
<RCVPFC/>
<RCVPRN>TSTCLNT000</RCVPRN>
<RCVSAD/>
<RCVLAD/>
<CREDAT>20050519</CREDAT>
<CRETIM>104537</CRETIM>
<REFINT/>
<REFGRP/>
<REFMES/>
<ARCKEY/>
<SERIAL/>
</EDI_DC40>
<E1MARAM SEGMENT="1">
<MSGFN>005</MSGFN>
<MATNR>BOXCOOKIES</MATNR>
<ERSDA>20020801</ERSDA>
<ERNAM>TIGGER</ERNAM>
<LAEDA/>
<AENAM/>
<PSTAT>KBG</PSTAT>
<LVORM/>
<MTART>FERT</MTART>
<MBRSH>L</MBRSH>
<MATKL>G1113</MATKL>
<BISMT/>
<MEINS>PCE</MEINS>
<BSTME/>
<ZEINR/>
<ZEIAR/>
<ZEIVR/>
<ZEIFO/>
<AESZN/>
<BLATT/>
<BLANZ>000</BLANZ>
<FERTH/>
<FORMT/>
<GROES/>
<WRKST/>
<NORMT/>
<LABOR/>
<EKWSL/>
<BRGEW>0.550</BRGEW>
<NTGEW>0.000</NTGEW>
<GEWEI>KGM</GEWEI>
<VOLUM/>
<VOLEH/>
<BEHVO/>
<RAUBE/>
<TEMPB/>
<TRAGR/>
<STOFF/>
<SPART/>
<KUNNR/>
<WESCH/>
<BWVOR/>
<BWSCL/>
<SAISO/>
<ETIAR/>
<ETIFO/>
<EAN11/>
<NUMTP/>
<LAENG/>
<BREIT/>
<HOEHE/>
<MEABM/>
<PRDHA/>
<CADKZ/>
<ERGEW/>
<ERGEI/>
<ERVOL/>
<ERVOE/>
<GEWTO/>
<VOLTO/>
<VABME/>
<KZKFG/>
<XCHPF/>
<VHART/>
<FUELG/>
<STFAK/>
<MAGRV/>
<BEGRU/>
<QMPUR/>
<RBNRM/>
<MHDRZ/>
<MHDHB/>
<MHDLP/>
<VPSTA>KBG</VPSTA>
<EXTWG/>
<MSTAE/>
<MSTAV/>
<MSTDE/>
<MSTDV/>
<KZUMW/>
<KOSCH/>
<NRFHG/>
<MFRPN/>
<MFRNR/>
<BMATN/>
<MPROF/>
<PROFL/>
<IHIVI/>
<ILOOS/>
<KZGVH/>
<XGCHP/>
<COMPL/>
<KZEFF/>
<RDMHD/>
<IPRKZ/>
<PRZUS/>
<MTPOS_MARA/>
<GEWTO_NEW/>
<VOLTO_NEW/>
<WRKST_NEW/>
<AENNR/>
<MATFI/>
<CMREL/>
<SATNR/>
<SLED_BBD/>
<GTIN_VARIANT/>
<GENNR/>
<SERLV/>
<RMATP/>
<E1MAKTM SEGMENT="1">
<MSGFN>005</MSGFN>
<SPRAS>D</SPRAS>
<MAKTX>Schachtel mit Keksen</MAKTX>
<SPRAS_ISO>DE</SPRAS_ISO>
</E1MAKTM>
<E1MAKTM SEGMENT="1">
<MSGFN>005</MSGFN>
<SPRAS>E</SPRAS>
<MAKTX>Box of cookies</MAKTX>
<SPRAS_ISO>EN</SPRAS_ISO>
</E1MAKTM>
<E1MARCM SEGMENT="1">
<MSGFN>005</MSGFN>
<WERKS>0001</WERKS>
<PSTAT>BG</PSTAT>
<LVORM/>
<BWTTY/>
<MAABC/>
<KZKRI/>
<EKGRP/>
<AUSME/>
<DISPR/>
<DISMM/>
<DISPO/>
<PLIFZ>0</PLIFZ>
<WEBAZ>0</WEBAZ>
<PERKZ>M</PERKZ>
<AUSSS>0.00</AUSSS>
<DISLS/>
<BESKZ>E</BESKZ>
<SOBSL/>
<MINBE/>
<EISBE/>
<BSTMI/>
<BSTMA/>
<BSTFE/>
<BSTRF/>
<MABST/>
<LOSFX/>
<SBDKZ/>
<LAGPR/>
<ALTSL/>
<KZAUS/>
<AUSDT/>
<NFMAT/>
<KZBED/>
<MISKZ/>
<FHORI/>
<PFREI/>
<FFREI/>
<RGEKZ/>
<FEVOR/>
<BEARZ/>
<RUEZT/>
<TRANZ/>
<BASMG/>
<DZEIT/>
<MAXLZ/>
<LZEIH/>
<KZPRO/>
<GPMKZ/>
<UEETO/>
<UEETK/>
<UNETO/>
<WZEIT/>
<ATPKZ/>
<VZUSL/>
<HERBL/>
<INSMK/>
<SSQSS/>
<KZDKZ/>
<UMLMC/>
<LADGR/>
<XCHPF/>
<USEQU/>
<LGRAD/>
<AUFTL/>
<PLVAR/>
<OTYPE/>
<OBJID/>
<MTVFP/>
<PERIV/>
<KZKFK/>
<VRVEZ/>
<VBAMG/>
<VBEAZ/>
<LIZYK/>
<BWSCL/>
<KAUTB/>
<KORDB/>
<STAWN/>
<HERKL/>
<HERKR/>
<EXPME/>
<MTVER/>
<PRCTR/>
<TRAME/>
<MRPPP/>
<SAUFT/>
<FXHOR/>
<VRMOD/>
<VINT1/>
<VINT2/>
<STLAL/>
<STLAN/>
<PLNNR/>
<APLAL/>
<LOSGR/>
<SOBSK/>
<FRTME/>
<LGPRO/>
<DISGR/>
<KAUSF/>
<QZGTP/>
<TAKZT/>
<RWPRO/>
<COPAM/>
<ABCIN/>
<AWSLS/>
<SERNP/>
<STDPD/>
<SFEPR/>
<XMCNG/>
<QSSYS/>
<LFRHY/>
<RDPRF/>
<VRBMT/>
<VRBWK/>
<VRBDT/>
<VRBFK/>
<AUTRU>X</AUTRU>
<PREFE/>
<PRENC/>
<PRENO/>
<PREND/>
<PRENE/>
<PRENG/>
<ITARK/>
<PRFRQ/>
<KZKUP/>
<STRGR/>
<LGFSB/>
<SCHGT/>
<CCFIX/>
<EPRIO/>
<QMATA/>
<PLNTY/>
<MMSTA/>
<SFCPF/>
<SHFLG/>
<SHZET/>
<MDACH/>
<KZECH/>
<MMSTD/>
<MFRGR/>
<FVIDK/>
<INDUS/>
<MOWNR/>
<MOGRU/>
<CASNR/>
<GPNUM/>
<STEUC/>
<FABKZ/>
<MATGR/>
<LOGGR/>
<VSPVB/>
<DPLFS/>
<DPLPU/>
<DPLHO/>
<MINLS/>
<MAXLS/>
<FIXLS/>
<LTINC/>
<COMPL/>
<CONVT/>
<FPRFM/>
<SHPRO/>
<FXPRU/>
<KZPSP/>
<OCMPF/>
<APOKZ/>
<AHDIS/>
<EISLO/>
<NCOST/>
<MEGRU/>
<ROTATION_DATE/>
<UCHKZ/>
<UCMAT/>
</E1MARCM>
<E1MBEWM SEGMENT="1">
<MSGFN>005</MSGFN>
<BWKEY>0001</BWKEY>
<BWTAR/>
<LVORM/>
<VPRSV>S</VPRSV>
<VERPR>0.00</VERPR>
<STPRS>15.50</STPRS>
<PEINH>1</PEINH>
<BKLAS>7920</BKLAS>
<VMVPR/>
<VMVER/>
<VMSTP/>
<VMPEI/>
<VMBKL/>
<VJVPR>S</VJVPR>
<VJVER>0.00</VJVER>
<VJSTP>15.50</VJSTP>
<LFGJA>2002</LFGJA>
<LFMON>08</LFMON>
<BWTTY/>
<ZKPRS/>
<ZKDAT/>
<BWPRS/>
<BWPRH/>
<VJBWS/>
<VJBWH/>
<VVJLB/>
<VVMLB/>
<VVSAL/>
<ZPLPR/>
<ZPLP1/>
<ZPLP2/>
<ZPLP3/>
<ZPLD1/>
<ZPLD2/>
<ZPLD3/>
<KALKZ/>
<KALKL/>
<XLIFO/>
<MYPOL/>
<BWPH1/>
<BWPS1/>
<ABWKZ/>
<PSTAT>BG</PSTAT>
<KALN1>000100126602</KALN1>
<KALNR>000100126603</KALNR>
<BWVA1/>
<BWVA2/>
<BWVA3/>
<VERS1/>
<VERS2/>
<VERS3/>
<HRKFT/>
<KOSGR/>
<PPRDZ/>
<PPRDL/>
<PPRDV/>
<PDATZ/>
<PDATL/>
<PDATV/>
<EKALR>X</EKALR>
<VPLPR>0.00</VPLPR>
<MLMAA/>
<MLAST/>
<VJBKL>7920</VJBKL>
<VJPEI>1</VJPEI>
<HKMAT/>
<EKLAS/>
<QKLAS/>
<MTUSE/>
<MTORG/>
<OWNPR/>
<BWPEI>0</BWPEI>
</E1MBEWM>
</E1MARAM>
</IDOC>
</MATMAS02>
</X4Structure>
</X4IDoc>
</X4SAP>