Der Job Xlsx-Batch Export stellt das Ergebnis einer definierten SQL-Abfrage als Excel-Datei (.xlsx) bereit.

Optional kann die erzeugte Datei:

• im Dateisystem abgelegt
• per E-Mail versendet
• sowohl gespeichert als auch versendet

werden.

Typische Einsatzszenarien:

• Reporting (z. B. Status- oder Mengenauswertungen)
• Datenexport für Fachbereiche
• Bereitstellung strukturierter Listen für externe Systeme

Funktionsweise

Der Job führt ein hinterlegtes SQL aus und verarbeitet die Ergebnismenge wie folgt:

1. Abfrage der Quelldatenbank
2. Erzeugung einer Excel-Datei (.xlsx)
3. Benennung über einen Namensgenerator
4. Ablage im definierten Verzeichnis
5. Optionaler Versand per E-Mail

Optional kann dem SQL der Parameter @lastExecution übergeben werden.

Dateiverhalten & Versand

Feld	Beschreibung
Überschreiben wenn notwendig	Ist die Checkbox aktiv, wird eine bereits vorhandene Datei mit gleichem Namen überschrieben.
Mailtext	Textkörper der E-Mail, sofern die Datei per E-Mail versendet wird.
Email an	Empfängeradresse für den Versand.
Subjekt	Betreff der generierten E-Mail.
Datei nicht an Mail anhängen	Steuert, ob die erzeugte Datei als Anhang versendet wird oder nicht.
Verzeichnis	Zielverzeichnis für die erzeugte Datei. Das Verzeichnis muss zuvor unter Communication → Ressourcen konfiguriert worden sein.

Dateiformat & Struktur

Feld	Beschreibung
Kodierung	Kodierung der Ergebnismenge (z. B. UTF-8).
Überschriften weglassen	Steuert, ob die Excel-Datei mit oder ohne Spaltenüberschriften erzeugt wird. Sind Überschriften aktiv, werden die SQL-Feldnamen als Header verwendet.
Trennzeichen	Konfigurationsfeld vorhanden, hat jedoch bei nativen .xlsx-Dateien in der Regel keine funktionale Relevanz (nur bei CSV relevant).

Dateibenennung & Laufsteuerung

Feld	Beschreibung
Namensgenerator	Definiert den Namen der Ergebnisdatei. Der Generator muss unter Communication → Namensgenerator konfiguriert sein.
Benötigt letztes Ausführungsdatum	Übergibt dem SQL den Parameter @lastExecution mit dem Zeitpunkt der letzten erfolgreichen Ausführung.
Batchcode	SQL zur Ermittlung der Ergebnismenge. Wichtig: Kein Leerzeichen vor dem ersten oder nach dem letzten Zeichen.
Timeout	Maximale Wartezeit auf eine Rückmeldung der Datenbank. Nicht die Laufzeit des SQL selbst.
Quelldatenbank	Datenbank, auf die sich das SQL bezieht. Muss unter Communication → Ressourcen gepflegt sein.
LogRowsEffected	Wird in diesem Job nicht verwendet.

Technische Hinweise

• Das SQL bestimmt vollständig die Struktur der Excel-Datei
• Feldnamen im SQL definieren die Spaltenüberschriften
• Bei Verwendung von @lastExecution muss das SQL diesen Parameter korrekt verarbeiten
• Der Job eignet sich besonders für regelmäßige Reporting-Läufe via Scheduling

Unterschiede zum CSV-BatchExport

CSV-BatchExport	Xlsx-Batch Export
CSV-Datei	Excel-Datei (.xlsx)
Trennzeichen relevant	Trennzeichen in der Regel nicht relevant
Textbasiertes Format	Strukturierte Excel-Datei