Schnittstellen
Version 27 Version 26 39.5.25 39.5.23 39.5.22 39.5.21 39.5.20 39.5.19 39.5.18 39.5.17 German English
Version 27 Version 26 39.5.25 39.5.23 39.5.22 39.5.21 39.5.20 39.5.19 39.5.18 39.5.17 German English

PLANTA Project und SAP

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 pyrfc und pyrfc.get_nwrfclib_version() prüfen. Meldet der Import No module named 'pyrfc', ist pyrfc nicht eingebunden. Fehlt pyrfc.Connection, findet der Worker die SDK-Bibliotheken nicht.

Update auf Version 27

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 pyrfc eingebunden werden.

Klassische Installation unter Windows oder Linux

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.