TaskSrv-Verzeichnis: Templates: Unterschied zwischen den Versionen

Aus TALSIM Docs
(Die Seite wurde neu angelegt: „In diesem Verzeichnis werden alle Template-Dateien (*.tpl) gespeichert, also die Vorlagen für den TaskServer. Die Template-Datei enthält einen oder mehrere…“)
 
(Diese Seite wurde zum Übersetzen freigegeben)
 
(9 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
<languages/>
<translate>
<!--T:1-->
{{Navigation|vorher=TaskSrv-Verzeichnis: Task|hoch=TaskSrv-Verzeichnisstruktur und Dateien|nachher=Liste aller TaskSrv-Jobs}}
<!--T:2-->
In diesem Verzeichnis werden alle Template-Dateien (*.tpl) gespeichert, also die Vorlagen für den TaskServer.  
In diesem Verzeichnis werden alle Template-Dateien (*.tpl) gespeichert, also die Vorlagen für den TaskServer.  


Die Template-Datei enthält einen oder mehrere der ca. 50 TaskServer-Jobs inklusive der Festlegung der Attribute für diesen Job bzw. die Definition von Variablen, mit denen die Attribute über die Konfiguration der Input-Dateien flexibel gefüllt werden können.  
<!--T:3-->
Die Template-Datei enthält einen oder mehrere der ca. 40 TaskServer-Jobs inklusive der Festlegung der Attribute für diesen Job bzw. die Definition von Variablen, mit denen die Attribute über die Konfiguration der Input-Dateien flexibel gefüllt werden können.  
In der Template-Datei nicht aufgeführte, aber für den Job benötigte Attribute werden entweder mit Default-Werten belegt oder erzeugen eine Fehlermeldung bei der Ausführung des TaskServers.
In der Template-Datei nicht aufgeführte, aber für den Job benötigte Attribute werden entweder mit Default-Werten belegt oder erzeugen eine Fehlermeldung bei der Ausführung des TaskServers.


Beispiel für eine Template-Datei (MinMaxMittel.tpl):
<!--T:4-->
Beispiel für eine Template-Datei (<code>MinMaxMittel.tpl</code>):


<!--T:5-->
<pre>
<pre>


<!--T:6-->
#=======================
#=======================
#Template
#Template
Zeile 13: Zeile 24:
#kein Job zur Erstellung equidistanter Schritte erforderlich, weil die Quelle bereits so vorliegt (WEL-Format)
#kein Job zur Erstellung equidistanter Schritte erforderlich, weil die Quelle bereits so vorliegt (WEL-Format)


<!--T:7-->
[JOBS]
[JOBS]
CountJobs=3
CountJobs=3


#ID;aktiv 0/1;RUNMODE 0=LoopInput, 1=MergeInput; Identifier;Mode;Beschreibung
<!--T:8-->
#ID;aktiv 0/1;RUNMODE 0=LoopInput, 1=MergeInput; Identifier;Job;Beschreibung
1;1;0;WelToBin;IMPORT;Konvertiert eine Reihe aus einer *.WEL Datein in Sydro-Binär-Format für einen definierten Zeitraum
1;1;0;WelToBin;IMPORT;Konvertiert eine Reihe aus einer *.WEL Datein in Sydro-Binär-Format für einen definierten Zeitraum
2;1;0;Momentenberechnung_Gesamt;MOMENT;Stellt die Basisstatistik aus einer Binärdatei zusammen für das gesamte Jahr
2;1;0;Momentenberechnung_Gesamt;MOMENT;Stellt die Basisstatistik aus einer Binärdatei zusammen für das gesamte Jahr
3;1;1;Merge_Results_Gesamt;MERGE;Ergebnisse zusammenfassen
3;1;1;Merge_Results_Gesamt;MERGE;Ergebnisse zusammenfassen


<!--T:9-->
[VARIABLES]
[VARIABLES]
CountVariables=5
CountVariables=5
Zeile 30: Zeile 44:
5;OUTPUT;STRING;Ergebnis Merge für Gesamt
5;OUTPUT;STRING;Ergebnis Merge für Gesamt


<!--T:10-->
[WelToBin]
[WelToBin]
Key=%1
Key=%1
Zeile 50: Zeile 65:
ErrorEqualDate=1
ErrorEqualDate=1


<!--T:11-->
[Momentenberechnung_Gesamt]
[Momentenberechnung_Gesamt]
Key=%1
Key=%1
Zeile 60: Zeile 76:
Log=0
Log=0


<!--T:12-->
[Merge_Results_Gesamt]
[Merge_Results_Gesamt]
Key=%1
Key=%1
Zeile 71: Zeile 88:
Col=2
Col=2


<!--T:13-->
</pre>
</pre>


Eine Template-Datei besteht aus den Bereichen  <code>[JOBS]</code>,  <code>[Variables]</code> sowie für jeden Job einen eigenen Bereich markiert mit dem Jobnamen (<code>[Identifier]<code>).
<!--T:14-->
Eine Template-Datei besteht aus den Bereichen  <code>[JOBS]</code>,  <code>[Variables]</code> sowie für jeden Job einen eigenen Bereich markiert mit dem Jobnamen (<code>[Identifier]</code>).


Im Bereich <code>[JOBS]</code> ist eingestellt, wie viele und welche Jobs mit dem Template gerechnet werden sollen (s. [Liste aller TaskSrv-Jobs]).
<!--T:15-->
Im Bereich <code>[JOBS]</code> ist eingestellt, wie viele (<code>CountJobs</code>) und welche Jobs mit dem Template gerechnet werden sollen (s. [[Special:MyLanguage/Liste aller TaskSrv-Jobs|Liste aller TaskSrv-Jobs]]). Für jeden Job wird eine Zeile mit folgenden Einträgen ausgefüllt:


<!--T:16-->
{| class="wikitable"
{| class="wikitable"
|ID || Innerhalb des Templates eindeutige Nummer
|ID || Innerhalb des Templates eindeutige Nummer fortlaufende Nummer (Start bei 1)
|-
|-
|aktiv 0/1 || Einstellung, ob der Job aktiv ist
|aktiv 0/1 || Einstellung, ob der Job aktiv ist
|-
|-
| RUNMODE 0=LoopInput, 1=MERGEINPUT || Einstellung, ob mit dem Job über alle im Input-File definierten Einträge iteriert werden soll, oder ob der Job alle Inputs zusammenfasst und in einer Datei ausgibt
| RUNMODE 0=LoopInput, 1=MERGEINPUT || Einstellung, ob mit dem Job über alle Einträge im [[TaskSrv-Verzeichnis:_Input|Input-File]] iteriert werden soll, oder ob der Job alle Einträge zusammenfasst und z.B. in einer Datei ausgibt
|-  
|-  
| Identifier || Eindeutige Bezeichnung für den Job
| Identifier || Eindeutige Bezeichnung für den Job innerhalb des Templates
|-
|-
| Mode || Kategorie, die der Job zugeordnet werden kann
| Job || Jobname bzw. Job Identifier für die [[TaskSrv-Verzeichnis:_Exe#tasksrvi.exe|TaskSrvi.exe]] (frühere Bezeichnung: Mode)
|-
|-
| Beschreibung || Kurze Beschreibung des Jobs
| Beschreibung || Kurze Beschreibung des Jobs
|}
|}
<!--T:17-->
Im Bereich <code>[VARIABLES]</code> werden die Variablen definiert. Mit <code>CountVariables</code> wird die Anzahl der definierten Variablen festgelegt. Für jede Variable wird eine Zeile mit folgenden Einträgen angelegt:
<!--T:18-->
{| class="wikitable"
|ID || Innerhalb des Templates eindeutige Nummer fortlaufende Nummer (Start bei 1)
|-
|Typ || Typ der Variablen: INPUT, OUTPUT oder TMP (Variablen mit dem Typ TMP müssen nicht im [[TaskSrv-Verzeichnis:_Input|Input-File]] gefüllt werden; Manche Variablen sind für den einen Job der OUTPUT, für den nächsten Job der INPUT. Diese können gemäß ihrem ersten Auftreten mit OUTPUT definiert werden.
|-
| DataType|| Datentyp (z.B. STRING, INT, ...)
|-
| Beschreibung || Kurze Beschreibung der Variablen
|}
<!--T:19-->
In den Bereichen der einzelnen Jobs <code>[Identifier]</code> werden die Attribute für diesen Job festgelegt, bzw. mit Variablen verknüpft. Die Variablen werden dabei mit einem vorangestellten Prozentzeichen und ihrer ID aufgerufen (z.B. <code>%1</code>). Kommentare zu den einzelnen Attributen können mit einem vorangestellten Semicolon <code>;</code> hinter die Attribute geschrieben werden. In den Kommentaren können z.B. hilfreiche Informationen zu den Optionen stehen, mit welchen das Attribut gefüllt werden kann oder auch Bemerkungen dazu, warum eine bestimmte Einstellung gewählt wurde.
Ein Sonderfall sind Attribute in Vektorform. Diese werden bei den Attributen in geschweifte Klammern eingetragen (z.B. die Jährlichkeit für HQx ausgewertet werden sollen: <code>Tn={TN}</code>). Diese Vektoren werden dann in einem weiteren Bereich gefüllt, z.B.:
<!--T:20-->
<pre>
[TN]
Count=6
      1.
      5.
    10.
    50.
    100.
  1000.
</pre>
</translate>

Aktuelle Version vom 23. September 2020, 16:11 Uhr

Sprachen:

In diesem Verzeichnis werden alle Template-Dateien (*.tpl) gespeichert, also die Vorlagen für den TaskServer.

Die Template-Datei enthält einen oder mehrere der ca. 40 TaskServer-Jobs inklusive der Festlegung der Attribute für diesen Job bzw. die Definition von Variablen, mit denen die Attribute über die Konfiguration der Input-Dateien flexibel gefüllt werden können. In der Template-Datei nicht aufgeführte, aber für den Job benötigte Attribute werden entweder mit Default-Werten belegt oder erzeugen eine Fehlermeldung bei der Ausführung des TaskServers.

Beispiel für eine Template-Datei (MinMaxMittel.tpl):


#=======================
#Template
#=======================
#kein Job zur Erstellung equidistanter Schritte erforderlich, weil die Quelle bereits so vorliegt (WEL-Format)

[JOBS]
CountJobs=3

#ID;aktiv 0/1;RUNMODE 0=LoopInput, 1=MergeInput; Identifier;Job;Beschreibung
1;1;0;WelToBin;IMPORT;Konvertiert eine Reihe aus einer *.WEL Datein in Sydro-Binär-Format für einen definierten Zeitraum
2;1;0;Momentenberechnung_Gesamt;MOMENT;Stellt die Basisstatistik aus einer Binärdatei zusammen für das gesamte Jahr
3;1;1;Merge_Results_Gesamt;MERGE;Ergebnisse zusammenfassen

[VARIABLES]
CountVariables=5
#ID;Typ;DataType;Beschreibung   (nur "INPUT" und "OUTPUT" müssen mit Eingaben belegt sein)
1;INPUT;STRING;Key
2;INPUT;STRING;Datenquelle im WEL Format
3;TMP;STRING;Binary Ausgabe nach Import aus WEL-Format
4;OUTPUT;STRING;Ergebnis Momentenberechnung Gesamt
5;OUTPUT;STRING;Ergebnis Merge für Gesamt

[WelToBin]
Key=%1
Input=%2
Output=%3
StartDate=
InputFormat=WEL
Interpretation=2
EndDate=
TimeStep=
TimeStepCount=1
Factor=1
AddValue=0
Expo=1
TimeStep=
TimeStepCount=
AutoDate=0
AutoDateInc=
AutoStartDate=
ErrorEqualDate=1

[Momentenberechnung_Gesamt]
Key=%1
Input=%3
Output=%4
ValueMode=
TimeMode=ALL
Threshold1=
Threshold2=
Log=0

[Merge_Results_Gesamt]
Key=%1
Input=%4
Output=%5
InputFormat=TXT
LenOut=10
DecimalOut=3
Delimiter=TAB
Row=0
Col=2

Eine Template-Datei besteht aus den Bereichen [JOBS], [Variables] sowie für jeden Job einen eigenen Bereich markiert mit dem Jobnamen ([Identifier]).

Im Bereich [JOBS] ist eingestellt, wie viele (CountJobs) und welche Jobs mit dem Template gerechnet werden sollen (s. Liste aller TaskSrv-Jobs). Für jeden Job wird eine Zeile mit folgenden Einträgen ausgefüllt:

ID Innerhalb des Templates eindeutige Nummer fortlaufende Nummer (Start bei 1)
aktiv 0/1 Einstellung, ob der Job aktiv ist
RUNMODE 0=LoopInput, 1=MERGEINPUT Einstellung, ob mit dem Job über alle Einträge im Input-File iteriert werden soll, oder ob der Job alle Einträge zusammenfasst und z.B. in einer Datei ausgibt
Identifier Eindeutige Bezeichnung für den Job innerhalb des Templates
Job Jobname bzw. Job Identifier für die TaskSrvi.exe (frühere Bezeichnung: Mode)
Beschreibung Kurze Beschreibung des Jobs


Im Bereich [VARIABLES] werden die Variablen definiert. Mit CountVariables wird die Anzahl der definierten Variablen festgelegt. Für jede Variable wird eine Zeile mit folgenden Einträgen angelegt:

ID Innerhalb des Templates eindeutige Nummer fortlaufende Nummer (Start bei 1)
Typ Typ der Variablen: INPUT, OUTPUT oder TMP (Variablen mit dem Typ TMP müssen nicht im Input-File gefüllt werden; Manche Variablen sind für den einen Job der OUTPUT, für den nächsten Job der INPUT. Diese können gemäß ihrem ersten Auftreten mit OUTPUT definiert werden.
DataType Datentyp (z.B. STRING, INT, ...)
Beschreibung Kurze Beschreibung der Variablen

In den Bereichen der einzelnen Jobs [Identifier] werden die Attribute für diesen Job festgelegt, bzw. mit Variablen verknüpft. Die Variablen werden dabei mit einem vorangestellten Prozentzeichen und ihrer ID aufgerufen (z.B. %1). Kommentare zu den einzelnen Attributen können mit einem vorangestellten Semicolon ; hinter die Attribute geschrieben werden. In den Kommentaren können z.B. hilfreiche Informationen zu den Optionen stehen, mit welchen das Attribut gefüllt werden kann oder auch Bemerkungen dazu, warum eine bestimmte Einstellung gewählt wurde. Ein Sonderfall sind Attribute in Vektorform. Diese werden bei den Attributen in geschweifte Klammern eingetragen (z.B. die Jährlichkeit für HQx ausgewertet werden sollen: Tn={TN}). Diese Vektoren werden dann in einem weiteren Bereich gefüllt, z.B.:

[TN]
Count=6
      1.
      5.
     10.
     50.
    100.
   1000.