STATIC VARA-Objekte

Mit STATIC VARA-Objekten können Sie beliebig viele Schlüssel mit jeweils maximal 5 Werten speichern. Sie können die Werte manuell, mithilfe eines Script-Elements 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.

STATIC VARA-Objekte definieren

Die Definition eines STATIC-VARA-Objekts besteht aus den folgenden Seiten:

• Seite "Allgemein"

  Gemeinsam für alle Objekttypen definieren Sie hier grundlegende Objektinformationen und wenden benutzerdefinierte Werte auf sie an.

• Die Seite Variablen definieren

• Die Seite Attribute definieren

  Hier legen Sie die objektspezifischen Einstellungen fest. Einige Abschnitte dieser Seite gelten für alle VARA-Objekte und werden in jeweils eigenen Themen beschrieben. In diesem Kapitel werden die SQL-spezifischen Einstellungen für die Seite Attribute beschrieben.

• Seite "Versionsmanagement"

  Allgemein für alle Objekttypen finden Sie hier eine Liste aller Versionen des Objekts.

• Seite "Dokumentation"

  Hier geben Sie die Informationen ein, die Sie als wichtig erachten, um die Konfiguration und das Verhalten des Objekts zu verstehen.

Die Seite Variablen definieren

Auf dieser Seite definieren Sie die Werte des STATIC VARA-Objekts.

1. Klicken Sie auf ein Feld, um es zu aktivieren.

2. Geben Sie den Wert ein, oder klicken Sie auf das Symbol, um das Fenster Zellen-Editor zu öffnen. Der Zellen-Editor ermöglicht eine bequeme und übersichtliche Bearbeitung des Inhalts. Er ist vor allem für die Änderung von langen Werten hilfreich.

   Wichtig!

   • Der Schlüssel darf nicht mit & beginnen

     Wenn ein Schlüssel mit & beginnt, können Sie das VARA-Objekt speichern. Allerdings tritt ein Fehler auf, wenn ein Script versucht, darauf zuzugreifen.

   • Maximale Schlüssellänge: 200 Zeichen

   • Groß-/Kleinschreibung wird unterstützt

     Beispiel: Fügen Sie die Schlüssel "test" und "TEST" hinzu. Wenn bei Ihrer Datenbank die Groß-/Kleinschreibung berücksichtigt wird, werden beide Schlüssel gespeichert. Anderenfalls ersetzt der zweite Eintrag den ersten.

   • Die folgenden Wertebereiche sind abhängig von Ihrer Auswahl im Feld Datentyp (Abschnitt Daten und Formatierung) erlaubt:

     • Zahl

       Länge des Inhalts: 0–2147483647

     • Zeitstempel

       Länge des Inhalts: Datums- und Zeitwert je nach Ausgabeformat

     • Zeit

       Länge des Inhalts: Zeitwert je nach Ausgabeformat

     • Datum

       Länge des Inhaltes: Datumswert je nach Ausgabeformat

Die Seite Attribute definieren

1. Definieren Sie Datentypen und Formatierung.

2. Geben Sie im Abschnitt Variableneinstellungen Folgendes an:

   • Typ

     Schreibgeschützt

   • Gültigkeitsbereich

     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. Geben Sie einen bestimmten Gültigkeitsbereich an, um die Erstellung von Scripts zu vereinfachen, die in ein VARA-Objekt schreiben oder dieses auslesen.

     Der Schlüssel ist optional für alle Werte des Bereichs, mit Ausnahme der Option Frei gewählt. 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 Schlüssels ist optional

       Standardschlüssel, wenn keiner angegeben ist: *

     • Frei gewählt

       Die Angabe eines Schlüssels ist erforderlich

       Standardschlüssel, wenn kein Wert angegeben ist: N/A. Da die Angabe eines Schlüssels obligatorisch ist, tritt der Laufzeitfehler U00003712 auf, wenn der Schlüssel fehlt.

       Hat das VARA-Objekt den Bereich Frei gewählt, müssen Sie den Schlüssel 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 Schlüssels ist optional

       Standardschlüssel, wenn kein Schlüssel angegeben ist: Der Name des Agenten, auf dem die Aufgabe ausgeführt wird.

     • Aufgabe - je Aufgabenname

       Die Angabe eines Schlüssels ist optional

       Standardschlüssel, wenn kein Schlüssel angegeben ist: Der Name des laufenden ausführbaren Objekts.

     • Workflow-Name - jeder Workflow-Name

       Die Angabe eines Schlüssels ist optional

       Standardschlüssel, wenn kein Schlüssel angegeben ist: Der Name des übergeordneten Workflows, in dem die Aufgabe ausgeführt wird.

     • Workflow-Session - je Workflow-Session

       Die Angabe eines Schlüssels ist optional

       Standardschlüssel, wenn kein Schlüssel angegeben ist: Die RunID des übergeordneten Workflows, in dem die Aufgabe ausgeführt wird.

     • Benutzer - je Benutzer-Name

       Die Angabe eines Schlüssels ist optional

       Standardschlüssel, wenn kein Wert angegeben ist: Der Name des ausführenden Benutzers

       Hat das VARA-Objekt den Bereich Benutzer - je Benutzer-Name, müssen Sie den Schlüssel 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 Benutzer-Session

       Die Angabe eines Schlüssels ist optional

       Standardschlüssel, wenn kein Schlüssel angegeben wird: Die RunID der Benutzer-Session. Der Eintrag (die Zeile) für die Benutzer-Session wird gelöscht, sobald die Benutzer-Session beendet wird.

     Tipp: Die beiden nützlichsten Bereiche sind Benutzer-Session - je Benutzer-Session und Workflow-Session - je Workflow-Aktivierung. Ist bei diesen beiden Bereichen kein Standardschlüssel 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 Benutzer-Session setzen und Werte in das VARA-Objekt eingeben, ohne, wie hier dargestellt, einen Schlüssel 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 Schlüssel 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:

     Schlüssel 1168010

     Wert 1 Merkur

     Wert 2 Venus

     Wert 3 Erde

     Wert 4 Mars

     Wert 5 Jupiter

     1168010 ist die ID der Benutzer-Session. Diese IDs sind unter Benutzer in der Administration-Perspektive 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 Schlüssel), wird automatisch entfernt, sobald der ausführende Workflow deaktiviert ist.

3. Definieren Sie den Script-Zugriff.
4. Wenn Sie bei Mandant 0 angemeldet sind, ist ein zusätzlicher Abschnitt verfügbar. Weitere Informationen finden Sie unter Mandant-0-VARA-Objekte in anderen Mandanten.

5. Speichern Sie Ihre Änderungen.

Script-Elemente für STATIC VARA-Objekte

Folgende- Script-Elemente stehen zum Speichern von Werten in einem STATIC VARA-Objekt zur Verfügung:

• :PUT_VAR - Speichert Werte in statischen Variablen.
• :PUT_VAR_COL - Speichert einen Wert in einer bestimmten Spalte eines statischen Variablenobjekts.
• :DELETE_VAR - Löscht einen oder alle Wert/e einer statischen Variable.

Einträge filtern

Bei großen Installationen können STATIC VARA-Objekte Hunderte von Einträgen enthalten. Verwenden Sie die Filterfunktion, um Einträge schneller zu finden.

Den Inhalt der STATIC VARA-Objekts filtern

1. Klicken Sie in der Symbolleiste auf Filter .

   Das Fenster Filter wird geöffnet. Schlüsselname, Wert 1 und Wert 2 werden immer angezeigt. Sie können diese Spalten nicht ausblenden.

2. Klicken Sie auf Filterkriterien hinzufügen, um Ihrem Filter weitere Werte hinzuzufügen.

3. Geben Sie den Namen oder die Werte ein, und klicken Sie unten im Fenster auf die Schaltfläche Filter.

Wichtig!

• Der Filter verwendet implizite Platzhalterzeichen am Anfang und am Ende des Strings, die Sie in eines der Felder eingeben. Durch Eingabe von ABCwird die Suche nach *ABC* ausgelöst. Die folgenden Ergebnisse werden auch in der Drop-down-Liste vorgeschlagen:

  • MS_ABC
  • ABC_MS
  • MS_ABC_MS
• In der Suche wird Groß- und Kleinschreibung nicht unterschieden

Einträge exportieren

Über die Schaltfläche "Exportieren" in der Symbolleiste können Sie die Liste der Einträge im STATIC VARA-Objekt in eine CSV-Datei exportieren. Wenn die Liste gefiltert wird, werden nur die sichtbaren Einträge exportiert. Wenn die Liste nicht gefiltert ist, wird die gesamte Liste exportiert.

Die Liste kann immer exportiert werden, unabhängig von der Anzahl der Einträge, die sie enthält.

Verwendung

In diesem Video erfahren Sie, wie STATIC und XML VARA-Objekte verwendet werden, um Workflows zu konfigurieren: Sehen Sie sich das Video an: Konfigurieren von Workflows mit VARA-Objekten

Siehe auch:

• Benutzerdefinierte VARA-Objekte
• Variablen und VARA-Objekte
• Variablen/VARA-Objekte in Objekte und Scripts einfügen