Integrationen

Alle Anbindungen in ProcessFlow laufen über Ressourcen und die Schritte innerhalb Ihrer Flows. Eine Ressource ist eine gespeicherte Verbindung zu einem externen System; die Flow-Schritte nutzen diese Verbindung, um Daten zu lesen, zu schreiben oder Aufrufe auszulösen.

Kein nativer ERP-Konnektor

ProcessFlow bringt keine fertigen SAP- oder Dynamics-Konnektoren mit. Die Anbindung eines ERP erfolgt über die generischen Bausteine unten – meist über die HTTP- oder die DB-Ressource. Typische Muster finden Sie im Abschnitt ERP anbinden.

Ressourcentypen im Überblick

Ressourcentyp	Zweck	Konfiguration (Kern)
HTTP	ausgehende REST- oder SOAP-Aufrufe (z. B. ERP-Schnittstellen); Operationskatalog optional per OpenAPI-Import	Basis-URL, REST/SOAP, Auth (ohne/Basic/Bearer/API-Key); je Operation Methode, Pfad, Body-Vorlage; Antwort-Auswertung per JSONPath (REST) bzw. XPath (SOAP)
DB	Datenbank aus Flows lesen/schreiben	Host, Port, DB-Name, Benutzer, Passwort
SMTP	E-Mail-Versand aus Flows und Alert-Mails	Host, Port, Benutzer, Passwort, StartTLS/SSL
FILE	Datei-Import (überwachter Ordner als Flow-Start) und -Export (CSV/Vorlage)	Speicherart lokal/SMB/FTP/SFTP, Basis-Pfad, Zugangsdaten
MESSAGING	MQTT- oder JMS-Nachrichten senden/empfangen (Flow-Start per Nachricht)	Protokoll MQTT/JMS, Broker-URL, Benutzer/Passwort, Client-ID
OPC UA	Maschinenwerte lesen/schreiben, Flow-Start per Subscription	Endpoint-URL, Security-Policy, Auth, Client-Zertifikat, Server-Zertifikat-Pinning
AI	KI-Funktionen (KI-Task im Flow, Assistenten, Spracherfassung)	Anbieter, Basis-URL, Modell, API-Schlüssel, Budget

📷 Screenshot folgt

TODO-SCREENSHOT: Ressourcenübersicht mit den verfügbaren Typen und dem Dialog „Ressource anlegen“.

HTTP: REST und SOAP

Die HTTP-Ressource ruft externe Web-Schnittstellen auf – REST (JSON) oder SOAP (XML).

• Basis-URL und Art (REST/SOAP) festlegen.
• Authentifizierung: ohne, Basic, Bearer oder API-Key.
• Je Operation definieren Sie Methode, Pfad und – falls nötig – eine Body-Vorlage.
• Die Antwort werten Sie per JSONPath (REST) bzw. XPath (SOAP) aus und übernehmen Werte in den Flow.
• Ein OpenAPI-Import kann den Operationskatalog optional automatisch befüllen.

DB: Datenbanken

Lesen und schreiben Sie Daten direkt aus Flows.

• Konfiguration: Host, Port, DB-Name, Benutzer, Passwort.
• Offiziell unterstützt: PostgreSQL.

Hinweis

MySQL, SQL Server und Oracle sind vorbereitet, die passenden Treiber sind jedoch nicht im Lieferumfang enthalten. Diese Anbindungen sind auf Anfrage möglich.

SMTP: E-Mail-Versand

Versendet E-Mails aus Flows und dient als Grundlage für Alert-Mails.

• Konfiguration: Host, Port, Benutzer, Passwort.
• Verschlüsselung per StartTLS oder SSL.

FILE: Dateiaustausch

Für den Austausch über Dateien – als Flow-Start (Import) oder als Ausgabe (Export).

• Import: Ein überwachter Ordner startet automatisch einen Flow, sobald eine Datei eintrifft.
• Export: Ausgabe als CSV oder nach Vorlage.
• Speicherart: lokal, SMB, FTP oder SFTP; dazu Basis-Pfad und Zugangsdaten.
• SFTP prüft den Host-Key gegen known_hosts.

MESSAGING: MQTT und JMS

Sendet und empfängt Nachrichten über einen Message-Broker; eine eingehende Nachricht kann einen Flow starten.

• Protokoll: MQTT oder JMS.
• Broker-URL: tcp://… unverschlüsselt bzw. ssl://… für TLS.
• Dazu Benutzer/Passwort und eine Client-ID.

OPC UA: Maschinendaten

OPC UA (Kommunikationsstandard in der industriellen Automatisierung) liest und schreibt Maschinenwerte; eine Subscription kann einen Flow starten.

• Endpoint-URL: opc.tcp://….
• Security-Policy: u. a. Basic256Sha256.
• Auth: anonym oder mit Benutzer.
• Zertifikate: eigenes Client-Zertifikat (PKCS#12) sowie Server-Zertifikat-Pinning.

AI: KI-Funktionen

Grundlage für KI-Tasks im Flow, die Assistenten und die Spracherfassung.

• Anbieter: Anthropic, OpenAI oder OpenAI-kompatibel (auch selbst gehostet).
• Konfiguration: Basis-URL, Modell, API-Schlüssel und ein Budget.

Eingehende Auslöser

Neben den überwachten Ordnern, MQTT/JMS-Nachrichten und OPC-UA-Subscriptions gibt es zwei weitere Wege, Flows von außen zu starten:

• REST-Start über die öffentliche URL – ein Flow lässt sich unter /public/flows/{uuid}/v{n}/start bzw. .../startAndWait starten. Abgesichert wird der Aufruf über den Header X-API-Key. Den Schlüssel erzeugen Sie je Flow-Gruppe in der Web-Oberfläche; für noch nicht freigegebene Versionen gibt es einen separaten Test-Schlüssel.
• Zeitplan-Start – cron-artige Auslöser für wiederkehrende Abläufe, mit einer Nachhol-Regelung nach Ausfallzeiten.

Zugangsdaten und Verschlüsselung

Achtung

Zugangsdaten in Ressourcen werden verschlüsselt gespeichert (Jasypt). API-Schlüssel sind nach dem Speichern nicht mehr auslesbar (write-only) – notieren Sie einen neuen Schlüssel also vor dem Speichern, falls Sie ihn andernorts benötigen.

Die Verschlüsselung hängt am Secret JASYPT_ENCRYPTOR_PASSWORD aus der Installation. Geht dieser Wert verloren, müssen die Zugangsdaten neu eingegeben werden.

ERP anbinden

Ein ERP schließen Sie über die generischen Bausteine an. Üblich sind diese Muster:

• REST/SOAP-API des ERP: HTTP-Ressource plus API-Aufruf im Flow.
• Zwischendatenbank: DB-Ressource auf eine Austausch-Datenbank.
• Dateiaustausch: FILE-Ressource über SMB oder SFTP.
• Message-Broker: MESSAGING-Ressource (MQTT/JMS).

Welches Muster passt, hängt davon ab, welche Schnittstellen Ihr ERP anbietet. Wie Sie die Ressourcen dann im Ablauf verwenden, zeigt Flows erstellen.