Datentypen und Formatierung

Als Entwickler und Objektdesigner definieren Sie die Attribute Benutzerdefinierte VARA-Objekte auf der Seite Variablen oder auf der Unterseite Attribute (für STATIC- und XML VARA-Objekte). Im Abschnitt Daten und Formatierung geben Sie den Datentyp des Wertes an, der durch das VARA-Objekt dargestellt wird.

Hinweis: Der Datentyp der Objekte BACKEND und FILELIST VARA ist immer Text und kann nicht geändert werden. Der Datentyp von EXEC, MULTI, SQL, SEC_SQL, SQLI, SEC_SQLI und STATIC kann jederzeit geändert werden.

Diese Seite beinhaltet Folgendes:

Datentyp: Text

Geben Sie einen alphanumerische String ein. Das System entfernt Leerzeichen am Ende des Strings, wobei vorangestellte Leerzeichen beibehalten werden.

Für VARA-Objekte mit diesem Datentyp definieren Sie zusätzlich die folgenden Parameter:

Textlänge limitieren (alle VARA-Typen)

Setzt eine Grenze für die Länge des Strings

Bei STATIC VARA-Objekten: Die Inhaltslänge ist unbegrenzt. Wenn Sie diese Option aktivieren, wirkt sich diese Einschränkung nur auf die Spalte für den ersten Wert aus.
Max. Textlänge (Alle VARA-Typen)

Mögliche Werte: 1 bis 1024
Großschreibung erzwingen (Alle VARA-Typen)

Konvertiert den Text der ersten Wertspalte in Großbuchstaben
Ergebnisformat (BACKEND-, MULTI-, SQL-, SQLI-, SEC_SQL- und SEC_SQLI VARA-Objekte)

Definiert das Format des Inhalts in der Spalte ERGEBNIS, die die erste Spalte ist, die in der Vorschau angezeigt wird. Die Ergebnis-Spalte kann aus einer Kombination von Werte-Spalten und beliebigen anderen Zeichen bestehen.

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

Beispiel:
- Wert Spalte 1: JOB1
- Wert Spalte 2: WIN01
- Ergebnisformat: {1}_{2}
- Ergebnisspalte: JOB01_WIN01
Wenn Sie kein Ergebnisformat angeben, wird der Wert in der Spalte Ergebnis oder in der Spalte Schlüssel verwendet.

Wichtig!
- Das Ergebnis muss innerhalb der definierten Grenzen liegen und dem Datentyp entsprechen. Ansonsten zeigt die Resultat-Spalte keinen Wert an.
- Die Beschränkungen (Min. Wert, Max. Wert, Textlimitierung) haben auf die Ergebnisspalte keinen Einfluss, sondern nur auf die erste zurückgelieferte Spalte. Wenn die Werte dieser Spalte den maximalen Bereich überschreiten, wird diese Zeile übersprungen. Die Zeile ist nicht über das VARA-Objekt verfügbar.
Gültigkeitsbereich (SEC_SQL- und SEC_SQLI VARA-Objekte)

Vereinfacht das Script, mit dem Werte in Variablen geschrieben oder aus ihnen gelesen werden sollen

Normalerweise muss der Schlüssel als Parameter im Script-Element :PUT_VAR oder GET_VAR angegeben werden. Dadurch wird es jedoch schwieriger, sicherzustellen, dass die Werte mit eindeutigen Schlüsseln gespeichert sind. Mit Angabe eines bestimmten Gültigkeitsbereichs vereinfachen Sie die Erstellung von Scripts, die in ein VARA-Objekt schreiben oder dieses auslesen.

Unter der Option Frei gewählt ist die Angabe eines Schlüssels optional. Für alle anderen Gültigkeitsbereichswerte hängt der Standard von der Aufgabe ab, auf die zugegriffen wird, wenn kein Schlüssel angegeben ist.

Diese Liste beschreibt, was passiert, wenn Sie diese Einstellung verwenden:
- Kein Gültigkeitsbereich
  
  Standardschlüssel, wenn keiner angegeben ist: *
- Frei gewählt
  
  Wenn kein Schlüssel angegeben wird, tritt der Laufzeitfehler U00003712 auf.
- Host - je Host-Name
  
  Standardschlüssel, wenn kein Wert angegeben ist: Name des Agenten, auf dem die Aufgabe ausgeführt wird
- Aufgabe - je Aufgabenname
  
  Standardschlüssel, wenn kein Wert angegeben ist: Name der Aufgabe
- Workflow-Name - jeder Workflow-Name
  
  Standardschlüssel, wenn kein Wert angegeben ist: Name des Parent-Workflows der Aufgabe
- Workflow-Session - je Workflow-Aktivierung
  
  Standardschlüssel, wenn kein Wert angegeben wird: RunID des Parent-Workflows der Aufgabe
- Benutzer - je Benutzer-Name
  
  Standardschlüssel, wenn kein Wert angegeben ist: Name des ausführenden Benutzers
- Benutzer-Session - je Benutzer-Session
  
  Standardschlüssel, wenn kein Wert angegeben ist: RunID der Benutzer-Session
  
  Der Eintrag (die Zeile) für die Benutzer-Session wird gelöscht, sobald die Benutzer-Session beendet wird.
Sortieren nach Spalte (nur für STATIC VARA-Objekte)

Gibt die Spalte an, nach der die Einträge sortiert werden sollen

Mögliche Werte: Schlüssel, Wert 1, Wert 2, Wert 3, Wert 4 oder Wert 5.
Sortierfolge (nur für STATIC VARA-Objekte)

Mögliche Optionen: Absteigend oder Aufsteigend.

Die zugrunde liegende Art der Sortierung, wie z. B. binär oder alphabetisch, hängt davon ab, was in Ihrer Datenbank definiert ist.

Datentyp: Zahl, Zeit, Datum, Zeitstempel

Für VARA-Objekte mit diesen Datentypen definieren Sie auch die folgenden Parameter:

Ausgabeformat (Alle VARA-Typen)
- Für Zahl
  
  Ganzzahl mit Vorzeichen, mögliche Werte: beliebige Zahl von 0 bis 2147483647
  
  Standardformat: 16 Stellen
- Für Zeit
  
  Möglich sind dabei die folgenden Formate:
  - HHMMSS
  - HH:MM:SS
  - HHMM
  - HH:MM
  - MMSS
  - MM:SS
  Standardformat: HHMMSS
  
  Der Wert für diesen Datentyp muss eine vier- oder sechsstellige Zahl sein. Kommastellen werden entfernt. Eine vierstellige Zahl wird dabei in Stunden und Minuten konvertiert.
  
  Beispiel:
  
  Ausgabeformat: HH:MM:SS
  
  Wert des Benutzers oder der Datenquelle: 1234, 1234.5, 123400, 12:34, 12:34:00
  
  Resultierender Variablenwert: 12:34:00
- Für Datum
  
  Möglich sind dabei die folgenden Formate:
  - DD-MON-YYYY
  - DD-MON-RR
  - MM-DD-YYYY
  - YYYYMMDD
  - MMDDRR
  - DDMMRR
  - MM-DD-RR
  - MM/DD/RR
  - YYMMDD
  - YY.MM.DD
  - YY-MM-DD
  - YYYYMMDD
  - YYYY.MM.DD
  - YYYY-MM-DD
  - DDMMYY
  - DD.MM.YY
  - DD-MM-YY
  - DDMMYYYY
  - DD.MM.YYYY
  - DD-MM-YYYY
  - MMDDYY
  - MMDDYYYY
  - MM/DD/YY
  - MM/DD/YYYY
  Standardformat: YYMMDD
  
  Hinweis: 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 - Das aktuelle Jahrhundert gilt für Zahlen von 00 bis 80. Im Bereich 81 - 99 das vorherige.
  - RR - Das aktuelle Jahrhundert gilt für Zahlen von 00 bis 49. Im Bereich 50 - 99 das vorherige.
  Beispiele:
  - Datumsformat TTMMJJ und die daraus resultierenden Daten:
    
    010305 - entspricht dem 01. März 2005
    010365 - entspricht dem 01. März 2065
    010380 - entspricht dem 01. März 2080
    010385 - entspricht dem 01. März 1985
  - Datumsformat TTMMRR und die daraus resultierenden Daten:
    
    010305 - entspricht dem 01. März 2005
    010365 - entspricht dem 01. März 1965
    010380 - entspricht dem 01. März 1980
    010385 - entspricht dem 01. März 1985
- Für Zeitstempel
  
  Mögliche Formate:
  - YYYYMMDDHH24MISS
  - YYYY-MM-DD HH:MM:SS
  Standardformat: YYYY-MM-DD HH:MM:SS
  
  Der Wert für diesen Datentyp muss eine vier- oder sechsstellige Zahl sein. Kommastellen werden entfernt. Eine vierstellige Zahl wird dabei in Stunden und Minuten konvertiert.
  
  Beispiel:
  
  Ausgabeformat: YYYY-MM-DD HH:MM:SS
  Wert des Benutzers oder der Datenquelle: 20110325 2201, 20110325 2201.5, 20110325 220100
  Resultierender Variablenwert: 2011-03-25 22:01:00
Hinweise:
- In STATIC VARA-Objekten ist die erste Spalte Wert 1
- Bei Datenbank- und MULTI-VARA-Objekten ist die erste Spalte die erste Basisspalte. MULTI-VARA-Objekte verwenden die erste Basisspalte als Referenzspalte. Aus diesem Grund kann das Ausgabeformat der Quellvariablen die abgerufenen Werte beeinflussen.
- Das Ausgabeformat von STATIC-VARA-Objekten kann jederzeit geändert werden. Die Werte werden in das neue Format konvertiert. Sie werden jedoch nicht konvertiert, wenn die Werte nicht dem alten Format entsprechen.
- Das Format in dem Werte in statische VARA-Objekte eingetragen werden, spielt keine Rolle, solange es ein von AE unterstütztes Format des jeweiligen Datentyps ist. Die Werte werden dann in das entsprechende Ausgabeformat umgewandelt.
Minimum festlegen / Min. Wert und Maximum festlegen / Max. Wert (Alle VARA-Typen)

Legt einen Minimal-/Maximalwert fest.

Mögliche Werte für Zahl: Maximal 16 Stellen vor und 16 Stellen nach dem Dezimalpunkt
Ergebnisformat (für MULTI, SQL, SQLI, SEC_SQL, SEC_SQLI)

Definiert das Format des Inhalts in der Spalte ERGEBNIS, die die erste Spalte ist, die in der Vorschau angezeigt wird. Die Ergebnis-Spalte kann aus einer Kombination von Werte-Spalten und beliebigen anderen Zeichen bestehen.

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

Beispiel:
- Wert Spalte 1: JOB1
- Wert Spalte 2: WIN01
- Ergebnisformat: {1}_{2}
- Ergebnisspalte: JOB01_WIN01
Wenn Sie kein Ergebnisformat angeben, wird der Wert in der Spalte Ergebnis oder in der Spalte Schlüssel verwendet.
Gültigkeitsbereich (für SEC_SQL, SEC_SQLI)

Siehe Beschreibung unter Gültigkeitsbereich (SEC_SQL- und SEC_SQLI VARA-Objekte) oben
Sortieren nach Spalte (STATIC)

Gibt die Spalte an, nach der die Einträge sortiert werden sollen

Mögliche Werte: Schlüssel, Wert 1, Wert 2, Wert 3, Wert 4 oder Wert 5
Nach Reihenfolge sortieren (STATIC)

Mögliche Optionen: Absteigend oder Aufsteigend

Die zugrunde liegende Art der Sortierung, wie z. B. binär oder alphabetisch, hängt davon ab, was in Ihrer Datenbank definiert ist.

Datentyp ändern

Das Ändern des Datentyps eines VARA-Objekts ist mit Ausnahme von BACKEND, FILELIST und XML möglich.

Hinweise:

Nachdem Sie die Datentypen Zahl, Zeitstempel, Uhrzeit und Datum definiert haben, können Sie diese in Text ändern. Die resultierenden Werte werden unverändert konvertiert.
Die Datentypen Anzahl, Zeitstempel, Uhrzeit und Datum können Sie nicht direkt ändern. Zuerst müssen Sie sie in Text umwandeln.
Nachdem Sie Textdatentypen definiert haben, können Sie diese nur dann in Anzahl, Zeitstempel, Uhrzeit oder Datum ändern, wenn das Ausgabeformat definiert ist. Beim Speichern des VARA-Objektes wird überprüft, ob die Werte dem Format entsprechen.
Nur der Eintrag in der Spalte Wert 1 wird anhand des Datentyps auf Plausibilität geprüft. Sie können einen beliebigen Wert in die restlichen Wertspalten eingeben.

Siehe auch: