Professional Documents
Culture Documents
SAP XI 3.0 RDXI30 - Unit4 - AdapterFramework - Detail - V4.
SAP XI 3.0 RDXI30 - Unit4 - AdapterFramework - Detail - V4.
SAP AG
SAP INTERNAL ONLY!
Learning Objectives
adapters Have an impression of the J2EE based Adapter Engine Be familiar with technical aspects of the individual adapters in detail
SAP INTERNAL!
Agenda
1. Overview New J2EE based Adapter Engine/AF/PCK
2. J2EE based Adapter Engine -Installation and Administration Issues 3. Technical Aspects of Individual Technical Adapters - RFC-Adapter in detail - IDoc-Adapter in detail - http-Adapter in detail - File/JMS/JDBC in detail - SOAP-Adapter in detail - MarketSet-Adapter introduction RNIF adapter introduction
SAP INTERNAL!
XI Messaging Service
AF Module Processor R 3
Generic AF modules R Integration Directory R Cache R Runtime Workbench Administratio nal Services Utilities (Threads, Transactions) 6 R
R external protocol 1 R
Configuration Services
7 R Logging API
4R
Integration Repository
8R
SAP INTERNAL!
XI Message
Adapter Framework
Adapter B a c k e n d
J Sender C A
Adapter Receiver
Messaging
Configuration Master
SAP INTERNAL!
End-to-End Monitoring
Adapter Framework
PCK in SAP J2EE Adapter Engine in SAP J2EE
B a c k e n d
IS Runtime
Conf. cache
https://<IntegrationServerURL>
XI Message
Q
https://<AdapterEngineURL> Messaging Configura tion Master Tracing Logging Security
Conf UI
Monitoring Administration
Mon. UI Adm. UI
Configuration Master
Party->Service->Interface
XI 3.0SP1
R Integration Server
XI Messaging Service
AF Module Processor R 3
Generic AF modules R Integration Directory R Cache R Runtime Workbench Administratio nal Services Utilities (Threads, Transactions) 6 R
Connected System e.g. A2A: Siebel, Oracle, Peoplesoft or B2B: UCCnet, CIDX, EDIFact VPN Client
R external protocol
Configuration Services
1 R
7 R Logging API
Integration Repository
Client GUI
R external protocol
4 R 8
SAP INTERNAL!
Overview - Summary
SAP INTERNAL!
Agenda
SAP INTERNAL!
Central AE: uses UME with ABAP (J2EE with Add-In option), i.e. UME of this engine is configured against the coresponding ABAP stack automatically during installation) Decentral AE: uses UME with DB only (default) or UME with ABAP (su01, PFCG; roles visible as groups; CUSTOM INSTALLATION); decision at installation time!
SAP INTERNAL!
SAP INTERNAL!
SLD
1 Change in XI ID 5
3 2
AE CPA Cache
SAP INTERNAL!
SAP INTERNAL!
CPA Cache
SAP INTERNAL!
SAP INTERNAL!
SAP INTERNAL!
SAP INTERNAL!
SAP INTERNAL!
SAP INTERNAL!
SAP INTERNAL!
SXI_CACHE
SAP INTERNAL!
SAP INTERNAL!
SAP INTERNAL!
Messaging System
http://<host>:<port>/MessagingSystem
SAP INTERNAL!
SAP INTERNAL!
SAP INTERNAL!
SAP INTERNAL!
Log Destination
SAP INTERNAL!
SAP INTERNAL!
SAP INTERNAL!
Agenda
SAP INTERNAL!
Message Protocol
Used to select attributes specific to the adapter type Evaluate conditions require defining additional field values
SAP INTERNAL!
J2EE AF (AE/PCK)
XI-SOAP/http RFC
Integration Server
Messaging Modul XI RFC System Processor Adapter XI-SOAP/http JRFC/Jco M1 M.. -lib Mn
RFCServer/Client
RFC
SAP INTERNAL!
SAP INTERNAL!
SAP INTERNAL!
No Call-Back; No RFC-GUI-Debug
No qRFC Just one payload/attachment
No digital signature
Currently:
not released for external system (in test; dedicated RFC-gateway necessary, i.e. this will not be delivered with the J2EE Service) no SNC not several function calls with one TID/ within one LUW (this is also a change to XI 2.0)
SAP INTERNAL!
SAP INTERNAL!
SAP INTERNAL!
Identification obligatory
SAP INTERNAL!
SAP INTERNAL!
Technical fields:
!MANDT: 100 !DOCREL: SNDPOR: WCU !DIRECT: 1 !TABNAM: EDI_DC40 !DOCNUM: 0000000000000001
Interface:
!IDOCTYP: WMTCID02 ZIMTYP: for customer extension !MESTYP: WMTOCO MESCODE:
MESFUNC:
!SNDPRT: LS !SNDPRN: WMUNIT SNDPFC: optional Partner Function !RCVPRT: LS !RCVPRN: SP4CLNT800 RCVPFC: Optional TEST: optional SERIAL: optional
(valid for structure: edi_dc40)
SAP INTERNAL!
party name := IDoc party name party scheme := ALE#party type[#party function] party agency := service
optional party name := business party party scheme := XIParty party agency := http://sap.com/xi/XI/Systems
SAP INTERNAL!
system BCE
party type LI
party function -
BCE
ALR
123
456
8004711
Meyer
DE
LI
LF
-
SAP INTERNAL!
SAP INTERNAL!
mapping
channel definition / identification party role & technical routing RCVPOR * SNDPRN * * SNDPRT * * SNDPFC * RCVPRN RCVPRT RCVPFC
party & interface determination fields of IDoc control record * MESTYP * IDOCTYP CIMTYP
payload modification
SNDPOR MANDT DIRECT CREDATE CRETIME TABNAM STATUS OUTMOD DOCREL ARCKEY
Fields are set by the system runtime, no configuration possible Fields are configured by the administrator, IDoc key fields are marked with an asterix (*)
SAP AG 2003, Holger Kunitz/ 50
SAP INTERNAL!
SAP INTERNAL!
Port not generated automatically out of the end point anymore Fixed namespace urn:sapcom:document:sap:idoc:messages not mandatory, i.e. not checked by the adapter and no
influence on the suggested adapter type in the directory
SAP INTERNAL!
SOAP Adapter
Inbound:
http://<host_and_port>/XISOAPAdapter/MessageServlet?query
SAP INTERNAL!
SOAP Adapter
SOAP adapter enables exchange of SOAP messages between remote clients or Web service servers and the Integration Server
The transport protocol supported by SOAP adapter is HTTP and the message protocol being SOAP 1.1
Choose the Adapter Engine where the SOAP adapter needs to be configured
SAP INTERNAL!
Keep Headers will enable web service header to be included in the XI message Keep Attachments will enable web service attachment to be included in the XI message A true for Encoded headers will encode the header
SAP INTERNAL!
XI Parameters
Interface Namespace Interface Name
Processing Parameters
Best Effort (BE) Exactly Once (EO) Exactly Once In Order (EOIO)
SAP INTERNAL!
SAP INTERNAL!
http-Adapter
Supports EOIO now (URL) Module processor not used Directory: only receiver communication channel necessary Switch for Content Types (e.g. BC-IDoc-XML) hardcoded Unchanged: => http 1.0 => no fault messages/attachments (ignored)
New parameters on the query string (party, agency, scheme, service, Queue ID, QoS EOIO)
SAP INTERNAL!
File Adapter
Type File
Exactly one sender agreement per Communication channel
At least interface name and sender service must be qualified in the sender agreement
SAP INTERNAL!
SAP INTERNAL!
SAP INTERNAL!
Best Effort
EO
EOIO Specify Queue name in this case
Processing Sequence
Operating system command
SAP AG 2003, Holger Kunitz/ 62
SAP INTERNAL!
SAP INTERNAL!
Create Append
Add Timestamp
Add MessageID Add Counter
SAP INTERNAL!
File Encoding
SAP INTERNAL!
JDBC-Adapter
Type JDBC Exactly one sender agreement per Communication channel At least interface name and sender service must be qualified in the sender agreement
SAP INTERNAL!
SAP INTERNAL!
JMS-Adapter
Type JMS Exactly one sender communication channel per Sender-CPA At least interface name and sender service must be qualified in the sender agreement Asynchronous
SAP INTERNAL!
JMS Adapter
To connect Messaging systems to the Integration Engine
Sonic MQ WebSphere MQ JNDI JMS provider lookup JMS provider Objects via file Generic JMS Provider
Message Protocol
JMS 1.x
SAP INTERNAL!
SAP INTERNAL!
SAP INTERNAL!
SAP INTERNAL!
SAP INTERNAL!
If you want to use a transactional JMS session use this setting. Following processing of a message, a transactional session ends either with a COMMIT, or in the case of an error, with a ROLLBACK
SAP INTERNAL!
Entire XMB message to be JMS-payload XMB payload to be the JMS-payload Best Effort (BE) Exactly Once Exactly Once In Order
Specify the Queue ID and Processing J2EE cluster Server (Cluster ID)
Quality of Service
SAP INTERNAL!
Sonic MQ JMS Provider WebSphereMQ (MQ Series) JNDI JMS Provider lookup JMS Provider Administered Objects via File Generic JMS Provider
Message Protocol
JMS 1.x
SAP INTERNAL!
SAP INTERNAL!
SAP INTERNAL!
SAP INTERNAL!
If you want to use a transactional JMS session use this setting. Following processing of a message, a transactional session ends either with a COMMIT, or in the case of an error, with a ROLLBACK
You can also specify the quality of service
Save JMS messages in the JMS provider Do not save JMS messages in the JMS provider
SAP INTERNAL!
SAP INTERNAL!
SAP INTERNAL!
SAP INTERNAL!
XMB.SenderParty
SAP INTERNAL!
2. Add the above jar files into aii_af_jmsproviderlib.sda 3. Deploy the modified aii_af_jmsproviderlib.sda into the J2EE server in a standalone mode using SDM 4. Restart the J2EE server for the change to take effect
SAP INTERNAL!
SAP INTERNAL!
Marketplace Adapter
SAP INTERNAL!
For every adapter it is possible to define generic modules in the module processor: possibility to extend the functionality of the specific adapter Equivalent to the dispatcher classes in the J2SE adapter engine; currently: no direct migration path for this classes from SAP XI 2.0 to XI3.0
If no module is specified in the communication channel explicitly: the default module for the certain adapter is used
SAP INTERNAL!
RFC adapter
File/FTP Adapter JDBC Adapter JMS Adapter ???
localejbs/sap.com/com.sap.all.af.SoapAdapter/xisoapAdapterBe an
SOAP Adapter
localejbs/RNIFModuleListener
RNIF Adapter
SAP INTERNAL!
2)
3)
Assign the key pair to use for the specific SSL port - prequisites: - key pair exists as a private key in the service_ssl view of the keystore service - the SSL provider service is running for each dispatcher and server instance that is to support SSL - follow the instructions in "SAP J2EE 6.30 Administration Manual" page 245
4) Configure client certificates - optional and currently not supported by XI internal communication - configuration described in "SAP J2EE 6.30 Administration Manual" page 275
SAP INTERNAL!
Acknowledgements
Type Sender Receiver
Idoc Adapter
all (*2*)
all (*3*)
RNIF Adapter
Others
3/4 (*4*)
none
1/4 (*5*)
2/4 (*1)
(*1*) Delivery Acks (SysAcks) only (*2*) Per Default the Idoc Adapter requests all Acks. Can be configured if no Acks should be requested (transparent table IDXNOALE) (*3*) If Acks are replied, depends on ALEAUDIT configuration in target system. (*4*) RNIF Adapter always requests positiv und negative SystemAcks and negative ApplicationAcks (*5*) RNIF Adapter supports only positive SystemAcks (*6*) Scenario Proxy IDoc now possible (*7*) Message split and acks: status unknown (except ABAP-proxy)
SAP AG 2003, Holger Kunitz/ 91
SAP INTERNAL!
Adapter Access
SAP J2EE
JCA Container
Mandatory
Message Exchange
XI AF
Java library
Mandatory
3 4
Module Configuration
XI AF XI AF/IB
Optional Mandatory
5 6
XI AF RWB XI AF Util
XI AF XI AF
Optional Mandatory
Logging&Monitoring
XI AF Trace
Java library
Optional
Message Defintion
XI IR Ex.Def.
XI IR
File upload
Optional
SAP INTERNAL!
Stay Tuned!
SAP INTERNAL!
Type XI
SAP AG 2003, Holger Kunitz/ 94
SAP INTERNAL!
Questions?
Thank you!!!
Questions??
SAP INTERNAL!