Export CSV

Exportiert tages-, monats- oder jahresweise Daten einer Zählpunkt-Messgröße in jeweils eine CSV-Datei. Dabei kann bestimmt werden, welcher Daten-Status minimal vorliegen muss, dass der Export erfolgreich durchgeführt wird. Der Zeitstempel des letzten exportierten Datensatzes wird gespeichert, so dass dieser Workflow zyklisch (beispielsweise täglich) ausgeführt werden kann und so fortlaufend kontinuierlich Daten exportiert. Über den Testmodus können alternativ Daten exportiert werden, ohne das letzte Export-Datum zu ändern. Für die CSV-Datei kann ein Ziel-Ordner definiert werden und / oder eine E-Mail-Empfängerliste angegeben werden. Die Parameter, welche in die Datei geschrieben werden, können individuell bestimmt werden.

Wo finde ich diesen Workflow?

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

Parameter

Minimaler Status

Auswahl - Definiert den geringsten Messwert-Status eines Wertes. Ist der Status schlechter als hier angegeben, so erfolgt keine Verarbeitung.

Export-Zeitraum

Auswahl - Bestimmt den jeweils zu exportierenden Zeitraum. Maßgeblich ist der Parameter 'Letztes Export-Datum'.

  • Täglich: Ab dem Tag nach dem letzten Export-Datum. Für jeden Tag wird ein Export ausgeführt.
  • Monatlich: Ein gesamter Monat ab dem letzten Export-Datum. Für jeden Monat wird ein Export ausgeführt.
  • Jährlich: Ein gesamtes Jahr ab dem letzten Export-Datum. Für jedes Jahr wird ein Export ausgeführt.

Zeitspanne

Definiert, wie die Zeitspanne für die Aktion festgelegt wird.

  • neueste: Zeit zwischen dem letzten Datensatz und dem Zeitpunkt der Ausführung.
  • vollständig: Der gesamte Zeitraum, beginnend beim Zeitstempel des ersten Datensatzes.
  • Anzahl Tage: Ganze Tage in der Vergangenheit ausgehend vom Zeitpunkt der Ausführung.
  • Zeitraum: Präzise Angabe von Start- und Endzeitpunkt.

Letztes [Export / Berechnung] -Datum

Zeitpunkt des Datensatzes, der durch die letzte erfolgreiche Aktion verarbeitet wurde. Nur aktiv, wenn als Zeitspanne 'neueste' gewählt ist.

Zeitraum

Datum Start / Datum Ende – Legt fest, für welchen Zeitraum die Aktion ausgeführt werden soll. Nur aktiv, wenn als Zeitspanne 'Zeitraum' gewählt ist.

Testmodus

Ja / Nein – Im Testmodus werden Daten, ausgehend vom Ausführungszeitpunkt, verarbeitet. Die Zeitspanne wird über den Parameter 'Offset für Testmodus' berechnet. Der Parameter 'Letztes Export-Datum' wird nicht beachtet und auch nicht aktualisiert. Dadurch kann der Export eines Zeitraums mehrfach ausgeführt werden.

Offset für Testmodus

Auswahl – Angabe der Zeitspanne für den 'Testmodus', abhängig vom Parameter 'Export-Zeitraum'.

  • Täglicher 'Export-Zeitraum': Anzahl an Tage in die Vergangenheit, ausgehend vom aktuellen Tag. Nicht der aktuelle Tag.
  • Monatlicher 'Export-Zeitraum': Anzahl an ganzen Monaten in die Vergangenheit, ausgehend vom aktuellen Monat. Nicht der aktuelle Monat.
  • Jährlicher 'Export-Zeitraum': Anzahl an ganzen Jahren in die Vergangenheit, ausgehend vom aktuellen Jahr. Nicht das aktuelle Jahr.

Ausgabe-Verzeichnis

Text – Angabe eines Verzeichnisnamens oder Freigabe.

Ziel-Ordner

Auswahl - Wahl des visual energy Ordners zur Ablage der Ausgabedatei.

Empfängerliste
für E-Mails

Text – Legt fest, an welche Empfänger die E-Mail gesendet werden soll. Die Empfänger können durch Semikolon voneinander getrennt werden.

Trennzeichen

Auswahl

  • Semikolon
  • Tabulator

Tabellenkopf / Kopfzeile

Ja / Nein

  • Ausgabeparameter: Soll die Ausgabe einen Tabellenkopf (Spaltenüberschriften) besitzen?
  • Eingabeparameter: Besitzt die Tabelle einen Tabellenkopf (Spaltenüberschriften).

Feldliste

Auswahl – Auswahl der Felder für die Ausgabe. Unterschiedliche Formate sind für Datum und Zahlen möglich.

  • N0-N3 geben die Nachkommastellen im Zahlenformat an (z.B. N3: 32,452).
  • Bei S1-S3 wird die Zahl mit den jeweiligen Nachkommastellen, jedoch ohne Trennzeichen dargestellt (z.B. S3: 32452).
  • Für einige Felder kann eine fixe Zeichenlänge zwischen 1 und 100 definiert werden. Bei einem kürzeren Wert wird die Länge durch Leerzeichen aufgefüllt, bei einem längeren Wert, wird dieser auf die definierte Zeichenlänge gekürzt. Eine Ausnahme bildet die Variable "Wert". Bei dieser wird die definierte Zeichenlänge durch führende Nullen erreicht. Der Default-Wert 0 besagt, dass keine Längen-Änderung des Feldes vorgenommen wird.

Die Felder:

  • ZP (ID)
  • Start (lokal)
  • Ende (lokal)
  • Wert
  • Einheit
  • Status
  • OBIS (Code, kurz)
  • OBIS (Name, kurz)
  • OBIS (Code, lang)
  • OBIS (Name, lang)
  • ZP (Name)
  • ZP (Nummer)
  • ZP (Installationsort)
  • ZP (GUID)
  • Standort (Name)
  • Zeitzone (Id)
  • Zeitzone (Anzeige-Name)
  • Zeitzone (Standard-Name)
  • Zeitzone(Base UTC Offset)
  • Start (UTC)
  • Ende (UTC)
  • Konstante 1
  • Konstante 2
  • Konstante 3
  • Konstante 4
  • Konstante 5

Beendet-Trigger

Trigger – Legt den Trigger fest, welcher nach dem Beenden des Workflows ausgeführt wird.

Version

Datum

Änderung

3.23

12/04/2025

Argument "Export Directory" title renamed to directory

3.22

11/26/2025

Argument "Target Directory" replaced with "Export Directory"

3.21

11/13/2025

Argument desciption "Target Directory" changes

3.20

03/02/2022

Limit start date of the 'continuous' function.

3.19

02/14/2023

FIX: Wrong timerange with OBIS of type ObisCodeType.CumulatedDayMax

3.18

12/15/2022

Use automation server settings

3.17

05/20/2022

FIX: Wrong timerange with timezone.

3.16

05/20/2022

Add parameter timerangechoice and timerange.

3.15

05/02/2022

FIX: Wrong date/time conversions using local timezone instead of location timezone.

3.14

04/13/2022

FIX: Workflow creates invalid files for export interval "Month". First file only contains one day.

3.13

07/07/2021

Update of description.

3.12

06/14/2021

Extended SMTP-Options

3.11

01/12/2021

Fix error when saving to folder that no longer exist.

3.10

12/07/2020

Add source workflow id to the csv document.

3.9

07/22/2020

Add value 'yearly' to 'Export timespan'

3.8

07/14/2020

Add argument 'DocumentTargetFolder'.

3.7

05/15/2019

Update of description.

3.6

07/30/2018

FIX: Workflow creates invalid files if meter values are exported.

3.5

05/23/2018

FIX: Workflow creates invalid files if there are no data for a time span.

3.4

03/19/2018

FIX: Workflow creates invalid files if there is a gap in the source data

3.3

02/06/2018

FIX: Last day is not exported if data ends exactly with value at end of day (eg. 30.01.2018 23:00).

3.2

10/23/2017

Validation of parameters TargetDirectory/Recipients.

3.1

11/13/2017

Additional parameter FieldSet.

3.0

05/12/2017

Multi-Target workflows

2.2

05/24/2017

Workflow terminates with exception if email settings in automation server settings are not set.