eNVenta B10W

Zweck

Der Enventa Business 1.0 WebService Connector dient der Integration mit dem Enventa ERP-System über dessen SOAP-WebService. Der Hauptzweck dieses Connectors ist das Auslösen und Abrufen von standardisierten Datenexporten aus dem Enventa-System. Er bietet auch eine Funktion, um die aktuelle Version des WebService zu überprüfen.

Dies ermöglicht es dir, den Prozess des Abrufens spezifischer Datensätze, wie z.B. Kunden- oder Bestelldaten, aus deinem Enventa ERP für die Verwendung in anderen Anwendungen und Workflows zu automatisieren.

Praktische Anwendungshinweise

• Der Connector erstellt automatisch den erforderlichen Enventa Business 10WS Login SOAP-Header für jede Anfrage unter Verwendung der in der Konfiguration bereitgestellten Anmeldeinformationen.

• Die Export-Aktion kann Daten entweder als rohes XML oder als Base64-kodierten String zurückgeben, basierend auf dem Rückgabe-Typ-Parameter. Der Connector dekodiert bei Bedarf den Base64-String, parst das resultierende XML und wandelt es in ein strukturiertes JSON-Objekt um.

• Für jede ausgewählte Anfrage wird die passende SOAP-Aktions-URL verwendet (Kombination aus Namespace und Funktionsname).

Authentifizierung

Die Authentifizierung für den Enventa-Connector erfolgt durch die Angabe von Anmeldeinformationen im Konfigurationsschritt. Der Connector verwendet diese Daten, um den erforderlichen SOAP-Authentifizierungs-Header für jede Anfrage zu erstellen.

• URL: Die Endpunkt-URL für den Enventa SOAP WebService.

• User: Der Benutzername für dein Enventa-Konto.

• Password: Das mit deinem Enventa-Konto verknüpfte Passwort.

• Client: Der Enventa-Mandanten-Identifikator.

Erwartungen an Ein- und Ausgabe

Eingabe

Der Connector bietet eine formularbasierte Schnittstelle zur Konfiguration der Anfragen. Die verfügbaren Aktionen sind im Schritt-für-Schritt-Format beschrieben:

1

Version abrufen (GetVersion)

• Beschreibung: Ruft die Version des Enventa WebService ab.

• Parameter: Keine erforderlich.

• Ausgabe: Einfaches JSON-Objekt mit dem Ergebnis unter dem Schlüssel GetVersionResult.

2

Exportieren (Export)

• Beschreibung: Hauptaktion zum Abrufen von Daten aus Enventa.

• Erforderliche Parameter:

  • ExportName: Der Name des auszuführenden Exports.

  • ExportTyp: Der Typ des Exports.

  • ZusatzParameter: Zusätzliche Parameter für den Export.

  • ExportModus: Der Modus für den Export, z. B. DELTA.

  • ExportSubDir: Optionales Unterverzeichnis für den Export.

  • RueckgabeTyp: Gewünschter Rückgabetyp vom Server, entweder XML oder BASE64.

• Verhalten: Der Connector dekodiert bei Bedarf Base64, parst XML und liefert ein strukturiertes JSON-Objekt.

Ausgabe

• Bei der GetVersion-Aktion: Ein JSON-Objekt mit dem Ergebnis unter GetVersionResult.

• Bei der Exportieren-Aktion: Ein JSON-Objekt, das aus den von Enventa zurückgegebenen XML-Daten geparst wurde und eine strukturierte Darstellung der exportierten Daten bietet.

Du kannst die Aktion createResponseDataStructure verwenden, um Felder aus der response für die einfache Verwendung in nachfolgenden Workflow-Schritten zuzuordnen.

Hinweise zur Verarbeitung

• Achte bei Verwendung von RueckgabeTyp = BASE64 darauf, dass der Connector die Decodierung und das XML-Parsing übernimmt, sodass nachfolgende Schritte mit einem strukturierten JSON-Objekt arbeiten können.

• Stelle sicher, dass die Endpoint-URL und die Anmeldeinformationen korrekt sind, damit der SOAP-Header erfolgreich generiert und die Anfragen authentifiziert werden.