Daten Tabellen

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. Datensätze ü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 Datensätzen erweitert und mit Daten befüllt werden.

 

DataAddBooleanColumn#

Die Aktion DataAddBooleanColumn fügt eine Spalte des Datentyps Boolean der Daten-Tabelle (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" />

 

DataAddDateTimeColumn#

Die Aktion DataAddDateTimeColumn fügt eine Spalte des Datentyps DateTime der Daten-Tabelle (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" />

 

DataAddDecimalColumn#

Die Aktion DataAddDecimalColumn fügt eine Spalte des Datentyps Decimal der Daten-Tabelle (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" />

 

DataAddDoubleColumn#

Die Aktion DataAddDoubleColumn fügt eine Spalte des Datentyps Double der Daten-Tabelle (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" />

 

DataAddIntegerColumn#

Die Aktion DataAddIntegerColumn fügt eine Spalte des Datentyps Integer der Daten-Tabelle (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" />

 

DataAddLongColumn#

Die Aktion DataAddLongColumn fügt eine Spalte des Datentyps Long der Daten-Tabelle (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" />

 

DataAddShortColumn#

Die Aktion DataAddShortColumn fügt eine Spalte des Datentyps Short der Daten-Tabelle (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" />

 

DataAddStringColumn#

Die Aktion DataAddStringColumn fügt eine Spalte des Datentyps String der Daten-Tabelle (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" />

 

DataRemoveColumn#

Die Aktion DataRemoveColumn löscht eine Spalte aus der Daten-Tabelle (Attribut: Data). Die zu löschende Spalte kann über das Attribut Name angegeben werden.

<DataRemoveColumn Data="{@myData}" Name="" Condition="" Variable="{@Result}" IgnoreError="false" />

 

DataCopy#

Die Aktion DataCopy kopiert eine Daten-Tabelle (Attribut: Data) in eine neue Daten-Tabelle (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 Datensätze aus der Tabelle übernommen werden. Über das Attribut OrderBy kann mit SQL-Syntax die Datensätze der Tabelle sortiert werden. Die Anzahl der kopierten Datensätze wird über das Attribut DataCount ausgegeben.

<DataCopy Data="{@myData}" DataCopy="{@myDataCopy}" Where="" OrderBy="" SchemaOnly="false" DataCount="{@ResultCount}" Condition="" Variable="{@Result}" IgnoreError="false" />

 

DataSelect#

Die Aktion DataSelect ermittelt aus einer Daten-Tabelle (Attribut: Data) den Wert des angegebenen Feldes (Attribut: Field) abhängig von einem Filter (Attribut: Where) mit SQL-Syntax. Das Ergebnis wird immer aus der ersten Datensatz ermittelt, sofern es mehrere Datensätze geben sollte. Über das Attribut OrderBy kann mit SQL-Syntax die Datensätze der Tabelle sortiert werden. 

<DataSelect Data="{@myData}" Field="Matchcode" Where="Adresse=4711" OrderBy="" Condition="" Variable="{@Result}" IgnoreError="false" />

 

DataInsert#

Die Aktion DataInsert führt einen INSERT Befehl auf der angegeben Datenbank Tabelle durch (Attribut: Table). Bei dem INSERT werden die Daten aus der Daten-Tabelle (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" />

 

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 der Daten-Tabelle (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" />

 

DataRowClear#

Die Aktion DataRowClear löscht alle Datensätze aus der Daten-Tabelle (Attribut: Data)

<DataRowClear Data="{@myData}" Condition="" Variable="{@Result}" IgnoreError="false" />

 

DataRowCount#

Die Aktion DataRowCount ermittelt die Anzahl der Datensätze in der Daten-Tabelle abhängig von dem angegebenen Filter

<DataRowCount Data="{@myData}" Where="" Condition="" Variable="{@Result}" IgnoreError="false" />

 

DataRowInsert#

Die Aktion DataRowInsert fügt einer Daten-Tabelle (Attribut: Data) einen neuen Datensatz hinzu. Der neu hinzugefügte Datensatz enthält keine Werte. 

<DataRowInsert Data="{@myData}" Condition="" Variable="{@Result}" IgnoreError="false" />

 

DataRowGetValue#

Die Aktion DataRowGetValue liest aus der Daten-Tabelle (Attribut: Data) des aktiven Datensatz 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" />

 

DataRowSetValue#

Die Aktion DataRowSetValue setzt in der Daten-Tabelle (Attribut: Data) des aktiven Datensatz in der Spalte (Attribut: Name) einen Wert (Attribut: Value).

<DataRowSetValue Name="" Value="" Data="{@myData}" Condition="" Variable="{@Result}" IgnoreError="false" />

 

DataAggregateAvg#

Die Aktion DataAggregateAvg gibt den durchnittlichen Wert der Spalte (Attribut: Field) aus der Daten-Tabelle (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" />

 

DataAggregateCount#

Die Aktion DataAggregateCount gibt die Anzahl der Werte der Spalte (Attribut: Field) aus der Daten-Tabelle (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" />

 

DataAggregateMax#

Die Aktion DataAggregateMax gibt den maximalen Wert der Spalte (Attribut: Field) aus der Daten-Tabelle (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" />

 

DataAggregateMin#

Die Aktion DataAggregateMin gibt den minimalen Wert der Spalte (Attribut: Field) aus der Daten-Tabelle (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" />

 

DataAggregateSum#

Die Aktion DataAggregateSum gibt die Summe der Werte in der Spalte (Attribut: Field) aus der Daten-Tabelle (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" />

 

DelimitedStringFromDataColumn#

Erstellt eine Zeichenkette aus den Werten einer bestimmten Spalte in einer Datentabelle.

<DelimitedStringFromDataColumn Data="{@myData}" Column="" Delimiter="," HasFieldsEnclosedInQuotes="false" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

  • Data: Datentabelle, die verarbeitet wird.
  • Column: Name der Spalte, aus der die Werte gelesen werden.
  • Delimiter: Trennzeichen welches zwischen den Werten verwendet werden soll.
  • HasFieldsEnclosedInQuotes Ob Felder in Anführungszeichen eingeschlossen werden sollen.
  • Variable: Variable, in der die erzeugte Zeichenkette gespeichert wird.
  • Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.

  • IgnoreError: (Optional) Wenn auf true gesetzt, werden auftretende Fehler ignoriert und die Aktion wird fortgesetzt.

     

DelimitedStringFromDataRow#

Erstellt eine Zeichenkette aus den Werten einer einzelnen Zeile in einer Datentabelle.

<DelimitedStringFromDataRow Data="{@myData}" Delimiter="," HasFieldsEnclosedInQuotes="false" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

  • Data: Datentabelle, aus der die Zeile gelesen wird.
  • Delimiter Trennzeichen welches zwischen den Werten verwendet werden soll.
  • HasFieldsEnclosedInQuotes Ob Felder in Anführungszeichen eingeschlossen werden sollen.
  • Variable: Variable, in der die erzeugte Zeichenkette gespeichert wird.
  • Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
  • IgnoreError: (Optional) Wenn auf true gesetzt, werden auftretende Fehler ignoriert und die Aktion wird fortgesetzt.

 

DataTableToString#

Die Aktion DataTableToString konvertiert eine DataTable in eine Zeichenfolge im CSV-Format und speichert das Ergebnis in der angegebenen Variable. Im Gegensatz zu CSVWriteData wird das Ergebnis nicht in eine Datei geschrieben, sondern direkt als String zurückgegeben und kann im weiteren Skriptablauf weiterverwendet werden.

<DataTableToString Data="{@myData}" Delimiter=";" HasFieldsEnclosedInQuotes="true" FirstLineIsHeader="true" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

  • Data: Die DataTable, die in einen String konvertiert werden soll.
  • Delimiter: Das Trennzeichen zwischen den Feldern. Standardwert: ;.
  • HasFieldsEnclosedInQuotes: Gibt an, ob Felder in Anführungszeichen eingeschlossen werden sollen. Standardwert: true.
  • FirstLineIsHeader: Gibt an, ob die erste Zeile die Spaltenüberschriften enthält. Standardwert: true.
  • Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
  • Variable: Die Variable, in der die CSV-Zeichenfolge gespeichert wird.
  • IgnoreError: (Optional) Wenn auf true gesetzt, werden auftretende Fehler ignoriert und die Aktion wird fortgesetzt.

Beispiel:

<DataTableToString Data="{@myData}" Delimiter=";" HasFieldsEnclosedInQuotes="true" FirstLineIsHeader="true" Condition="" Variable="{@CSVText}" IgnoreError="false" />
<SendMail To="[email protected]" Subject="Datenexport" Body="{@CSVText}" IsBodyHtml="false" Variable="{@Result}" />

In diesem Beispiel wird die DataTable {@myData} in einen CSV-formatierten String umgewandelt und anschließend direkt als E-Mail-Body versendet.