SAP rel.1.0 : SAP State: Final Date: 03-27-200 Enterprise @pplication Integration Software S.r.l. Sede legale: Via Cola di Rienzo 212-00192 Rome - Italy Tel. +39.06.6864226 Sede operativa: viale Regina Margherita 302 00198 Rome - Italy Tel. +39.06.44291186 Partita IVA 06459481005
DOCUMENT REFERENCES Title SAP Release 1.0 Protocol # 22/C007/FL04 Short description SAP State Final Date 05/1/2005 Written by Gianfranco Iannello, Ciro Romano Approved by Privacy Confidential level. E@I Software S.r.l. contents and graphics copyright SAP - Page 2 / 10
TABLE OF CONTENTS 1 INTRODUZIONE...3 1.1 DEFINITIONS AND ACRONYMS...5 1.2 GENERALITÀ SULL ADAPTER SIO PER SAP PER BEA WEBLOGIC...5 2 DESCRIZIONE JAVA CONNECTOR ARCHITECTURE E WEB SERVICES...7 2.1 WEB SERVICES...7 2.2 JAVA CONNECTOR ARCHITECTURE...7 3 ADAPTER SIO: CARATTERISTICHE TECNICHE...8 3.1 FUNZIONALITÀ SUPPORTATE...8 3.2 ELEMENTI DI SISTEMA...9 3.3 CONFIGURAZIONE...9 3.4 DESTINAZIONI...9 3.5 PIATTAFORME SUPPORTATE...10 1 Introduzione Il SIO (SAP Interface Object) Adapter è un connettore JCA 1.0 compliant, totalmente compatibile con SAP R/3 ed R/4. JCA (Java Connector Architecture) definisce le specifiche per connettere applicazioni J2EE con applicazioni non-java, risorse legacy e pacchetti applicativi, è un tentativo di standardizzazione all'interno di un mercato dominato dalle soluzioni proprietarie quale quello dei prodotti di EAI (Enterprise Application Integration). Definisce un'architettura standard per uniformare l'accesso ad EIS(Enterprise Information System, il sistema che fornisce un infrastruttura di informazioni per una applicazione enterprise) eterogenei all'interno di applicazioni J2EE. JCA è costituita da tre elementi: le API Common Client Interface (CCI), i Resource Adapter ed i System Contracts. SAP - Page 3 / 10
Architettura JCA - CCI definisce un insieme di API per uniformare l'accesso a EIS da parte di applicazioni J2EE. Grazie ad esse non è necessario affrontare un'integrazione ad hoc per ogni tipologia di EIS, analogamente a quanto avviene con JDBC, JNDI e JMS. - Il connettore (Resource Adapter, RA) è il SIOConnector, può essere invocato mediante le API CCI e deve essere istallato (modello plugin) all'interno dell'application Server J2EE, - EIS è il sistema SAP. SAP - Page 4 / 10
1.1 Definitions and Acronyms CCI EAI J2EE JAX-P JNI XML JCA Common Client Interface Enterprise Application Integration Java 2 Enterprise Edition Java Api for XML Processing Java Native Interface extensible Markup Language Java Connector Architetture 1.2 Generalità sull Adapter SIO per SAP per Bea WebLogic L Adapter SIO ci fornisce un mezzo per scambiare dati di business in modo real-time tra il sistema SAP e le altre applicazioni, database, o esterni sistemi di business. L Adapter abilita le applicazioni esterne per il processing con SAP, per applicazioni sia inbound che outbound. SAP - Page 5 / 10
L adapter usa i messaggi XML per abilitare le applicazioni di tipo non SAP per comunicare e cambiare le transazioni con SAP usando uno dei seguenti due metodi: - Event Adapter: le Applicazioni usano questa funzionalità se richiedono l accesso ai dati SAP solo quando avviene un evento di business SAP. SAP - Page 6 / 10
- Request/response: le applicazioni usano questa funzionalità quando devono estrarre dati da SAP, l adapter invia all applicazione un messaggio di risposta nella forma di un documento di tipo XML. L interconnessione del sistema verso SAP è realizzata tramite le API JCO 1.2.4. 2 Descrizione Java Connector Architecture e Web Services 2.1 Web Services I Web Service consentono di effettuare delle chiamate a SAP attraverso Internet o intranet, usando delle versioni specifiche del linguaggio XML che consente allo sviluppatore di specificare i parametri, i metodi di connessione, e le chiamate remote ed immagazzinarle nel repository. A run-time, una persona, una interfaccia, o un altra funzione può leggere tale repository ed invocare automaticamente il servizio. Usando i Web Services si possono usare le funzioni fornite dai providers esterni quando si conoscono le funzioni d interfaccia. 2.2 Java Connector Architecture Java Connector Architecture (JCA) fornisce un modello di componente riutilizzabile per costruire e deployare applicazioni multi-tier che sono piattaforme e vendorindependent. JCA agisce come un tipo di envelope o container che consentirà all adapter di andare in stato di run all interno BEA WebLogic server e connettersi a SAP, ritornando immediatamente il risultato. Il JCA è utile quando il sistema SAP risiede all interno di una intranet locale o è acceduto direttamente. Il JCA implementa il modello di connessioni e transazioni JAVA. JCA richiede che sia deployato fisicamente il resource adapter nel server di una applicazione host per accedere al sistema EIS remoto. SAP - Page 7 / 10
E possibile usare congiuntamente JCA e Web Services, per esempio una applicazione JCA può essere invocata attraverso un Web Service oppure un Web Service può essere implementata all interno del JCA container. 3 Adapter SIO: Caratteristiche tecniche 3.1 Funzionalità supportate - Supporto per l interazione dei messaggi in modo bidirezionale - metadata per costruire gli schema XML ed i Web Services per gestire le richieste all adapter o dati evento. - Supporto di interfacce verso SAP per Remote Function Calls (RFC), Business Application Programming Interfaces(BAPI), e Intermediate Documents (IDoc). SAP - Page 8 / 10
3.2 Elementi di sistema Il sistema è composto da due componenti principali: - SAP Connector: gestisce le richieste da inviare a SAP, sotto forma di chiamate a funzione RFC (sincrone) e richieste di IDOC (asincrone); - SAP Handler: gestisce gli IDOC inviati da SAP e li direziona verso uno o più sistemi. 3.3 Configurazione Il sistema SIO viene configurato attraverso due files di configurazione: Per la Generazione Standard del log generation: con l utilizzo del Log4J con possibile modifica a runtime del livello dei log. Attualmente il framework di logging Log4J è configurato in modo da creare dei file di log "rotativi" in modo che ogni giorno verranno creati dei file di log nuovi nel formato definito nell'appender "LOGGER_FOR_SIO". Per la configurazione del sistema SIO: definisce i parametri di connessione sia del sottosistema SAP Connector (usato per inviare richieste a SAP) che del SAP Handler (che riceve richieste da SAP). 3.4 Destinazioni Sono configurabili tre tipi di destinazioni: - JMS: utilizzate per inviare IDOC verso sistemi che sono sottoscritti a code JMS (Topic o Queue); - FILE: utilizzate per fare debug sui messaggi ricevuti da SAP; - SOAP: utilizzate per comunicare attraverso il protocollo SOAP verso Web Services o simili. SAP - Page 9 / 10
3.5 Piattaforme Supportate Dall Adapter SIO sono supportate le seguenti piattaforme SAP: SAP Web Application Server Version 6.1 and higher. SAP R/3 4.0. SAP Enterprise R/3 4.7. Dall Adapter SIO sono supportate i seguenti sistemi operativi: Windows NT/2000/XP SunOS 5.8 This is the last page of the document. SAP - Page 10 / 10