SAP ERP

Für Ereignisabo konfigurieren

Wenn Sie das Abonnieren von Ereignissen aktivieren, müssen Sie das ABAP SDK konfigurieren. Informationen zum Konfigurieren des ABAP SDK finden Sie unter ABAP SDK for Google Cloud – Übersicht.

Geben Sie im Abschnitt Details zum Ereignisabo die folgenden Werte ein:

1. Wählen Sie einen der folgenden Authentifizierungstypen für den Event-Listener aus.
   • Google-Authentifizierung. Wenn Sie diese Option aktivieren, folgen Sie der Anleitung unter Mit JSON-Webtokens authentifizieren, um die Authentifizierung für das ABAP SDK zu konfigurieren. Außerdem muss das Dienstkonto die Rolle roles/connectors.listener haben, deren Zugriffstoken für die Authentifizierung verwendet wird.
   • Authentifizierung von API-Schlüsseln Wenn Sie diese Option auswählen, müssen Sie einen API-Schlüssel erstellt und als Secret Manager-Secret gespeichert haben. Weitere Informationen finden Sie unter API-Schlüssel erstellen.
2. Geben Sie den Feldnamen für den Ereignistyp ein. In diesem Feld wird der Typ des Ereignisses angegeben, das mit der eingehenden Ereignisanfrage verknüpft ist.

   {
   "event_type": "user.created",
   ...
   // other request fields
   ...
   }

3. Wählen Sie Private Verbindung aktivieren aus, um eine sichere Verbindung zwischen Ihrer Backend-Anwendung und Ihrer Verbindung herzustellen. Wenn Sie diese Option auswählen, müssen Sie nach dem Erstellen der Verbindung zusätzliche Konfigurationsschritte ausführen. Weitere Informationen finden Sie unter Private Verbindung für Ereignisabos.
4. Geben Sie die Konfiguration für unzustellbare Nachrichten ein. Wenn Sie ein Thema für fehlgeschlagene Nachrichten konfigurieren, schreibt die Verbindung die nicht verarbeiteten Ereignisse in das angegebene Pub/Sub-Thema. Geben Sie die folgenden Informationen ein:
   1. Projekt-ID für Unzustellbarkeitsnachrichten : Die Google Cloud-Projekt-ID, in der Sie das Pub/Sub-Thema für Unzustellbarkeitsnachrichten konfiguriert haben.
   2. Thema für unzustellbare Nachrichten : Das Pub/Sub-Thema, in das Sie die Details des nicht verarbeiteten Ereignisses schreiben möchten.

Beispiele für Verbindungskonfigurationen

In den folgenden Abschnitten sind die Beispielwerte für die verschiedenen Felder beim Erstellen der SAP ERP-Verbindung sowie die für die verschiedenen Verbindungstypen erforderlichen Parameter aufgeführt.

Verbindung zu einem verteilten SAP-System herstellen

Wenn Sie eine Verbindung zu einem verteilten SAP-System herstellen, z. B. einem System mit Lastenausgleich, müssen Sie die folgenden zusätzlichen Verbindungseigenschaften angeben. Ein Administrator kann diese Verbindungseigenschaften im SAP-System auf dem Tab „Verbindung“ des Dialogfelds „Systemeintragseigenschaften“ abrufen.

• System-ID: Geben Sie den Wert an, den Sie über die SystemId-Eigenschaft erhalten haben. Die System-ID ist die System-ID/der R3Name des SAP-Systems. Die System-ID ist ein String mit maximal drei Zeichen.
• Message Server: Wenn Sie eine Verbindung zu einem SAP-System herstellen, das Load-Balancing verwendet, müssen Sie das Feld „Message Server“ angeben. Legen Sie diese Eigenschaft auf den Wert fest, den Sie aus der MessageServer-Eigenschaft im SAP-System erhalten haben. Stellen Sie dem Wert des Felds „Message Server“ den Wert des Felds „SAProuter“ voran.
• Gruppe: Legen Sie diese Eigenschaft auf den Wert fest, den Sie aus der Eigenschaft „Gruppe/Server“ erhalten haben. Die Group-Eigenschaft gibt die verwendete Anmeldegruppe an. Der Standardwert ist PUBLIC.

Verbindung zu einem benutzerdefinierten Anwendungsserver herstellen

Wenn Sie eine Verbindung zu einem SAP-System mit einem dedizierten Anwendungsserver oder einem benutzerdefinierten Anwendungsserver herstellen, müssen Sie die folgenden zusätzlichen Verbindungseigenschaften angeben. Ein Administrator kann diese Verbindungseigenschaften aus dem SAP-System abrufen.

• System-ID: Geben Sie den Wert an, den Sie über die SystemId-Eigenschaft erhalten haben. Dies ist die System-ID oder der R3Name des SAP-Systems. Die System-ID ist ein String mit maximal drei Zeichen.
• Host: Geben Sie den Wert an, den Sie vom Anwendungsserver erhalten haben.

  Gibt den Hostnamen des Zielsystems an. Dieser Wert kann ein regulärer Hostname, eine IP-Adresse oder eine SAP-Router-Adresse sein.

• Systemnummer: Geben Sie den Wert an, den Sie über die Eigenschaft „SystemNumber“ erhalten haben.

  Die Eigenschaft „SystemNumber“ definiert das Zielsystem.

Sichere Netzwerkverbindungen konfigurieren

Wenn der Administrator die Secure Network Communication (SNC) konfiguriert hat, müssen Sie die folgenden zusätzlichen Eigenschaften festlegen. Im SAP-System können Sie die folgenden SNC-Verbindungsstring-Attribute auf dem Tab „Netzwerk“ des Dialogfelds „Systemeintragseigenschaften“ abrufen.

• SNC-Modus: Wenn das Kästchen „Sichere Netzwerkverbindungen aktivieren“ in SAP aktiviert ist, legen Sie die Verbindungseigenschaft „SNC-Modus“ auf „True“ fest. Andernfalls legen Sie das Verbindungsattribut „SNC Mode“ auf „False“ fest.

  Die Verbindungseigenschaft „SNCMode“ ist ein boolescher Wert, der angibt, ob Sie SNC verwenden. Der Standardwert ist "False".

• SNC PartnerName: Der SNC PartnerName gibt den SNC-Namen des Anwendungsservers an. Beispiel: p:CN=IDS, OU=IT, O=CSW, C=DE
• SNC-Name: Optional. Das Attribut „SNCName“ gibt den Namen der SNC-Verbindung an. Legen Sie diese Property fest, um sicherzustellen, dass der richtige SNC-Name für die Verbindung verwendet wird.
• SNC Qop: Legen Sie diese Eigenschaft auf die ausgewählte Option im Bereich „Secure Network Settings“ (Sichere Netzwerkeinstellungen) fest. Wenn beispielsweise die Option „Integrität“ ausgewählt ist, legen Sie die SNCQop-Property auf „3“ fest.

  Mit der Eigenschaft „SNCQop“ wird das Niveau (oder die Qualität) des Datenschutzes angegeben. Wenn diese Property nicht angegeben ist, wird für sie die Ganzzahl -1 festgelegt. Gültige Werte sind 1, 2, 3, 8 oder 9, die den Schutzstufen entsprechen.

• SNC_Lib-Objekt-ID: Legen Sie diese Eigenschaft auf den Pfad und Dateinamen Ihrer SNC-Bibliothek fest. Geben Sie den vollständigen Pfad zur verwendeten Sicherheitsbibliothek an, z. B. C:\Secude\secude.xll..

Verbindungstyp des Anwendungsservers

Für die Verbindung zum Anwendungsserver müssen Private Service Connect und Load Balancer mit der SAP-System-IP und dem Port 33XX in der Netzwerk-Endpunktgruppe (NEG) und der Systemdiagnose konfiguriert werden. Dabei ist XX die System- oder Instanznummer des verwendeten SAP-Systems. In der folgenden Tabelle sind die Beispielkonfigurationswerte für den Verbindungstyp ApplicationServer aufgeführt. Welche Felder optional und welche Pflichtfelder sind, können Sie der Benutzeroberfläche zum Erstellen von Verbindungen in der Konsole entnehmen.

Verbindungstyp des Nachrichtenservers (Gruppenservers)

• Private Service Connect und der Load Balancer müssen mit der SAP-System-IP auf Port 33XX und 36XX in der Netzwerk-Endpunktgruppe (NEG) und der Systemdiagnose konfiguriert werden. Dabei ist XX die System- oder Instanznummer des verwendeten SAP-Systems.
• Sie müssen eine DNS-Zone in Cloud DNS erstellen und den Endpunktanhang des Anwendungsservers, der auf Port 33XX konfiguriert ist, dem Hostnamen des SAP-Systems zuordnen.
• Sie können nur dann eine Verbindung zu einem SAP-System mit einem Message Server (Group Server) herstellen, wenn der Message Server die FQDN-Adresse (Fully Qualified Domain Name) des Anwendungsservers zurückgibt. Sie können keine Verbindung zu einem SAP-System mit einem Message Server (Group Server) herstellen, wenn der Message Server die IP-Adresse zurückgibt.
• Der Nachrichtenserver muss mit dem DNS der Anwendungsserver antworten, mit denen die Anwendung eine Verbindung herstellen muss, wenn die Anwendung dies anfordert.
• Der DNS der Anwendungsserver muss eindeutig sein und darf nicht von einem anderen SAP-System verwendet werden.
• In der SAP-Anwendung müssen die IP-Adressen für die Endpunktanhänge für die Anwendungs- und Nachrichtenserver unter den Parametern „gw/alternative_hostnames“ verwaltet werden.
  1. Rufen Sie den Transaktionscode RZ10 auf und geben Sie im Instanzprofil einen Eintrag für den Parameter „gw/alternative_hostname“ ein.
  2. Setzen Sie den Parameter ms/lg\_with\_hostname auf 1, um SAP-Nachrichtenserverversionen vor 7.53 so zu konfigurieren, dass Hostnamen zurückgegeben werden. In Version 7.53 und höher werden Hostnamen standardmäßig zurückgegeben.
  3. Starten Sie die SAP-Anwendung neu, damit die Parameter wirksam werden.

In der folgenden Tabelle sind die Beispielkonfigurationswerte für den Verbindungstyp Group Server aufgeführt:

X509-Zertifikatverbindungstyp

Für die sichere Netzwerkkommunikation (Secure Network Communications, SNC) mit X509-Verbindung müssen Private Service Connect und Load Balancer mit der SAP-System-IP und dem Port 48XX in der Netzwerk-Endpunktgruppe (NEG) und der Systemdiagnose konfiguriert werden. Dabei ist XX die System- oder Instanznummer des verwendeten SAP-Systems. In der folgenden Tabelle sind die Beispielkonfigurationswerte für den Verbindungstyp X509 certificate aufgeführt. Welche Felder optional und welche Pflichtfelder sind, können Sie der Benutzeroberfläche zum Erstellen von Verbindungen in der Konsole entnehmen.

Entitäten, Vorgänge und Aktionen

Alle Integration Connectors bieten eine Abstraktionsebene für die Objekte der verbundenen Anwendung. Sie können nur über diese Abstraktion auf die Objekte einer Anwendung zugreifen. Die Abstraktion wird Ihnen als Entitäten, Vorgänge und Aktionen zur Verfügung gestellt.

• Entität: Eine Entität kann als Objekt oder Sammlung von Attributen in der verbundenen Anwendung oder im verbundenen Dienst verstanden werden. Die Definition einer Entität unterscheidet sich von Connector zu Connector. Beispiel: In einem Datenbank-Connector sind Tabellen die Entitäten, in einem Dateiserver-Connector sind Ordner die Entitäten und in einem Nachrichtensystem-Connector sind Warteschlangen die Entitäten.

  Es ist jedoch möglich, dass ein Connector keine Entitäten unterstützt oder keine Entitäten enthält. In diesem Fall ist die Liste Entities leer.

• Vorgang: Ein Vorgang ist die Aktivität, die Sie für eine Entität ausführen können. Sie können einen der folgenden Vorgänge für eine Entität ausführen:
  • Liste
  • Abrufen
  • Erstellen
  • Aktualisieren
  • Löschen

  Durch Auswahl einer Entität aus der verfügbaren Liste wird eine Liste der Vorgänge generiert, die für die Entität verfügbar sind. Eine detaillierte Beschreibung der Vorgänge finden Sie in den Entitätsvorgängen der Connectors-Aufgabe. Wenn ein Connector jedoch keine der Entitätsvorgänge unterstützt, werden diese nicht unterstützten Vorgänge nicht in der Operations-Liste aufgeführt.

• Aktion: Eine Aktion ist eine Funktion erster Klasse, die über die Connector-Benutzeroberfläche für die Integration verfügbar gemacht wird. Mit einer Aktion können Sie Änderungen an einer oder mehreren Entitäten vornehmen, die von Connector zu Connector unterschiedlich sind. Normalerweise hat eine Aktion einige Eingabeparameter und einen Ausgabeparameter. Es ist jedoch möglich, dass ein Connector keine Aktionen unterstützt. In diesem Fall ist die Actions-Liste leer.

Aktionen

Dieser Abschnitt enthält Informationen zu den RFCs und listet die vom Connector unterstützten Aktionen auf. Informationen zum Konfigurieren der Aktionen finden Sie unter Beispiele für Aktionen.

RFCs verwenden

In diesem Abschnitt finden Sie Informationen zu den erforderlichen RFCs und zur Verwendung der RFCs.

Erforderliche RFCs

Wenn einer der erforderlichen RFCs nicht verfügbar ist, funktionieren einige oder alle Funktionen möglicherweise nicht. Mit dem T-Code SE37 können Sie verfügbare Funktionsmodule in SAP aufrufen.

Die folgenden RFCs werden vom SAP ERP-Connector verwendet.

• DDIF_FIELDINFO_GET
• RFC_GET_FUNCTION_INTERFACE
• RFC_GET_STRUCTURE_DEFINITION
• RFC_GET_SYSTEM_INFO
• RFC_GET_UNICODE_STRUCTURE
• RFC_READ_TABLE
• SLDAG_CHECK_FOR_UNICODE

Große Datenmengen lesen

In diesem Abschnitt wird beschrieben, wie Sie große Datenmengen aus Ihrem SAP-Backend lesen.

Der SAP ERP-Connector verwendet die Funktion SAP RFC_READ_TABLE, um Daten aus SAP-Tabellen abzurufen. Diese Funktion hat eine feste Größe von 512 Byte. Es kann für jede Datenzeile gepuffert werden. Daher können Sie nicht mehr Spalten auswählen, als in diesen Puffer passen. Wenn Sie mehr als 512 Byte auswählen, tritt beim Ausführen der Integration die Ausnahme DATA_BUFFER_EXCEEDED auf. Das bedeutet, dass Sie die maximal zulässige Puffergröße pro Zeile überschritten haben und weniger Spalten auswählen müssen.

Um dieses Problem zu beheben, können Sie den Code für ein Custom RFC_READ_TABLE einfügen, das dem SAP RFC_READ_TABLE ähnelt, aber einen größeren Puffer hat, um das Problem mit DATA_BUFFER_EXCEEDED zu beheben.

Benutzerdefinierte Funktion zum Lesen von Tabellen verwenden

Der Connector unterstützt einen Custom RFC_READ_TABLE, der dem SAP RFC_READ_TABLE ähnelt, aber einen größeren Puffer hat, sodass das Problem DATA_BUFFER_EXCEEDED behoben werden kann.

Benutzerdefinierte RFC_READ_TABLE in Ihrem SAP-Backend erstellen

Führen Sie die folgenden Schritte aus, um die benutzerdefinierte Beispiel-RFC_READ_TABLE zu verwenden.

1. Verwenden Sie die Funktion RFC_READ_TABLE als Vorlage für die neue Funktion: Wählen Sie den Transaktionscode SE37 und die SDTX-Funktionsgruppe aus und kopieren Sie RFC_READ_TABLE in eine neue Funktionsgruppe oder Ihre Arbeitsfunktionsgruppe. In diesem Beispiel wird RFC_READ_TABLE in Z_CUSTOM_RFC_TABLE kopiert.
2. Wählen Sie auf dem Tab Attribute der SAP-Seite die Option Remote Enabled Module (Modul mit Remote-Zugriff) aus.
3. Legen Sie auf dem Tab Tabellen den Parameter DATA auf CHAR8000 fest. Möglicherweise müssen Sie mit der rechten Maustaste klicken und dann auf Anzeigen -> Ändern klicken.
4. Geben Sie auf dem Tab Quellcode den benutzerdefinierten RFC-Code für „read-table“ ein. Eine Referenz finden Sie unter sample Z_CUSTOM_RFC_TABLE_function.txt.
5. Klicken Sie auf Speichern.
6. Definieren Sie die Importe, Tabellen und Ausnahmen wie in der bereitgestellten benutzerdefinierten Lesetabelle beschrieben.
7. Aktivieren Sie das Funktionsmodul.

Benutzerdefinierte Tabelle zum Lesen für ABAP 7.52

Wenn Sie ABAP 7.52 oder höher verwenden, lesen Sie das Beispiel Z_CUSTOM_RFC_TABLE_function_ABAP752.txt. Die Beispielfunktion ist für ABAP-Version 7.52 und höher konzipiert. Sie ähnelt der Funktion Z_CUSTOM_RFC_TABLE, nutzt aber neu verfügbare Schlüsselwörter in ABAP 7.52, um die Paginierung in der Datenbank anstelle des ABAP-Skripts selbst durchzuführen. Dadurch wird die Paginierung wesentlich effizienter und die Leistung bei der Arbeit mit großen Tabellen verbessert. Es wird empfohlen, nach Möglichkeit Z_CUSTOM_RFC_TABLE_752 RFC zu verwenden.

Zugriff auf die Funktion RFC_READ_TABLE

In diesem Abschnitt finden Sie Informationen zur Rolle, die einem SAP-Nutzer zugewiesen werden muss, um auf die Funktion „RFC_READ_TABLE“ zuzugreifen. Diese Funktion ist ein fernzugriffsberechtigtes Funktionsmodul, das einen generischen Lesezugriff auf beliebige Tabellen ermöglicht.

Damit die Tabellen bei der Konfiguration des SAP ERP-Connectors unter „Entitäten“ aufgeführt werden, müssen Sie die Funktion „RFC_READ_TABLE“ auf SAP ERP-Verbindungsebene verwenden und berechtigt sein, auf die R/3-Funktion „RFC_READ_TABLE“ zuzugreifen.

Fügen Sie die Autorisierung S_TABU_DIS für die Aktivität 03 (Anzeigen) und die Autorisierungsgruppe „SC“ für die Funktion RFC_READ_TABLE hinzu.

Im Folgenden sind einige der technischen Einschränkungen von RFC_READ_TABLE aufgeführt:

• Es können nur Tabellen mit einfachen Datentypen gelesen werden. STRING- oder XSTRING-Felder werden nicht unterstützt.
• Die maximale Zeilenbreite beträgt 512 Zeichen.
• Die Anzahl der zurückgegebenen Datensätze ist durch Speichergrenzwerte begrenzt.

Aktion „BAPI_MATERIAL_SAVEDATA“

Mit dieser Aktion können Sie bestimmte Aufgaben ausführen. Sie können damit beispielsweise Materialstammdaten in SAP ERP erstellen oder ändern.

Eingabeparameter der Aktion „BAPI_MATERIAL_SAVEDATA“

Ausgabeparameter der Aktion „BAPI_MATERIAL_SAVEDATA“

Bei erfolgreicher Ausführung gibt diese Aktion den Status 200 (OK) zurück.

Ein Beispiel für die Konfiguration der Aktion BAPI_MATERIAL_SAVEDATA finden Sie unter Beispiele für Aktionen.

ZFM_GCP_MULTIDATA_TAB-Aktion

Mit dieser Aktion können Nutzer bestimmte Aufgaben ausführen. Sie können beispielsweise Daten mit mehreren Datentypen in SAP ERP erstellen.

Eingabeparameter der Aktion „ZFM_GCP_MULTIDATA_TAB“

Ausgabeparameter der Aktion „ZFM_GCP_MULTIDATA_TAB“

Bei erfolgreicher Ausführung gibt diese Aktion den Status 200 (OK) zurück.

Ein Beispiel für die Konfiguration der ZFM_GCP_MULTIDATA_TAB-Aktion finden Sie unter Beispiele für Aktionen.

PushIDoc-Aktion

Mit dieser Aktion können Sie bestimmte Aufgaben ausführen. Sie können beispielsweise Daten von SAP in ein externes System übertragen.

Eingabeparameter der PushIDoc-Aktion

Ausgabeparameter der PushIDoc-Aktion

Bei erfolgreicher Ausführung gibt diese Aktion den Status 200 (OK) zurück.

Beispiele für die Konfiguration der PushIDoc-Aktion finden Sie unter Beispiele für Aktionen.

Aktion „ExecuteCustomQuery“

Mit dieser Aktion können Sie eine benutzerdefinierte Abfrage ausführen.

So erstellen Sie eine benutzerdefinierte Abfrage:

1. Folgen Sie der detaillierten Anleitung zum Hinzufügen einer Connectors-Aufgabe.
2. Wenn Sie die Connector-Aufgabe konfigurieren, wählen Sie unter „Art der auszuführenden Aktion“ die Option Aktionen aus.
3. Wählen Sie in der Liste Aktion die Option Benutzerdefinierte Abfrage ausführen aus und klicken Sie dann auf Fertig.

   

4. Maximieren Sie den Abschnitt Aufgabeneingabe und gehen Sie dann so vor:
   1. Geben Sie im Feld Zeitlimit nach die Anzahl der Sekunden ein, die gewartet werden soll, bis die Abfrage ausgeführt wird.

      Standardwert: 180 Sekunden.

   2. Geben Sie im Feld Maximale Zeilenanzahl die maximale Anzahl der Zeilen ein, die aus der Datenbank zurückgegeben werden sollen.

      Standardwert: 25.

   3. Wenn Sie die benutzerdefinierte Abfrage aktualisieren möchten, klicken Sie auf Benutzerdefiniertes Skript bearbeiten. Das Dialogfeld Skripteditor wird geöffnet.

      

   4. Geben Sie im Dialogfeld Skripteditor die SQL-Abfrage ein und klicken Sie auf Speichern.

      Sie können ein Fragezeichen (?) in einer SQL-Anweisung verwenden, um einen einzelnen Parameter darzustellen, der in der Liste der Abfrageparameter angegeben werden muss. Mit der folgenden SQL-Abfrage werden beispielsweise alle Zeilen aus der Tabelle Employees ausgewählt, die den für die Spalte LastName angegebenen Werten entsprechen:

      SELECT * FROM Employees where LastName=?

   5. Wenn Sie Fragezeichen in Ihrer SQL-Abfrage verwendet haben, müssen Sie den Parameter hinzufügen, indem Sie für jedes Fragezeichen auf + Parameternamen hinzufügen klicken. Bei der Ausführung der Integration werden diese Parameter sequenziell durch die Fragezeichen (?) in der SQL-Abfrage ersetzt. Wenn Sie beispielsweise drei Fragezeichen (?) hinzugefügt haben, müssen Sie drei Parameter in der richtigen Reihenfolge hinzufügen.

      

      So fügen Sie Abfrageparameter hinzu:

      1. Wählen Sie in der Liste Typ den Datentyp des Parameters aus.
      2. Geben Sie im Feld Wert den Wert des Parameters ein.
      3. Wenn Sie mehrere Parameter hinzufügen möchten, klicken Sie auf + Abfrageparameter hinzufügen.

Bei erfolgreicher Ausführung gibt diese Aktion den Status 200 (OK) mit einem Antworttext zurück, der die Abfrageergebnisse enthält.

Beispiele für Aktionen

Beispiel: Eintrag erstellen

In diesem Beispiel wird ein Materialdatensatz mit der Aktion BAPI_MATERIAL_SAVEDATA erstellt.

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion BAPI_MATERIAL_SAVEDATA aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
   "HEADDATA": "{\"MATERIAL\":\"000000000000009001\",\"IND_SECTOR\":\"M\",\"MATL_TYPE\":\"HALB\",\"BASIC_VIEW\":\"X\"}",
   "CLIENTDATA" : "{\"MATL_GROUP\":\"00107\",\"BASE_UOM\":\"KG\"}",
   "CLIENTDATAX" : "{\"MATL_GROUP\":\"X\",\"BASE_UOM\":\"X\"}",
   "MATERIALDESCRIPTION" : "{\"LANGU\":\"E\",\"MATL_DESC\":\"Classification Google\"}"
   }

Wenn die Aktion erfolgreich ist, hat der connectorOutputPayload-Antwortparameter der BAPI_MATERIAL_SAVEDATA-Aufgabe einen Wert, der dem folgenden ähnelt:

[{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_MESSAGE": "The material 9001 has been created or extended",
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9001",
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

Beispiel: Datensatz aktualisieren

In diesem Beispiel wird ein Materialdatensatz mit der Aktion BAPI_MATERIAL_SAVEDATA aktualisiert.

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion BAPI_MATERIAL_SAVEDATA aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
   "HEADDATA": "{\"MATERIAL\":\"000000000000009000\",\"IND_SECTOR\":\"A\",\"MATL_TYPE\":\"FHMI\",\"BASIC_VIEW\":\"X\"}",
   "CLIENTDATA": "{\"MATL_GROUP\":\"013\",\"BASE_UOM\":\"ST\"}",
   "CLIENTDATAX": "{\"MATL_GROUP\":\"X\",\"BASE_UOM\":\"X\"}",
   "MATERIALDESCRIPTION": "{\"LANGU\":\"E\",\"MATL_DESC\":\"Classification Googlecloud\"}"
   }

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des BAPI_MATERIAL_SAVEDATA-Vorgangs einen Wert, der dem folgenden ähnelt:

[{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_MESSAGE": "The material 9000 has been created or extended",
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9000",
"RETURN_PARAMETER": "",
"RETURN_ROW": 0,
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

Beispiel: Eintrag löschen

In diesem Beispiel wird ein Materialdatensatz mit der Aktion BAPI_MATERIAL_SAVEDATA gelöscht.

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion BAPI_MATERIAL_SAVEDATA aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
   "HEADDATA": "{\"MATERIAL\":\"000000000000009000\",\"BASIC_VIEW\":\"X\"}",
   "CLIENTDATA": "{\"DEL_FLAG\":\"X\"}",
   "CLIENTDATAX": "{\"DEL_FLAG\":\"X\"}"
   }

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des BAPI_MATERIAL_SAVEDATA-Vorgangs einen Wert, der dem folgenden ähnelt:

[{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9000",
"RETURN_PARAMETER": "",
"RETURN_ROW": 0,
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

Beispiel: Daten mit mehreren Datentypen erstellen

In diesem Beispiel werden Daten mit mehreren Datentypen mit der Aktion ZFM_GCP_MULTIDATA_TAB erstellt.

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion ZFM_GCP_MULTIDATA_TAB aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
   "T_TABLE": "{\"ZACCP\":\"111\",\"ZCHAR\":\"CHARACTER1\",\"ZCLNT\":\"100\",\"ZCUKY\":\"INR\",\"ZCURR\": 200,\"ZDATS\": \"20231213\",\"ZINT1\": 45,\"ZINT2\":54,\"ZDEC\": 0.12,\"ZFLTP\": 1234,\"ZLANG\":\"E\",\"ZNUMC\":\"110\",\"ZPREC\": 3,\"ZQUAN\": 188.0,\"ZRAW\":\"01010008010101050401\",\"ZTIMS\": \"103056\",\"ZUNIT\":\"11\",\"ZINT4P\": 45,\"ZINT4\": 54,\"ZLRAW\":\"0101000801010105040100030101010300040000\"}",
   "IM_INPUT_1": "{\"ZACCP\":\"222\",\"ZCHAR\":\"CHARACTER1\",\"ZCLNT\":\"100\",\"ZCUKY\":\"INR\",\"ZCURR\": 200,\"ZDATS\": \"20231213\",\"ZINT1\": 45,\"ZINT2\":54,\"ZDEC\": 0.12,\"ZFLTP\": 1234,\"ZLANG\":\"E\",\"ZNUMC\":\"110\",\"ZPREC\": 3,\"ZQUAN\": 188.0,\"ZRAW\":\"01010008010101050401\",\"ZTIMS\": \"103056\",\"ZUNIT\":\"11\",\"ZINT4P\": 45,\"ZINT4\": 54,\"ZLRAW\":\"0101000801010105040100030101010300040000\"}",
   "IM_INPUT_2": "{\"ZSTRING\": \"HI Google\",\"ZSSTRING\": \"HI Google How are you\"}"
   }

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des ZFM_GCP_MULTIDATA_TAB-Vorgangs einen Wert, der dem folgenden ähnelt:

[{
"EX_OUTPUT_1_ZACCP": 222,
"EX_OUTPUT_1_ZCHAR": "CHARACTER1",
"EX_OUTPUT_1_ZCLNT": "100",
"EX_OUTPUT_1_ZCUKY": "INR",
"EX_OUTPUT_1_ZCURR": 200,
"EX_OUTPUT_1_ZDATS": "2023-12-13",
"EX_OUTPUT_1_ZRAW": "01010008010101050401",
"EX_OUTPUT_1_ZTIMS": "10:30:56",
"EX_OUTPUT_1_ZUNIT": "11",
"EX_OUTPUT_1_ZINT4P": 45,
"EX_OUTPUT_1_ZINT4": 54,
"EX_OUTPUT_1_ZLRAW": "0101000801010105040100030101010300040000\u0000",
"EX_OUTPUT_2_ZSTRING": null,
"EX_OUTPUT_2_ZSSTRING": null,
"RESULT_TABLE": null,
"T_TABLE_ZACCP": null,
"T_TABLE_ZCHAR": null,
"T_TABLE_ZCLNT": null,
"T_TABLE_ZQUAN": null,
"T_TABLE_ZRAW": null,
"T_TABLE_ZTIMS": null,
"T_TABLE_ZUNIT": null
},{
"EX_OUTPUT_1_ZACCP": null,
"EX_OUTPUT_1_ZCHAR": null,
"EX_OUTPUT_1_ZCLNT": null,
"EX_OUTPUT_1_ZCUKY": null,
"EX_OUTPUT_1_ZRAW": null,
"T_TABLE_ZLANG": null,
"T_TABLE_ZNUMC": null,
"T_TABLE_ZPREC": null,
"T_TABLE_ZQUAN": null,
"T_TABLE_ZRAW": null,
"T_TABLE_ZTIMS": null,
"T_TABLE_ZUNIT": null
},{
"EX_OUTPUT_1_ZACCP": null,
"EX_OUTPUT_1_ZCHAR": null,
"EX_OUTPUT_1_ZCLNT": null,
"EX_OUTPUT_1_ZCUKY": null,
"EX_OUTPUT_1_ZCURR": null,
"EX_OUTPUT_1_ZDATS": null,
"EX_OUTPUT_1_ZDEC": null,
"EX_OUTPUT_1_ZQUAN": null,
"T_TABLE_ZNUMC": 110,
"T_TABLE_ZPREC": 3,
"T_TABLE_ZQUAN": 188,
"T_TABLE_ZRAW": "01010008010101050401",
"T_TABLE_ZTIMS": "10:30:56",
"T_TABLE_ZUNIT": "11"
}]

Beispiel: IDoc übertragen

In diesem Beispiel wird ein IDoc an das SAP ERP-System gesendet.

1. Klicken Sie im Dialogfeld Configure connector task auf Actions.
2. Wählen Sie die Aktion PushIDoc aus und klicken Sie auf Fertig.
3. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf connectorInputPayload und geben Sie dann einen Wert ähnlich dem folgenden in Feld Default Value ein:

   {
   "Content": "\n\n\n EDI_DC40\n 800\n 0000000008604824\n 740\n 53\n 2\n \n MATMAS05\n MATMAS\n ZLS_QA23\n LS\n ZLS_QA23\n SAPSA1\n LS\n SA1CLNT800\n 20230218\n 232556\n\n\n 005\n 000000000000000012\n 20170328\n 42039\n 20170727\n 42039\n KLVC\n FERT\n M\n 02\n BG\n 000\n 002\n 0.000\n 0.000\n KGM\n 0.000\n 0001\n 0.000\n 0.000\n 0.000\n 0.000\n 0.000\n",
   "FileType": "XML",
   "Mode": "ASync"
   }

Wenn die Aktion erfolgreich ist, hat der Antwortparameter connectorOutputPayload des PushIDoc-Vorgangs einen Wert, der dem folgenden ähnelt:

[{
"Result": "Success",
"Message": "Push IDoc success"
}]

Beispiele für Entitätsvorgänge

In diesem Abschnitt wird beschrieben, wie Sie einige Entitätsvorgänge in diesem Connector ausführen.

Beispiel: Alle Datensätze auflisten

In diesem Beispiel werden alle Datensätze in der Entität T001 aufgelistet.

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie T001 aus der Liste Entity aus.
3. Wählen Sie den Vorgang List aus und klicken Sie auf Fertig.
4. Optional können Sie im Bereich Aufgabeneingabe der Aufgabe Connectors das Ergebnisset filtern, indem Sie eine Filterklausel angeben. Geben Sie den Wert der Filterklausel immer in einfachen Anführungszeichen (') an.

Beispiel: Datensatz aus einer Entität abrufen

In diesem Beispiel wird ein Datensatz mit der angegebenen ID aus der T001-Entität abgerufen.

1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
2. Wählen Sie T001 aus der Liste Entity aus.
3. Wählen Sie den Vorgang Get aus und klicken Sie auf Fertig.
4. Klicken Sie im Bereich Aufgabeneingabe der Aufgabe Connectors auf EntityId und geben Sie dann 0001 in das Feld Standardwert ein.

   Dabei ist 0001 eine eindeutige Datensatz-ID in der T001-Entität.