Garbit Automate Dokumentation - Befehle, Transformationen, Architektur

01 · Architektur

Framework und Konfiguration.

Garbit Automate trennt strikt zwischen dem stabilen Framework (von Garbit gepflegt, update-sicher) und der Konfiguration (gehört dem Kunden, frei anpassbar). Die gesamte Geschäftslogik eines Workflows steht in lesbaren INI-Dateien - kein kompilierter Code, kein Deployment.

Baustein	Bedeutung
Job (Aufgabe)	Eine einzelne, parametrisierbare Funktion - fertig entwickelt, sofort einsetzbar (z. B. `IMPORT_ORDER_XML`, `EXPORT_XML`, `email_send_all`).
Sektion	Eine benannte Gruppe von Jobs in der INI - ein Unterprogramm, das von anderen Sektionen per `subcall_sektion` aufgerufen wird.
Script / Config	Die vollständige INI-Datei eines Mandanten - definiert alle Sektionen und deren Reihenfolge. Der einzige Ort, den ein Kunde anfasst.
Vorlage (Template)	`VORLAGE_*.ini` - definiert SQL-Abfrage, Feld-Mapping und Transformationsregeln getrennt vom Ablauf.

Wie das Script-System im Detail aufgebaut ist - mit Variablen, Vorlagen und einem Praxis-Beispiel - zeigt die Seite Low-Code-System.

02 · Befehlsreferenz

Steuerungsanweisungen im Überblick.

Ablaufsteuerung, Sage-100-Transaktionen, Dateioperationen, Datenverarbeitung und Monitoring - alles als lesbare Low-Code-Befehle in der INI-Datei.

Ablaufsteuerung

Anweisung	Funktion
`subcall_sektion = Name`	Ruft eine andere Sektion auf (Unterprogramm)
`ifgoto \| {WERT}=="X";Ziel`	Bedingte Verzweigung (If/Else in der INI)
`on_error_goto = Fehler`	Bei Fehler: Sprung zur Fehler-Sektion
`Setvariable \| NAME \| Wert`	Setzt eine Variable für diesen Lauf

Sage 100 Transaktionen & Dateioperationen

Anweisung	Funktion
`sage_transaktion = begin`	Startet eine Datenbank-Transaktion
`sage_transaktion = commit`	Schließt erfolgreich ab
`sage_transaktion = rollback`	Macht alle Änderungen rückgängig
`FILE_COMPARE = datei.xml`	Vergleicht mit letztem Upload - Abbruch wenn identisch
`GET_LAST_FROM_ARCHIVE`	Holt die letzte archivierte Version einer Datei
`MOVE_TO_ARCHIV`	Verschiebt verarbeitete Dateien ins Archiv

Datenverarbeitung & Konvertierung

Anweisung	Funktion
`EXPORT_XML = VORLAGE.ini`	Exportiert Daten aus Sage 100 als XML (SQL aus der Vorlage)
`IMPORT_ORDER_XML`	Importiert XML-Bestelldaten in Sage 100
`execute_sql_procedure = dbo.spName`	Führt eine SQL-Stored-Procedure aus
`convert_json_to_xml` / `convert_csv_to_xml`	Konvertiert JSON bzw. CSV in XML
`convert_edi_to_xml`	Konvertiert eine EDIFACT-Nachricht in XML

Reporting & Monitoring

Anweisung	Funktion
`email_send_all`	Sendet das Lauf-Protokoll per E-Mail
`EMAIL_Report_Erzwingen`	Erzwingt den E-Mail-Report auch ohne Fehler
`ping_monitor`	Heartbeat-Signal an den Monitoring-Dienst
`garbit_upload_imex_monitoring_to_sentry`	Fehler-Events an Sentry (Cloud-Monitoring)
`zip_logs`	Archiviert die Protokolldateien als ZIP

Mehr Kontext zu Transaktionssicherheit, on_error_goto, Heartbeat und Sentry finden Sie auf der Seite Monitoring.

03 · Transformationen

Feld-Transformationen in der Vorlage.

Jedes einzelne Datenfeld kann bei der Verarbeitung transformiert werden - direkt in der Vorlage-Datei, ohne Code. Mehrere Regeln lassen sich verketten; {$} ist der aktuelle Feldwert.

Anweisung	Funktion	Beispiel
`dateformat`	Datumsformat umwandeln	`2026-03-16T10:12:29+00:00` → `16.03.2026`
`number_format`	Zahlenformat konvertieren	`1.234,56` → `1234.56`
`replace`	Zeichenfolge ersetzen	`,` → `.` (Dezimaltrennzeichen)
`trim`	Leerzeichen entfernen	`" Test "` → `"Test"`
`lookup_db`	Datenbankwert nachschlagen	EAN → Sage-Artikelnummer
`lookup_ini`	Wert über INI-Mapping übersetzen	`DE` → `Deutschland`
`vbscript`	Beliebige Logik in VBScript (Escape-Hatch)	komplexe Sonderregeln
`ifgoto`	Bedingte Verzweigung auf Feld-Ebene	leere Felder überspringen

; Drei Regeln, keine Codezeile
ORDER_DATE = dateformat|iso8601;dd.MM.yyyy;{$}
COUNTRY = lookup_ini|COUNTRY_MAP;{$}
PRICE = replace|,|.;number_format|2;{$}

Alle unterstützten Formate (CSV, XML, JSON, Excel, EDI, PDF) und die vollständige Transformations-Engine beschreibt die Seite Datenformate.

04 · Grundlagen & Themen

Themen im Detail.

Die Dokumentation gliedert sich in thematische Bereiche. Hier steigen Sie direkt in das passende Kapitel ein - vom Low-Code-System über die Kommunikationswege bis zur Sage 100 Tiefenintegration.

Low-Code-System

Jobs, Sektionen, Scripts, Variablen und Vorlagen - der vollständige Aufbau des INI-Script-Systems.

Kommunikationswege

REST, GraphQL, SFTP/FTP/FTPS, IMAP/SMTP, SQL und Web-Automation per Selenium.

Datenformate

CSV, XML, JSON, Excel, EDI, PDF und Bilder - Formate, Konvertierung und Transformations-Engine.

Zeitplanung

Aufgabenplanung pro Sektion, unabhängige Intervalle und Delta-Updates mit FILE_COMPARE.

Monitoring & Fehler

Transaktionen, on_error_goto, rollback, Heartbeat (ping_monitor), Sentry und E-Mail-Reports.

Sage 100 Integration

Belegverarbeitung über das Sage 100 SDK, User-Defined Fields und Multi-Mandant.