Das DatabaseToCSV Add-In erzeugt aus einer SQL Abfrage eine oder mehrere CSV-Dateien.
| Merkmale | |
| Add-In Type | Logic |
| Schnittstellen | In: Datenbank Out: CSV-Datei |
| Transaktionen | 1 pro erstellte Datei |
| Ereignisse | Pro erstellte Datei: <Instanz>.Output (Parameter = file) 1x am Schluss: <Instanz>.Done |
| Parameter | |
| connectionString | Verbindungszeichenfolge der Datenbank |
| delimiter | Trennzeichen in der CSV-Datei (Optional, Default = Semikolon) |
| encoding | Kodierung der CSV-Datei (Optional, Default = “UTF-8”) |
| fileNamePattern | Dateiname der CSV-Datei Wird ignoriert wenn der Dateiname von der SQL Abfrage zurückgegeben wird. Der Platzhalter {0} wird durch einen aktuellen Zeitstempel ersetzt. Bsp.: File_{0: yyyyMMdd_hhmmss}.csv = File_20160523_115620.csv Bestehende Dateien werden überschrieben. |
| fileSaveLocation | Zielverzeichnis der CSV-Datei |
| includeColumnName | true: Spaltenname werden in die 1. Zeile geschrieben (Optional, default = false) |
| query | Eine SQL Abfrage welche die zu exportierenden Daten zurückgibt Nur SELECT oder EXEC sind erlaubt. Pro Resultatset wird eine CSV-Datei erstellt |
| timeOut | Timeout in Sekunden bis der SQL-Befehl abgebrochen wird. (Optional, default = 30) |
| endpoint | Name des Endpunktes der in der Transaktion verwendet wird (Optional, Default = “”) |
Oftmals erhält die IT den Auftrag periodisch Datensätze aus einer Datenbank zu exportieren, damit die Fachbereiche die Angaben überprüfen oder weiterverarbeiten können.
Dazu wird eine SQL-Abfrage definiert, welche die Daten zurückgibt. Ein Timer, welcher das Add-In DatabaseToCSV periodisch aufruft und ein MailSender, welcher den Fachbereich über die neu erstellten CSV-Dateien informiert, runden das Paket ab.
Wird von der SQL Abfrage ein 2. Resultatset zurückgegeben, dann wird die 1. Spalte der 1. Zeile des 2. Resultatsets als Dateiname interpretiert. Der Parameter “fileNamePattern” wird in diesem Fall ignoriert. Beispiel einer SQL Abfrage:
SELECT * FROM DataTable;
SELECT 'DataTable_export.csv';
Wenn die SQL Abfrage ein mehrfaches von 2 Resultatsets zurückgibt, werden mehrere CSV-Dateien erstellt. In diesem Fall kann der Dateinamen also nicht über den Parameter “fileNamePattern” festgelegt werden. Beispiel einer SQL Abfrage die zwei CSV-Dateien erstellt:
SELECT * FROM DataTable;
SELECT 'DataTable_export.csv';
SELECT * FROM StatisticData;
SELECT 'Statistic_export.csv';