Die Komponente Sql Batch Collector dient zur Ausführung eines definierten SQL-Statements, um zusätzliche Daten aus einer Datenbank zu ermitteln und im Prozesskontext bereitzustellen.

Das SQL-Statement kann auf Prozessdaten zugreifen, die im bisherigen Prozessverlauf ermittelt oder erzeugt wurden. Diese Werte können über konfigurierte SQL-Parameter in das Statement eingebunden werden.

Die Komponente ist ausschließlich für lesende Datenbankzugriffe vorgesehen. Daher ist nur die Ausführung eines SELECT-Statements zulässig.

Die ermittelten Daten können abhängig von der erwarteten Ergebnismenge entweder:

• als Tabellenstruktur (mehrere Ergebniszeilen)
• als DataItem (eine einzelne Ergebniszeile)

im Prozesskontext gespeichert werden.

Konfigurationsparameter

Datenquelle und Datenbankzugriff

Feld	Beschreibung
Quelle	Definiert die Datenquelle im Prozesskontext, auf deren Daten die Komponente ihre Operationen ausführt und aus der Werte für SQL-Parameter gelesen werden können.
Quelldatenbank	Definiert die Datenbankverbindung, gegen die das SQL-Statement ausgeführt wird. Die Datenbank muss zuvor im Datacenter unter Communication → Ressourcen konfiguriert worden sein.

SQL-Ausführung

Feld	Beschreibung
Batch	Enthält das auszuführende SQL-Statement. Es ist ausschließlich ein SELECT-Statement zulässig. Beim SQL-Statement dürfen keine führenden oder abschließenden Leerzeichen (Whitespace) enthalten sein, da diese vom Ausführungsmechanismus nicht bereinigt werden und dazu führen können, dass das SQL-Statement nicht ausgeführt wird.
Timeout	Definiert die maximale Wartezeit auf eine Antwort der Datenbank, bevor der Lauf abgebrochen wird. Dies betrifft nicht die Laufzeit des SQL, sondern die maximale Antwortzeit der Datenbank.

Ergebnisverarbeitung

Feld	Beschreibung
Output Name (Table)	Definiert den Namen des Tabellenobjekts im Prozesskontext, in das das Ergebnis geschrieben wird, wenn mehrere Ergebniszeilen erwartet werden.
Output Name (DataItem)	Definiert den Namen des DataItems im Prozesskontext, in das das Ergebnis geschrieben wird, wenn genau eine Ergebniszeile erwartet wird.

SQL-Parameter

Feld	Beschreibung
Parameter	Definiert die Felder aus dem Prozesskontext, die im SQL-Statement als Parameter verwendet werden.

Parameterstruktur

Attribut	Beschreibung
Name	Name des Parameters, der im SQL-Statement verwendet wird.
Quelle	Definiert das Feld innerhalb der im Prozesskontext konfigurierten Quelle.

Verarbeitung

Die Komponente führt folgende Verarbeitungsschritte aus:

• Aufbau einer Verbindung zur konfigurierten Quelldatenbank
• Ersetzung der definierten SQL-Parameter mit Werten aus dem Prozesskontext
• Ausführung des definierten SELECT-Statements
• Übernahme des Ergebnisses in den Prozesskontext:

• als Tabellenobjekt, wenn mehrere Ergebniszeilen zurückgegeben werden
• als DataItem, wenn genau eine Ergebniszeile erwartet wird

• Abbruch der Ausführung, wenn der konfigurierte Timeout überschritten wird