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. Sie definieren und erfassen die Werte für STATIC VARA-Objekte auf zwei Seiten. Auf der Hauptseite Variablen legen Sie die Werte fest. Auf der Seite Attribute definieren Sie die spezifischen VARA-Objektparameter.

Diese Seite beinhaltet Folgendes:

Übersicht

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

Ein STATIC VARA-Objekt definieren

Seite "Variablen"

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.

    Maximale Schlüssellänge: 200 Zeichen

    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.

    Es wird zwischen Groß- und Kleinschreibung unterschieden. Wenn bei Ihrer Datenbank die Groß- und Kleinschreibung beachtet wird und Sie zwei identische Schlüssel eingeben, bei denen ein Schlüssel in Großbuchstaben und ein anderer in Kleinbuchstaben dargestellt ist (z. B. test und TEST), werden beide Schlüssel gespeichert, wenn Sie das Objekt speichern. Wenn bei Ihrer Datenbank die Groß-/Kleinschreibung nicht beachtet wird, ersetzt der letzte Eintrag, den Sie eingeben, den ersten.

    Die folgenden Wertebereiche sind abhängig von Ihrer Auswahl im Feld Datentyp (Abschnitt  Daten & 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

Seite "Attribute"

  1. Definition der Datentypen und Formatierung
    Hinweis: 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.

  2. Geben Sie im Abschnitt Variableneinstellungen Folgendes an:

    • Typ (schreibgeschütztes Feld)

    • 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 Standardschlüssel für den Zugriff auf das VARA-Objekt verwendet wird, wenn kein Schlüssel 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. Laufzeitfehler U00003712 tritt auf, wenn der Schlüssel fehlt.

        Standardschlüssel, wenn keiner angegeben ist: N/A

        Beispiel:

        : SET &VARA_NAME# = "UC0.MAL.TEST#1_1.VARA_STATIC_USERNAME"

        : PUT_VAR &VARA_NAME#, &$USER#, "Merkur", "Venus", "Erde", "Mars", "Jupiter"

        : SET &VALUE# = GET_VAR(&VARA_NAME#, &$USER# ,1)

        : PRINT "Wert: &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 - je 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 Parent-Workflows, in dem die Aufgabe ausgeführt wird.

      • Benutzer - je Benutzer-Name

        Die Angabe eines Schlüssels ist optional.

        Standardschlüssel, wenn kein Schlüssel angegeben ist: der Name des ausführenden Benutzers.

        Beispiel:

        : SET &VARA_NAME# = "UC0.MAL.TEST#1_1.VARA_STATIC_USERNAME"

        : PUT_VAR &VARA_NAME#, , "Merkur", "Venus", "Erde", "Mars", "Jupiter"

        : SET &VALUE# = GET_VAR(&VARA_NAME#, &$USER# ,1)

        : PRINT "Wert: &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 Benutzersitzung und Workflow-Session - je Workflow-Aktivierung. Ist für diese beiden Bereiche 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#, , "Merkur", "Venus", "Erde", "Mars", "Jupiter"

      : SET &VALUE# = GET_VAR(&VARA_NAME#, &$USER# ,1)

      : PRINT "Wert: &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-Session 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. Speichern Sie Ihre Änderungen.

Script-Elemente für STATIC VARA-Objekte

Sie können die folgenden Script-Elemente verwenden, um Werte im VARA-Objekt zu speichern:

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,, den Sie in eines der Felder eingeben. Durch Eingabe von ABCwird die Suche nach *ABC* ausgelöst. Die folgenden Ergebnisse werden auch in der Dropdown-Liste vorgeschlagen:

    • MS_ABC
    • ABC_MS
    • MS_ABC_MS
  • In der Suche ist nicht case-sensitiv

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.

Einträge kopieren

Sie können den Inhalt eines STATIC VARA-Objekts in ein anderes Objekt auf demselben Mandanten, auf einem anderen Mandanten oder in einem anderen Automation Engine-System kopieren, vorausgesetzt, Sie haben die notwendigen Rechte. Sie können es auch in ein Drittanbieter-Tool wie Google Sheets oder Excel kopieren.

Hinweis: Das Kopieren und Einfügen in eine Drittanbieteranwendung funktioniert nur, wenn die Automic Web Interface https verwendet.

Den Inhalt eines STATIC VARA-Objekts kopieren

  1. Wählen Sie im Quellobjekt so viele Zeilen aus, wie Sie benötigen.

  2. Klicken Sie auf Kopieren.

  3. Führen Sie eine der folgenden Aktionen aus:

    • Öffnen oder erstellen Sie ein weiteres STATIC VARA-Objekt, und wählen Sie Einfügen aus.

    • Öffnen Sie das Drittanbieter-Tool (z. B. Google Sheets oder Excel), drücken Sie Strg+V oder klicken Sie mit der rechten Maustaste und wählen Sie Einfügen.

  4. Wählen Sie im Zielobjekt Einfügen aus.

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: