Ka\u017cde z nich zostanie w kr\u00f3tkiej formie opisane w dalszej cz\u0119\u015bci postu, aby og\u00f3lnie przybli\u017cy\u0107 Tobie, drogi czytelniku, jakie warianty s\u0105 mo\u017cliwe do zastosowania podczas prac integracyjnych.<\/p>\n\n\n\n
Na samym pocz\u0105tku musimy, tak\u017ce pami\u0119ta\u0107 na jakiej wersji SAP b\u0119dziemy dokonywali takiego po\u0142\u0105czenia. Czy b\u0119dzie to SAP Business One, SAP B1 on HANA, SAP ECC, ECC on HANA, S\/4 HANA itd.<\/p>\n\n\n\n
![\"sap](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/09\/sap-300x300-1.png\")
<\/a><\/figure><\/div>\n\n\n\nKa\u017cde z rozwi\u0105za\u0144 przewiduje swoje podej\u015bcie do poruszanego tematu. Niekt\u00f3re mog\u0105 by\u0107 wykorzystywane zamiennie na r\u00f3\u017cnych wersjach jak np. modu\u0142y RFC albo oDATA na systemie S\/4 HANA, jednak nale\u017cy pami\u0119ta\u0107 aby dane rozwi\u0105zania dobiera\u0107 zgodnie z zastosowaniem.<\/p>\n\n\n\n
1. Mechanizm wysy\u0142ania plik\u00f3w przez modu\u0142y RFC<\/h3>\n\n\n\n
Jest to pierwsza i jedna z prostszych oraz bardzo podstawowych metod przesy\u0142ania danych na zewn\u0119trzne dyski, sk\u0105d integrowane systemy pobieraj\u0105 dane w postaci plik\u00f3w w formatach np. CSV, XML, itd. Do tego celu s\u0105 nam potrzebne takie mechanizmy jak np. modu\u0142 RFC uruchamiaj\u0105cy polecenie systemowe zapisane w transakcji SM69.<\/p>\n\n\n\n
- Jak RFC wygl\u0105da w SAP?<\/li><\/ul>\n\n\n\n
Przyk\u0142adowy modu\u0142 RFC:<\/strong><\/p>\n\n\n\n
![\"modul](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/09\/modul-rfc-1.jpg\")
<\/a><\/figure><\/div>\n\n\n\nPrzyk\u0142adowe u\u017cycie modu\u0142u RFC:<\/strong><\/p>\n\n\n\n
![\"przykladowe](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/09\/przykladowe-uzycie-rfc-1.jpg\")
<\/a><\/figure><\/div>\n\n\n\nGrafika prezentuj\u0105ca, kt\u00f3re polecenie z transakcji SM69 zosta\u0142o wywo\u0142ane przez modu\u0142 RFC:<\/strong><\/p>\n\n\n\n
![\"zewnetrzne](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/09\/zewnetrzne-polecenie-systemu-operacyjnego-1.jpg\")
<\/a><\/figure><\/div>\n\n\n\nPolecenie musi by\u0107 zrozumia\u0142e przez system operacyjny, na jakim jest zainstalowana instancja SAP. Dodatkowo potrzebujemy adres IP serwera na kt\u00f3ry b\u0119dziemy wysy\u0142ali pliki oraz, je\u017celi jest to wymagane, nazw\u0119 u\u017cytkownika oraz has\u0142o lub czasami jeszcze klucz identyfikacyjny dla uwierzytelnienia swojego dost\u0119pu do danego dysku sieciowego.<\/p>\n\n\n\n
Dzi\u0119ki takiemu mechanizmowi mo\u017cemy bez wi\u0119kszych problem\u00f3w wysy\u0142a\u0107 pliki na zewn\u0119trzne no\u015bniki danych. W przypadku systemu operacyjnego Linux, mo\u017cemy tego dokona\u0107 np. za pomoc\u0105 takich polece\u0144 systemowych jak:<\/p>\n\n\n\n
- FTP<\/li>
- SFTP<\/li>
- CURL<\/li><\/ul>\n\n\n\n
Og\u00f3lne zasady dzia\u0142ania modu\u0142\u00f3w RFC<\/h4>\n\n\n\n
Co to jest RFC?<\/strong><\/p>\n\n\n\n
RFC (ang. Remote Function Call) to protok\u00f3\u0142 SAP do obs\u0142ugi komunikacji mi\u0119dzy systemami w celu uproszczenia powi\u0105zanego programowania. Jest to proces wywo\u0142ywania modu\u0142u funkcyjnego, kt\u00f3ry znajduje si\u0119 na innej maszynie ni\u017c program wywo\u0142uj\u0105cy. RFC mog\u0105 by\u0107 u\u017cywane do wywo\u0142ywania innego programu na tej samej maszynie, ale zwykle jest u\u017cywane, gdy \u201e wywo\u0142uj\u0105ce \u201d i \u201e wywo\u0142ywane\u201d modu\u0142y\/programy funkcyjne, dzia\u0142aj\u0105 na osobnych maszynach.<\/p>\n\n\n\n
Graficzna prezentacja przep\u0142ywu danych:<\/p>\n\n\n\n
![\"przeplyw](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/09\/przeplyw-danych-1.jpg\")
<\/a><\/figure><\/div>\n\n\n\nW systemach SAP, interfejsy RFC s\u0142u\u017c\u0105 do zestawiania po\u0142\u0105cze\u0144 RFC mi\u0119dzy r\u00f3\u017cnymi systemami SAP, a tak\u017ce mi\u0119dzy systemem SAP a systemem zewn\u0119trznym (innym ni\u017c SAP).<\/p>\n\n\n\n
RFC sk\u0142ada si\u0119 z dw\u00f3ch interfejs\u00f3w:<\/p>\n\n\n\n
- Interfejs wywo\u0142uj\u0105cy dla program\u00f3w ABAP<\/li>
- Interfejs wywo\u0142uj\u0105cy dla program\u00f3w innych ni\u017c SAP.<\/li><\/ul>\n\n\n\n
Ka\u017cdy program napisany w j\u0119zyku ABAP mo\u017ce korzysta\u0107 z modu\u0142\u00f3w RFC, po przez u\u017cywanie komendy CALL FUNCTION\u2026DESTINATION<\/strong>.<\/p>\n\n\n\n
- Istotne wiadomo\u015bci na temat modu\u0142\u00f3w RFC:<\/strong>
- SAP u\u017cywa protoko\u0142u CPIC (Common Programming Interface for Communication) do przesy\u0142ania danych mi\u0119dzy systemami. Jest to protok\u00f3\u0142 specyficzny dla SAP. Zdalne wywo\u0142anie funkcji (RFC) to interfejs komunikacyjny oparty na CPI-C, ale z wi\u0119ksz\u0105 liczb\u0105 funkcji i \u0142atwiejszy w u\u017cyciu dla programist\u00f3w aplikacji.<\/li>
- Funkcje biblioteki RFC obs\u0142uguj\u0105 j\u0119zyk programowania C i Visual Basic (na platformach Windows).<\/li>
- Po\u0142\u0105czenia RFC mog\u0105 by\u0107 zawsze u\u017cywane w ca\u0142ym systemie, co oznacza, \u017ce po\u0142\u0105czenie RFC zdefiniowane w kliencie 000 mo\u017ce by\u0107 r\u00f3wnie\u017c u\u017cywane z klienta 100 (bez \u017cadnej r\u00f3\u017cnicy).<\/li>
- Jedyn\u0105 r\u00f3\u017cnic\u0105 mi\u0119dzy zdalnym wywo\u0142aniem modu\u0142u funkcji na inny serwer a wywo\u0142aniem lokalnym jest specjalny parametr (miejsce docelowe), kt\u00f3ry okre\u015bla serwer docelowy, na kt\u00f3rym ma by\u0107 wykonywany program.<\/li><\/ul><\/li>
- Zalety modu\u0142\u00f3w RFC:<\/strong>
- S\u0105 w stanie przekonwertowa\u0107 dane na format zrozumia\u0142y dla systemu zdalnego (docelowego).<\/li>
- Potrafi\u0105 wywo\u0142ywa\u0107 okre\u015blone procedury, kt\u00f3re s\u0105 niezb\u0119dne do rozpocz\u0119cia komunikacji ze zdalnym systemem.<\/li>
- Obs\u0142uguj\u0105 b\u0142\u0119dy, kt\u00f3re mog\u0105 wyst\u0105pi\u0107 w procesie komunikacji.<\/li>
- Pomagaj\u0105, tak\u017ce w zmniejszeniu wysi\u0142ku na opracowywanie modu\u0142\u00f3w oraz metod w zdalnych systemach.<\/li><\/ul><\/li><\/ul>\n\n\n\n
Wyr\u00f3\u017cniamy par\u0119 rodzaj\u00f3w modu\u0142\u00f3w RFC:<\/strong><\/p>\n\n\n\n
![\"typy](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/09\/typy-rfc-1.jpg\")
<\/a><\/figure><\/div>\n\n\n\nPowy\u017csze modu\u0142y zostan\u0105 opisane w kolejnej cz\u0119\u015bci, po\u015bwi\u0119conej modu\u0142om RFC. ^_^<\/p>\n\n\n\n
2. Mechanizm BAPI<\/h3>\n\n\n\n
BAPI \u2013 Interfejs Programistyczny Aplikacji Biznesowych (ang. Business Application Programming Interface). Podstawow\u0105 koncepcj\u0105 interfejs\u00f3w BAPI jest orientacja obiektowa. Interfejsy BAPI umo\u017cliwiaj\u0105 dost\u0119p do obiekt\u00f3w biznesowych w systemie SAP przez systemy zewn\u0119trzne. Obiekty biznesowe reprezentuj\u0105 rzeczywiste obiekty, takie jak zam\u00f3wienia, klienci lub artyku\u0142y. Dost\u0119p do instancji jest mo\u017cliwy wy\u0142\u0105cznie przy u\u017cyciu metod udost\u0119pnianych przez obiekt biznesowy. Technicznie metoda jest wywo\u0142ywana na podstawie interfejs\u00f3w RFC. Instancja, do kt\u00f3rej nawi\u0105zywane s\u0105 po\u0142\u0105czenia, jest okre\u015blana przez pola kluczowe (numer klienta itd.).<\/p>\n\n\n\n
Graficzna prezentacja przep\u0142ywu danych:<\/strong><\/p>\n\n\n\n
![\"przeplyw](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/09\/przeplyw-danych-bapi-1.jpg\")
<\/a><\/figure><\/div>\n\n\n\n3. Mechanizmy modu\u0142\u00f3w PI\/PO<\/h3>\n\n\n\n
Na samym pocz\u0105tku nale\u017cy przypomnie\u0107 sobie czym s\u0105 te dwa produkty, dostarczane przez firm\u0119 SAP:<\/p>\n\n\n\n
- SAP Process Integration<\/em><\/strong> \u2013 jest to \u201epo\u015brednik\u201d integracji, kt\u00f3ry tradycyjnie korzysta z obu stos\u00f3w ABAP i Java, aby umo\u017cliwi\u0107 integracj\u0119 opart\u0105 na wiadomo\u015bciach mi\u0119dzy systemami informatycznymi przy u\u017cyciu wielu adapter\u00f3w do pobierania komunikat\u00f3w do, i z tych system\u00f3w. Jest tak\u017ce mo\u017cliwe wdro\u017cenie PI w taki spos\u00f3b, aby po prostu dzia\u0142a\u0142o na stosie Java, ale je\u015bli to robisz, mo\u017cesz r\u00f3wnie dobrze aktywowa\u0107 dodatkowe komponenty PO.<\/li>
- SAP Process Orchestration<\/em><\/strong> \u2013 jest to po\u0142\u0105czenie SAP Process Integration (jak wy\u017cej), SAP Business Process Management (u\u017cywane do tworzenia przep\u0142yw\u00f3w pracy mi\u0119dzy lud\u017ami i systemami), SAP Business Rules Management (u\u017cywane do w\u0142\u0105czania definiowanej przez u\u017cytkownika logiki biznesowej wymaganej w dowolnym procesie biznesowym,
wy\u0142\u0105czania\/w\u0142\u0105czania limit\u00f3w). Zawiera r\u00f3wnie\u017c wiele pomocnych komponent\u00f3w technicznych, takich jak Composite Application Framework (do tworzenia trwa\u0142o\u015bci danych), Enterprise Content Management (u\u017cywany do zarz\u0105dzania dokumentami) i lekk\u0105 wersj\u0119 funkcji SAP Portal (u\u017cywanej do dost\u0119pu do tre\u015bci w oparciu o role). Wszystkie z wymienionych element\u00f3w dzia\u0142aj\u0105 na stosie SAP Java.<\/li><\/ul>\n\n\n\nM\u00f3wi\u0105c najpro\u015bciej, SAP Process Orchestration<\/em><\/strong> obejmuje wszystkie narz\u0119dzia potrzebne do tworzenia logiki biznesowej, aplikacji i integracji wymaganych do wype\u0142nienia wszelkich luk mi\u0119dzy systemami IT <-> lokaln\u0105 platform\u0119 rozszerze\u0144. Daje on te\u017c pe\u0142n\u0105 mo\u017cliwo\u015b\u0107 do integracji z baz\u0105 HANA oraz z rozwi\u0105zaniami chmurowymi oferowanymi ju\u017c od paru lat przez firm\u0119 SAP.<\/p>\n\n\n\n
Nale\u017cy tak\u017ce pami\u0119ta\u0107 o tym, \u017ce modu\u0142 PI nie jest ju\u017c wspierany w formie nowych rozszerze\u0144, jego rol\u0119 przej\u0105\u0142 modu\u0142 PO i to on jest polecany przez firm\u0119 SAP.<\/p>\n\n\n\n
Przyk\u0142adowa grafika, prezentuj\u0105ca spos\u00f3b dzia\u0142ania modu\u0142u PO w procesie integracji z zewn\u0119trznym systemem, kt\u00f3ry ma inn\u0105 form\u0119 komunikacji ni\u017c dane rozwi\u0105zanie w systemie SAP.<\/p>\n\n\n\n
![\"modulpo](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/09\/modulpo-1.jpg\")
<\/a><\/figure><\/div>\n\n\n\n<\/div>\n\n\n\n4. Mechanizmy REST API<\/h3>\n\n\n\n
REST API (ang. Representational state transfer), transfer stanu reprezentuj\u0105cego, to zbi\u00f3r zasad tworzenia architektury oprogramowania dla system\u00f3w rozproszonych. Opisywany standard definiuje sze\u015b\u0107 podstawowych regu\u0142:<\/p>\n\n\n\n
- Architektura Klient-Server<\/li>
- Bezstanowo\u015b\u0107<\/li>
- Zdolno\u015b\u0107 zapami\u0119tywania\/buforowania zasob\u00f3w<\/li>
- System warstwowy<\/li>
- Kod na \u017c\u0105danie<\/li>
- Jednolity interfejs<\/li><\/ol>\n\n\n\n
W rozwi\u0105zaniach systemu SAP mamy do czynienia z takim terminem jak OData<\/em><\/strong>. Czym w\u0142a\u015bciwie jest wspomniana fraza? W og\u00f3lnym rozumieniu, OData s\u0142u\u017cy do definiowania najlepszych rozwi\u0105za\u0144, kt\u00f3re s\u0105 wymagane do tworzenia i u\u017cywania interfejs\u00f3w API RESTful. Pomaga w wyszukiwaniu zmian, definiowaniu funkcji dla procedur wielokrotnego u\u017cytku i wysy\u0142aniu paczek \u017c\u0105da\u0144 itp.<\/p>\n\n\n\n
OData to protok\u00f3\u0142 do przesy\u0142ania zaprojektowany przez Microsoft ju\u017c w roku 2007 i od tego czasu stale rozwijany. Najnowsza wersja oData 4.0 zosta\u0142a wydana w roku 2014.<\/p>\n\n\n\n
Cykl \u017cycia us\u0142ugi OData:<\/strong><\/p>\n\n\n\n
![\"cykl](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/09\/cykl-zycia-odata-1.jpg\")
<\/a><\/figure><\/div>\n\n\n\nOd kilku lat SAP Gateway ma funkcjonalno\u015b\u0107 dostarczania funkcji ABAP i interfejs\u00f3w RFC w postaci REST API. REST ma pewne zalety w stosunku do SOAP, ale ma podobn\u0105 technologi\u0119, poniewa\u017c jest r\u00f3wnie\u017c wywo\u0142aniem funkcji za po\u015brednictwem protoko\u0142u HTTP. W por\u00f3wnaniu z SOAP, REST jest \u0142atwy do wywo\u0142ania z r\u00f3\u017cnych platform, przesy\u0142a czyste dane czytelne dla cz\u0142owieka w formacie JSON lub XML, jest szybszy i oszcz\u0119dza zasoby. W podstawowej idei REST dost\u0119p do obiektu uzyskuje si\u0119 za po\u015brednictwem REST, a nie jego metod. Stan obiektu mo\u017cna zmieni\u0107 za pomoc\u0105 dost\u0119pu REST. Zmiana jest spowodowana przekazanymi parametrami. Cz\u0119stym zastosowaniem jest po\u0142\u0105czenie SAP PI przez interfejs REST.<\/p>\n\n\n\n
Cztery podstawowe metody HTTP wykorzystywane w rozwi\u0105zaniach REST API:<\/strong><\/p>\n\n\n\n
GET<\/strong> \u2013 s\u0142u\u017cy do pobierania danych. Tutaj wystarczy poda\u0107 odpowiedni endpoint, ewentualnie zmodyfikowa\u0107 nag\u0142\u00f3wki(headers) zapytania.<\/p>\n\n\n\n
POST<\/strong> \u2013 s\u0142u\u017cy tworzeniu i przes\u0142aniu nowych danych. W tym przypadku konieczne jest ju\u017c stworzenie cia\u0142a(body), w kt\u00f3rym przeka\u017cemy dane do naszego REST API.<\/p>\n\n\n\n
PUT<\/strong> \u2013 r\u00f3wnie\u017c s\u0142u\u017cy przesy\u0142aniu danych, lecz najcz\u0119\u015bciej w celu aktualizacji tych danych. Tutaj r\u00f3wnie\u017c wymagane jest przes\u0142anie danych w ciele.<\/p>\n\n\n\n
DELETE<\/strong> \u2013 metoda s\u0142u\u017c\u0105ca do usuwania danych. W tym momencie chc\u0119 wspomnie\u0107 o technice tak zwanego soft-delete. M\u00f3wi\u0105c skr\u00f3tem polega to na tym, \u017ce kasuj\u0105c dane za pomoc\u0105 API tak naprawd\u0119 tylko dodajemy do encji informacj\u0119 o tym, \u017ce zosta\u0142a ona usuni\u0119ta. W rezultacie dane pozostaj\u0105 nadal w bazie, lecz nie s\u0105 one dost\u0119pne z poziomu API. Mechanizm ten nale\u017cy ju\u017c zaimplementowa\u0107 w samym API i nie ma on nic wsp\u00f3lnego z HTTP.<\/p>\n\n\n\n
Graficzna prezentacja przep\u0142ywu danych:<\/strong><\/p>\n\n\n\n
![\"soap](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/09\/soap-rest-1.jpg\")
<\/a><\/figure><\/div>\n\n\n\nPrzyk\u0142adowe zapytanie GET dla REST API:<\/strong><\/p>\n\n\n\n
![\"zapytanie](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/09\/zapytanie-get-dla-rest-1.jpg\")
<\/a><\/figure><\/div>\n\n\n\n
- SAP Process Orchestration<\/em><\/strong> \u2013 jest to po\u0142\u0105czenie SAP Process Integration (jak wy\u017cej), SAP Business Process Management (u\u017cywane do tworzenia przep\u0142yw\u00f3w pracy mi\u0119dzy lud\u017ami i systemami), SAP Business Rules Management (u\u017cywane do w\u0142\u0105czania definiowanej przez u\u017cytkownika logiki biznesowej wymaganej w dowolnym procesie biznesowym,
- SAP Process Integration<\/em><\/strong> \u2013 jest to \u201epo\u015brednik\u201d integracji, kt\u00f3ry tradycyjnie korzysta z obu stos\u00f3w ABAP i Java, aby umo\u017cliwi\u0107 integracj\u0119 opart\u0105 na wiadomo\u015bciach mi\u0119dzy systemami informatycznymi przy u\u017cyciu wielu adapter\u00f3w do pobierania komunikat\u00f3w do, i z tych system\u00f3w. Jest tak\u017ce mo\u017cliwe wdro\u017cenie PI w taki spos\u00f3b, aby po prostu dzia\u0142a\u0142o na stosie Java, ale je\u015bli to robisz, mo\u017cesz r\u00f3wnie dobrze aktywowa\u0107 dodatkowe komponenty PO.<\/li>
- Istotne wiadomo\u015bci na temat modu\u0142\u00f3w RFC:<\/strong>