Zum Inhalt springen

SAP-Verbindung

Einführung

Eine SAP-Verbindung, die den SAP-Connector verwendet, ermöglicht den Zugriff auf entweder SAP ECC Version 6 und höher oder SAP S/4HANA Single-Tenant. Sobald eine Verbindung konfiguriert ist, können Instanzen von SAP-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet zu werden.

Hinweis

Dieser Connector unterstützt die Re-Authentifizierung bei Änderung Organisationsrichtlinie. Wenn aktiviert, erfordert eine Änderung des Hosts, Benutzernamens oder Consumer Keys in dieser Verbindung, dass Benutzer das Passwort, den Sicherheitstoken und das Consumer Secret für die Verbindung erneut eingeben.

Erstellen oder Bearbeiten einer SAP-Verbindung

Eine neue SAP-Verbindung wird mit dem SAP-Connector aus einem dieser Standorte erstellt:

Eine vorhandene SAP-Verbindung kann von diesen Standorten bearbeitet werden:

Konfigurieren einer SAP-Verbindung

Jedes Benutzeroberflächenelement des SAP-Verbindungs-Konfigurationsbildschirms wird im Folgenden beschrieben.

Hinweis

Felder mit einem Symbol für Variablen unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben, oder indem Sie auf das Symbol für Variablen klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

  • Verbindungsname: Geben Sie einen Namen ein, um die SAP-Verbindung zu identifizieren. Der Name muss für jede SAP-Verbindung eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

  • SAP-Version: Wählen Sie entweder ECC oder S4HANA als SAP-Systemtyp aus. Der SAP-Connector ist mit der SAP ECC-Version 6 und höher oder SAP S/4HANA Single-Tenant kompatibel. SAP R/3 wird nicht unterstützt.

  • Benutzername: Geben Sie den Benutzernamen für die Anmeldung am SAP-System ein.

  • Passwort: Geben Sie das Passwort für die Anmeldung am SAP-System ein.

  • Mandant: Geben Sie die numerische Mandanten-ID an, die mit dem SAP-System verbunden ist. Der SAP-Administrator der Organisation kann diese Informationen bereitstellen.

  • Sprache: Geben Sie den Sprachcode für die Sprache ein, in der SAP-Nachrichten gesendet werden sollen. Die Standardsprache ist Englisch.

  • Host: Geben Sie den Hostnamen des SAP-Anwendungsservers ein.

  • Systemnummer: Geben Sie die SAP-Systemnummer ein.

  • Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

    • Zusätzliche Konfiguration der Verbindung: In diesem Abschnitt können Sie den SAP-Verbindungstyp auswählen und zusätzliche Verbindungseinstellungen angeben.

      • Für direkte Verbindung: Wählen Sie aus, wenn die SAP-Verbindung eine direkte Serververbindung ist (Standard). Wenn ausgewählt, wählen Sie nicht auch Für Lastenausgeglichene Verbindung.

      • Für lastenausgeglichene Verbindung: Wählen Sie aus, wenn die SAP-Verbindung Anfragen über einen Lastenausgleich verarbeitet. Wenn ausgewählt, wählen Sie nicht auch Für direkte Verbindung. Geben Sie die folgenden Informationen ein, um eine lastenausgeglichene Verbindung zu konfigurieren:

        • Gruppenname: Geben Sie den SAP-Gruppennamen der Anwendungsserver ein.

        • MSHost: Geben Sie den Hostnamen des SAP-Messageservers ein.

        • MSPort: Geben Sie den Port des SAP-Messageservers ein.

        • System-ID: Geben Sie die SAP-System-ID ein.

      • Router: Wenn das SAP-System durch eine Firewall geschützt ist, geben Sie die Routerzeichenfolge ein, die erforderlich ist, um eine Verbindung herzustellen.

    • Verbindungspool: In diesem Abschnitt können Sie die Einstellungen für den Verbindungspool Ihres SAP-Systems festlegen.

      • Maximale aktive Verbindungen: Geben Sie die maximale Anzahl gleichzeitiger Verbindungen an, die aus dem Verbindungspool des SAP-Systems erlaubt sind. Der Standardwert beträgt 10. Der maximal erlaubte Wert beträgt 250.

      • Maximale Anzahl von Verbindungen: Geben Sie die Anzahl der Verbindungen an, die im Verbindungspool gespeichert sind. Der Standardwert beträgt 15. Der maximal erlaubte Wert beträgt 250.

      • Zeitüberschreitung für inaktive Verbindungen: Geben Sie die maximale Zeit (in Sekunden) an, die eine Verbindung im Verbindungspool inaktiv bleiben kann. Der Standard- und Maximalwert beträgt 3600 Sekunden.

    • Listener-Aktivitätseigenschaften: Wenn Sie die Receive IDoc-Aktivität verwenden möchten, müssen diese Felder konfiguriert werden:

      • Listener-Anzahl: Geben Sie die Anzahl der Threads an, die zugewiesen werden sollen, um eingehende Anfragen zu empfangen. Der Standardwert beträgt 1, da jeder Listener-Thread in der Lage ist, einen IDoc-Aufruf gleichzeitig zu akzeptieren und zu verarbeiten. Ein höherer Wert ermöglicht es dem Server, mehr gleichzeitige RFC-Aufrufe zu verarbeiten.

      • Ziel: Geben Sie das RFC-Ziel an, das im SAP-System konfiguriert ist, wie in den Voraussetzungen beschrieben. Das Ziel muss für jede SAP-Verbindung eindeutig sein.

      • Gateway-Dienst: Geben Sie den Namen des Gateway-Servers für das SAP-System ein.

      Hinweis

      Bestätigen Sie, dass die Werte für diese Felder gültig sind, da ungültige Werte zu einem Fehler beim Bereitstellen der Operation oder beim Aktivieren des Listeners führen können.

  • Zusätzliche Konfiguration der SAP-Verbindung: Verwenden Sie diese Tabelle, um Schlüssel-Wert-Paare hinzuzufügen, die mit jeder Aktivitätsanfrage gesendet werden. Jeder Wert, der zur Tabelle hinzugefügt wird, ist im Anfrage-Schema jeder Aktivität enthalten.

    -   <span class="icon-plus" style="color: #908c94"></span> **Hinzufügen:** Fügt eine Zeile zur Tabelle hinzu. Geben Sie ein Schlüssel-Wert-Paar für jede Eigenschaft ein.
-   <span class="icon-success" style="color: #908c94"></span> **Einreichen:** Speichert das Schlüssel-Wert-Paar in der Tabelle. Sichtbar beim Überfahren einer Zeile im Bearbeitungsmodus.
-   <span class="icon-fail" style="color: #908c94"></span> **Verwerfen:** Verwirft eine neue Zeile oder alle Änderungen an einer bestehenden Zeile. Sichtbar beim Überfahren einer Zeile im Bearbeitungsmodus.
-   <span class="icon-edit" style="color: #908c94"></span> **Bearbeiten:** Ermöglicht das Bearbeiten eines bestehenden Schlüssel-Wert-Paares. Sichtbar beim Überfahren einer bestehenden Zeile.
-   <span class="icon-trash" style="color: #908c94"></span> **Löschen:** Löscht die Zeile aus der Tabelle. Sichtbar beim Überfahren einer bestehenden Zeile.
-   **Alle löschen:** Löscht alle Zeilen aus der Tabelle.

!!! note "Hinweis"
    Der Mindestwert im Feld **Wert** beträgt `1`. Jeder Wert unter `1` führt zu einem Fehler beim Testen der Verbindung.

!!! important "Wichtig"
    Felder in der Tabelle **Zusätzliche Konfiguration der SAP-Verbindung** zeigen das <span class="icon-variable"></span> Symbol für Variablen nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit befüllt werden, muss die Agenten-Version mindestens [10.75 / 11.13](/de/release-notes/harmony-release-notes/summer-2023/10-75-11-13/) sein.

    Felder in der Tabelle **Zusätzliche Konfiguration der SAP-Verbindung** unterstützen nicht die Verwendung von Variablen, um rohes JSON zu übergeben. Wenn Ihr Anwendungsfall nicht unterstützt, rohes JSON direkt in den Feldern zu definieren, entkommen Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Zum Beispiel wird `{"success": "true"};` zu `{\"success\": \"true\"};`.

  • Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisation Richtlinie Automatische Connector-Aktualisierung deaktivieren.

    Tipp

    Wenn beim Testen der Verbindung diese Fehlermeldung zurückgegeben wird, kann dies daran liegen, dass die erforderlichen SAP-Bibliotheken nicht installiert sind:

    Ein Fehler ist aufgetreten: Der Connector ist teilweise auf dem Jitterbit-Agenten geladen oder es fehlt an Funktionalität. Fehler: NoClassDefFoundError com/sap/conn/jco/JCoException. Siehe Protokolle für weitere Details.

    Um die erforderlichen SAP-Bibliotheken zu installieren, siehe SAP-Connector-Installation.

  • Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.

  • Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine SAP-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfsgrafik, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Palette der Entwurfskomponenten zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar: