HAKOM PowerTSM® Documentation

Automatisierung (Batch)

Mit dem Automation Plug-in können Einstellungen für die automatisierte Ausführung von Aufgaben in der Oberfläche des TSM bearbeiten werden.

Das Ein- bzw. Auslesen verschiedener Vorlagen kann durch dieses Plug-in mit einem einzigen Task gesteuert werden.

Funktionsbeschreibung

Das Automation Plug-in bietet zusammen mit einem einzigen Scheduled Task die Möglichkeit verschiedene Vorlagen zu unterschiedlichen Zeitpunkten abzuarbeiten. Es kann jeder Vorlage eine eigene Häufigkeit zugeordnet werden. So können zum Beispiel folgende Aufgaben automatisiert abgearbeitet werden:

  • Vorlage 1: wird täglich ausgelesen, anschließend im Excel berechnet und wieder eingelesen,

  • Vorlage 2: wird einmal im Monat eingelesen

  • Vorlage 3: wird stündlich eingelesen und abgespeichert.

Einzige Voraussetzung für die Abarbeitung durch einen einzigen Task ist, dass diese Vorlagen in demselben Ordner abliegen.

Funktionalität

Die Funktionalität des Automation Plug-in ist nur in Kombination mit einem Scheduled Task zweckmäßig.

Das Automation Plug-in wird über den entsprechenden Excel Ribbon aufgerufen:

Batch-de-1.jpg


Mit dem Button „Aktualisieren“, werden die Parameter aus dem aktuellen Excel Arbeitsblatt in das Automation Plug-in eingelesen.

Mit dem Button „Speichern“ werden die eingegebenen Parameter für die in "Vorlage" angegebene Excel Datei gespeichert. Dadurch werden die Parameter an den Excel Namens-Manager übergeben, der diese wiederum an den TSM weitergibt.



Batch-de-2.jpg

Batch-de-3.jpg


Um die Parameter beizubehalten, muss diese Datei beim Schließen der Vorlage gespeichert werden.

Die Abarbeitung der Vorlagen erfolgt mittels TSM+. Aus diesem Grund müssen Datumsangaben in Excel Formeln in der Form yyyyMMdd hh:mm erfolgen.

Allgemein

Batch-de-4.jpg


Checkbox/Feld

Beschreibung

Allgemein

Aktivierung dieser Checkbox erlaubt die Bearbeitung weiterer Checkboxen und Felder. Durch die Aktivierung dieser Checkbox wird die Funktion des Automation Plug-ins aktiviert.

letzter Aufruf

Gibt den Zeitpunkt des letzten Aufrufs des Automation Plug-ins für die gewählte Excel Datei an.

nächste Startzeit

Gibt den Zeitpunkt des nächsten Aufrufs des Automation Plug-ins für die gewählte Excel Datei an.

Wiederholung

Gibt die Wiederholungsrate für Aufrufe des Automation Plug-ins an. Soll das Automation Plug-in für die betroffene Excel Datei einmal täglich durchgeführt werden, muss der Eintrag lauten: Wiederholung : 1 x Tag

Blatt

Hier kann festgelegt werden, ob ein bestimmtes oder alle Arbeitsblätter der Excel Datei vom Automation Plug-in bearbeitet werden soll/sollen.

Lesen in Excel

Ist diese Checkbox aktiviert, werden die in der Vorlage angegeben Zeitreihen in diese ausgelesen.

Fehlende leer

Ist diese Checkbox aktiviert, werden Werte, die mit dem Flag "fehlend" gespeichert sind, nicht in die Vorlage eingetragen. Die entsprechenden Zellen bleiben somit leer.

Raster aus Vorlage

Ist diese Checkbox aktiviert, wird zum Auslesen das Raster aus der Vorlage herangezogen und die Dropdown-Liste rechts daneben ist nicht mehr auswählbar.

Ist die Checkbox nicht aktiviert, muss aus der Dropdown-Liste rechts daneben ein Raster, in dem die Zeitreihendaten in die Vorlage ausgelesen werden sollen, ausgewählt werden.

Speichern in DB

Ist diese Checkbox aktiviert, werden Werte aus der Vorlage auf die jeweilige Zeitreihe gespeichert.

Datei speichern

Batch-de-5.jpg


Checkbox/Feld

Beschreibung

Datei speichern

Ist diese Checkbox aktiviert, werden aus abgearbeiteten Vorlagen resultierende Dateien am unter "Berichtspfad" angegebenen Ort abgelegt.

Berichtspfad

Gibt den Pfad an, unter dem erzeugte Dateien abgelegt werden sollen.

Dateiname

Hier kann ein Muster für den Namen erzeugter Dateien angegeben werden. 

Excel

Ist diese Option ausgewählt, werden erzeugte Dateien als Excel Dateien gespeichert.

CSV

Ist diese Option ausgewählt, werden erzeugte Dateien als CSV Dateien gespeichert.

Blatt

Wird hier ein Arbeitsblatt ausgewählt, wird für nur für dieses eine CSV Datei erstellt. Wird hier <Alle> ausgewählt, wird für jedes Arbeitsblatt eine eigene CSV Datei erstellt.

Trennzeichen

Gibt das Trennzeichen der erzeugten CSV Datei an.

Dezimalpunkt

Gibt das Dezimaltrennzeichen der erzeugten CSV Datei an.

KISS-A Formatierung

Ist diese Checkbox aktiviert, wird die Zeitreihe aus dem HAKOM Format in das KISS-A Format umgewandelt.

(Nähere Informationen zu den Formaten einer Zeitreihe finden Sie unter Users - Standard Plug-ins: ZAMS - Zeitreihenformate)

KISS-A Transformation

Diese Checkbox kann nur in Verbindung mit Kiss-A Formatierung gewählt werden und steht nur für xlsx-Dateien zur Verfügung. Ist sie aktiviert, werden Zeitreihen in resultierenden Datei aus dem HAKOM Format in das KISS-A Format umgewandelt.

(Nähere Informationen zur KISS-A Transformation finden Sie hier: Users - Standard Plug-ins: KISS-A Transformation)

Defined Names

Die Parameter mit denen das Automation Plug-in ausgeführt wird sind im Names Manager als Defined Names angegeben. Neben jenen, die oben durch die GUI übergeben werden können, gibt es noch weitere. Hier ist eine vollständige Liste aller möglichen Defined Names:

Name

Pendant in GUI

Beschreibung

Mögliche Werte

Beispiel

ActivateBatch

Allgemein

Siehe "Allgemein"

  • True

  • False

True

ActivateRead

Lesen in Excel

Siehe "Allgemein"

  • True

  • False

True

ActivateWrite

Speichern in DB

Siehe "Allgemein"

  • True

  • False

True

ActivateSaveFile

Datei speichern

Siehe "Datei speichern"

  • True

  • False

True

SavePath

Berichtspfad

Siehe "Datei speichern"

Pfad

C:\Saves

LogErrorMessages

/

Gibt an, welche Zellen des Blattes benutzerdefinierte Fehlermeldungen enthalten.

String mit Excel Ranges

Blatt_3!D18:D41

ActivateSaveFileOnError

/

Gibt an, ob im Falle eines Fehlers eine Datei angelegt werden soll.

  • True

  • False

True

SavePathOnError

/

Gibt an, wo die Datei, die Fehler enthält, gespeichert werden soll.

Pfad

C:\Errors

LastRun

letzter Aufruf

Siehe "Allgemein"

Datum im ISO-8601 Standard

2020-01-01T00:00:00Z

NextRun

nächste Startzeit

Siehe "Allgemein"

Datum im ISO-8601 Standard

2020-01-01T00:00:00Z

RepeatInterval

Wiederholung (Auswahlliste)

Siehe "Allgemein"

  • 1 (Sekunde)

  • 60 (Minute)

  • -1 (Viertelstunde)

  • -2 (Halbe Stunde)

  • -3 (Stunde)

  • -4 (Tag)

  • -5 (Woche)

  • -6 (Monat)

  • -7 (Quartal)

  • -8 (Jahr)

  • -10 (Halbes Jahr)

-3

RepeatIntervalMultiplier

Wiederholung (Zahl)

Siehe "Allgemein"

Integer

1

Sheets

Blatt (Unter "Allgemein")

Siehe "Allgemein"

Name des Blatts

(Für alle Blätter den Parameter weglassen)

Blatt_1

CSVSheets

Blatt (Unter "Datei speichern")

Siehe "Datei speichern"

Name des Blatts

(Für alle Blätter den Parameter weglassen)

Blatt_1

From

/

Gibt das Datum an, ab dem die Zeitreihendaten in der Vorlage bearbeitet werden sollen.

Datum im ISO-8601 Standard

2020-01-01T00:00:00Z

To

/

Gibt das Datum an, bis zu dem die Zeitreihendaten in der Vorlage bearbeitet werden sollen.

Datum im ISO-8601 Standard

2020-01-01T00:00:00Z

Raster

Raster aus Vorlage

Siehe "Allgemein"

  • #NV für Raster aus Vorlage

  • 1 (Sekunde)

  • 60 (Minute)

  • -1 (Viertelstunde)

  • -2 (Halbe Stunde)

  • -3 (Stunde)

  • -4 (Tag)

  • -5 (Woche)

  • -6 (Monat)

  • -7 (Quartal)

  • -8 (Jahr)

  • -10 (Halbes Jahr)

-3

MissingEmpty

Fehlende leer

Siehe "Allgemein"

  • True

  • False

True

csvDelimiter

Trennzeichen

Siehe "Datei speichern"

Character

;

csvDecimalPoint

Dezimalpunkt

Siehe "Datei speichern"

"." oder ","

,

SaveFileFormat

Excel oder CSV

Siehe "Datei speichern"

"CSV" oder "Excel"

CSV

KISSAFormatting

KISS-A Formatierung

Siehe "Datei speichern"

  • True

  • False

True

KISSATransformation

KISS-A Transformation

Siehe "Datei speichern"

  • True

  • False

True

saveFilename

Dateiname

Siehe "Datei speichern"

String

<Filename>_<Date,ddMMyyyy_HHmmss>

AreasToDelete

/

Gibt an welche Bereiche im generierten File gelöscht werden sollen

Durch Kommata getrennte Liste mit Excel Ranges.

"Blatt_1!B10:B10","Blatt_2!F10:G10"

SheetsToDelete

/

Gibt die zu löschenden Blätter in der generierten Arbeitsmappe an

Namen der Blätter durch Kommata getrennt.

Blatt_1, Blatt_3

Wichtiger Hinweis

Sollten beim automatisierten Durchlauf Probleme auftreten die im TSM nicht nachstellbar oder nachvollziehbar sind, sollten die verwendeten Vorlagen mit dem TSM+ getestet werden, da das Automation Plug-in im Hintergrund diesen für die Abarbeitung verwendet und gegebenenfalls kleine Unterschiede in der Verarbeitung von Formeln zwischen Excel und TSM+ auftreten können.