Information
-
Diese Seite beschreibt die technische Anbindung von PLANTA Project an ein SAP-System. Sie ist relevant, wenn Sie eine SAP-Schnittstelle auf Basis der Universal-Schnittstelle von PLANTA link einrichten.
-
Den Datenaustausch und die fachliche Logik beschreibt die Seite Einführung in PLANTA link und Schnittstellen.
-
PLANTA stellt einige SAP-Standard-Schnittstellen zur Verfügung, die als Vorlage zum Aufsetzen individueller SAP-Schnittstellen verwendet werden können.
Siehe auch: Weitere Integrationen von PLANTA Project
Allgemeines
Information
-
PLANTA Project kommuniziert mit dem SAP-System über RFC-Aufrufe (Remote Function Call).
-
Dazu bindet der Worker die SAP NetWeaver RFC Client-Bibliothek über das Python-Modul pyrfc ein.
Einrichtung
Voraussetzungen
-
Das Worker-Image enthält das Python-Modul pyrfc nicht. Es basiert auf PyRFC und wird kundenseitig bereitgestellt.
-
Die Bibliotheken des SAP NetWeaver RFC Software Development Kit (SDK) 7.50 für Linux sind nicht im Image enthalten. Sie werden kundenseitig bereitgestellt.
-
Der Worker-Container muss das SAP-System über das Netzwerk erreichen.
Hinweise
-
Der Worker findet die SDK-Bibliotheken über die Umgebungsvariable LD_LIBRARY_PATH. Der Pfad /planta/dlls muss dabei an erster Stelle stehen.
-
Die Umgebungsvariable SAPNWRFC_HOME wird nicht benötigt.
-
Legen Sie pyrfc nicht im Customizing-Ordner venus ab. Der Import schlägt dort fehl.
-
Das Volume darf im Worker-Container nicht mit der Option noexec eingebunden sein. Sonst lädt der Worker die Bibliotheken nicht, und das Log meldet failed to map segment from shared object.
Vorgehensweise
-
Die SDK-Bibliotheken in einem Verzeichnis ablegen und dieses Verzeichnis als Volume in den Worker-Container einbinden, z. B. unter /opt/sap/nwrfcsdk/lib.
-
Bei einer Einzelumgebung geschieht das in der Datei docker-compose.yml unter volumes des Worker-Dienstes.
-
Bei einer orchestrierten Umgebung geschieht das in den Helm-Werten unter worker.additionalVolumes und worker.additionalVolumeMounts.
-
-
Aus dem Wheel von PyRFC 3.3.1 für Python 3.12 unter Linux (cp312) die Verzeichnisse pyrfc und pyrfc-3.3.1.dist-info entnehmen.
-
Beide Verzeichnisse einzeln in den Worker-Container einbinden, unter /planta/py/distribution/site-packages/pyrfc und /planta/py/distribution/site-packages/pyrfc-3.3.1.dist-info. Ohne das Verzeichnis pyrfc-3.3.1.dist-info schlägt der Import fehl.
-
Die Umgebungsvariable LD_LIBRARY_PATH des Worker-Containers auf /planta/dlls:/opt/sap/nwrfcsdk/lib setzen.
-
Bei einer Einzelumgebung geschieht das in der Datei docker-compose.yml unter environment des Worker-Dienstes.
-
Bei einer orchestrierten Umgebung geschieht das in den Helm-Werten unter worker.env.
-
-
Den Worker-Container neu starten.
-
Die Einrichtung in einem Python-Makro mit
import pyrfcundpyrfc.get_nwrfclib_version()prüfen. Meldet der Import No module named 'pyrfc', ist pyrfc nicht eingebunden. Fehltpyrfc.Connection, findet der Worker die SDK-Bibliotheken nicht.
Ab Version 27 mit Worker S 39.2.5 enthält das Worker-Image das Python-Modul pyrfc. Nach dem Update genügt es, die SDK-Bibliotheken bereitzustellen. Entfernen Sie dann die Einbindungen von pyrfc und pyrfc-3.3.1.dist-info aus dem Worker-Container.
Verwendung
Information
-
Das Python-Modul pyrfc kann in PLANTA Project in beliebigen Python-Makros mit
import pyrfceingebunden werden.
Die Einrichtung auf dieser Seite gilt für PLANTA Project im Container-Betrieb. Ist Ihr PLANTA-Server klassisch unter Windows oder Linux installiert (bis Server S 39.5.37), finden Sie die Einrichtung in der Dokumentation zur Version 39.5.23.
Das Modul sapnwrfc ist ab Server S 39.5.31 durch pyrfc ersetzt. Python-Makros, die noch sapnwrfc verwenden, stellen Sie beim Wechsel in den Container-Betrieb auf pyrfc um.