Workflow-Komponenten (Knoten & Verbindungen)

Jeder Workflow in Argon ERP wird aus verschiedenen Knoten zusammengesetzt, die durch Verbindungen miteinander verknüpft sind. Diese Komponenten definieren die Logik und den Ablauf Ihres Geschäftsprozesses.

Übersicht

Ein Workflow besteht grundsätzlich aus:

• Knoten (Nodes): Die Bausteine, die Aktionen ausführen, Bedingungen prüfen oder Ereignisse verarbeiten
• Verbindungen (Connections): Die Pfeile, die den Daten- und Kontrollfluss zwischen den Knoten definieren

Knotenarten

Es gibt verschiedene Typen von Knoten, die Sie in Ihren Workflows verwenden können:

1. Start-Knoten (Trigger)

Start-Knoten definieren, wie ein Workflow initiiert wird. Jeder Workflow muss mit genau einem Start-Knoten beginnen.

Objekt-Ereignis

Beschreibung: Startet den Workflow automatisch, wenn ein Objekt erstellt, geändert, veröffentlicht oder gelöscht wird. Unterstützt Bedingungen und optionale Sperre während der Ausführung.

• Ereignisse: created, updated, on-publish, after-publish, manually, deleted

System-Ereignis

Beschreibung: Startet den Workflow bei einem konfigurierten System-Ereignis. Ermöglicht die Reaktion auf interne Anwendungsereignisse mit optionaler Bedingungsprüfung.

HTTP Webhook

Beschreibung: Startet den Workflow über eine externe HTTP-Anfrage (Webhook). Ermöglicht die Integration mit externen Systemen über REST-API-Aufrufe mit konfigurierbarer Authentifizierung.

• HTTP-Methoden: POST, GET, PUT, PATCH, DELETE
• Authentifizierung: Public, Secret, User, Group

Zeitgesteuert (Cron)

Beschreibung: Startet den Workflow automatisch nach einem festgelegten Zeitplan. Verwendet Cron-Syntax für flexible Zeitplanung (z.B. täglich, wöchentlich, monatlich).

• Beispiel: 0 1 * * * = täglich um 1 Uhr

Manueller Start

Beschreibung: Startet den Workflow manuell durch Benutzerinteraktion. Ermöglicht die Übergabe von Eingabeparametern beim Start.

MQTT-Ereignis

Beschreibung: Startet den Workflow, wenn eine Nachricht auf einem MQTT-Topic empfangen wird. Ermöglicht die Reaktion auf MQTT-Ereignisse mit optionaler Bedingungsprüfung.

E-Mail-Ereignis

Beschreibung: Startet den Workflow, wenn eine E-Mail empfangen wird. Ermöglicht die Verarbeitung von eingehenden E-Mails basierend auf konfigurierbaren Bedingungen.

Datei überwachen

Beschreibung: Überwacht ein Verzeichnis und startet den Workflow, wenn eine Datei hinzugefügt oder geändert wird.

SQL Observer Start

Beschreibung: Überwacht die Datenbank auf Änderungen und startet den Workflow basierend auf SQL-Abfrage-Ergebnissen.

Pipeline-Karte verschoben

Beschreibung: Startet den Workflow, wenn eine Pipeline-Karte in eine bestimmte Phase verschoben wird. Optional kann die Karte während der Workflow-Ausführung gesperrt werden.

2. Kontrollfluss-Knoten

Diese Knoten steuern den Ablauf und die Logik des Workflows.

Bedingung prüfen

Beschreibung: Prüft eine oder mehrere Bedingungen und verzweigt den Workflow basierend auf dem Ergebnis. Ermöglicht die Erstellung von komplexen Entscheidungslogiken.

• Ausgänge: Ja (wahr) / Nein (falsch)

Mehrfachverzweigung

Beschreibung: Ermöglicht die Verzweigung des Workflows in mehrere Pfade basierend auf dem Wert einer Variable. Ähnlich einer Switch-Case-Anweisung in der Programmierung.

Für jedes Element wiederholen

Beschreibung: Iteriert über eine Liste von Objekten und führt für jedes Element die nachfolgenden Workflow-Aktionen aus. Ideal für die Verarbeitung mehrerer Datensätze.

• Ausgänge: Erledigt / Eintrag (für jedes Element)

Zeitverzögerung

Beschreibung: Pausiert die Workflow-Ausführung für eine bestimmte Zeitdauer. Die Wartezeit kann in Sekunden, Minuten, Stunden oder Tagen angegeben werden.

Workflow abbrechen

Beschreibung: Bricht die Ausführung des Workflows sofort ab und beendet alle weiteren Aktionen. Dieser Baustein stoppt den Workflow-Prozess umgehend.

Workflow beenden

Beschreibung: Markiert das erfolgreiche Ende des Workflows. Schließt die Workflow-Ausführung ab und erzeugt einen entsprechenden Feed-Eintrag.

3. Aktions-Knoten

Aktions-Knoten führen konkrete Operationen aus, die den Kern der Workflow-Funktionalität bilden.

Datenbank-Operationen

SQL-Abfrage

• Beschreibung: Führt eine benutzerdefinierte SQL-Abfrage aus und gibt die Ergebnisse zurück. Unterstützt SELECT, INSERT, UPDATE und DELETE-Operationen mit Template-Variablen.

Objekt laden

• Beschreibung: Lädt ein Objekt aus der Datenbank basierend auf einer ID oder einem Filter.

Daten in Datenbank importieren

• Beschreibung: Importiert Daten aus dem Workflow-Kontext in eine Datenbank-Tabelle. Ermöglicht flexible Feld-Zuordnungen zwischen JSON-Schema und Datenbank-Spalten.

Stored Procedure ausführen

• Beschreibung: Führt eine gespeicherte Prozedur in der Datenbank aus.

Datenbank-Backup erstellen

• Beschreibung: Erstellt eine Sicherungskopie der Datenbank. Ermöglicht die automatische Erstellung von Backups mit optionaler Komprimierung. (Nur in Entwicklungsumgebungen)

Kommunikation

E-Mail senden

• Beschreibung: Sendet eine E-Mail-Nachricht an Benutzer oder externe Empfänger. Unterstützt HTML-Formatierung, Anhänge, CC/BCC und Push-Benachrichtigungen für interne Benutzer.

SMS senden

• Beschreibung: Versendet SMS-Nachrichten an Telefonnummern.

Fax senden

• Beschreibung: Sendet Dokumente per Fax.

Aufgabe erstellen

• Beschreibung: Erstellt eine neue Aufgabe und weist sie Benutzern oder Gruppen zu. Ermöglicht die Angabe von Titel, Beschreibung, Priorität, Fälligkeitsdatum und Verknüpfung zu Objekten.

Termin erstellen

• Beschreibung: Erstellt einen neuen Termin oder eine Aufgabe im Kalender. Ermöglicht die Angabe von Start- und Endzeitpunkt, Beschreibung und Zuordnung zu Benutzern.

Freigabe anfordern

• Beschreibung: Pausiert den Workflow und fordert eine Freigabe von ausgewählten Benutzern oder Gruppen an. Unterstützt E-Mail-Benachrichtigungen, externe Freigaben und Zeitlimits.

Benutzereingabe anfordern

• Beschreibung: Pausiert den Workflow und wartet auf eine Eingabe oder Entscheidung durch einen Benutzer.

Datei-Operationen

PDF-Bericht erstellen

• Beschreibung: Erzeugt ein PDF-Dokument aus einem Formular oder HTML-Template. Unterstützt Wasserzeichen, benutzerdefinierte Dateinamen und mehrsprachige Berichte.

PDF Anhänge extrahieren

• Beschreibung: Extrahiert Anhänge aus PDF-Dateien.

Dokument drucken

• Beschreibung: Sendet ein Dokument an einen Netzwerkdrucker. Unterstützt Druckoptionen wie Anzahl der Kopien, Duplex-Druck, Schwarz-Weiß und Papierschacht-Auswahl.

Datei aus Text erstellen

• Beschreibung: Erstellt eine Datei aus einem Textstring im Workflow-Kontext mit wählbarem Encoding.

Text aus Datei extrahieren

• Beschreibung: Extrahiert den Textinhalt einer Datei aus dem Workflow-Kontext mit wählbarem Encoding.

Datei speichern

• Beschreibung: Speichert eine Datei aus dem Workflow-Kontext in einer Dokumenten-Collection und gibt die Dokument-ID zurück.

Datei laden

• Beschreibung: Lädt eine Datei aus dem Dokumentenmanagementsystem.

Datei herunterladen

• Beschreibung: Lädt eine Datei von einer URL herunter. Unterstützt verschiedene HTTP-Methoden, benutzerdefinierte Header und automatische Dateinamenerkennung.

Daten importieren

• Beschreibung: Importiert Daten aus verschiedenen Formaten (CSV, JSON, XLSX, YAML, XML, TSV).

Daten exportieren

• Beschreibung: Exportiert Daten in verschiedene Formate.

Integration

Ausgehende HTTP Anfrage

• Beschreibung: Führt eine HTTP-Anfrage an externe APIs aus. Unterstützt verschiedene HTTP-Methoden, Header, Body und Authentifizierung.

HTTP Antwort senden

• Beschreibung: Erzeugt eine HTTP-Antwort für eingehende Webhook-Requests.

MQTT senden

• Beschreibung: Sendet eine Nachricht an ein MQTT-Topic. Unterstützt konfigurierbare QoS-Level, Authentifizierung und Retain-Flags.

FTP Upload/Download

• Beschreibung: Dateien über FTP hochladen oder herunterladen.

Befehl über SSH ausführen

• Beschreibung: Führt ein Shell-Skript über SSH aus.

Unter-Workflow ausführen

• Beschreibung: Startet einen anderen Workflow als Unter-Workflow. Ermöglicht die Übergabe von Variablen und optional das Warten auf die Fertigstellung des Unter-Workflows.

Pipeline-Operationen

Pipeline-Karte erstellen

• Beschreibung: Erstellt eine neue Karte in einer Pipeline.

Pipeline-Karte verschieben

• Beschreibung: Verschiebt eine Pipeline-Karte in eine andere Phase. Optional kann dabei ein verknüpfter Workflow automatisch gestartet werden.

Pipeline-Karte Status ändern

• Beschreibung: Ändert den Status einer Pipeline-Karte.

KI und Automatisierung

KI-Assistent

• Beschreibung: Nutzt künstliche Intelligenz zur Beantwortung von Fragen, Generierung von Texten oder Analyse von Inhalten. Der KI-Assistent kann kontextbezogen auf Anfragen reagieren und komplexe Aufgaben lösen.

Daten extrahieren (KI)

• Beschreibung: Extrahiert strukturierte Daten aus unstrukturierten Texten mit Hilfe von KI.

Klassifizieren (KI)

• Beschreibung: Klassifiziert Texte oder Dokumente mit Hilfe von KI in verschiedene Kategorien.

Skript-Ausführung

JavaScript-Code ausführen

• Beschreibung: Führt benutzerdefinierten JavaScript/TypeScript-Code aus. Ermöglicht den Zugriff auf den Workflow-Kontext und Datenbankoperationen.

Python-Skript ausführen

• Beschreibung: Führt ein Python3-Skript aus. Der Workflow-Kontext ist als JSON-Variable 'context' verfügbar. Nur in Entwicklungsumgebungen verfügbar.

Shell-Skript ausführen

• Beschreibung: Führt ein Shell-Skript aus (Bash unter Linux/macOS, CMD unter Windows). Nur in Entwicklungsumgebungen verfügbar.

Daten-Transformation

Text

• Beschreibung: Definiert einen Textwert. Unterstützt HTML-Formatierung.

Number (Zahl)

• Beschreibung: Definiert einen numerischen Wert.

Boolean (Wahrheitswert)

• Beschreibung: Definiert einen Booleschen Wert (Ja/Nein). Nur in Entwicklungsumgebungen.

Utility-Knoten

Konsolen-Ausgabe

• Beschreibung: Gibt Daten in der Server-Konsole aus. Nützlich für Debugging und Entwicklung von Workflows.

Feed-Eintrag erstellen

• Beschreibung: Erstellt einen Feed-Eintrag im System.

Veröffentlichen

• Beschreibung: Veröffentlicht Inhalte auf bestimmten Kanälen.

Währungskurse aktualisieren

• Beschreibung: Aktualisiert die Währungskurse im System. Nur in Entwicklungsumgebungen.

XML validieren

• Beschreibung: Validiert XML-Dokumente gegen ein Schema.

Ungültiger Baustein

• Beschreibung: Wird verwendet, wenn ein Knoten nicht mehr verfügbar ist oder gelöscht wurde.

Verbindungen

• Symbol: Pfeile zwischen den Knoten
• Zweck: Definieren die Reihenfolge und die logische Abfolge der Schritte. Sie zeigen an, welcher Knoten als nächstes ausgeführt wird, nachdem ein Knoten abgeschlossen ist (ggf. abhängig vom Ausgang, z.B. bei Bedingungen)
• Datenfluss: Daten können entlang der Verbindungen von einem Knoten zum nächsten übertragen werden

Knoten-Gruppen

Die Knoten sind in verschiedene Gruppen organisiert, um die Auswahl zu erleichtern:

• Start: Alle Start-Knoten
• Common: Häufig verwendete Knoten für den allgemeinen Workflow-Ablauf
• Developer: Erweiterte Knoten für Entwickler
• AI: KI-basierte Verarbeitungs-Knoten
• Pipeline: Pipeline-spezifische Operationen

Das Verständnis dieser Komponenten ist die Grundlage für das Erstellen und Bearbeiten von Workflows.