Das Batch Modul, Definitionen automatisiert und zeitgesteuert ausführen

Definitionen automatisch und zeitgesteuert ausführenDas Modul "FHBatch.exe" ist eine Konsolenanwendung die über Befehlszeilenparameter bzw. Übergabeparameter gesteuert wird. Mit dem Batchmodul können Sie jede gespeicherte FlowHeater Definition ohne den grafischen Designer ausführen lassen. z.B. können Sie nachdem Sie die Definition im Designer getestet und gespeichert haben das Ganze auf einen Windows Server stellen und dann über einen zeitgesteuerten Windows Task ausführen lassen.

Mit dem Batch Modul können langlaufende Definitionen und immer wiederkehrende Aufgaben wie z.B. Import / Export / Update von Datenbank Tabellen sowie automatisiertes erstellen von Testdaten problemlos als Batch Job in der Nacht ausgeführt werden.

Beispiel eines Aufrufes

Mit diesem Befehl weisen Sie den FlowHeater an die Definition ImportUmsatz.fhd auszuführen und dabei sollen max. die ersten 1000 Datensätze berücksichtigt werden.

Hinweis

Werden Anmeldeinformationen benötigt, z.B. für eine Anmeldung an eine Datenbank ( SQL Server, Oracle, MySQL, ...), muss das evtl. benötigte Passwort in der Definition mit abgespeichert werden. Aus Sicherheitsgründen wird das Passwort verschlüsselt in der FlowHeater Definition hinterlegt!

Returncode / Exitcode / Errorlevel

Nach der Ausführung des Batch Moduls können Sie über den Exitcode in Batch Dateien (.CMD / .BAT) abfragen ob die Ausführung der gestarteten FlowHeater Definition Erfolgreich durchgeführt werden konnte. Dabei bedeuten:

z.B.

 

Optionen

	Option	Beschreibung
	/? oder /help	zeigt eine kurze Hilfebeschreibung an
	/MaxRows n	Es werden max. die ersten n Datensätze berücksichtigt
	/SetParameter Name=Wert	Setzt den FlowHeater Parameter [Name] auf den angegebenen [Wert]
	/SetParameter Name:Crypt=Wert	Setzt den FlowHeater Parameter [Name] auf den angegebenen [Wert] der Wert muss dabie vorher mit der Option /Crypt verschlüsselt werden
	/Memory	Stellt auf Hauptspeicherdatenverarbeitung um (ab Version 2.x)
	/Massdata	Stellt auf den Massenverarbeitungsmodus um
	/LogFile Dateiname	fügt die Ausgabe an das angegebene Logfile an
	/LogCompact	hiermit wird ein einzeiliges (kompaktes) Ausgabeformat aktiviert
	/LogQuote	umschließt die einzelnen Logeinträge mit dem Anführungszeichen
	/LogDelete	löscht die angegebene Logdatei vor der Ausführung
	/ShowDebug	gibt Debug Meldungen auf der Konsole aus
	/DisableDebug	Deaktiviert Debug Meldungen (ab Version 2.x)
	/ShowWarnings	Aktiviert Warnungen (ab Version 2.x)
	/DisableWarnings	Deaktiviert Warnungen
	/Crypt Wert	Verschlüsselt den Wert zur späteren Verwendung über die Option /SetParameter Name:Crypt=Wert

 

Nur für TextFile, Excel und XML Adapter

Für die Adapter TextFile, Excel und XML können Sie über die Optionen /ReadFileName und /WriteFileName festlegen welche Datei gelesen bzw. geschrieben werden soll. Ist auf der jeweiligen Seite ein andere Adapter vorhanden wirft diese Option eine Fehlermeldung aus und die Verarbeitung wird abgebrochen.

	Option	Beschreibung
	/ReadFileName Dateiname	Überschreibt die Vorgabe in der Definitionsdatei. Setzt dabei den Dateinamen vom ersten Adapter im ersten Verarbeitungsschritt. Über /ReadFileName[:V[:A]] können auch beliebig andere Adapter in anderen Verarbeitungsschritten gesetzt werden. z.B. setzt /ReadFileName:2:1 die Eingabedatei vom ersten Adapter im zweiten Verarbeitungsschritt. Wird der Adapter [:A] weggelassen wird automatisch der erste Adapter vom angegeben Verarbeitungsschritt verwendet. Wildcards wie C:\Temp\*.csv sind erlaubt!
	/WriteFileName Dateiname	Überschreibt die Vorgabe in der Definitionsdatei. Setzt dabei den Dateinamen vom ersten Adapter im letzten Verarbeitungsschritt. Über /WriteFileName[:V[:A]] können auch beliebig andere Adapter in anderen Verarbeitungsschritten gesetzt werden. z.B. setzt /WriteFileName:2:1 die Ausgabedatei vom ersten Adapter im zweiten Verarbeitungsschritt. Wird der Adapter [:A] weggelassen wird automatisch der erste Adapter vom angegeben Verarbeitungsschritt verwendet.

Hinweis: Die Option /ReadFileName setzt immer den Dateinamen des ersten Adapters im ersten Verarbeitungsschritt und die Option /WriteFileName setzt den Ausgabedateinamen vom ersten Adapter im letzten Verarbeitungsschritt. Ist es notwendig weitere Dateinamen über die Batchverarbeitung zu übergeben können diese z.B. über FlowHeater Parameter mittels der Option „/SetParameter FILE2=C:\Temp\export.csv“ realisiert werden.

Ab Version 2.x werden alle Optionen die Sie über den Designer im Test und Ausführen Dialog eingestellt haben mit in der FlowHeater Definition abgespeichert. Die oben aufgeführten Optionen benötigen Sie nur noch wenn Sie die Voreinstellung während der Batchausführung verändern möchten.

z.B. Sie haben einen etwas größeren Datenbestand den Sie importieren/exportieren möchten. Im Designer stellen Sie solange Sie die Definition erstellen und testen die Option ein, dass Sie max. 1000 Datensätze verarbeiten möchten. Diese Einstellung wird jedoch mit in der Definitionsdatei gespeichert. Wenn Sie nun diese Definition über das Batchmodul ohne weitere Option ausführen, werden ebenfalls nur 1000 Datensätze verarbeitet. Damit das Batchmodul während der Batchverarbeitung alle vorhandenen Datensätze verarbeitet brauchen Sie nur die Option /MaxRows mit dem Wert 0 aufrufen. Siehe Beispiel.

FHBatch.exe /MaxRows 0 import.fhd

Hiermit werden alle verfügbaren Datensätze/Zeilen verarbeitet, egal welche Voreinstellung in der Definition vorgenommen wurde.

 

Beispiele

Mit dem Batch Modul können Sie z.B. problemlos jede Nacht automatisiert Umsatzzahlen als CSV Textdatei erstellen lassen. Oder Flatfiles bzw. Testdaten, formatiert mit festen längen,  die dann zu Testzwecken (für die Entwickler unter uns) in eine SQL Server Datenbank automatisiert importiert werden, etc.

Folgende Beispiele sind zum Batch Modul bereits verfügbar

• Automatischer Batch Import in eine MS Access Datenbank Tabelle von mehreren CSV Textdateien