Wybór serwisu OData (dla skryptu OData)
EasyInput może korzystać z serwisów Open Data Protocol (OData) z systemu SAP oraz serwisów zewnętrznych[1]. Dokumentację standardu OData można znaleźć na stronach https://www.odata.org . Wybranie właściwej usługi OData pokazane zostanie na przykładzie serwisu dostarczonego przez system SAP.
System SAP w szczególności w wersji S4HANA dostarcza dziesiątki predefiniowanych usług OData pozwalających zarówno na łatwe raportowanie jak i wykonywanie transakcji. Na stronie https://api.sap.com można znaleźć dokumentację oficjalnie udostępnionych serwisów OData. Dodatkowo w przeglądarce transakcji realizowanych za pomocą interfejsu SAP Fiori https://fioriappslibrary.hana.ondemand.com wskazane są usługi OData wykorzystywane przez konkretną transakcję Fiori.
W systemie SAP serwisy OData realizowane są w dwóch wersjach: OData V2 (starsza) i OData V4 (nowsza). Wiele usług dla S4HANA została zaimplementowana w starszej wersji OData V2. Nowe serwisy zazwyczaj implementowane są wg nowszej specyfikacji standardu OData V4. Dokumentacja API OData V2 i V4 w SAP znajduje się na stronach SAP razem z dokumentacją narzędzia SAP Gateway (https://help.sap.com).
OData wersja 2.0 w SAP
Aktywacja i przegląd serwisów OData w wersji 2.0 w SAP odbywa się za pomocą transakcji /n/IWFND/MAINT_SERVICE. Transakcja pozwala zarówno przegląd uruchomionych usług jak i na aktywację nowych dotychczas nieaktywnych serwisów (przycisk Dodawanie usługi). Definiowanie i zmienianie serwisów OData V2 wykonuje się za pomocą transakcji SEGW w SAP GUI.
OData wersja 4.0 w SAP
Administracja serwisami OData w wersji 4 w SAP wykonywana jest transakcją /n/IWBEP/V4_ADMIN. Rozwój serwisów w wersji V4 powinien być wykonywany w środowisku Eclipse/ABAP.
Testowanie serwisu OData
Po aktywacji serwis OData można przetestować w SAP GUI z użyciem transakcji /n/IWFND/GW_CLIENT. Transakcja ta pozwala testować zarówno serwisy w wersji 2 i 4.
Automatyczne tworzenie skryptu OData na arkuszu EI_Script_OD
Jeśli serwis OData jest dobrze rozpoznany można przystąpić do utworzenia skryptu OData opartego na tym serwisie. W tym celu po wybraniu arkusza EI_Script_OD z menu wstążki należy wybrać opcję „Dodaj serwis OData”.
Inne użyteczne transakcje dotyczące serwisów OData w SAP
|
Transakcja |
Opis |
|
/n/IWFND/GW_CLIENT |
Transakcja pozwalająca na testowanie zarówno serwisów OData w wersji V2 jak i w wersji V4. Pozwala na sprawdzenie działania serwisu i jest zalecana, aby dobrze poznać parametry wywołania serwisu przed definiowaniem skryptu OData w EasyInput. |
|
/n/IWFND/CACHE_CLEANUP |
Czyszczenie pamięci podręcznej serwisów ODATA V2 |
|
/n/IWBEP/CACHE_CLEANUP |
Czyszczenie pamięci podręcznej serwisów ODATA V4 |
|
/n/IWFND/ERROR_LOG |
Przegląd logów błędów serwisów OData w wersji V2 i V4 |
|
/n/IWFND/TRACES |
Analiza przebiegów OData w wersji V2 i V4 (analiza wydajności) |
Dalsze informacje na temat skryptu OData.
[1] Część serwisów zewnętrznych może być dla EasyInput niedostępna (np. ze względu na wersję implementacji OData lub sposób autentykacji).