SAP ERP

Az SAP ERP egy nagyvállalati erőforrás-tervező szoftver, amelyet az SAP SE fejlesztett ki. Az SAP ERP magában foglalja a szervezet legfontosabb üzleti funkcióit. Az SAP ERP-összekötővel RFC- és BAPI-függvényeket hívhat meg egy helyszíni adatátjáró használatával.

Ez az összekötő a következő termékekben és régiókban érhető el:

Service	Class	Régiók
Copilot Studio	prémium	Minden Power Automate-régió
Power Alkalmazások	prémium	Minden Power Apps-régió
Power Automate	prémium	Minden Power Automate-régió

Érintkezés
Név	Microsoft
URL	https://learn.microsoft.com/connectors/saperp/

Összekötő metaadatai
Kiadó	Microsoft
Webhely	https://www.sap.com/products/enterprise-management-erp.html
Adatvédelmi irányelvek	https://www.sap.com/about/legal/privacy.html
Kategóriák	Termelékenység

Az SAP ERP-összekötő használata

Az összekötő használatának megkezdéséhez olvassa el az alábbi blogbejegyzéseket:

Pre-requisites

Az SAP ERP-összekötő függőséget tartalmaz a következő összetevőkhöz, amelyeket ugyanazon a gépen kell telepíteni:

Helyszíni adatátjáró (2023. októberi verzió – 3000.194-es vagy újabb verzió)
Microsoft C++ Runtime DLL 14.x-es verzió (Visual Studio 2015, 2017, 2019 és 2022) (SAP NCo-függőség)
SAP .NET-összekötő az SAP-ból
- Válassza ki az NCo 3.1 64 bites verzióját (a 32 bites nem támogatott)
- Ne telepítse az NCo 3.0-t (nem támogatott)
- A letöltési hozzáféréshez érvényes S-felhasználó szükséges. Előfordulhat, hogy kapcsolatba kell lépnie az SAP-csapattal.

SAP-engedélyek

Az SAP-felhasználói fióknak hozzá kell férnie a RFC_METADATA függvénycsoporthoz és a megfelelő függvénymodulokhoz a következő műveletekhez:

Operations	Hozzáférés a függvénymodulokhoz
RFC-műveletek	`RFC_GROUP_SEARCH`, `DD_LANGU_TO_ISOLA`
BAPI-műveletek	`BAPI_TRANSACTION_COMMIT`, `BAPI_TRANSACTION_ROLLBACK`, `RPY_BOR_TREE_INIT`, `SWO_QUERY_METHODS`, , `SWO_QUERY_API_METHODS`
IDoc-műveletek	`IDOCTYPES_LIST_WITH_MESSAGES`, `IDOCTYPES_FOR_MESTYPE_READ`, `INBOUND_IDOCS_FOR_TID`, `OUTBOUND_IDOCS_FOR_TIDGET_STATUS_FROM_IDOCNRIDOC_RECORD_READ`
SAP-táblaművelet olvasása	`RFC BBP_RFC_READ_TABLE` vagy `RFC_READ_TABLE`
Minimális hozzáférés	`RFC_METADATA_GET`, `RFC_METADATA_GET_TIMESTAMP`

Authentication

Az összekötő támogatja az SAP-hitelesítést, a Windows-hitelesítést, a Kerberos-alapú Microsoft Entra-azonosítót és a Tanúsítványokkal rendelkező Microsoft Entra-azonosítót.

Mivel az összekötőt úgy tervezték, hogy egy alkalmazás több felhasználója használja, a kapcsolatok nem lesznek megosztva. Ehelyett minden felhasználó az SAP-rendszerrel fog hitelesíteni. A felhasználói hitelesítő adatok a kapcsolaton belül vannak megadva, míg az SAP-rendszerhez való csatlakozáshoz szükséges további részletek (például a kiszolgáló adatai, a biztonsági konfiguráció) a művelet részeként jelennek meg.

SAP-hitelesítés

Egyszerű SAP-hitelesítés SAP-felhasználónévvel és jelszóval.

Windows-hitelesítés

További beállításokat igényel a biztonságos hálózati kommunikációhoz (SNC). További beállításokat igényel a Kerberos-alapú egyszeri bejelentkezéshez a Power Platformról a helyszíni adatforrásokra.

Microsoft Entra ID (Kerberossal)

Microsoft Entra-azonosító (tanúsítványokkal)

További beállításokat igényel a biztonságos hálózati kommunikációhoz (SNC). További beállításokat igényel a tanúsítványalapú egyszeri bejelentkezéshez a Power Platformtól a helyszíni adatforrásokig.

Kerberos-alapú egyszeri bejelentkezés konfigurálása

A felhasználó SAP SNC-nevének (p:CN=JANEDOE@REDMOND.CORP.CONTOSO.COM) meg kell egyenlõnek a Microsoft Entra ID teljes tartománynévvel (JANEDOE@REDMOND.CORP.CONTOSO.COM) a Windows és a Microsoft Entra ID hitelesítéshez.

SAP SNC name

Ingatlan	Description
Az SNC használata	Ha engedélyezni szeretné az SNC-t, állítsa "Igen" értékre
SNC-kódtár	Az SNC-kódtár neve vagy elérési útja az NCo telepítési helyéhez vagy az abszolút elérési úthoz viszonyítva. Ilyenek például a `sapcrypto.dll` vagy `.\security\sapcrypto.dll`a `c:\security\sapcrypto.dll`.
SNC SSO	Megadja, hogy az összekötő a szolgáltatás identitását vagy a végfelhasználói hitelesítő adatokat használja-e
SNC Saját név	Szükség esetén adja meg a használni kívánt identitást
SNC-partner neve	A háttérbeli SNC-kiszolgáló neve
Az SNC védelmi minősége	Az adott cél vagy kiszolgáló SNC-kommunikációjára használandó szolgáltatásminőség. Az alapértelmezett értéket a háttérrendszer határozza meg. A maximális értéket az SNC-hez használt biztonsági termék határozza meg.

Ha az SAP ERP-összekötőhöz Microsoft Entra-azonosítóra vagy Windows-hitelesítésre van szükség, a következőkre van szükség:

Kerberos-alapú egyszeri bejelentkezés konfigurálása a Power Platformról a helyszíni adatforrásokra
Az SAP ERP konfigurálása a CommonCryptoLib használatának engedélyezéséhez (sapcrypto.dll)

Kerberos-alapú egyszeri bejelentkezés konfigurálása a Power Platformról a helyszíni adatforrásokra Előfeltételek

A Data Gateway telepítése után az átjáró az NT Service\PBIEgwService számítógép-helyi szolgáltatásfiókként fut. A Kerberos által korlátozott delegálás engedélyezéséhez két lehetősége van:

Az átjárónak tartományi fiókként kell futnia, lásd az átjárószolgáltatás-fiók módosításának dokumentációját ; vagy
Szinkronizálja a Microsoft Entra ID-példányt a helyi Microsoft Entra ID-példánysal (a Microsoft Entra ID DirSync/Connect használatával)

Konfigurációs lépések:

Tartományadminisztrátori jogosultságok beszerzése az SPN-ek (SetSPN) és a Kerberos korlátozott delegálási beállításainak konfigurálásához
Korlátozott Kerberos-delegálás konfigurálása az átjáróhoz és az adatforráshoz
Egyszerű szolgáltatásnév konfigurálása az átjárószolgáltatás-fiókhoz
Átjárószolgáltatás-fiók hozzáadása a Windows engedélyezési és hozzáférési csoportjához, ha szükséges
Döntse el, hogy milyen típusú Kerberos-korlátozott delegálást használjon:
- Az átjárószolgáltatás-fiók konfigurálása normál Kerberos-korlátozott delegáláshoz
- Az átjárószolgáltatás-fiók konfigurálása erőforrás-alapú korlátozott Kerberos-delegáláshoz
Az átjáró szolgáltatásfiókjának helyi házirend-jogosultságok biztosítása az átjárógépen
Felhasználóleképezés konfigurációs paramétereinek beállítása az átjárógépen (ha szükséges)

Ennek konfigurálásáról további információt a Kerberos-alapú egyszeri bejelentkezés power BI-dokumentációjában talál a Power BI szolgáltatásból a helyszíni adatforrásokra.

Az SAP ERP konfigurálása a CommonCryptoLib használatának engedélyezéséhez (sapcrypto.dll)

Győződjön meg arról, hogy az SAP ERP-kiszolgáló megfelelően van konfigurálva a Kerberos SSO-hoz a CommonCryptoLib használatával. Ha igen, az SSO használatával hozzáférhet az SAP ERP-kiszolgálóhoz egy SAP-eszközzel, például az SAP GUI-val, amely a CommonCryptoLib használatára lett konfigurálva. A beállítási lépésekről további információt az SAP Egyszeri bejelentkezés: Hitelesítés Kerberos/SPNEGO használatával című témakörben talál. A kiszolgálónak a CommonCryptoLib-t kell használnia SNC-kódtárként, és rendelkeznie kell egy CN-vel kezdődő SNC-névvel. Az SNC-névkövetelményekről (pontosabban a paraméterről) további információt a snc/identity/as Kerberos-konfiguráció SNC-paramétereiben talál.
Győződjön meg arról, hogy az SAP Secure Login Client (SLC) nem fut azon a számítógépen, amelyen az átjáró telepítve van. Az SLC úgy gyorsítótárazza a Kerberos-jegyeket, hogy az zavarja az átjáró azon képességét, hogy Kerberost használjon az egyszeri bejelentkezéshez. Ha az SLC telepítve van, távolítsa el, vagy győződjön meg arról, hogy kilép az SAP Biztonságos bejelentkezési ügyfélprogramból. Kattintson a jobb gombbal a tálcán található ikonra, és válassza a Kijelentkezés és kilépés lehetőséget, mielőtt SSO-kapcsolatot próbál meg az átjáróval. Az SLC nem támogatott Windows Server-gépeken való használatra. További információ: SAP Note 2780475 (s-user required).

SAP Secure Login Client

Ha eltávolítja az SLC-t, vagy a Kijelentkezés és kilépés lehetőséget választja, nyisson meg egy parancsablakot, és írja be klist purge a gyorsítótárazott Kerberos-jegyek törléséhez, mielőtt SSO-kapcsolatot kísérel meg az átjárón keresztül.
Töltse le a 64 bites CommonCryptoLib (sapcrypto.dll) 8.5.25-ös vagy újabb verzióját az SAP Launchpadről, és másolja az átjárógép egyik mappájába. Ugyanabban a könyvtárban, ahol másolt sapcrypto.dll, hozzon létre egy fájlt sapcrypto.inia következő tartalommal:

ccl/snc/enable_kerberos_in_client_role = 1

A .ini fájl a CommonCryptoLib által az egyszeri bejelentkezés engedélyezéséhez szükséges konfigurációs információkat tartalmazza az átjáróforgatókönyvben.

Megjegyzés:

Ezeket a fájlokat ugyanazon a helyen kell tárolni; más szóval tartalmaznia /path/to/sapcrypto/ kell mind sapcrypto.ini a sapcrypto.dll.

Mind az átjárószolgáltatás felhasználójának, mind a Microsoft Entra-azonosító felhasználónak, amelyet a szolgáltatásfelhasználó megszemélyesít, olvasási és végrehajtási engedélyekre van szüksége mindkét fájlhoz. Javasoljuk, hogy a hitelesített felhasználók csoportnak adjon engedélyeket mind a .ini.dll fájlokhoz, mind a fájlokhoz. Tesztelési célokból ezeket az engedélyeket kifejezetten megadhatja az átjárószolgáltatás felhasználójának és a teszteléshez használt Microsoft Entra-azonosító felhasználónak is. Az alábbi képernyőképen a Hitelesített felhasználók csoport olvasási és végrehajtási engedélyeit adtuk meg a következőhöz sapcrypto.dll:

Olvasási és végrehajtási engedélyek megadása hitelesített felhasználók számára

Ha még nem rendelkezik SAP BW-adatforrással ahhoz az átjáróhoz, amelyen keresztül át szeretné haladni az egyszeri bejelentkezést, vegyen fel egyet a Power BI szolgáltatás Átjárók kezelése lapján. Ha már rendelkezik ilyen adatforrással, szerkessze:

Válassza az SAP Business Warehouse-t adatforrástípusként, ha SSO-kapcsolatot szeretne létrehozni egy BW-alkalmazáskiszolgálóhoz.
Válassza az Sap Business Warehouse üzenetkiszolgálót, ha SSO-kapcsolatot szeretne létrehozni egy BW üzenetkiszolgálóval.

Hozzon létre egy rendszerkörnyezeti változót CCL_PROFILE , és állítsa az értékét a következő sapcrypto.inielérési útra.

CCL_PROFILE rendszerkörnyezet változója:

Rendszerkörnyezeti változók létrehozása és beállítása

A sapcrypto.dll fájloknak .ini ugyanabban a helyen kell lenniük. A fenti példában sapcrypto.inisapcrypto.dll mindkettő az asztalon található.

Indítsa újra az átjárószolgáltatást.

Az átjárószolgáltatás-szolgáltatások újraindítása

Microsoft Entra-azonosító hitelesítése

Ez a hitelesítési típus csak a következő műveletekkel működik:

SAP-függvény meghívása (V2)
Állapotalapú munkamenet létrehozása
SAP-tábla olvasása elemzéssel

A Microsoft Entra ID SAP-szolgáltatásnév-fióknak az attribútumban msDS-SupportedEncryptionType definiált AES 128-tal vagy AES 256-tal kell rendelkeznie. Ez a blogbejegyzés egy táblázatot tartalmaz, amely segít a decimális/hexa értékek kiszámításában a támogatott titkosítási típusok esetében.

Ismert problémák és korlátozások

Az SAP ERP-összekötő ismert problémái és korlátozásai a következők:

Az összekötő csak az RFC-ket és a BAPI-kat támogatja.
Az összekötő nem támogatja az SAP Servertől érkező üzenetek fogadását.
A tranzakciós RFC-k (tRC-k) nem támogatottak.
Az átjáró 2 MB hasznos adatkorlátot biztosít az írási műveletekhez, és 8 MB-os tömörített adatválasz-korlátot biztosít az olvasási műveletekhez.
Az állapotalapú SAP-műveletek nem támogatják a terheléselosztási módban lévő adatátjáró-fürtöket. Az állapotalapú kommunikációnak ugyanazon az adatátjáró-fürtcsomóponton kell maradnia. Állapotalapú SAP-műveletekhez használja az adatátjárót nem fürt módban vagy olyan fürtben, amely csak feladatátvételre van beállítva.
Frissítse a helyszíni adatátjárót a legújabb verzióra , ha a folyamat létrehozása során a következőhöz hasonló hibaüzenet jelenik meg: Length of the name of the RFC '<RFC_NAME>?honorSapOptionalFlag=1' is larger than the maximum allowed limit of 30
Az SAP-ból lekért RFC/BAPI-paraméterek gyorsítótárazva vannak a helyszíni adatátjárón belül. Indítsa újra a helyszíni adatátjáró szolgáltatást a gyorsítótár törléséhez és az új értékek lekéréséhez.

Naplók gyűjtése

Az alábbi naplók hasznosak a SapErp-összekötőkkel kapcsolatos problémák elhárításához, amikor kapcsolatba lépnek a Microsoft ügyfélszolgálatával:

Engedélyezze Additional logging a Diagnostics helyszíni adatátjáró-alkalmazás beállításaiban az SAP Adapter kiterjesztett naplóinak és a SapErp Adapter nyomkövetéseinek lekérését Informational .
Frissítse a következő beállítást a konfigurációs fájlban Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config. Ez a konfigurációs fájl általában ott található, ahol a helyszíni adatátjáró telepítve van (például C:\Program Files\On-premises data gateway\Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config).
```
<setting name="SapTraceLevel" serializeAs="String">
   <value>Verbose</value>
</setting>
```

SAP-rendszertulajdonságok – útmutató

A paramétert SAP system támogató műveletekhez az alábbi táblázatban talál útmutatást.

Ingatlan	Description
AppServerHost	Az SAP-alkalmazáskiszolgáló állomásneve.
AppServerService	Az adott SAP Application Server szolgáltatásneve vagy portszáma, amelyhez csatlakozni szeretne (Nem kötelező a kapcsolattípushoz (Bejelentkezés) A – Alkalmazáskiszolgáló).
Ügyfél	Az SAP-ügyfél azonosítója az SAP-rendszerhez való csatlakozáshoz. Az SAP háttérrendszer ügyfele (vagy "Mandant"), amelybe be kell jelentkeznie. Ez a szám 000-től 999-ig terjed.
Nyelv	Az SAP-rendszerhez való csatlakozáshoz használt nyelvi kód. Kétbetűs ISO 639-1 kód. Az SAP-n belül kell telepíteni. Ez felülírja a böngésző nyelvbeállítását.
LogonGroup	Az SAP-rendszer bejelentkezési csoportja, amelyből az üzenetkiszolgálónak ki kell választania egy alkalmazáskiszolgálót (csak akkor érhető el, ha a kapcsolat típusa (bejelentkezés) B – Üzenetkiszolgáló (csoport)).
LogonType	Az SAP-rendszerbe való bejelentkezés típusa, vagy az Application Server bejelentkezése (A típus) vagy a csoportos bejelentkezés (B típus aka üzenetkiszolgáló). Engedélyezett értékek: ApplicationServer, Group
MessageServerHost	Az SAP-rendszer üzenetkiszolgálójának (központi példányának) állomásneve, más néven R3 rendszernév (kötelező, ha a kapcsolat típusa (bejelentkezés) B – Üzenetkiszolgáló (csoport)).
MessageServerService	A szolgáltatás neve (az etc/services-ben meghatározottak szerint) vagy az a portszám, amely alatt az üzenetkiszolgáló figyeli a terheléselosztási kérelmeket (kötelező, ha a kapcsolat típusa (bejelentkezés) B – Üzenetkiszolgáló (csoport) és a rendszerazonosító nem található.
SafeTyping	Alapértelmezés szerint az SAP-kapcsolat létrehozásakor a rendszer erős gépeléssel ellenőrzi az érvénytelen értékeket a sémán végzett ellenőrzéssel. Ez a viselkedés segíthet a problémák korábbi észlelésében. A Biztonságos gépelés beállítás a visszamenőleges kompatibilitás érdekében érhető el, és csak a sztring hosszát ellenőrzi. Engedélyezett értékek: igaz, hamis
SncCertificate	X.509-tanúsítvány Base64 kódolású formában, kezdő vagy záró tanúsítványcímkék nélkül.
SncMyName	A telepített SNC-megoldás általában ismeri a saját SNC-nevét. Csak a "több identitást" támogató megoldások esetében lehet, hogy meg kell adnia a cél/kiszolgáló számára használandó identitást (nem kötelező). Ez a paraméter megkülönbözteti a kis- és nagybetűket, ezért ellenőrizze az SAP Alap rendszergazdáinál a megfelelő értéket.
SncLibraryPath	A használni kívánt SNC-kódtár neve vagy elérési útja. A helyszíni adatátjáróval az elérési út abszolút vagy relatív lehet az NCo-kódtárhoz képest.
SncPartnerName	A háttérrendszer SNC-neve (akkor szükséges, ha a bejelentkezési típus az Application Server). Ez a paraméter megkülönbözteti a kis- és nagybetűket, ezért kérdezze meg az SAP Alap rendszergazdáit a megfelelő értékről.
SncQop	A cél/kiszolgáló SNC-kommunikációjára használandó szolgáltatásminőség. Engedélyezett értékek: Hitelesítés, Integritás, Adatvédelem, Alapértelmezett, Maximum
SncSso	Az SNC SSO meghatározza, hogy az SNC-identitást vagy az RFC-szinten megadott hitelesítő adatokat használja-e.
SsoCertificateSubject	Tanúsítvány tárgya az OPDG Windows-gépen a Tanúsítványalapú hitelesítéshez a Microsoft Entra-azonosítóval
SystemId	Az SAP-rendszer hárombetűs rendszerazonosítója (kötelező, ha a kapcsolat típusa (bejelentkezés) B – Üzenetkiszolgáló (Csoport) és az Üzenetkiszolgáló szolgáltatás nincs jelen.
SystemNumber	Az SAP-rendszer rendszerszáma. Ez egy 00 és 99 közötti szám (kötelező, ha a kapcsolat típusa (bejelentkezés) az A - Application Server).
UseSnc	Ha ki van választva, a kapcsolatok SNC-vel lesznek biztosítva. Engedélyezett értékek: Igen

Migrálás innen:`Call SAP FunctionCall SAP Function (v2)`

A Call SAP Function 2023 júliusában megszüntetett támogatás 2026 júliusában megszűnik. A felhasználóknak át kell telepíteniük a meglévő 1. v1-et, vagy a folyamatok megszakadnak.

Több űrlapmezőt cserélje le egyetlen JSON-sztringre a kapcsolat tulajdonságaihoz.
Használja a következő tulajdonságleképezést:

v1 mezőfelirat	v2 tulajdonság
AS-gazdagép	AppServerHost
Ügyfél	Ügyfél
AS rendszerszám	SystemNumber
SAP-függvény neve	N/A – kapcsolati sztring szempontjából nem releváns
Állapotalapú munkamenet	N/A – Az állapotalapú munkamenetek a "Speciális beállítások" területen érhetők el, ahol megadható egy azonosító `Session Id`. Az azonos `Session Id` lépések ugyanazon állapotalapú munkamenet részeként lesznek futtatva.
Az SNC használata	UseSnc
SNC-kódtár	SncLibraryPath
SNC SSO	SncSso
SNC Saját név	SncMyName
SNC-partner neve	SncPartnerName
Az SNC védelmi minősége	SncQop

Example

AZ SAP-függvény 1. hívása:

SAP-függvény meghívása 1.

AZ SAP-függvény 2. hívása:

SAP-függvény meghívása v2

A képernyőkép alapján a kapcsolati sztring a következőképpen nézne ki:

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

Mivel Use SNC a képernyőképen a "Nem" érték szerepel, nincs szükség tulajdonságra. Az alapértelmezett érték a "false" (hamis)

Környezeti változók használata

A beépített folyamatok környezeti változók használatával kezelhetik ezeket a kapcsolati sztringeket. Ez az ajánlott módszer, mivel lehetővé teszi a kapcsolat paramétereinek módosítását a környezet alapján. Ha a folyamat nincs megoldásban, a sztringet a másoláshoz/beillesztéshez tartsa kéznél.

Általános korlátok

Név	Érték
A dinamikus séma által támogatott tulajdonságok maximális száma. A JSON-elemzési művelet használatával séma hozható létre a minta hasznos adataiból, ha túllépi a tulajdonságok maximális számát.	1024

Kapcsolat létrehozása

Az összekötő a következő hitelesítési típusokat támogatja:


Microsoft Entra-azonosító (tanúsítványokkal)	Az SAP eléréséhez használja a Microsoft Entra azonosító egyszerű propagálását X509-tanúsítványokkal.	Minden régió	Nem osztható meg
Microsoft Entra ID (Kerberossal)	Az SAP eléréséhez használja a Microsoft Entra azonosító egyszerű propagálását a Kerberoson keresztül.	Minden régió	Nem osztható meg
SAP-hitelesítés	Sap-felhasználónév és jelszó használata az SAP-kiszolgáló eléréséhez.	Minden régió	Nem osztható meg
Windows-hitelesítés	Az SAP Server eléréséhez használja a windowsos felhasználónevet és jelszót.	Minden régió	Nem osztható meg
Alapértelmezett [ELAVULT]	Ez a beállítás csak olyan régebbi kapcsolatokhoz használható, amelyeknek nincs explicit hitelesítési típusuk, és csak a visszamenőleges kompatibilitást biztosítják.	Minden régió	Nem osztható meg

Microsoft Entra-azonosító (tanúsítványokkal)

Hitelesítési azonosító: UpnX509Certificate

Alkalmazható: Minden régió

Az SAP eléréséhez használja a Microsoft Entra azonosító egyszerű propagálását X509-tanúsítványokkal.