VARA-Objekte vom Typ FILELIST

FILELIST VARA-Objekte rufen die Dateinamen der Dateien ab, die in einem bestimmten Verzeichnis gespeichert sind. Wenn Sie ein FILELIST VARA-Objekt definieren, ist die Angabe eines Agenten obligatorisch. Auf Windows-Agenten sind die Dateinamen in aufsteigender Reihenfolge sortiert. Auf UNIX-Agenten sind die Dateinamen nicht sortiert.

FILELIST VARA-Objekte enthalten eine Spalte; sie haben keine Ergebnisspalte. Beachten Sie dies, wenn Sie das Script-Element GET_PROCESS_LINE in Verbindung mit FILELIST VARA-Objekten verwenden.

Verwenden Sie hier PromptSet-Variablen, wenn Sie die Funktion Dynamisch aktualisieren für Kombinationsfeld-Eingabeaufforderungen verwenden. Die PromptSet-Variablen werden aufgelöst, wenn das Objekt, das die Eingabeaufforderung enthält, ausgeführt wird.

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

Ein FILELIST VARA-Objekt definieren

  1. Geben Sie im Abschnitt Variableneinstellungen an, wie das VARA-Objekt auf das Zielsystem zugreifen soll, von dem es die Werte abruft.

    • Wählen Sie unter Agent den BS-Agenten aus, der für den Zugriff auf das Verzeichnis verwendet wird. Agentengruppen sind nicht erlaubt. Wenn Sie nichts auswählen, wird der Agent der Aufgabe, die das VARA-Objekt verwendet, angewendet.

      Hinweise:

      • Ein Laufzeitfehler tritt auf, wenn das VARA-Objekt in einem Objekt verwendet wird, dem kein Agent oder Login zugeordnet ist.
      • Dateiübertragungsobjekt als Quelle: Wenn Sie keinen Agenten zuweisen, wird der Agent verwendet, der in den Zieleinstellungen des Dateiübertragungsobjekts definiert ist.

      • Wenn Sie die Funktion für das dynamische Aktualisieren für Kombinationsfeld-Prompts verwenden, können Sie hier PromptSet-Variablen hinzufügen. Wenn Sie PromptSet-Variablen in einem dynamischen VARA-Objekt verwenden, gibt die Funktion Vorschau einen Fehler zurück. Der Grund hierfür ist, dass PromptSet-Variablen im dynamischen VARA-Objekten nicht existieren. Die PromptSet-Variablen werden jedoch aufgelöst, wenn Objekte, die PromptSet beinhalten, ausgeführt werden.

    • Wählen Sie Aufgaben-Agenten anwenden aus, um stattdessen den Agenten der Aufgabe zu verwenden, die das VARA-Objekt verwendet. Wenn die Aufgabe keinen Agenten hat (z. B. bei Script-Objekten), wird der Agent des VARA-Objekts verwendet. Wenn weder das VARA-Objekt noch die Aufgabe einen Agenten hat, tritt ein Fehler auf.

    • Wählen Sie das Login-Objekt aus, das dem VARA-Objekt den Zugriff auf das Zielbetriebssystem ermöglicht.

    • Wählen Sie Aufgaben-Login anwenden aus, um das Login-Objekt zu verwenden, das der Aufgabe zugewiesen ist, die das VARA-Objekt verwendet. Wenn der Aufgabe kein Login-Objekt zugeordnet ist (z. B. bei Script-Objekten), wird das dem VARA-Objekt zugeordnete Login-Objekt verwendet. Wenn weder das VARA-Objekt noch die Aufgabe ein Login-Objekt hat, tritt ein Fehler auf.

    • Geben Sie unter Dateien das Verzeichnis ein, aus dem die Dateinamen als Werteliste zurückgegeben werden sollen, sobald auf das VARA-Objekt zugegriffen wird. Auf einem Windows-Computer könnte es beispielsweise so sein:

      C:\temp\*.*

      Dabei ist es auch möglich, nur Dateien mit bestimmtem Namen oder Endung zu erhalten. Um solche Filter zu setzen, verwenden Sie "*" (mehrere Zeichen) oder "?" (genau ein Zeichen). Zum Beispiel:

      C:\utility\temp\*.txt

  2. Der Inhalt von VARA-Objekten vom Typ FILELIST ist immer ein String. Daher ist der Typ immer Text. Dies wird im Abschnitt Daten & Formatierung angezeigt und kann nicht geändert werden. In diesem Abschnitt geben Sie das Datenformat des Werts an, der durch das VARA-Objekt gerendert wird. Führen Sie folgende Schritte durch:

    • 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.

  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. Diese Funktion überprüft, ob das Verzeichnis vorhanden ist, ob der Agent verfügbar ist, ob der Pfad Lesezugriff hat usw. Wenn die Einstellungen korrekt sind, wird die Dateiliste 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 das Objekt.

Siehe auch: