MULTI VARA-Objekte

MULTI VARA-Objekte kombinieren die von zwei verschiedenen VARA-Objekten dargestellten Werte.

Wie alle anderen Objekte haben MULTI-VARA-Objekte mehrere verschiedene Definitionsseiten. Allgemein, Versionsmanagement und Dokumentation existieren für alle Objekte. Hier wird die Seite Variablen beschrieben, die für MULTI-VARA-Objekte spezifisch ist.

Ein MULTI VARA-Objekt definieren

  1. Geben Sie im Abschnitt Variableneinstellungen die VARA-Objekte an, deren Werte dieses VARA-Objekt vom Typ MULTI abrufen und kombinieren soll.

    • Variable 1

      VARA-Objekt, aus dem die Werte abgerufen und mit den Werten in Variable 2 kombiniert werden. Die Werte werden aus den Referenzspalten im VARA-Objekt entnommen, das Sie hier auswählen. Jedes VARA-Objekt hat eine eigene Referenzspalte für diesen Zweck. Die Referenzspalten sind:

      • STATIC: Schlüsselspalte
      • SQL, SQLI, MULTI: Erste Spalte
      • FILELIST: Filelist-Spalte

      Wichtig! Stellen Sie sicher, dass der Wert in der Referenzspalte den gleichen Datentyp wie das MULTI VARA-Objekt. Andernfalls tritt ein Fehler auf.

    • Variable 2

      VARA-Objekt, aus dem die Werte abgerufen und mit den Werten in Variable 1 kombiniert werden. Wenn das VARA-Objekt, das Sie hier auswählen, nicht die Referenzspalten enthält, wird kein Wert aus diesem VARA-Objekt in das Ergebnis des MULTI VARA-Objekts aufgenommen.

      Die Werte, die aus Variable 1 resultieren, werden verwendet, wenn die zwei VARA-Objekte, die in Variable 1 und Variable 2 ausgewählt wurden, Einträge mit demselben Namen enthalten.

    • Wählen Sie die Operation aus, die dieses VARA-Objekt vom Typ MULTI anwenden soll, um die Werte der ausgewählten VARA-Objekte zu kombinieren.

      • Vereinigungsmenge ruft alle Werte von Variable 1 und Variable 2 ab. Wenn die Variableneinträge identisch sind, werden die Werte von Variable 1 verwendet.

      • Schnittmenge ruft die Werte ab, die sowohl in Variable 1 als auch in Variable 2 verwendet werden. Dabei werden die Werte-Spalten bei gleichen Ergebnis/Schlüssel-Einträgen von Variable 1 übernommen.

      • Differenz ruft alle Werte von Variable 1 ab, die nicht in Variable 2 enthalten sind. Die Ergebnis/Schlüssel-Spalteneinträge der Variablen werden miteinander verglichen.

  2. Im Abschnitt Daten & Formatierung legen Sie das Datenformat des Werts fest, der vom VARA-Objekt gerendert wird. Führen Sie folgende Schritte durch:

    • Datentyp

      • Für Text

        • Wählen Sie Textlänge limitieren aus, um ein Limit für die Länge des Zeichen-Strings festzulegen.

        • Geben Sie unter Max. Textlänge die maximale Länge an. Mögliche Werte: 1 bis 1024.

        • Wählen Sie Großschreibung erzwingen aus, wenn Sie den Text der ersten Wertspalte in Großbuchstaben konvertieren möchten.

        • Legen Sie unter Ergebnisformat das Format des Inhalts in der Spalte ERGEBNIS fest. Das ist die erste Spalte, 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 Ergebnis-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.

      • 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

    • 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

  3. Alle VARA-Objekte haben den Abschnitt Script-Zugriff auf ihren Definitionsseiten, der die Fehlerbehandlung festlegt, wenn Scripts das VARA-Objekt lesen. In diesem Bereich entscheiden Sie, was passieren soll, wenn Scripts auf das VARA-Objekt zugreifen und der Schlüssel, auf den sie verweisen, nicht verfügbar ist.

    Folgende Optionen stehen zur Verfügung:

    • Fehler zurückliefern

      Das Script wird nicht ordnungsgemäß beendet, und auf der Meldungen-Konsole wird eine Laufzeitfehlermeldung angezeigt.

    • Anfangswerte zurückgeben (Standard)

      Das Script wird weiterhin ausgeführt, obwohl der Schlüssel nicht verfügbar ist. Es wird kein Laufzeitfehler angezeigt. Der Report enthält einen leeren String, woran zu erkennen ist, dass kein Schlüssel gefunden wurde.

      Tipp: Stellen Sie sicher, dass die Schlüssel von VARA-Objekten immer einen Wert zurückgeben, wenn Sie diese Option verwenden möchten.

  4. Klicken Sie auf die Schaltfläche Vorschau, um das VARA-Objekt zu überprüfen. Es wird eine Vorschau der Ergebniswerte angezeigt.

  5. Um den Inhalt der Vorschautabelle in eine CSV-Datei zu exportieren, klicken Sie auf Tabelle exportieren. Alle Zeilen und Spalten werden exportiert. Verwenden Sie diese Funktion, wenn Sie den Inhalt der CSV-Datei weiter verarbeiten müssen (ihn in eine andere Anwendung zur weiteren Verarbeitung einfügen usw.).

  6. Um eine oder mehrere Zeilen in der Vorschautabelle zu kopieren, wählen Sie die Schaltfläche Kopieren aus. Die ausgewählten Zeilen werden in die Zwischenablage kopiert und Sie können sie in ein Drittanbieter-Tool (Google, Sheets, Excel, Texteditor usw.) einfügen.

    Hinweis: Diese Funktion ist nur verfügbar, wenn https in der Automic Web Interface verwendet wird.

  7. Speichern Sie Ihre Änderungen.

Siehe auch: