DIRECTORY-Befehl

Erstellt eine Liste der Dateien und Ordner im angegebenen Verzeichnis.

Syntax

DIRECTORY <Dateispezifikation> <SUPPRESS> <SUBDIRECTORY> <APPEND> <TO Tabellenname|Dateiname>

Parameter

Name Beschreibung
Dateispezifikation

Optional

Windows-Ordner oder -Dateien, die aufgelistet und für die Informationen angezeigt werden sollen.

Sie können das Sternchen (*) als Platzhalter verwenden, um alle Dateien auszuwählen, die eine bestimmte Erweiterung haben bzw. mit einer bestimmten Zeichenfolge beginnen, oder um alle Dateien in einem Ordner anzuzeigen. Beispiel:

  • *.fil – Listet alle Dateien mit der Dateierweiterung „.fil“ auf (Analytics-Datendateien)Analytics
  • Inv*.* – Listet alle Dateien auf, die mit „Inv“ beginnen, unabhängig von ihrer Dateierweiterung
  • Ergebnisse\* oder Ergebnisse\*.* – Listet alle Dateien in dem Ergebnisordner auf.

Um die aufgelisteten Dateien in einem bestimmten Ordner zu begrenzen, können Sie einen relativen Pfad zum Analytics-Projektordner oder einen vollständigen Pfad angeben. Beispiel:

  • Ergebnisse\*.* – Zeigt die Inhalte des Unterordners „Ergebnisse“ im Analytics-Projektordner an.Analytics
  • C:\ACL-Daten\Ergebnisse\*.* – Zeigt die Inhalte des angegebenen Ordners an.

Hinweis

Das Platzhalterzeichen kann nicht in Zwischenbereichen eines festgelegten Dateipfads eingesetzt werden. Es lässt sich lediglich am Ende des Pfads entsprechend der obigen Darstellung verwenden.

Pfade oder Dateinamen, die Leerzeichen enthalten, müssen in Anführungszeichen gesetzt werden.

Wenn Sie Dateispezifikation verwenden, muss dies vor allen anderen Parametern angegeben werden. Falls Dateispezifikation an einer anderen Stelle erscheint, wird der DIRECTORY-Befehl nicht ausgeführt und es erscheint eine Fehlermeldung.

Wenn Sie Dateispezifikation weglassen, werden alle Dateien in dem Ordner aufgeführt, der das Analytics-Projekt enthält. Wenn Sie Dateispezifikation nicht angeben, können Sie keinen der anderen Parameter verwenden.

SUPPRESS

Optional

Unterdrückt Pfadinformationen in der Ausgabe, sodass nur Dateinamen und Eigenschaften beibehalten werden.

SUBDIRECTORY

Optional

Schließt die Inhalte der Unterordner in die Verzeichnisauflistung ein.

Wenn Dateispezifikation beispielsweise Ergebnisse\*.fil lautet, werden der Ergebnisordner und alle Unterverzeichnisse des Ergebnisordners nach .fil-Dateien durchsucht.

Je nachdem, wie viele aufzulistende Unterverzeichnisse und Dateien es gibt, kann die Verwendung von SUBDIRECTORY beim Durchsuchen der Unterverzeichnisse Verzögerungen verursachen. In Analytics wird ein Dialogfeld mit dem Fortschritt des Befehls angezeigt.

APPEND

Optional

Hängt die Befehlsausgabe an das Ende einer vorhandenen Datei an, statt die Datei zu überschreiben.

Hinweis

Vergewissern Sie sich, dass die Struktur der Befehlsausgabe und der bestehenden Datei identisch sind:

  • dieselben Felder
  • dieselbe Feldanordnung
  • abzugleichende Felder mit derselben Länge
  • abzugleichende Felder mit demselben Datentyp

Analytics hängt eine Ausgabe an eine bestehende Datei beliebiger Struktur an. Falls die Struktur der Ausgabe und der bestehenden Datei nicht übereinstimmen, kann die Datenintegrität verletzt sein, es können Daten fehlen oder falsch sein.
TO Tabellenname | Dateiname

Optional

Der Ort, an den die Ergebnisse des Befehls gesendet werden sollen:

  • Tabellenname Speichert die Ergebnisse in einer Analytics-Tabelle.

    Geben Sie Tabellenname als in Anführungszeichen gesetzte Zeichenfolge mit der Dateierweiterung „.FIL“ an. Beispiel: TO "Ausgabe.FIL"

    Standardmäßig wird die Tabellendatendatei (.FIL) im Ordner mit dem Analytics-Projekt gespeichert.

    Verwenden Sie entweder einen absoluten oder relativen Dateipfad, um die Datendatei in einen anderen bestehenden Ordner zu speichern:

    • TO "C:\Ausgabe.FIL"
    • TO "Ergebnisse\Ausgabe.FIL"

    Hinweis

    Tabellennamen sind auf 64 alphanumerische Zeichen beschränkt, was die .FIL-Dateierweiterung nicht einbezieht. Der Name kann den Unterstrich beinhalten ( _ ), aber keine anderen Sonderzeichen oder Leerzeichen. Er kann nicht mit einer Ziffer beginnen.

  • Dateiname Speichert die Ergebnisse in einer Datei.

    Geben Sie Dateiname als Zeichenfolge in Anführungszeichen mit einer geeigneten Dateierweiterung an. Beispiel: TO "Ausgabe.TXT"

    Standardmäßig wird die Datei im Ordner mit dem Analytics-Projekt gespeichert.

    Verwenden Sie entweder einen absoluten oder relativen Dateipfad, um die Datei in einen anderen bestehenden Ordner zu speichern:

    • TO "C:\Ausgabe.TXT"
    • TO "Ergebnisse\Ausgabe.TXT"

Wenn Sie TO nicht angeben, erscheint die Verzeichnisauflistung im Analytics-Anzeigebereich.

Beispiele

Unterschiedliche Optionen für die Auflistung von Dateien

Es ist hilfreich, Dateien für eine Ad-hoc-Untersuchung und für eine Aufnahme in Skripts aufzulisten.

Es folgen unterschiedliche Optionen für die Auflistung von Dateien mit dem DIRECTORY-Befehl.

Alle Dateien auflisten

Listet alle Dateien im Ordner auf, der das Analytics-Projekt enthält:

DIRECTORY

Alle Dateien im angegebenen Ordner auflisten

Listet alle .fil-Dateien (Analytics-Datendateien) im Ordner auf, der das Analytics-Projekt enthält:

DIRECTORY *.fil

Platzhalter zur Auflistung von Dateien verwenden

Listet alle Dateien, die mit „Inv“ beginnen, im Ordner auf, der das Analytics-Projekt enthält:

DIRECTORY Inv*.*

Alle Dateien in einem Unterordner relativ zum Analytics-Projektordner auflisten

Listet alle Dateien im Unterordner Ergebnisse des Ordners auf, der das Analytics-Projekt enthält:Analytics

DIRECTORY "Ergebnisse\*"

Alle Dateien im angegebenen Ordner auflisten

Listet alle Dateien im Unterordner Ergebnisse auf:

DIRECTORY "C:\ACL-Daten\Ergebnisse\*"

Alle Dateien eines bestimmten Typs in einem festgelegten Speicherort auflisten

Listet alle .fil-Dateien (Analytics-Datendateien) im angegebenen Ordner und in möglichen Unterordnern auf:

DIRECTORY "C:\ACL-Daten\Ergebnisse\*.fil" SUBDIRECTORY

Alle Dateien im angegebenen Ordner auflisten und die Liste in eine Analytics-Tabelle ausgeben

Listet alle Dateien im Ordner Ergebnisse auf und gibt die Liste in einer Analytics-Tabelle im Ordner aus, der das Analytics-Projekt enthält:AnalyticsAnalytics

DIRECTORY "C:\ACL-Daten\Ergebnisse\*" TO Ergebnisordner_Inhalt.fil

Die neue Tabelle Ergebnisordner_Inhalt wird dem offenen Projekt hinzugefügt.

Alle Dateien eines Ordners auflisten und die Liste in eine Analytics-Tabelle eines anderen Ordners ausgeben

Listet alle Dateien im Ordner ACL-Daten\Ergebnisse auf und gibt die Liste in einer Analytics-Tabelle im Ordner GL Audit 2014\Ergebnisse aus:Analytics

DIRECTORY "C:\ACL-Daten\Ergebnisse\*" TO "C:\ACL-Projekte\GL Audit 2014\Ergebnisse\Ergebnisordner_Inhalt.fil"

Die neue Tabelle Ergebnisordner_Inhalt wird dem offenen Projekt hinzugefügt. Die dazugehörige Datendatei (Ergebnisordner_Inhalt.fil) wird im spezifizierten Ausgabeordner angelegt. Dies kann, muss aber nicht der Ordner sein, der das Analytics-Projekt enthält.

Bemerkungen

Durch DIRECTORY angezeigte Eigenschaften

Der DIRECTORY-Befehl ähnelt dem DIR-Befehl unter Windows. Zusätzlich zur Auflistung von Dateien und Unterordnern in einem Ordner zeigt der DIRECTORY-Befehl auch die folgenden Datei- und Ordnereigenschaften an:

  • Dateigröße
  • Attribute
  • Erstelldatum
  • Erstellzeit
  • Zugriffsdatum
  • Zugriffszeit
  • Änderungsdatum
  • Änderungszeit
  • die Gesamtzahl der Dateien oder Ordner, die den angegebenen Kriterien entsprechen

Verwendungsmöglichkeiten von DIRECTORY in einem Skript

Wenn der DIRECTORY-Befehl in einem Skript verwendet wird, kann damit das Dateisystem untersucht werden. Zum Beispiel könnte DIRECTORY in Verbindung mit anderen Befehlen verwendet werden, um das Vorliegen oder Nichtvorhandensein bestimmter Dateien zu ermitteln, die Dateigröße zu prüfen oder Entscheidungen basierend auf anderen Dateieigenschaften zu fällen.

Die Ergebnisse von DIRECTORY ausgeben

Der Befehl kann von der Befehlszeile ausgeführt werden, um eine Verzeichnisliste anzuzeigen oder die Auflistung in einer Analytics-Tabelle oder .txt-Datei zu speichern.

Wie tabellenbasierte Ergebnisse von DIRECTORY geöffnet werden können

Der DIRECTORY-Befehl beinhaltet nicht den OPEN-Parameter. Wenn Sie den Befehl in einem Skript verwenden, die Ergebnisse in einer Analytics-Tabelle ausgeben lassen und die sich ergebende Tabelle öffnen möchten, lassen Sie dem DIRECTORY-Befehl den OPEN-Befehl folgen. Beispiel:

DIRECTORY "C:\ACL Daten\Ergebnisse\*" TO Ergebnisordner_Inhalt.fil
OPEN Ergebnisordner_Inhalt