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
-
Ab Worker S 39.2.5 enthält das Worker-Image das Python-Modul pyrfc. Es basiert auf PyRFC.
-
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.
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.
-
-
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. Fehltpyrfc.Connection, findet der Worker die SDK-Bibliotheken nicht.
Einrichtung mit Worker vor S 39.2.5
Hinweise
-
Worker-Images vor S 39.2.5 enthalten das Python-Modul pyrfc nicht. Der Import meldet dann No module named 'pyrfc'. Stellen Sie pyrfc in diesem Fall zusätzlich zu den SDK-Bibliotheken bereit.
-
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
-
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.
-
Den Worker-Container neu starten.
-
Nach dem Update auf Worker S 39.2.5 oder höher die Einbindungen von pyrfc und pyrfc-3.3.1.dist-info entfernen.
Verwendung
Information
-
Das Python-Modul pyrfc kann in PLANTA Project in beliebigen Python-Makros mit
import pyrfceingebunden werden.