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

  • 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 pyrfc und pyrfc.get_nwrfclib_version() prüfen. Fehlt pyrfc.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 pyrfc eingebunden werden.