SAP ERP

SAP ERP to oprogramowanie do planowania zasobów przedsiębiorstwa opracowane przez sap SE. SYSTEM SAP ERP obejmuje kluczowe funkcje biznesowe organizacji. Łącznik SAP ERP umożliwia wywoływanie funkcji RFC i BAPI przy użyciu lokalnej bramy danych.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa	Class	Regions
Copilot Studio	Premium	Wszystkie regiony usługi Power Automate
Power Apps	Premium	Wszystkie regiony usługi Power Apps
Power Automate	Premium	Wszystkie regiony usługi Power Automate

Kontakt
Name	Microsoft
adres URL	https://learn.microsoft.com/connectors/saperp/

Metadane łącznika
Publisher	Microsoft
Witryna internetowa	https://www.sap.com/products/enterprise-management-erp.html
Zasady ochrony prywatności	https://www.sap.com/about/legal/privacy.html
Kategorie	Produktywność

Korzystanie z łącznika SAP ERP

Aby rozpocząć korzystanie z tego łącznika, przeczytaj następujące wpisy w blogu:

Pre-requisites

Łącznik SAP ERP ma zależność od następujących składników, które muszą być zainstalowane na tym samym komputerze:

Lokalna brama danych (wersja z października 2023 r. — 3000.194 lub nowsza)
Biblioteka DLL środowiska uruchomieniowego programu Microsoft C++ w wersji 14.x (zależność SAP NCo programu Visual Studio 2015, 2017, 2019 i 2022)
Łącznik SAP .NET Connector z systemu SAP
- Wybierz wersję 64-bitową NCo 3.1 (wersja 32-bitowa nie jest obsługiwana)
- Nie instaluj NCo 3.0 (nieobsługiwane)
- Wymaga prawidłowego użytkownika S-user na potrzeby pobierania. Może być konieczne skontaktowanie się z zespołem SAP.

Autoryzacje SAP

Konto użytkownika sap wymaga dostępu do RFC_METADATA grupy funkcji i odpowiednich modułów funkcji dla następujących operacji:

Operations	Dostęp do modułów funkcji
Akcje RFC	`RFC_GROUP_SEARCH`, `DD_LANGU_TO_ISOLA`
Akcje BAPI	`BAPI_TRANSACTION_COMMIT`, , `BAPI_TRANSACTION_ROLLBACK`, `RPY_BOR_TREE_INIT`, , `SWO_QUERY_METHODSSWO_QUERY_API_METHODS`
Akcje IDoc	`IDOCTYPES_LIST_WITH_MESSAGES`, , `IDOCTYPES_FOR_MESTYPE_READ`, `INBOUND_IDOCS_FOR_TID`, `OUTBOUND_IDOCS_FOR_TID`, , `GET_STATUS_FROM_IDOCNRIDOC_RECORD_READ`
Odczytywanie akcji tabeli SAP	`RFC BBP_RFC_READ_TABLE` lub `RFC_READ_TABLE`
Minimalny dostęp	`RFC_METADATA_GET`, `RFC_METADATA_GET_TIMESTAMP`

Authentication

Łącznik obsługuje uwierzytelnianie SAP, uwierzytelnianie systemu Windows, identyfikator entra firmy Microsoft z protokołem Kerberos i identyfikator entra firmy Microsoft z certyfikatami.

Ponieważ łącznik jest przeznaczony do użycia przez wielu użytkowników aplikacji, połączenia nie są współużytkowane. Zamiast tego każdy użytkownik będzie uwierzytelniany w systemie SAP. Poświadczenia użytkownika są udostępniane w połączeniu, a dodatkowe szczegóły wymagane do nawiązania połączenia z systemem SAP (takie jak szczegóły serwera, konfiguracja zabezpieczeń) są udostępniane w ramach akcji.

Uwierzytelnianie SAP

Podstawowe uwierzytelnianie SAP przy użyciu nazwy użytkownika i hasła SAP.

Uwierzytelnianie systemu Windows

Wymaga dodatkowej konfiguracji dla bezpiecznej komunikacji sieciowej (SNC). Wymaga dodatkowej konfiguracji logowania jednokrotnego opartego na protokole Kerberos z platformy Power Platform do lokalnych źródeł danych.

Microsoft Entra ID (z kerberos)

Microsoft Entra ID (z certyfikatami)

Wymaga dodatkowej konfiguracji dla bezpiecznej komunikacji sieciowej (SNC). Wymaga dodatkowej konfiguracji logowania jednokrotnego opartego na certyfikatach z platformy Power Platform do lokalnych źródeł danych.

Konfigurowanie logowania jednokrotnego opartego na protokole Kerberos

Nazwa SNC sap dla użytkownika (p:CN=JANEDOE@REDMOND.CORP.CONTOSO.COM) musi być równa użytkownikom Microsoft Entra ID w pełni kwalifikowana nazwa domeny (JANEDOE@REDMOND.CORP.CONTOSO.COM) zarówno dla uwierzytelniania systemu Windows, jak i microsoft Entra ID.

Nazwa sap SNC

Majątek	Description
Korzystanie z SNC	Ustaw wartość "Tak", jeśli chcesz włączyć SNC
Biblioteka SNC	Nazwa lub ścieżka biblioteki SNC względem lokalizacji instalacji NCo lub ścieżki bezwzględnej. Przykłady to `sapcrypto.dll` lub `.\security\sapcrypto.dll`, lub `c:\security\sapcrypto.dll`.
Logowanie jednokrotne SNC	Określa, czy łącznik będzie używać tożsamości usługi, czy poświadczeń użytkownika końcowego
SNC Moja nazwa	W razie potrzeby określ tożsamość, która ma być używana
Nazwa partnera SNC	Nazwa serwera SNC zaplecza
Jakość ochrony SNC	Jakość usług, która ma być używana do komunikacji SNC z tym konkretnym miejscem docelowym lub serwerem. Wartość domyślna jest definiowana przez system zaplecza. Maksymalna wartość jest definiowana przez produkt zabezpieczający używany dla SNC.

Jeśli do łącznika SAP ERP potrzebujesz identyfikatora Entra firmy Microsoft lub uwierzytelniania systemu Windows, musisz wykonać następujące czynności:

Konfigurowanie logowania jednokrotnego opartego na protokole Kerberos z platformy Power Platform do lokalnych źródeł danych
Konfigurowanie systemu SAP ERP w celu włączenia przy użyciu biblioteki CommonCryptoLib (sapcrypto.dll)

Konfigurowanie logowania jednokrotnego opartego na protokole Kerberos z platformy Power Platform do lokalnych źródeł danych — wymagania wstępne

Po zainstalowaniu bramy danych brama jest uruchamiana jako konto usługi lokalnej komputera NT Service\PBIEgwService. Aby włączyć ograniczone delegowanie protokołu Kerberos, dostępne są dwie opcje:

Brama musi działać jako konto domeny, zobacz dokumentację dotyczącą sposobu zmiany konta usługi bramy ; lub
Synchronizowanie wystąpienia identyfikatora Entra firmy Microsoft z lokalnym wystąpieniem microsoft Entra ID (przy użyciu narzędzia Microsoft Entra ID DirSync/Connect)

Kroki konfiguracji:

Uzyskiwanie uprawnień administratora domeny do konfigurowania ustawień delegowania ograniczonego protokołu Kerberos (SetSPN)
Konfigurowanie ograniczonego delegowania protokołu Kerberos dla bramy i źródła danych
Konfigurowanie nazwy SPN dla konta usługi bramy
Dodaj konto usługi bramy do grupy autoryzacji systemu Windows i dostępu, jeśli jest to wymagane
Zdecyduj o typie ograniczonego delegowania protokołu Kerberos do użycia:
- Konfigurowanie konta usługi bramy dla ograniczonego delegowania protokołu Kerberos w warstwie Standardowa
- Konfigurowanie konta usługi bramy dla ograniczonego delegowania Kerberos opartego na zasobach
Udzielanie kontu usługi bramy praw zasad lokalnych na maszynie bramy
Ustawianie parametrów konfiguracji mapowania użytkownika na maszynie bramy (w razie potrzeby)

Aby uzyskać więcej informacji na temat konfigurowania tej konfiguracji, zapoznaj się z dokumentacją usługi Power BI dotyczącą konfigurowania logowania jednokrotnego opartego na protokole Kerberos z usługi Power BI do lokalnych źródeł danych.

Konfigurowanie systemu SAP ERP w celu włączenia przy użyciu biblioteki CommonCryptoLib (sapcrypto.dll)

Upewnij się, że serwer SAP ERP jest poprawnie skonfigurowany pod kątem logowania jednokrotnego Kerberos przy użyciu biblioteki CommonCryptoLib. Jeśli tak jest, możesz użyć logowania jednokrotnego, aby uzyskać dostęp do serwera SAP ERP za pomocą narzędzia SAP, takiego jak interfejs UŻYTKOWNIKA SAP, który został skonfigurowany do korzystania z biblioteki CommonCryptoLib. Aby uzyskać więcej informacji na temat kroków konfiguracji, zobacz Sap Single Sign-On: Authenticate with Kerberos/SPNEGO (Logowanie jednokrotne SAP: uwierzytelnianie przy użyciu protokołu Kerberos/SPNEGO). Serwer powinien używać biblioteki CommonCryptoLib jako biblioteki SNC i mieć nazwę SNC rozpoczynającą się od nazwy CN. Aby uzyskać więcej informacji na temat wymagań dotyczących nazw SNC (w szczególności parametru snc/identity/as ), zobacz Parametry SNC dla konfiguracji protokołu Kerberos.
Upewnij się, że program SAP Secure Login Client (SLC) nie jest uruchomiony na komputerze, na którym zainstalowano bramę. Usługa SLC buforuje bilety Kerberos w sposób, który może zakłócać możliwość korzystania z protokołu Kerberos przez bramę na potrzeby logowania jednokrotnego. Jeśli zainstalowano protokół SLC, odinstaluj go lub upewnij się, że kończysz pracę z klientem SAP Secure Login Client. Kliknij prawym przyciskiem myszy ikonę na pasku zadań systemowych, a następnie wybierz pozycję Wyloguj się i Zakończ przed podjęciem próby nawiązania połączenia z logowaniem jednokrotnym przy użyciu bramy. Protokół SLC nie jest obsługiwany do użycia na maszynach z systemem Windows Server. Aby uzyskać więcej informacji, zobacz sap Note 2780475 (wymagany jest użytkownik s-user).

Sap Secure Login Client

Jeśli odinstalujesz usługę SLC lub wybierzesz pozycję Wyloguj się i zakończ, otwórz okno cmd i wprowadź polecenie klist purge , aby wyczyścić wszystkie buforowane bilety protokołu Kerberos przed podjęciem próby nawiązania połączenia z logowaniem jednokrotnym za pośrednictwem bramy.
Pobierz 64-bitową bibliotekę CommonCryptoLib (sapcrypto.dll) w wersji 8.5.25 lub nowszej z programu SAP Launchpad i skopiuj ją do folderu na maszynie bramy. W tym samym katalogu, w którym skopiowano sapcrypto.dllplik , utwórz plik o nazwie sapcrypto.ini, z następującą zawartością:

ccl/snc/enable_kerberos_in_client_role = 1

Plik .ini zawiera informacje o konfiguracji wymagane przez bibliotekę CommonCryptoLib w celu włączenia logowania jednokrotnego w scenariuszu bramy.

Uwaga / Notatka

Te pliki muszą być przechowywane w tej samej lokalizacji; innymi słowy, /path/to/sapcrypto/ powinny zawierać zarówno elementy , jak sapcrypto.ini i sapcrypto.dll.

Zarówno użytkownik usługi bramy, jak i użytkownik Microsoft Entra ID, którego personifikator usługi potrzebuje uprawnień do odczytu i wykonywania dla obu plików. Zalecamy przyznanie uprawnień zarówno dla plików, jak .ini i .dll do grupy Uwierzytelnieni użytkownicy. W celach testowych można również jawnie przyznać te uprawnienia zarówno użytkownikowi usługi bramy, jak i użytkownikowi Microsoft Entra ID, którego używasz do testowania. Na poniższym zrzucie ekranu przyznaliśmy grupie Uwierzytelnieni użytkownicy uprawnienia do odczytu i wykonywania dla elementu sapcrypto.dll:

Udzielanie uprawnień do odczytu i wykonywania dla uwierzytelnionych użytkowników

Jeśli nie masz jeszcze źródła danych sap BW skojarzonego z bramą, przez którą połączenie logowania jednokrotnego ma przepływać, dodaj je na stronie Zarządzanie bramami w usłudze Power BI. Jeśli masz już takie źródło danych, zmodyfikuj je:

Wybierz pozycję SAP Business Warehouse jako typ źródła danych, jeśli chcesz utworzyć połączenie logowania jednokrotnego z serwerem aplikacji BW.
Wybierz pozycję Sap Business Warehouse Message Server, jeśli chcesz utworzyć połączenie logowania jednokrotnego z serwerem komunikatów BW.

Utwórz zmienną środowiskową systemową CCL_PROFILE i ustaw jej wartość na ścieżkę na sapcrypto.ini.

CCL_PROFILE zmienna środowiskowa systemu:

Tworzenie i ustawianie zmiennych środowiskowych systemowych

Pliki sapcrypto.dll i .ini muszą istnieć w tej samej lokalizacji. W powyższym przykładzie sapcrypto.ini i sapcrypto.dll znajdują się na pulpicie.

Uruchom ponownie usługę bramy.

Ponowne uruchamianie usług usługi bramy

Uwierzytelnianie Microsoft Entra ID

Ten typ uwierzytelniania będzie działać tylko z następującymi akcjami:

Wywoływanie funkcji SAP (V2)
Tworzenie sesji stanowej
Odczytywanie tabeli SAP z analizowaniem

Konto jednostki usługi SAP o identyfikatorze msDS-SupportedEncryptionType entra firmy Microsoft musi mieć zdefiniowany atrybut AES 128 lub AES 256. Ten wpis w blogu zawiera tabelę , która ułatwia kalkuate wartości dziesiętne/szesnastkowe dla obsługiwanych typów szyfrowania.

Znane problemy i ograniczenia

Poniżej przedstawiono niektóre znane problemy i ograniczenia łącznika SAP ERP:

Łącznik obsługuje tylko RFC i BAPIs.
Łącznik nie obsługuje odbierania komunikatów z serwera SAP Server.
Transakcyjne RFC (tRFC) nie są obsługiwane.
Brama ma limit ładunku 2 MB dla operacji zapisu i limit odpowiedzi skompresowanych danych 8 MB dla operacji odczytu.
Klastry bramy danych w trybie równoważenia obciążenia nie są obsługiwane przez stanowe akcje SAP. Komunikacja stanowa musi pozostać w tym samym węźle klastra bramy danych. W przypadku stanowych akcji SAP użyj bramy danych w trybie innym niż klaster lub w klastrze skonfigurowanym tylko na potrzeby trybu failover.
Uaktualnij lokalną bramę danych do najnowszej wersji , jeśli podczas tworzenia przepływu wystąpi błąd podobny do następującego: Length of the name of the RFC '<RFC_NAME>?honorSapOptionalFlag=1' is larger than the maximum allowed limit of 30
Parametry RFC/BAPI pobierane z systemu SAP są buforowane w lokalnej bramie danych. Uruchom ponownie usługę lokalnej bramy danych, aby wyczyścić pamięć podręczną i pobrać nowe wartości.

Zbieranie dzienników

Poniższe dzienniki są przydatne do rozwiązywania problemów z łącznikiem SapErp podczas kontaktowania się z pomocą techniczną firmy Microsoft:

Włącz Additional logging w Diagnostics ustawieniach lokalnej aplikacji bramy danych, aby uzyskać Informational rozszerzone dzienniki adaptera SAP i ślady adaptera SapErp.
Zaktualizuj następujące ustawienie w pliku Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.configkonfiguracji . Zazwyczaj ten plik konfiguracji znajduje się w miejscu, w którym zainstalowano lokalną bramę danych (np. C:\Program Files\On-premises data gateway\Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config).
```
<setting name="SapTraceLevel" serializeAs="String">
   <value>Verbose</value>
</setting>
```

Wskazówki dotyczące właściwości systemu SAP

W przypadku akcji obsługujących SAP system parametr użyj poniższej tabeli, aby uzyskać wskazówki.

Majątek	Description
AppServerHost	Nazwa hosta serwera aplikacji SAP.
AppServerService	Nazwa usługi lub numer portu określonego serwera aplikacji SAP do nawiązania połączenia (opcjonalnie dla typu połączenia (Logowanie) A — Serwer aplikacji).
Client	Identyfikator klienta SAP w celu nawiązania połączenia z systemem SAP. Klient zaplecza SAP (lub "Mandant"), do którego ma się zalogować. Jest to liczba z zakresu od 000 do 999.
Język	Kod języka umożliwiający nawiązanie połączenia z systemem SAP za pomocą polecenia . Dwuliterowy kod ISO 639-1. Musi być zainstalowany w oprogramowaniu SAP. Spowoduje to zastąpienie ustawienia języka przeglądarek.
Grupa logowania	Grupa logowania dla systemu SAP, z którego serwer komunikatów wybierze serwer aplikacji (dostępny tylko wtedy, gdy typ połączenia (logowanie) to B — serwer komunikatów (grupa)).
Typ logowania	Typ logowania do systemu SAP, logowanie serwera aplikacji (typ A) lub logowanie grupy (wpisz B aka Message Server). Dozwolone wartości: ApplicationServer, Group
MessageServerHost	Nazwa hosta serwera komunikatów systemu SAP (wystąpienie centralne) aka R3 Nazwa systemu (obowiązkowe, jeśli typ połączenia (logowanie) to B — serwer komunikatów (grupa)).
MessageServerService	Nazwa usługi (zdefiniowana w usługach etc/services) lub numer portu, w ramach którego serwer komunikatów nasłuchuje żądań równoważenia obciążenia (obowiązkowe, jeśli typ połączenia (logowanie) to B — serwer komunikatów (grupa) i identyfikator systemu nie jest obecny.
SafeTyping	Domyślnie podczas tworzenia połączenia SAP silne wpisywanie jest używane do sprawdzania nieprawidłowych wartości przez przeprowadzenie walidacji względem schematu. To zachowanie może pomóc w wykrywaniu problemów wcześniej. Opcja Bezpieczne wpisywanie jest dostępna w celu zachowania zgodności z poprzednimi wersjami i sprawdza tylko długość ciągu. Dozwolone wartości: true, false
SncCertificate	Certyfikat X.509 w postaci zakodowanej w formacie Base64 bez tagów certyfikatu rozpoczęcia lub zakończenia.
SncMyName	Zainstalowane rozwiązanie SNC zwykle zna własną nazwę SNC. Tylko w przypadku rozwiązań obsługujących "wiele tożsamości" może być konieczne określenie tożsamości, która ma być używana dla tego miejsca docelowego/serwera (opcjonalnie). W tym parametrze jest rozróżniana wielkość liter, dlatego sprawdź, czy administratorzy platformy SAP Basis mają poprawną wartość.
SncLibraryPath	Nazwa lub ścieżka biblioteki SNC do użycia. W przypadku lokalnej bramy danych ścieżka może być bezwzględna lub względna dla biblioteki NCo.
SncPartnerName	Nazwa SNC zaplecza (wymagana, gdy typ logowania to Serwer aplikacji). W tym parametrze jest rozróżniana wielkość liter, więc sprawdź, czy administratorzy platformy SAP Basis mają poprawną wartość.
SncQop	Jakość usługi, która ma być używana do komunikacji SNC z tym miejscem docelowym/serwerem. Dozwolone wartości: Uwierzytelnianie, Integralność, Prywatność, Wartość domyślna, Maksymalna
SncSso	Logowanie jednokrotne SNC określa, czy należy używać tożsamości SNC, czy poświadczeń podanych na poziomie RFC.
SsoCertificateSubject	Podmiot certyfikatu na komputerze z systemem Windows OPDG na potrzeby uwierzytelniania opartego na certyfikatach przy użyciu identyfikatora Firmy Microsoft Entra
Identyfikator systemowy	Trzyliterowy identyfikator systemu SAP (obowiązkowy, jeśli typ połączenia (logowanie) to B — serwer komunikatów (grupa) i usługa serwera komunikatów nie jest obecna.
Numer systemu	Numer systemowy systemu SAP. Jest to liczba z zakresu od 00 do 99 (obowiązkowe, jeśli typ połączenia (logowanie) to A — Serwer aplikacji.
UseSnc	Po wybraniu połączenia będą zabezpieczone za pomocą SNC. Dozwolone wartości: Tak

Migrowanie z `Call SAP Function` do `Call SAP Function (v2)`

Element Call SAP Function ten został wycofany w lipcu 2023 r., a wsparcie zakończy się w lipcu 2026 r. Użytkownicy będą musieli przeprowadzić migrację istniejących akcji w wersji 1 przed tym czasem lub ich przepływy zostaną przerwane.

Zastąp wiele pól formularza pojedynczymi parametrami JSON dla właściwości połączenia.
Użyj następującego mapowania właściwości:

Etykieta pola w wersji 1	Właściwość v2
AS Host	AppServerHost
Client	Client
Numer systemu AS	Numer systemu
Nazwa funkcji SAP	N/A — nie dotyczy parametrów połączenia
Sesja stanowa	Nie dotyczy — sesje stanowe są dostępne w obszarze "Opcje zaawansowane", w których można określić identyfikator dla elementu `Session Id`. Kroki z tym samym `Session Id` elementem będą uruchamiane w ramach tej samej sesji stanowej.
Korzystanie z SNC	UseSnc
Biblioteka SNC	SncLibraryPath
Logowanie jednokrotne SNC	SncSso
SNC Moja nazwa	SncMyName
Nazwa partnera SNC	SncPartnerName
Jakość ochrony SNC	SncQop

Example

Wywołaj funkcję SAP w wersji 1:

Wywoływanie funkcji SAP w wersji 1

Wywołaj funkcję SAP, wersja 2:

Wywoływanie funkcji SAP w wersji 2

Biorąc pod uwagę zrzut ekranu, parametry połączenia będą wyglądać następująco:

{
  "AppServerHost": "sap.example.com",
  "Client": 100,
  "SystemNumber": "00"
}

Ponieważ Use SNC na zrzucie ekranu nie ma właściwości "Nie", nie jest wymagana żadna właściwość. Wartość domyślna to "false"

Używanie zmiennych środowiskowych

Przepływy wbudowane w rozwiązania mogą zarządzać tymi parametrami połączenia przy użyciu zmiennych środowiskowych. Jest to zalecana metoda, ponieważ umożliwia zmianę parametrów połączenia na podstawie środowiska. Jeśli przepływ nie znajduje się w rozwiązaniu, zachowaj poręczność ciągu do kopiowania/wklejania.

Ogólne limity

Name	Wartość
Maksymalna liczba właściwości obsługiwanych przez schemat dynamiczny. Akcji Analizowanie kodu JSON można użyć do generowania schematu na podstawie przykładowego ładunku, jeśli przekracza maksymalną liczbę właściwości.	1024

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:


Microsoft Entra ID (z certyfikatami)	Aby uzyskać dostęp do oprogramowania SAP, użyj propagacji podmiotu zabezpieczeń entra id firmy Microsoft za pośrednictwem certyfikatów X509.	Wszystkie regiony	Nie można udostępniać
Microsoft Entra ID (z kerberos)	Użyj propagacji podmiotu zabezpieczeń identyfikatora Entra firmy Microsoft za pośrednictwem protokołu Kerberos, aby uzyskać dostęp do oprogramowania SAP.	Wszystkie regiony	Nie można udostępniać
Uwierzytelnianie SAP	Użyj nazwy użytkownika i hasła SAP, aby uzyskać dostęp do serwera SAP.	Wszystkie regiony	Nie można udostępniać
Uwierzytelnianie Windows	Użyj nazwy użytkownika systemu Windows i hasła, aby uzyskać dostęp do serwera SAP Server.	Wszystkie regiony	Nie można udostępniać
Domyślne [PRZESTARZAŁE]	Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami.	Wszystkie regiony	Nie można udostępniać

Microsoft Entra ID (z certyfikatami)

Identyfikator uwierzytelniania: UpnX509Certificate

Dotyczy: wszystkie regiony

Aby uzyskać dostęp do oprogramowania SAP, użyj propagacji podmiotu zabezpieczeń entra id firmy Microsoft za pośrednictwem certyfikatów X509.