MULTI-Variablen

Angabe der beiden Variablenobjekte, die als Wertequelle dienen.

Variable 1 gibt dabei die Anzahl der Spalten vor. Abhängig von der festgelegten Operation werden die Werte der Bezugsspalten beider Variablen kombiniert. Die Bezugsspalte ist abhängig von der Variablenquelle: Key-SpalteSpalte bei statischen Variablen-Objekten, über die auf Werte einer bestimmte Zeile zugegriffen werden kann. (bei statischen Variablen), erste Wertespalte (Variablenquelle: SQL, SQL-intern, Multi) oder die Spalte Dateiliste (Variablenquelle: Dateiliste). Spalten, die in Variable 2 nicht enthalten sind, besitzen für die entsprechenden Einträge keinen Wert.

Enthalten die zwei Variablenobjekte gleichnamige Einträge, werden die Werte der Variable 1 verwendet.

Beachten Sie, dass der Datentyp der Bezugsspalte der Quellvariable mit dem Datentyp der Multi-Variable entsprechen sollten. Ansonsten kommt es entweder zum Fehler oder die Werte sind nicht verfügbar.

Der mathematische Prozess, der dazu dient, festzulegen, welche Werte aus Variable 1 und 2 ermittelt werden.

• Vereinigungsmenge: Ermittlung aller Werte von Variable 1 und 2. Bei identischen Einträgen der Variablen, werden die Werte von Variable 1 verwendet.
• Schnittmenge: Ermittlung der Werte, die sowohl in Variable 1 als auch in Variable 2 vorkommen. Dabei werden die Werte-Spalten bei gleichen Resultat-/Key-Einträgen von Variable 1 übernommen.
• Differenz: Ermittlung aller Werte der Variable 1, die nicht in der Variable 2 enthalten sind. Für den Vergleich werden die Resultat-/Key-Spalten der Variablen verwendet.

Der Datentyp bestimmt die Form des Wertes der Variable.

• Zeichenfolge: Alphanumerische Zeichenfolge. Leerzeichen am Ende des Strings werden abgeschnitten. Führende Leerzeichen bleiben jedoch erhalten. Ist die Einstellung Textlänge limitieren nicht gesetzt, so gibt es kein Limit für die Länge der Zeichenfolge.
• Nummer: Beliebige numerische Zeichen im vorgegebenen Bereich von 0 bis 2147483647.
• Zeitstempel: Beliebige Datums- und Zeitangabe.
• Uhrzeit: Zeitangabe.
• Datum: Datumsangabe.

Das genaue Format des gewählten Datentyps (Ausnahme: „String“) kann im Feld Ausgabeformat festgelegt werden.

Es wird der Datentyp der Werte in der ersten Spalte überprüft. Bei der Quelle „SQL“ und „SQL intern“ muss der Datentyp der Variable mit dem der ersten Spalte, die durch das SQL-Statement zurückgeliefert wird, übereinstimmen. Die Daten können auch durch spezielle SQL-Statements aufbereitet werden. Unterscheidet sich der Datentyp, so kommt es zu einem Fehler beim Speichern von statischen Variablen bzw. beim Zugriff auf dynamische Variablen.

Für die Änderung des Datentyps von statischen Variablenobjekten, die bereits Werte enthalten, sind folgende Punkte zu beachten:

• Die Änderung von „Zahl“, „Zeitstempel“, „Zeit“ oder „Datum“ auf „Text“ ist problemlos möglich. Die Werte werden unverändert konvertiert.
• Nach der Änderung von „Text“ auf „Zahl“, „Zeitstempel“, „Zeit“ oder „Datum“ ist das Ausgabeformat auszuwählen. Beim Speichern des Variablenobjektes wird überprüft, ob die Werte dem Format entsprechen.
• Die direkte Änderung innerhalb der Datentypen „Datum“, „Zeit“, „Zahl“ und „Zeitstempel“ wird nicht unterstützt. Es ist zuerst eine Umsetzung auf den Datentyp „Text“ erforderlich.

Der Datentyp von „Multi-“, „SQL-“ und „SQL-internen“ Variablen kann beliebig gewechselt werden.

Bei Werten, die mit dem Sprachmittel GET_VAR aus Variablenobjekten mit dem Datentyp „Zahl“ bezogen werden, spielt der Datentyp der jeweiligen Script-VariablePlatzhalter eines Wertes in einem Script. („float“, „signed“, „unsigned“ oder „string“) keine Rolle. Der Wert kann immer gespeichert werden. Dabei werden Vorzeichen und Nachkommastellen entfernt, wenn der Datentyp der ScriptEigener Objekttyp in der Automation Engine-Variable dies nicht unterstützt. Ist im Variablenobjekt ein anderer Datentyp eingestellt, werden die Werte an das Script immer als „string“ übergeben.

Mit dieser Einstellung wird das Format festgelegt, in dem die Werte in das Variablenobjekt gespeichert (Quelle: statisch) bzw. von der Datenquelle ermittelt werden (dynamische Variablen).

Der Inhalt dieses Auswahlmenüs ist abhängig vom Datentyp. Für jeden Datentyp außer „Text“ stehen mehrere unterschiedliche Formate zur Verfügung.

Das Ausgabeformat bezieht sich nur auf die erste Spalte! Bei statischen Variablen ist das die Spalte Wert 1, bei DatenbankEine Datenbank ist eine organisierte Sammlung von Daten und wichtigen Datenstrukturen.- und Multi-Variablen die erste Rohspalte. Beachten Sie bei Multi-Variablen, dass die erste Rohspalte als Bezugsspalte dient und sich daher das Ausgabeformat der Quellvariable auf die ermittelten Werte auswirken kann!

Das Ausgabeformat von statischen Variablen innerhalb eines bestimmten Datentyps ist beliebig änderbar. Die Werte werden dabei in das neue Format konvertiert. Entsprechen Werte nicht dem alten Format, so ist eine Umwandlung in ein neues Format nicht möglich.

Das Format in dem Werte in statische Variablen eingetragen werden, spielt keine Rolle, solange es ein von der AE unterstütztes Format des jeweiligen Datentyps ist. Die Werte werden dann in das entsprechende Ausgabeformat umgewandelt.

Beim Datentyp „Text“ wird die Combobox ausgeblendet.

Manche Datumsformate enthalten „RR“ als Platzhalter für das abgekürzte Jahr. Der Unterschied zwischen „YY“ und „RR“ ergibt sich durch die unterschiedlichen Arten, Jahrhunderte zu zählen (erste zwei Stellen der abgekürzten Jahreszahl).
YY - Liegt die Zahl zwischen 00 und 80 wird das aktuelle Jahrhundert verwendet. Im Bereich 81 - 99 das vorherige. 
„RR“ - Befindet sich die Zahl zwischen 00 und 49 so wird das aktuelle Jahrhundert verwendet. Im Bereich 50 - 99 das vorherige.

Zum Beispiel:
Datumsformat TTMMJJ und die daraus resultierenden Daten:
010305 - bedeutet 1. März 2005
010365 - bedeutet 1. März 2065
010380 - bedeutet 1. März 2080
010385 - bedeutet 1. März 1985

Zum Beispiel:
Datumsformat TTMMRR und die daraus resultierenden Daten:
010305 - bedeutet 1. März 2005
010365 - bedeutet 1. März 1965
010380 - bedeutet 1. März 1980
010385 - bedeutet 1. März 1985

Beim Datentyp „Zeit“ bzw. „Zeitstempel“ muss der Wert für die Uhrzeit entweder eine vierstellige oder eine sechsstellige Zahl sein. Kommastellen werden entfernt. Eine vierstellige Zahl wird dabei auf Stunden und Minuten umgesetzt.

Beispiele:
Datentyp: Zeit
Ausgabeformat: HH:MM:SS
Wert des Benutzers bzw. der Datenquelle: 1234, 1234.5, 123400, 12:34, 12:34:00
Resultierender Variablenwert: 12:34:00

Datentyp: Zeitstempel
Ausgabeformat: YYYY-MM-DD HH:MM:SS
Wert des Benutzers bzw. der Datenquelle: 20110325 2201, 20110325 2201.5, 20110325 220100
Resultierender Variablenwert: 2011-03-25 22:01:00

Minimum festlegen

Min. Wert

Erzwingt einen Minimalwert.

Beim Datentyp „Text“ werden diese Felder nicht angezeigt.

Maximum festlegen

Max. Wert

Erzwingt einen Maximalwert.

Beim Datentyp „Text“ werden diese Felder nicht angezeigt.

Textlänge limitieren

Max. Textlänge

Erzwingt eine maximale Anzahl an Zeichen.

Erlaubte Werte: 1 bis 1024

Ist diese Option deaktiviert, so gibt es kein Limit.

Die Key-Spalte von statischen VARA-Objekten besitzt ein maximales Limit von 200 Zeichen. Dieses Limit ist immer vorhanden und kann nicht erhöht bzw. deaktiviert werden.

Die Resultat-Spalte von dynamischen Variablen besitzt kein Limit. Die Größe hängt von den Wertespalten ab.

Diese Beschränkung bezieht sich bei statischen und dynamischen Variablen auf die erste Wertespalte. Die Key- bzw. Resultat-Spalte wird nicht überprüft.

Werte, welche die max. Länge überschreiten, werden ausgegrenzt.

Diese Felder werden nur beim Datentyp „Text“ angezeigt.

Kleinbuchstaben in Variablen-Werten werden automatisch in Großbuchstaben umgewandelt. Dies betrifft nur die erste Werte-Spalte.

Dieses Feld wird nur beim Datentyp „Text“ angezeigt.

Definition des Inhaltes der Resultat-Spalte.

Die erste in der Vorschau angezeigte Spalte ist die „Resultat-Spalte“. Die Resultat-Spalte kann sich aus einer Kombination von Werte-Spalten und beliebiger Zeichen zusammensetzen, wobei dies mit dem Resultat-Format festzulegen ist.

Spaltennummern, die in {}-Klammern im Feld „Resultat-Format“ angegeben sind, werden durch den Wert der jeweiligen Spalte ersetzt.

Zum Beispiel:
Werte-Spalte 1: JOB1
Werte-Spalte 2: WIN01
Resultat-Format: {1}_{2}
Resultat-Spalte: JOB01_WIN01

Wurde kein Resultat-Format festgelegt, wird der Wert der Variable in der Spalte Resultat oder Key angenommen.

Die Werte der Resultat-Spalte müssen ebenfalls innerhalb der Variablen-Beschränkungen (Min. Wert, Max. Wert, Textlimitierung) liegen bzw. dem Ausgabeformat oder Datentyp entsprechen. Ansonsten enthält die Resultat-Spalte keinen Wert.