Import CSV

Importiert eine CSV-Datei aus einem visual energy Auswerte-Ordner oder dem Filesystem und speichert die Werte im Zieltyp, einer Zählpunkt-Messgröße. Die Datei muss mindestens eine Spalte mit Zeitstempel und eine Spalte mit dem Wert enthalten. Der Status kann ebenfalls eingelesen werden. Falls kein Status in der CSV-Datei enthalten ist, kann ein Standard-Status für alle Werte gesetzt werden. Der Dateiname kann mit Wildcard (*) angegeben werden. Es kann nur der Dateiname oder die Quell-Datei angegeben werden.

Wo finde ich diesen Workflow?

Erfassungsbereich => Zählpunkt => Messgrößen => Automation

Parameter

Dateiname

Text – Angabe des absoluten Pfades und des Dateinamens der Datei, die importiert werden soll (z.B. C:\ImportDateien\Beispiel.csv). Im Dateinamen können auch Wildcards verwendet werden (z.B. C:\ImportDateien\*.csv). Das Verzeichnis muss vom Webserver aus erreichbar sein und der Netzwerkdienst muss Lese- und Schreibrechte auf dem Ordner haben.

HINWEIS

Der eingerichtete Benutzer für die Freigabe muss über ausreichend Berechtigung für die gewünschte Funktion im Filesystem besitzen.

Berücksichtigen Sie beim Einrichten der Freigabe dabei bitte den gesamten Prozess. Beim Export müssen möglicherweise vorhandene Dateien überschrieben werden. Beim Import sollen eventuell nach Erfolg die Datei gelöscht oder in einen Unterordner verschoben werden. Falls diese Unterordner nicht existieren, muss der Freigabe-Benutzer Berechtigungen zum Erstellen besitzen.

Quell-Datei	Auswahl – Auswahl einer Datei aus einem visual energy Auswerte-Ordner.
Aktion nach Import	Auswahl – Mögliche Aktion nach erfolgreichem Import im Auswerte-Ordner oder Filesystem: Datei in Unterordner verschieben Datei löschen Keine Aktion
Trennzeichen	Auswahl Semikolon Tabulator
Zeitstempel ist UTC	Auswahl Ja – Der Zeitstempel wird als universelle UTC-Zeit interpretiert. Nein - Der Zeitstempel wird als lokale Standort-Zeit interpretiert
Datum und Uhrzeit	Auswahl Datum und Uhrzeit in einer gemeinsamen Spalte Datum und Uhrzeit in getrennten Spalten
Spaltenindex Datum und Zeit	Zahl – Gibt den Spaltenindex an, an dem der End-Zeitstempel (Datum und Zeit) geschrieben ist. Der Spaltenindex startet bei 1. Maximal kann der Spaltenindex 20 betragen.
Spaltenindex Datum	Zahl – Gibt den Spaltenindex an, an dem der End-Zeitstempel (Datum) geschrieben ist. Der Spaltenindex startet bei 1. Maximal kann der Spaltenindex 20 betragen.
Spaltenindex End-Zeitstempel	Zahl – Gibt den Spaltenindex an, an dem der End-Zeitstempel (Uhrzeit) geschrieben ist. Der Spaltenindex startet bei 1. Maximal kann der Spaltenindex 20 betragen.
Spaltenindex Wert	Zahl – Gibt den Spaltenindex des Wertes an. Der Spaltenindex startet bei 1. Maximal kann der Spaltenindex 20 betragen.
Spaltenindex Status	Zahl – Gibt den Spaltenindex des Status an. Der Spaltenindex startet bei 1. Maximal kann der Spaltenindex 20 betragen. Ist kein Status in der CSV-Datei vorhanden, dann soll der Spaltenindex auf 0 gesetzt werden. Damit wird für Status der Parameter "Standard-Status" übernommen.
Tabellenkopf / Kopfzeile	Ja / Nein Ausgabeparameter: Soll die Ausgabe einen Tabellenkopf (Spaltenüberschriften) besitzen? Eingabeparameter: Besitzt die Tabelle einen Tabellenkopf (Spaltenüberschriften).
Anzahl Kopfzeilen	Zahl - Die Anzahl der Kopfzeilen.
Standard-Status	Auswahl – Standard-Wert für den Messwert-Status. 0 – Originalwert 1 – Ersatzwert 2 – Temporärer- / Geschätzter Wert
Beendet-Trigger	Trigger – Legt den Trigger fest, welcher nach dem Beenden des Workflows ausgeführt wird.
Meldungstext / Titel	Text – Möglichst aussagefähiger Ausdruck. Die Verantwortlichen für das Energiemanagement sollen mit Hilfe des Meldungstextes sofort eine Übersicht über die Problematik erhalten.
Priorität	Auswahl – Priorität der Meldung. 0 (keine Priorität) bis 6 (sehr hohe Priorität).

Version	Datum	Änderung
2.14	12/04/2025	Replace parameter "Filename" with "ImportDirectory
2.13	03/16/2023	Replace parameter 'DeleteAfterImport' with 'ActionAfterImport'.
2.12	11/14/2021	New property Message.AssignedWorkflowID to define references between message and worflow assignment which created the message.
2.11	08/02/2022	Update of description.
2.10	07/18/2022	Update: Show file line in case of incorrect date time.
2.9	12/20/2021	UPDATE: Date and time can be specified in different columns. ColumnIndexValue and ColumnIndexState are required parameters.
2.8	12/06/2021	Update the validation of the imported file. If the line contains no value it will be set to 0 and status 4.
2.7	07/15/2021	FIX: Workflow will terminate with an exception when data could not be written to the database (activity WriteData returns false).
2.6	02/25/2021	FIX: Workflow terminates on empty columns.
2.5	07/14/2020	Add parameter 'DocumentTargetFolderItem'.
2.4	09/16/2019	Add parameter header lines. Add wildcard to filename. Optinal write a message (argument MessageText).
2.3	05/09/2019	Update of description.
2.2	07/04/2018	UPDATE: Workflow will terminate if import file could not be found.
2.1	07/19/2017	FIX: Data import with ambigious times (in case of daylight saving time) fails.
2.0	05/12/2017	Multi-Target workflows
1.5	05/24/2017	Exception shows number of line in which data could not be parsed.
1.4	05/19/2017	Backup file will be deleted if it already exists.
1.3	05/15/2017	Avoid import of invalid states, create start timestamp for OBIS of type EnergyFeed.