Export Anteilsobjekt CSV

Exportiert tages-, monats- oder jahresweise Daten einer spezifischen Messgröße eines Anteilsobjekt-Typs (Kostenstelle / Energienutzen / Maschinen und Anlagen) in jeweils eine CSV- oder Text-Datei. Dabei kann bestimmt werden, welcher Messwert-Status minimal vorliegen muss, dass der Export erfolgreich durchgeführt wird. Für die CSV-Datei kann ein Ziel-Ordner (visual energy Auswerte-Ordner oder Filesystem) definiert werden und / oder eine E-Mail-Empfängerliste angegeben werden. Die Parameter, welche in die Datei geschrieben werden, können individuell bestimmt werden. Ein benutzerdefinierter Trigger kann ausgelöst werden.

Wo finde ich diesen Workflow?

Auswertebereich => Anteilsobjekt (z.B. Kostenstelle) => 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

2.27

12/04/2025

Argument "Export Directory" title renamed to directory

2.26

11/26/2025

Argument "Target Directory" replaced with "Export Directory"

2.25

11/13/2025

Argument desciption "Target Directory" changes

2.24

07/10/2025

UPDATE: Usable in Version newer than 5.2.0. Change title. Add machine and systems and add term "sharing object".

2.22

12/15/2022

Use automation server settings

2.21

03/29/2022

FIX: Reset file name for each exported interval. Change description of argument "Filename".

2.20

03/03/2022

UPDATE: Enable flat export also for cost centers/energy usage.

2.23

03/02/2022

Limit start date of the "continuous" function

2.19

12/20/2021

Add parameter file name.

2.18

07/07/2021

Update of description.

2.17

06/14/2021

Extended SMTP-Options

2.16

01/12/2021

Fix error when saving to folder that no longer exist.

2.15

12/07/2020

Add source workflow id to the csv document.

2.14

07/22/2020

Add value "yearly" to "Export timespan"

2.13

07/14/2020

Add argument "DocumentTargetFolder".

2.12

04/29/2020

UPDATE: New Workflows for cost center (base) and energy benefit (base).

2.11

08/07/2019

UPDATE: Sends E-Mail when execution fails cause of status violation.

2.10

08/05/2019

UPDATE: Usable in Version newer than 4.7.1 Build 12810. Name change from "CSV export (cost center/energy benefit)" to "Export cost center / energy benefit". Add output as textfile without delimiter. Add variable for fix length of field set parameter. Add parameter "Ignore zero values".

2.9

05/20/2019

Update of description.

2.8

05/17/2018

FIX: Export of [Meteringpoint.Number] of number of [Target.Number] (If row is of type "MP").

2.7

05/16/2018

FIX: Export fails with an exception.

2.6

05/08/2018

UPDATE: Additional export columns.

2.5

05/04/2018

UPDATE: Additional parameter "Flat export".

2.1

05/03/2018

Validation of parameters TargetDirectory/Recipients.

2.2

05/03/2018

Permission for NDF removed.

2.1

05/03/2018

Validation of parameters TargetDirectory/Recipients.

2.0

09/05/2017

Workflow created