Mit STATIC-VARA-Objekten können Sie beliebig viele Keys mit jeweils maximal 5 Werten speichern. Sie können die Werte manuell, mithilfe eines Script-Sprachmittels oder mit einer Bedingungsaktion festlegen. Auf zwei Seiten definieren und erfassen Sie die Werte für STATIC-VARA-Objekte. Auf der Hauptseite Variablen legen Sie die Werte fest. Auf der Seite Attribute definieren Sie die spezifischen VARA-Objektparameter.
Dieses Thema beinhaltet Folgendes:
STATIC-VARA-Objekte definieren
Die Definition eines STATIC-VARA-Objekts besteht aus den folgenden Seiten:
- Seite „Allgemein“
-
Variablen, siehe Seite Seite „Variablen“ unten.
-
Attribute
Hier legen Sie die objektspezifischen Einstellungen fest. Einige Abschnitte dieser Seite gelten für alle VARA-Objekte und werden für all diese in eigenen Themen beschrieben:
- Datentypen und Formatierung
- Variablen-Einstellungen, siehe Seite Seite „Attribute“ unten
- Scriptzugriff
- Mandant-0-VARA-Objekte in anderen Mandanten
- Seite „Versionsmanagement“
- Seite „Dokumentation“
Es gibt verschiedene Möglichkeiten, die Werte des STATIC-VARA-Objekts festzulegen:
-
Werte manuell eingeben
Hinweise:
-
Achten Sie darauf, dass der Key nicht mit dem Zeichen & beginnt. In diesem Fall können Sie das VARA-Objekt zwar speichern, aber beim Scriptzugriff auf diese Zeilen kommt es zu einem Fehler.
-
Maximale Länge der Keys: 200 Zeichen
-
Groß-/Kleinschreibung wird unterstützt.
Beispiel: Fügen Sie die Keys „test“ und „TEST“ hinzu. Wenn Ihre Datenbank Groß- und Kleinschreibung unterstützt, speichert sie beide Keys, ansonsten ersetzt der zweite Eintrag den ersten.
-
Die folgenden Wertebereiche sind abhängig von Ihrer Auswahl im Feld Datentyp (Abschnitt Daten & Formatierung) erlaubt:
-
Zeichenfolge
Länge des Inhaltes: Unbegrenzt
Ist die Einstellung Textlänge limitieren im Abschnitt Daten & Formatierung gesetzt, so betrifft diese Beschränkung nur die erste Werte-Spalte.
-
Zahl
Länge des Inhaltes: 0 - 2147483647
-
Zeitstempel
Länge des Inhaltes: Datums- und Zeitangabe je nach Ausgabeformat
-
Zeit
Länge des Inhaltes: Zeitangabe je nach Ausgabeformat
-
Datum
Länge des Inhaltes: Datumsangabe je nach Ausgabeformat
-
Die Werte werden nach den Einstellungen auf der Seite Attribute sortiert. Standardmäßig wird aufsteigend nach der Key-Spalte sortiert.
-
-
Verwendung des Fensters Zelleneditor
Der Editor ermöglicht eine bequeme und übersichtliche Bearbeitung des Inhalts. Er ist vor allem für die Änderung von langen Werten hilfreich. Um den Editor zu öffnen, klicken Sie auf das Editorsymbol in einer Zelle.
-
Definieren einer SET VARIABLE- oder CLEAR VARIABLE-Bedingungsaktion für eine Workflow-Aufgabe. Es ist jedoch nicht möglich, ein neues ARA-Objekt innerhalb einer Bedingungsanweisung zu definieren.
Folgende Script-Sprachmittel sind für STATIC- und XML-Variablen verfügbar:
- :PUT_VAR - Speichert Werte in statische Variablen.
- :PUT_VAR_COL - Speichert einen Wert in eine bestimmte Spalte eines statischen Variablenobjekts.
- :DELETE_VAR - Löscht einen oder alle Wert/e einer statischen Variable.
-
Typ
Schreibgeschützt, immer STATIC.
-
Gültigkeitsbereich
Diese Einstellung dient dazu, das Script zu vereinfachen, mit dem Werte in das VARA-Objekt geschrieben oder aus diesem gelesen werden sollen.
Normalerweise muss der Key als Parameter im Script-Sprachmittel :PUT_VAR oder GET_VAR angegeben werden. Dadurch wird es jedoch schwieriger, sicherzustellen, dass die Werte mit eindeutigen Keys gespeichert sind. Mit Angabe eines bestimmten Gültigkeitsbereichs können Sie die Erstellung von Scripts vereinfachen, die in ein VARA-Objekt schreiben oder dieses auslesen.
Bei allen Werten für den Gültigkeitsbereich außer Frei gewählt ist der Key optional. Welcher Standard-Key für den Zugriff auf das VARA-Objekt verwendet wird, wenn kein Key angegeben ist, hängt von den Eigenschaften der Aufgabe ab, die auf das Objekt zugreift.
Folgende Optionen stehen zur Verfügung:
-
Kein Gültigkeitsbereich
Die Angabe eines Key ist optional.
Standard-Key, wenn keiner angegeben ist: *
-
Frei gewählt
Die Angabe eines Key ist erforderlich.
Standard-Key, wenn keiner angegeben ist: N/A. Da ein Key erforderlich ist, tritt Laufzeitfehler U00003712 auf, wenn kein Key spezifiziert ist.
Hat das VARA-Objekt den Bereich Frei gewählt, müssen Sie den Key beim Schreiben oder Lesen aus dem VARA-Objekt angeben.
Beispiel:
:SET&VARA_NAME# = "UC0.MAL.TEST#1_1.VARA_STATIC_USERNAME"
:PUT_VAR&VARA_NAME#, &$USER#, "Mercury", "Venus", "Earth", "Mars", "Jupiter"
:SET&VALUE# = GET_VAR(&VARA_NAME#, &$USER# ,1)
:PRINT"Value: &Value#"
-
Host - je Host-Name:
Die Angabe eines Key ist optional.
Standard-Key, wenn keiner angegeben ist: Name des Agenten, auf dem die Aufgabe läuft.
-
Aufgabe - je Aufgabenname
Die Angabe eines Key ist optional.
Standard-Key, wenn keiner angegeben ist: Name des laufenden ausführbaren Objekts.
-
Workflow-Name - je Workflow-Name
Die Angabe eines Key ist optional.
Standard-Key, wenn keiner angegeben ist: Der Name des Parent-Workflows, innerhalb dessen die Aufgabe ausgeführt wird.
-
Workflow-Session - je Workflow-Aktivierung
Die Angabe eines Key ist optional.
Standard-Key, wenn keiner angegeben ist: Die RunID des Parent-Workflows, innerhalb dessen die Aufgabe ausgeführt wird.
-
Benutzer - je Benutzer-Name
Die Angabe eines Key ist optional.
Standard-Key, wenn keiner angegeben ist: Name des ausführenden Benutzers.
Hat das VARA-Objekt den Bereich Benutzer - je Benutzer-Name, müssen Sie den Key bei Zugriff auf das VARA-Objekt nicht angeben.
Beispiel:
:SET&VARA_NAME# = "UC0.MAL.TEST#1_1.VARA_STATIC_USERNAME"
:PUT_VAR&VARA_NAME#, , "Mercury", "Venus", "Earth", "Mars", "Jupiter"
:SET&VALUE# = GET_VAR(&VARA_NAME#, &$USER# ,1)
:PRINT"Value: &Value#"
-
Benutzer-Session - je Benutzersitzung
Die Angabe eines Key ist optional.
Standard-Key, wenn keiner angegeben ist: Die RunID der Benutzer-Session. Der Eintrag (die Zeile) für die Benutzer-Session wird gelöscht, sobald die Benutzer-Session beendet wird.
Die beiden nützlichsten Bereiche sind Benutzer-Session - je Benutzersitzung und Workflow-Session - je Workflow-Aktivierung. Ist bei diesen beiden Bereichen kein Standard-Key angegeben, wird die Session-ID des Benutzers bzw. die RunID des Workflows verwendet. Bei diesen beiden Bereichen werden zudem die Zeilen gelöscht, wenn die entsprechende RunID deaktiviert wird.
Beispiel:
Sie möchten einige Informationen in einem VARA-Objekt speichern, solange ein Benutzer angemeldet ist, diese jedoch entfernen, wenn sich der Benutzer abmeldet. Sie können den Bereich des VARA-Objekts auf Benutzer-Session - je Benutzersitzung setzen und Werte in das VARA-Objekt eingeben, ohne, wie hier dargestellt, einen Key anzugeben:
:SET&VARA_NAME# = "UC0.MAL.TEST#1_1.VARA_STATIC_USERSESSION"
:PUT_VAR&VARA_NAME#, , "Mercury", "Venus", "Earth", "Mars", "Jupiter"
:SET&VALUE# = GET_VAR(&VARA_NAME#, &$USER# ,1)
:PRINT"Value: &Value#"
Der Key zum Schreiben der Werte ist die Session-ID des Benutzers, der das Script ausführt. In diesem Beispiel wurde dem VARA-Objekt beim Ausführen des Scripts die folgende Zeile hinzugefügt:
Key 1168010
Wert 1 Merkur
Wert 2 Venus
Wert 3 Erde
Wert 4 Mars
Wert 5 Jupiter
1168010 ist die ID der Benutzer-Session. Session-IDs der Benutzer sind in der Perspektive „Administration“ unter Benutzer sichtbar. Sobald sich der Benutzer abmeldet, wird diese Zeile aus dem VARA-Objekt entfernt.
Der Bereich Workflow-Session - je Workflow-Aktivierung funktioniert auf ähnliche Weise. Jede Zeile, die in ein solches VARA-Objekt geschrieben wird (ohne einen angegebenen Key), wird automatisch entfernt, sobald der ausführende Workflow deaktiviert ist.
-
Siehe auch: