Połączenie z S/4HANA Cloud Public Edition przez OData V4
SAP S/4HANA Cloud Public Edition nie obsługuje importu dab RFC Add-On dla tej metody połączenia. Dostęp należy skonfigurować poprzez aplikacje komunikacyjne w SAP Fiori launchpad. Wymagane jest utworzenie Communication User, Communication System reprezentującego środowisko Nexus oraz Communication Arrangement dla wybranego scenariusza komunikacyjnego.
Po ukończeniu konfiguracji po stronie SAP, należy skonfigurować punkt końcowy OData V4 udostępniony przez docelowego tenant'a w dab Nexus jako połączenie typu OData Communication. W scenariuszu Public Cloud Nexus nie udostępnia katalogu usług umożliwiającego automatyczny wybór źródeł.
Wymagania wstępne
Weryfikacja SAP System
Należy potwierdzić produkt, edycję, wydanie oraz docelowego tenant'a korzystając z funkcji Identify SAP System. Nie należy określać modelu operacyjnego wyłącznie na podstawie nazwy hosta lub Fiori launchpada.
SAP ECC, S/4HANA On-Premise, Private Cloud oraz Public Edition opierają się na różnych modelach połączenia i administracji. Nieznane wartości należy oznaczyć jako niepotwierdzone i uzyskać ich weryfikację u administratora SAP.
Weryfikacja środowiska Nexus
- Należy sprawdzić zainstalowaną wersję w sekcji Settings → Licence & Support. Potwierdzić dostępność opcji OData Communication.
- Trzeba upewnić się, że środowisko może połączyć się z hostem API SAP przez HTTPS na porcie TCP
443oraz zweryfikować certyfikat TLS.
Włączenie katalogu usług
Wymagany jest scenariusz komunikacyjny SAP_COM_0181, gdyż umożliwia on dostęp do katalogu usług SAP wykorzystywanego przez Nexus.
Należy utworzyć i utrzymać Communication Arrangement dla:
SAP_COM_0181
Przypisać Communication System oraz Communication User dedykowane do integracji z Nexus.
SAP_COM_0181 jest obligatoryjny, by połączyć się przez Nexus OData V4, gdyż katalog usług zostanie udostępniony tylko wtedy. Nie zastępuje to jednak komunikacyjnego scenariusza wymaganego przez właściwe źródło danych. Przykładowo, źródło CDI_CDS wymaga dodatkowo SAP_COM_0531 i odpowiadającego Communication Arrangement.
Przegląd procesu
- Wybór źródła oraz scenariusza komunikacyjnego.
- Dla
CDI_CDSskonfigurować allowlistę CDS oraz grupę autoryzacyjną. - Utworzenie Communication User oraz Communication System.
- Utworzenie Communication Arrangement.
- Ustalenie ścieżki entity-set.
- Utworzenie, przetestowanie i rejestracja połączenia Nexus.
- Utworzenie pakietu dla wybranego źródła w Package Studio oraz uruchomienie testowej ekstrakcji.
1. Wybór źródła i scenariusza komunikacyjnego
Należy uzyskać znany rekord referencyjny wraz z pełnym kluczem oraz oczekiwanymi wartościami pól. Posłuży on do weryfikacji połączenia i ekstrakcji.
| Źródło | Weryfikacja | Scenariusz komunikacyjny |
|---|---|---|
CDI_CDS | Znaleźć źródło w View Browser. Zweryfikować pola, klucze, obsługę ekstrakcji i delta dla docelowego wydania. | SAP_COM_0531 |
| Business API | W SAP Business Accelerator Hub znaleźć opublikowane API OData V4 dla Public Edition. Zweryfikować wymagane encje, pola oraz wersję API. | ID scenariusza podany w dokumentacji API |
Serwis wykorzystywany przez aplikację Fiori nie jest automatycznie udostępniany do integracji zewnętrznej.
Dla Business API:
- Allowlista CDI nie ma zastosowania.
SAP_COM_0531nie jest automatycznie odpowiednim scenariuszem.SAP_COM_0532nie zastępuje tutaj dostępu CDI OData.- Oprócz konfiguracji katalogu usług dla
SAP_COM_0181, wymagane jest źródło-specyficzne Communication Arrangement.
Niestandardowe widoki Key User CDS
W aplikacji Custom CDS Views należy potwierdzić, że widok wykorzystuje scenariusz Data Extraction, przechodzi walidację oraz jest opublikowany. Ta ścieżka Key-User różni się od widoków CDS tworzonych przez programistów (Z*); nie należy zakładać, że adnotacje ekstrakcyjne ABAP mogą być stosowane do dowolnych obiektów własnych w Public Edition. SAP dokumentuje pełną ekstrakcję bez delty dla tego typu źródeł w SAP KBA 2884410 w SAP for Me. Ograniczenie to nie dotyczy automatycznie standardowych ekstraktorów SAP.
W przypadku kontroli między edycjami — obejmujących dostęp do katalogu usług, wykrywanie dostawców CDI, metadane i rozwiązywanie problemów związanych z Package Studio — należy zapoznać się z Troubleshooting SAP OData V4 CDS Views Missing from Package Studio.
2. Konfiguracja allowlisty CDS i grupy autoryzacyjnej
Etap ten realizowany jest tylko dla CDI_CDS. Aby skonfigurować Business API, przejść do 3. Utworzenie Communication User.
Brak dostępu do czynności konfiguracyjnej oznacza, że musi ją wykonać uprawniony właściciel konfiguracji SAP Cloud.
2.1 Uruchomienie czynności konfiguracyjnej
Znaleźć Define Allowlists for CDS View Extraction korzystając z jednej z poniższych ścieżek.
Manage Your Solution
- Otworzyć Manage Your Solution → Configure Your Solution.
- Ustawić filtry:
- Application Area: Application Platform and Infrastructure
- Sub Application Area: Data Extraction
- Wybrać wyszukany wynik.
- W sekcji konfiguracji wybrać Configure.
SAP Central Business Configuration
Wyszukać nazwę czynności w:
Configuration Activities
→ General Settings
→ Further Settings
W zależności od interfejsu czynność może być widoczna bezpośrednio pod sekcją Configuration.
2.2 Utworzenie grupy autoryzacyjnej i allowlisty
- Wybrać New Entries.
- Wprowadzić unikalny Authorization Group ID.
- Uzupełnić opis znaczeniem.
- Jako typ wybrać Explicit allow list.
- Dodać wymagane źródła CDS do allowlisty grupy.
- Zatwierdzić konfigurację.
- Wybrać odpowiedni transport Customizing.
- Zanotować Authorization Group ID dla źródło-specyficznego Communication Arrangement.
- Dla innego tenant'a, należy potwierdzić dostępność grupy i jej pozycji także w tamtym środowisku.
2.3 Brak czynności allowlisty
W razie braku czynności należy poprosić właściciela konfiguracji o sprawdzenie, czy element zakresu Data Protection and Privacy (5LE) jest aktywny. Powodem może być brak aktywacji, co opisuje SAP KBA 3781796 w SAP for Me. Po aktywacji ponownie wyszukać czynność.
3. Utworzenie Communication User
- Otworzyć Maintain Communication Users.
- Utworzyć dedykowanego użytkownika komunikacyjnego dla Nexus lub otworzyć istniejącego przeznaczonego do tej integracji.
- Ustawić wymaganą metodę uwierzytelniania przez usługę.
Login i hasło
- Ustawić hasło dla Communication User.
- Przekazać je wyłącznie zatwierdzonym kanałem zarządzania danymi poufnymi.
- Wpisać je później w połączeniu Nexus.
Certyfikat klienta
- Przypisać publiczny certyfikat klienta do Communication User.
- Nexus będzie wymagać również odpowiadającego klucza prywatnego.
- Należy dostarczyć Nexus plik
.p12zawierający certyfikat oraz klucz prywatny. - Hasło do pliku należy przechowywać i przekazywać całkiem osobno od samego pliku certyfikatu.
- Zatwierdzić użytkownika.
- Zanotować tożsamość do wskazania w Communication System.
Communication User nie jest osobistym kontem wykorzystywanym do logowania do Fiori launchpad. Konto Fiori służy do konfiguracji integracji, natomiast Nexus realizuje wywołania z użyciem Communication User bądź powiązanego certyfikatu. Skuteczne logowanie do Fiori nie poświadcza więc uwierzytelnienia Nexus.
4. Utworzenie Communication System dla Nexus
- Otworzyć Communication Systems.
- Utworzyć system odpowiadający środowisku Nexus.
- Nadać unikalny identyfikator systemu oraz czytelną nazwę, np. DAB_NEXUS_PROD
- W polu Host Name podać nazwę hosta wybranej instalacji Nexus lub Managed App.
- Należy wpisać wyłącznie samą nazwę hosta, bez schematu i ścieżki URL.
- W sekcji Users for Inbound Communication dodać Communication User utworzonego w 3. Utworzenie Communication User.
- Ustawić metodę uwierzytelniania.
- Zapisać Communication System i zweryfikować przypisanie użytkownika.
W tym kontekście, inbound oznacza, że Nexus wykonuje żądanie do SAP.
Communication System reprezentuje Nexus jako partnera komunikacyjnego. Host Name nie jest hostem API SAP wykorzystywanym jako Nexus Base URL. URL API SAP należy pobrać z sekcji Inbound Services w Communication Arrangement.
Osobne Communication Systems należy utworzyć dla środowisk DEV, QA i PROD, jeśli korzystają one z różnych runtime'ów Nexus lub technicznych tożsamości.
5. Utworzenie Communication Arrangements
W zależności od potrzeb, należy utworzyć co najmniej dwa Communication Arrangements:
- Arrangement katalogu usług dla
SAP_COM_0181. - Arrangement źródła-specyficzny dla
SAP_COM_0531bądź scenariusza komunikacyjnego opisanego dla wybranego Business API.
5.1 Utworzenie arrangementu katalogu usług
- Otworzyć Communication Arrangements.
- Wybrać New.
- Wybrać scenariusz komunikacyjny:
SAP_COM_0181
- Wpisać czytelną nazwę arrangementu.
- Wskazać Communication System Nexus utworzony w 4. Utworzenie Communication System dla Nexus.
- W sekcji Inbound Communication sprawdzić:
- przypisanego Communication User,
- ustawioną metodę uwierzytelniania.
- Zatwierdzić arrangement.
- W sekcji Inbound Services sprawdzić dostęp do katalogu usług.
Arrangement SAP_COM_0181 umożliwia dostęp do katalogu usług, ale nie daje uprawnień do encji właściwego źródła danych.
5.2 Utworzenie arrangementu źródła-specyficznego
- Otworzyć Communication Arrangements.
- Wybrać New.
- Wybrać scenariusz zdefiniowany w 1. Wybór źródła i scenariusza komunikacyjnego:
- dla CDI:
SAP_COM_0531, - dla Business API: udokumentowany Communication Scenario ID.
- dla CDI:
- Podać nazwę arrangementu.
- Wskazać Communication System Nexus utworzony w 4. Utworzenie Communication System dla Nexus.
- W sekcji Inbound Communication sprawdzić:
- przypisanego Communication User,
- ustawioną metodę uwierzytelniania.
- Dla CDI podać Authorization Group ID utworzone w 2.2 Utworzenie grupy autoryzacyjnej i allowlisty w sekcji Additional Properties → Authorization Group ID.
- Zatwierdzić arrangement.
- Przejść do sekcji Inbound Services.
- Skopiować wyświetlone URL'e do docelowego tenant'a.
Najczęstsze błędy konfiguracyjne
Authorization Group musi być utrzymana
Należy zweryfikować:
- poprawność wpisania Authorization Group ID,
- istnienie grupy w docelowym tenant'cie,
- obecność wymaganych źródeł CDS w allowliście grupy.
Szczegóły opisuje SAP KBA 3118974 w SAP for Me.
Brak dostępu do katalogu usług
Należy potwierdzić:
- istnienie Communication Arrangement dla
SAP_COM_0181, - przypisanie właściwego Communication System,
- przypisanie wymaganego Communication User,
- zgodność konfiguracji metody uwierzytelniania do połączenia Nexus.
Nie należy traktować arrangementu źródła-specyficznego jako substytutu SAP_COM_0181.
Wymagana usługa nie jest dostępna
Należy porównać:
- wybrany scenariusz komunikacyjny,
- wersję API,
- wydanie SAP Cloud,
- dokumentację SAP dla wersji.
Nie wolno wybierać niepowiązanego scenariusza wyłącznie z powodu podobieństwa nazwy usługi.
6. Ustalenie konkretnej ścieżki entity-set
6.1 CDI_CDS
Odczyt katalogu dostawców
Korzystając z Communication User, należy wykonać wywołanie katalogu dostawców CDI przez endpoint CDI w arrangementcie. Schemat dokumentowany przez SAP obejmuje:
https://<SAP-API-Host>/sap/opu/odata4/sap/cdi/default/sap/cdi/0001/Providers
- Wyszukać techniczną nazwę ekstraktora, ustaloną w 1. Wybór źródła i scenariusza komunikacyjnego. Dla klasycznego widoku CDS może to być wygenerowana nazwa widoku SQL z odpowiednim sufiksem; np.
CMMPURORDHIST$Fjest ekstraktorem faktu/zdarzeń. W przypadku CDS View Entity należy użyć nazwy samej encji. - Nazwa ekstraktora nie jest URL'em dostawcy CDI. Nie należy budować URL na jej podstawie; należy skopiować URL dostawcy zwrócony przez SAP. Przykłady i szczegóły opisuje przewodnik rozwiązywania problemów CDI_CDS.
- Przejść każdą zwróconą stronę
@odata.nextLink. - Skopiować URL dostawcy proponowany przez docelowego tenant'a.
- Nie należy tworzyć ścieżki
CDI_CDSwyłącznie na podstawie nazwy widoku.
Weryfikacja usługi i metadanych
Należy wywołać:
- dokument usługowy pod rootem usługi, z końcówką
/, - dokument metadanych pod
service root + /$metadata.
Zweryfikować:
- entity set
Facts, - wymagane pola,
- pełny klucz,
- typy pól, waluty, jednostki.
Przykładowy tenant w zwróconych danych może prezentować ścieżki jak niżej:
Service root: /sap/opu/odata4/sap/cdi_cds/cdi_cds/sap/c_billingdocitembasicdex_1/0001/
Metadata: /sap/opu/odata4/sap/cdi_cds/cdi_cds/sap/c_billingdocitembasicdex_1/0001/$metadata
Entity set: /sap/opu/odata4/sap/cdi_cds/cdi_cds/sap/c_billingdocitembasicdex_1/0001/Facts
W miejsce przykładu należy wpisać URL dostawcy zwrócony przez docelowego tenant'a. Providers służy do wykrywania źródeł. Uzyskany URL dostawcy należy podać w ustawieniach Nexus przy konfiguracji.
Jeśli dostawca nie jest obecny lub widoczny w SAP, ale nie pojawia się w Package Studio, należy przejść do przewodnika rozwiązywania problemów CDI_CDS.
6.2 Business API
- Skopiować root usługi z sekcji Inbound Services w odpowiednim Communication Arrangement.
- Wywołać dokument usługowy.
- Wywołać
/$metadata. - Zidentyfikować wymagany entity set, pola oraz pełny klucz.
- Posłużyć się opublikowaną nazwą entity set z uwzględnieniem dokumentowanej wielkości liter.
Facts nie stanowi uniwersalnego sufiksu dla Business API. Wykorzystać należy nazwę entity set zdefiniowaną w metadanych wybranego API.