1 Verwendung von Daten Tabellen
"Daten Tabellen" im Kontext des Batchpad sind Tabellen, die zur Laufzeit des Skripts aufgebaut werden. Spalten werden über die Aktionen DataAdd... hinzugefügt. Reihen über die Aktion DataRowInsert.
Die "Daten Tabellen" können zur Laufzeit befüllt, kopiert und gelöscht werden. Zudem können die "Daten Tabellen" über die Aktionen DataUpdate und DataInsert in eine Datenbank geschrieben werden.
Die "Daten Tabellen" können zur Laufzeit über den Inspektor eingesehen werden. Der Inspektor zeigt wie die "Daten Tabellen" zur Laufzeit mit Spalten und Reihen erweitert und mit Daten befüllt werden.
2 Allgemeine AttributeDie allgemeinen Attribute IgnoreError, Variable und Condition können bei allen Aktionen angegeben werden. Die Attribute sind optional und brauchen nur bei Bedarf hinterlegt werden. Wenn diese für eine Aktion nicht benötigt werden, können diese aber auch zur besseren Lesbarkeit des Skriptes entfernt werden. IgnoreError Das optionale Attribut IgnoreError gibt an, ob bei einem Fehler die Ausführung des Batchpad Skriptes abbricht oder das Skript weiter ausgeführt werden soll. Der Wert muss dem Typ Boolean (true oder false) entsprechen. Variable Das optionale Attribut Variable kann immer dann verwendet werden, wenn man das Ergebnis einer auszuführenden Aktion ermitteln möchte. Variable="{@ResultFileExists}". Die Ergebnisse sind je nach ausgeführter Aktion vom Typ her unterschiedlich, oft ist es ein Boolean (true oder false) der angibt ob die Aktion erfolgreich war. Bei Aktionen für Zeichenketten sind die Ergebnisse dann eher vom Typ String usw. Condition Das optionale Attribut Condition gibt an, ob die Aktion ausgeführt werden soll. Hierzu wird der Inhalt des Attributes als logischer Ausdruck auf Wahr oder Falsch geprüft. Der Ausdruck sollte dem Typ Boolean (true oder false) entsprechen. Der Ausdruck kann Funktionen aus VBScript enthalten, genauso wie Operatoren NOT, OR, AND... Mit dem Condition Attribut wertet man in der Regel Variablen aus, die Ergebnisse aus zuvor durchgeführten Aktionen enthalten. Beispiel: Condition="NOT {@ResultFileExists}" |
3 DataAddBooleanColumn
Die Aktion DataAddBooleanColumn fügt eine Spalte des Datentyps Boolean dem DataTable Objekt (Attribut: Data) hinzu. Der Spaltenname wir über das Attribut Name gesetzt. Nullwerte können über das Attribut AllowNull erlaubt werden. Sollen die Werte bei einem Update/Insert (Aktionen DataUpdate und DataInsert) in eine Datenbank ignoriert werden kann über das Attribut IngoreOnWrite auf true gesetzt werden.
<DataAddBooleanColumn Data="{@myData}" Name="" AllowNull="true" IgnoreOnWrite="false" Condition="" Variable="{@Result}" IgnoreError="false" />
4 DataAddDateTimeColumn
Die Aktion DataAddDateTimeColumn fügt eine Spalte des Datentyps DateTime dem DataTable Objekt (Attribut: Data) hinzu. Der Spaltenname wir über das Attribut Name gesetzt. Nullwerte können über das Attribut AllowNull erlaubt werden. Sollen die Werte bei einem Update/Insert (Aktionen DataUpdate und DataInsert) in eine Datenbank ignoriert werden kann über das Attribut IngoreOnWrite auf true gesetzt werden.
<DataAddDateTimeColumn Data="{@myData}" Name="" AllowNull="true" IgnoreOnWrite="false" Condition="" Variable="{@Result}" IgnoreError="false" />
5 DataAddDecimalColumn
Die Aktion DataAddDecimalColumn fügt eine Spalte des Datentyps Decimal dem DataTable Objekt (Attribut: Data) hinzu. Der Spaltenname wir über das Attribut Name gesetzt. Nullwerte können über das Attribut AllowNull erlaubt werden. Sollen die Werte bei einem Update/Insert (Aktionen DataUpdate und DataInsert) in eine Datenbank ignoriert werden kann über das Attribut IngoreOnWrite auf true gesetzt werden.
<DataAddDecimalColumn Data="{@myData}" Name="" AllowNull="true" IgnoreOnWrite="false" Condition="" Variable="{@Result}" IgnoreError="false" />
6 DataAddDoubleColumn
Die Aktion DataAddDoubleColumn fügt eine Spalte des Datentyps Double dem DataTable Objekt (Attribut: Data) hinzu. Der Spaltenname wir über das Attribut Name gesetzt. Nullwerte können über das Attribut AllowNull erlaubt werden. Sollen die Werte bei einem Update/Insert (Aktionen DataUpdate und DataInsert) in eine Datenbank ignoriert werden kann über das Attribut IngoreOnWrite auf true gesetzt werden.
<DataAddDoubleColumn Data="{@myData}" Name="" AllowNull="true" IgnoreOnWrite="false" Condition="" Variable="{@Result}" IgnoreError="false" />
7 DataAddIntegerColumn
Die Aktion DataAddIntegerColumn fügt eine Spalte des Datentyps Integer dem DataTable Objekt (Attribut: Data) hinzu. Der Spaltenname wir über das Attribut Name gesetzt. Nullwerte können über das Attribut AllowNull erlaubt werden. Sollen die Werte bei einem Update/Insert (Aktionen DataUpdate und DataInsert) in eine Datenbank ignoriert werden kann über das Attribut IngoreOnWrite auf true gesetzt werden.
<DataAddIntegerColumn Data="{@myData}" Name="" AllowNull="true" IgnoreOnWrite="false" Condition="" Variable="{@Result}" IgnoreError="false" />
8 DataAddLongColumn
Die Aktion DataAddLongColumn fügt eine Spalte des Datentyps Long dem DataTable Objekt (Attribut: Data) hinzu. Der Spaltenname wir über das Attribut Name gesetzt. Nullwerte können über das Attribut AllowNull erlaubt werden. Sollen die Werte bei einem Update/Insert (Aktionen DataUpdate und DataInsert) in eine Datenbank ignoriert werden kann über das Attribut IngoreOnWrite auf true gesetzt werden.
<DataAddLongColumn Data="{@myData}" Name="" AllowNull="true" IgnoreOnWrite="false" Condition="" Variable="{@Result}" IgnoreError="false" />
9 DataAddShortColumn
Die Aktion DataAddShortColumn fügt eine Spalte des Datentyps Short dem DataTable Objekt (Attribut: Data) hinzu. Der Spaltenname wir über das Attribut Name gesetzt. Nullwerte können über das Attribut AllowNull erlaubt werden. Sollen die Werte bei einem Update/Insert (Aktionen DataUpdate und DataInsert) in eine Datenbank ignoriert werden kann über das Attribut IngoreOnWrite auf true gesetzt werden.
<DataAddShortColumn Data="{@myData}" Name="" AllowNull="true" IgnoreOnWrite="false" Condition="" Variable="{@Result}" IgnoreError="false" />
10 DataAddStringColumn
Die Aktion DataAddStringColumn fügt eine Spalte des Datentyps String dem DataTable Objekt (Attribut: Data) hinzu. Der Spaltenname wir über das Attribut Name gesetzt. Nullwerte können über das Attribut AllowNull erlaubt werden. Sollen die Werte bei einem Update/Insert (Aktionen DataUpdate und DataInsert) in eine Datenbank ignoriert werden kann über das Attribut IngoreOnWrite auf true gesetzt werden.
<DataAddStringColumn Data="{@myData}" Name="" AllowNull="true" IgnoreOnWrite="false" Condition="" Variable="{@Result}" IgnoreError="false" />
11 DataRemoveColumn
Die Aktion DataRemoveColumn löscht eine Spalte aus dem DataTable Objekt (Attribut: Data). Die zu löschende Spalte kann über das Attribut Name angegeben werden.
<DataRemoveColumn Data="{@myData}" Name="" Condition="" Variable="{@Result}" IgnoreError="false" />
12 DataCopy
Die Aktion DataCopy kopiert ein DataTable Objekt (Attribut: Data) in ein neues DataTable Objekt (Attribut: DataCopy). Wenn die Daten bei dem Kopieren mit in die neue Tabelle übernommen werden sollen kann das Attribut SchemaOnly auf false gesetzt werden. Zudem kann über einen Filter (Attribut: Where) mit SQL-Syntax bestimmt werden welche Reihen aus der Tabelle übernommen werden. Über das Attribut OrderBy kann mit SQL-Syntax die Reihen der Tabelle sortiert werden. Die Anzahl der kopierten Reihen wird über das Attribut DataCount ausgegeben.
<DataCopy Data="{@myData}" DataCopy="{@myDataCopy}" Where="" OrderBy="" SchemaOnly="false" DataCount="{@ResultCount}" Condition="" Variable="{@Result}" IgnoreError="false" />
13 DataInsert
Die Aktion DataInsert führt einen INSERT Befehl auf der angegeben Datenbank Tabelle durch (Attribut: Table). Bei dem INSERT werden die Daten aus dem DataTable Objekt (Attribut: Data) in angegebene Datenbank geschrieben (Attribut: Connection). Über das Attribut StopWhenRowFaild wird angegeben ob bei einem INSERT Fehler die noch offenen INSERT Befehle auf die Datenbank ausgeführt (false) oder abgebrochen werden sollen (true).
<DataInsert Data="{@myData}" Table="" Connection="{@myConnection}" StopWhenRowFailed="false" Condition="" Variable="{@Result}" IgnoreError="false" />
14 DataUpdate
Die Aktion DataUpdate führt einen UPDATE Befehl auf der angegeben Datenbank Tabelle durch (Attribut: Table). Bei dem UPDATE wird über die Daten aus dem DataTable Objekt (Attribut: Data) ein UPDATE auf die Datenbank ausgeführt (Attribut: Connection). Über das Attribut StopWhenRowFaild wird angegeben ob bei einem UPDATE Fehler die noch offenen UPDATE Befehle auf die Datenbank ausgeführt (false) oder abgebrochen werden sollen (true). Zudem kann ein Filter (Attribut: Where) mit SQL-Syntax bestimmt werden.
<DataUpdate Data="{@myData}" Table="" Where="" Connection="{@myConnection}" StopWhenRowFailed="false" Condition="" Variable="{@Result}" IgnoreError="false" />
15 DataRowClear
Die Aktion DataRowClear löscht alle Reihen aus dem DataTable Objekt (Attribut: Data)
<DataRowClear Data="{@myData}" Condition="" Variable="{@Result}" IgnoreError="false" />
16 DataRowInsert
Die Aktion DataRowInsert fügt einem DataTable Objekt (Attribut: Data) eine neue Reihe hinzu. Die neu hinzugefügte Reihe enhält keine Werte.
<DataRowInsert Data="{@myData}" Condition="" Variable="{@Result}" IgnoreError="false" />
17 DataRowGetValue
Die Aktion DataRowGetValue liest aus dem DataTable Objekt (Attribut: Data) der aktiven Reihe und der Spalte (Attribut: Name) den Wert aus und gibt den Wert über das Attribut Variable aus.
<DataRowGetValue Name="" Data="{@myData}" Condition="" Variable="{@Result}" IgnoreError="false" />
18 DataRowSetValue
Die Aktion DataRowSetValue setzt in dem DataTable Objekt (Attribut: Data) der aktiven Reihe in der Spalte (Attribut: Name) einen Wert (Attribut: Value).
<DataRowSetValue Name="" Value="" Data="{@myData}" Condition="" Variable="{@Result}" IgnoreError="false" />
19 DataAggregateAvg
Die Aktion DataAggregateAvg gibt den durschnittlichen Wert der Spalte (Attribut: Field) aus dem DataTable Objekt (Attribut: Data) über das Attribut Variable zurück. Ein Filter in SQL-Syntax kann über das Attribut Where gesetzt werden.
<DataAggregateAvg Data="{@myData}" Field="" Where="" Condition="" Variable="{@Result}" IgnoreError="false" />
20 DataAggregateCount
Die Aktion DataAggregateCount gibt die Anzahl der Werte der Spalte (Attribut: Field) aus dem DataTable Objekt (Attribut: Data) über das Attribut Variable zurück. Ein Filter in SQL-Syntax kann über das Attribut Where gesetzt werden.
<DataAggregateCount Data="{@myData}" Field="" Where="" Condition="" Variable="{@Result}" IgnoreError="false" />
21 DataAggregateMax
Die Aktion DataAggregateMax gibt den maximalen Wert der Spalte (Attribut: Field) aus dem DataTable Objekt (Attribut: Data) über das Attribut Variable zurück. Ein Filter in SQL-Syntax kann über das Attribut Where gesetzt werden.
<DataAggregateMax Data="{@myData}" Field="" Where="" Condition="" Variable="{@Result}" IgnoreError="false" />
22 DataAggregateMin
Die Aktion DataAggregateMin gibt den minimalen Wert der Spalte (Attribut: Field) aus dem DataTable Objekt (Attribut: Data) über das Attribut Variable zurück. Ein Filter in SQL-Syntax kann über das Attribut Where gesetzt werden.
<DataAggregateMin Data="{@myData}" Field="" Where="" Condition="" Variable="{@Result}" IgnoreError="false" />
23 DataAggregateSum
Die Aktion DataAggregateSum gibt die Summe der Werte in der Spalte (Attribut: Field) aus dem DataTable Objekt (Attribut: Data) über das Attribut Variable zurück. Ein Filter in SQL-Syntax kann über das Attribut Where gesetzt werden.
<DataAggregateSum Data="{@myData}" Field="" Where="" Condition="" Variable="{@Result}" IgnoreError="false" />
