Skriptsteuerung des DateilistenSchreibers
Dateilisten über Skripte oder über die die Kommandozeile erstellen? Das ist möglich mit dem Programm DateilistenSchreiber CL. Wie es funktioniert erklären wir Ihnen in diesem Tutorial. Wir zeigen Ihnen die ersten Schritte, die Konfigurationsmöglichkeiten sowie alle Parameter, die Sie nutzen können.
In der Skriptsteuerung des Programms stehen Ihnen alle Funktionen und Möglichkeiten für die Erstellung einer Dateiliste zur Verfügung, die Ihnen auch die grafische Benutzeroberfläche des DateilistenSchreibers bietet. So ist es zum Beispiel möglich, den DateilistenSchreiber CL in Skripte einzubinden und das Erstellen von Dateilisten zu automatisieren.
Das Tutorial ist in die folgenden Abschnitte eingeteilt:
- Allgemeine Grundlagen der Skriptsteuerung des DateilistenSchreibers CL
- Dateien und Ordner zur Dateiliste hinzufügen
- Dateilisten und Ordnerlisten
- Filter für die Dateiendung und den Dateityp
- Filter für den Dateinamen
- Spalten und deren Reihenfolge
- Sortierung der Dateiliste
- Speicherformat der Dateiliste
- Datum und Uhrzeit in den Dateinamen der Dateiliste schreiben
- Listeneigenschaften in den Dateinamen der Dateiliste schreiben
- Dateiliste nach dem Speichern öffnen
- Ausgabe der Dateiliste in der Konsole
- Verwendung von Einstellungsdateien
- Kombinierte Anwendung von Einstellungsdateien und Parametern
- Übersicht über alle verfügbaren Parameter
- Übersicht über die Parameter für Spalten
- Übersicht über alle Platzhalter für den Dateinamen
- Download des DateilistenSchreibers CL
Allgemeine Grundlagen der Skriptsteuerung des DateilistenSchreibers CL
Bevor wir uns die einzelnen Funktionen und Parameter im Detail ansehen, möchten wir uns zunächst anhand des folgenden Beispiels mit den Grundlagen der Skriptsteuerung des DateilistenSchreibers CL vertraut machen:
FilelistCreator.exe -cl C:\Ordner cols=name,size save=C:\DateiListe.xlsx
Mit diesem Aufruf erstellen wir eine Dateiliste, die alle Dateien aus dem Ordner "C:\Ordner" enthält und aus den beiden Spalten "Name" und "Dateigröße" besteht. Die Dateiliste speichern wir als Excel-Dokument unter dem Namen "C:\DateiListe.xlsx".
Schauen wir uns die einzelnen Parameter im Detail an:
- Mit dem Parameter "-cl", der für "command line" steht, versetzen wir den DateilistenSchreiber CL zunächst in den Batch-Modus. Dieser Parameter sagt dem Programm, dass es ohne grafische Benutzeroberfläche starten und die folgenden Parameter verarbeiten soll. Falls wir diesen Parameter weglassen würden, würde der DateilistenSchreiber wie gewohnt mit grafischer Benutzeroberfläche starten und die restlichen Parameter (außer die Datei- und Ordnernamen, die in diesem Falle im Programm geöffnet würden) blieben wirkungslos.
- Als zweiten Parameter übergeben wir den Pfad zu einem Ordner. Alle in dieser Form aufgeführten Ordner und Dateien werden zu unserer Dateiliste hinzugefügt. Wir können auch mehrere Ordner und/oder Dateien hintereinander angeben. Mehr zu diesem Thema erfahren Sie im nächsten Abschnitt über das Hinzufügen von Dateien und Ordnern.
- Mit dem Parameter "cols", den wir hier als dritten Parameter übergeben, können wir bestimmen, welche Spalten unsere Dateiliste umfassen soll. In unserem Beispiel sind das die Spalten "name" (Dateiname) und "size" (Dateigröße). Eine Übersicht über alle Parameter für Spalten, die Sie hier verwenden können, finden Sie in der Tabelle "Übersicht der Parameter für Spalten" am Ende dieses Tutorials. Mehr über den Parameter "cols" erfahren Sie im Abschnitt "Spalten und deren Reihenfolge".
- Zuletzt geben wir über den Parameter "save" an, wie und wo unsere Dateiliste gespeichert werden soll. In unserem Fall geben wir einen Dateipfad zur Datei "C:\DateiListe.xlsx" an. Anhand der Dateiendung "XLSX" weiß der DateilistenSchreiber, dass die Dateiliste im XLSX-Format für Excel gespeichert werden soll. Mehr zu den verfügbaren Speicherformaten erfahren Sie im Abschnitt über das Speicherformat der Dateiliste. Alternativ können Sie die Dateiliste auch direkt in der Konsole ausgegeben lassen. Mehr dazu im Abschnitt "Ausgabe der Dateiliste in der Konsole".
In den nächsten Abschnitten erklären wir Ihnen diese und weitere Parameter im Detail und mit zahlreichen Beispielen. Am Ende des Tutorials finden Sie darüber hinaus eine Übersichtstabelle mit einer Kurzbeschreibung aller Parameter einschließlich ihrer Default-Werte, die verwendet werden, wenn Sie den betreffenden Parameter nicht selber setzen.
Alternativ zu der Konfiguration Ihrer Dateiliste über einzelne Parameter können Sie Ihre Dateiliste auch über die grafische Benutzeroberfläche des DateilistenSchreibers konfigurieren, die Konfiguration als Einstellungsdatei speichern und dem DateilistenSchreiber CL nur den Pfad zu dieser Einstellungsdatei übergeben:
FilelistCreator.exe -cl C:\Ordner C:\Einstellungen.fls save=C:\DateiListe.txt
In diesem Beispiel haben wir die Einstellungen des Programms unter "C:\Einstellungen.fls" abgespeichert und übergeben ansonsten lediglich die zu listenden Dateien (hier der Inhalt aus "C:\Ordner") sowie die Exportdatei (hier "C:\DateiListe.txt"). Mehr dazu erfahren Sie im Abschnitt über die Nutzung von Einstellungsdateien.
Dateien und Ordner zur Dateiliste hinzufügen
Um einzelne oder mehrere Dateien und Ordner über die Befehlszeile zu Ihrer Dateiliste hinzuzufügen, übergeben Sie dem Programm einfach deren Pfade.
Die nächsten beiden Aufrufe demonstrieren, wie Sie eine beziehungsweise drei einzelne Dateien zu einer Dateiliste hinzufügen und im Textformat abspeichern können:
FilelistCreator.exe -cl C:\Datei.txt cols=name save=C:\DateiListe1.txt
FilelistCreator.exe -cl C:\Datei1.txt C:\Datei2.txt C:\Datei3.txt cols=name save=C:\DateiListe2.txt
Statt den einzelnen Dateien können Sie in der gleichen Weise auch Ordner übergeben. Dies zeigen die nächsten beiden Beispielaufrufe, in denen wir einen beziehungsweise zwei Ordner übergeben, deren Dateien auf diese Weise zur Dateiliste hinzugefügt werden:
FilelistCreator.exe -cl C:\Ordner cols=name save=C:\DateiListe1.txt
FilelistCreator.exe -cl C:\Ordner1 C:\Ordner2 cols=name save=C:\DateiListe2.txt
Natürlich können wir auch Ordner und Dateien gemeinsam übergeben. Der folgende Aufruf erstellt eine Liste aus allen Dateien aus dem Ordner "C:\Ordner" sowie der Einzeldatei "C:\Datei.pdf":
FilelistCreator.exe -cl C:\Ordner C:\Datei.pdf cols=name save=C:\DateiListe.xlsx
Beim Übergeben eines Ordnerpfades stellt sich die Frage, ob nur die Dateien hinzugefügt werden sollen, die sich direkt in dem betreffenden Ordner befinden, oder auch Dateien, die sich in Unterordnern des übergebenen Ordners befinden. Dieses Verhalten lässt sich mit dem Parameter "search-subdirs" steuern, mit dem Sie einen der beiden Werte "1" (ja) oder "0" (nein) übermitteln können:
FilelistCreator.exe -cl C:\Ordner search-subdirs=0 cols=name save=C:\DateiListeOhneUnterordner.txt
FilelistCreator.exe -cl C:\Ordner search-subdirs=1 cols=name save=C:\DateiListeMitUnterordnern.txt
In beiden Aufrufen möchten wir eine Liste der Dateien aus dem Ordner "C:\Ordner" erstellen. Im ersten Aufruf sollen nur die Dateien aufgeführt werden, die sich direkt in dem Ordner befinden. Dateien aus Unterordnern sollen nicht gelistet werden. Deswegen übergeben wir den Parameter "search-subdirs=0". Anders verhält es sich mit dem zweiten Aufruf. Hier übergeben wir "search-subdirs=1" und fügen damit auch alle Dateien aus Unterordnern zu unserer Dateiliste hinzu. Falls wir den Parameter "search-subdirs" auslassen (wie in unseren bisherigen Beispielen), wird standardmäßig der Wert "1" verwendet - standardmäßig werden also Dateien aus Unterordnern immer hinzugefügt.
Dateilisten und Ordnerlisten
In der GUI-Version des DateilistenSchreibers können Sie unter "Einbeziehen" bestimmen, ob nur Dateien oder auch Ordner als solche in die Dateiliste aufgenommen werden sollen. Dies ist natürlich auch in der CL-Version des DateilistenSchreibers möglich und kann mit den Parametern "add-files" sowie "add-folders" gesteuert werden, die einen der beiden Werte "1" (ja) oder "0" (nein) annehmen können.
Eine reine Ordnerliste ohne Dateien kann entsprechend mit der Übergabe eines Ordners oder mehrerer Ordner sowie den Parametern "add-files=0" und "add-folders=1" erstellt werden, wie das folgende Beispiel demonstriert:
FilelistCreator.exe -cl C:\Ordner add-files=0 add-folders=1 cols=name,filecount_direct save=C:\OrdnerListe.txt
Dieses Beispiel liefert uns eine Liste aller Ordner, die sich im Ordner "C:\Ordner" befinden mit den beiden Spalten "Name des Ordners" sowie "Anzahl der Dateien im jeweiligen Ordner".
Wenn wir sowohl Ordner als auch Dateien gemeinsam listen möchten, setzen wir beide Parameter auf "1" (ja):
FilelistCreator.exe -cl C:\Ordner add-files=1 add-folders=1 cols=name,size save=C:\OrdnerUndDateiListe.txt
Standardmäßig, also wenn wir keinen der beiden Parameter explizit angeben, werden die Werte "add-files=1" und "add-folders=0" verwendet. Bei der Übergabe eines Ordners werden also nur die enthaltenen Dateien gelistet, nicht aber der Ordner selber. Dies entspricht dem folgenden Aufruf:
FilelistCreator.exe -cl C:\Ordner add-files=1 add-folders=0 cols=name save=C:\DateiListe.txt
Wenn wir in diesem Aufruf die Parameter "add-files=1" und "add-folders=0" weglassen würden, würden wir also dasselbe Ergebnis erhalten.
Die Einstellungen, ob Dateien und/oder Ordner in die Dateiliste aufgenommen werden sollen, können statt über die Parameter "add-files" und "add-folders" auch über die grafische Benutzeroberfläche des DateilistenSchreibers konfiguriert und anschließend über Einstellungsdateien übergeben werden. Wie das funktioniert erfahren Sie im Abschnitt über die Nutzung von Einstellungsdateien.
Filter für die Dateiendung und den Dateityp
In allen unseren bisherigen Beispielen haben wir immer den kompletten Inhalt eines Ordners zu unserer Dateiliste hinzugefügt. Es gibt allerdings viele Situationen, in denen wir nur bestimmte Dateien aus einem Ordner in unsere Liste aufnehmen möchten, ohne diese Dateien alle einzeln aufzählen zu wollen oder zu können. In diesem Fall können wir uns der Filter-Parameter des DateilistenSchreibers CL bedienen, wie das nächste Beispiel zeigt:
FilelistCreator.exe -cl C:\Musik filter-ext=mp3/flac cols=name,audio_duration save=C:\Musik.csv
Hier möchten wir eine Liste unserer Musiksammlung erstellen. Wir übergeben den Ordner "C:\Musik", der allerdings auch andere Dateien wie Albumcover oder Playlists enthalten kann. Diese Dateien möchten wir nicht in unserer Liste aufgeführt haben und übergeben daher den Parameter "filter-ext=mp3/flac". Mit diesem Parameter können wir eine oder mehrere Dateiendungen definieren, die unsere Dateien haben dürfen. Mit diesen Aufruf erhalten wir demnach eine Liste aller MP3- und FLAC-Dateien aus unserem Ordner. Wir speichern die Liste mit den Spalten "name" (Dateiname) und "audio_duration" (Spieldauer) im CSV-Format unter dem Namen "C:\Musik.csv" ab.
Wenn unsere Musiksammlung nicht nur aus MP3s und FLACs besteht, sondern auch andere Formate wie beispielsweise WAV, WMA, M4A, AC3 oder MKA enthalten kann, kann es kompliziert werden, alle Dateiendungen einzeln aufzuführen. In diesem Fall hilft uns der Filter für den Dateityp "filter-type" weiter, den wir folgendermaßen verwenden können:
FilelistCreator.exe -cl C:\Musik filter-type=audio cols=name,audio_duration save=C:\Musik.csv
Mit dem Parameter "filter-type=audio" erstellen wir eine Liste beliebiger Audiodateien. Weitere Parameter für den Dateityp sind "image", "video", "text", "document", "spreadsheet", "website", "font", "executable", "archive", "playlist", "sourcecode" und "other". Es können auch mehrere Typen miteinander kombiniert werden:
FilelistCreator.exe -cl C:\Media filter-type=audio,video,image cols=path save=C:\Media.csv
Dieser Aufruf erstellt beispielsweise eine Liste aller Audio-, Video- und Bilddateien aus dem Ordner "C:\Media" und speichert die Liste als "C:\Media.csv".
Filter für den Dateinamen
Neben der Dateiendung und dem Dateityp, deren Filter wir uns im letzten Abschnitt angesehen haben, können wir die Dateien auch nach deren Namen filtern. Das geht mit dem Parameter "filter-name", den wir, wie im nächsten Beispiel gezeigt, verwenden können:
FilelistCreator.exe -cl C:\Medien filter-type=video filter-name=Bond cols=name,video_duration save=C:\JamesBondFilme.txt
Mit diesem Aufruf möchten wir eine Dateiliste aller Videos aus dem Ordner "C:\Medien" erstellen, deren Dateiname den Text "Bond" enthält. Dafür kombinieren wir die beiden Filter "filter-type=video" (nur Videodateien) sowie "filter-name=Bond" (nur Dateien, die den Text "Bond" im Dateinamen tragen). Wir speichern die Liste im TXT-Format unter dem Namen "C:\JamesBondFilme.txt".
Der Filter "filter-name" kann mit den drei Parametern "filter-name-matchcase", "filter-name-matchall" sowie "filter-name-regex" kombiniert werden. Damit bestimmen wir, ob die Groß- und Kleinschreibung des Suchtextes beachtet werden soll, ob der gesamte Dateiname dem Suchtext entsprechen soll beziehungsweise ob der Suchtext als regulärer Ausdruck interpretiert werden soll. Standardmäßig ist jeder der drei Parameter deaktiviert. Wenn Sie also keinen der Parameter explizit aktivieren, wird unabhängig von der Groß- und Kleinschreibung gesucht, es reicht aus falls der Suchtext lediglich im Dateinamen vorkommt und der Suchtext wird nicht als regulärer Ausdruck interpretiert.
Das folgende Beispiel demonstriert die Nutzung von "filter-name-matchcase". Wir möchten eine Liste aller Audio-Dateien (filter-type=audio) aus dem Ordner "C:\Medien" erstellen, die den Text "Live" im Dateinamen enthalten. Wir möchten allerdings ausschließen, dass Dateien gefunden werden, die "live" (zum Beispiel als Teil von "Alive") im Namen tragen. Deswegen verwenden wir die Parameter "filter-name=Live" in der Kombination mit "filter-name-matchcase=1". Als Spalten definieren wir den Namen und das Genre der Audio-Datei und speichern die Dateiliste als Textdatei unter dem Namen "GenreLiveAufnahmen.txt":
FilelistCreator.exe -cl C:\Medien filter-type=audio filter-name=Live filter-name-matchcase=1 cols=name,audio_genre save=C:\GenreLiveAufnahmen.txt
Das nächste Beispiel demonstriert die Verwendung von regulären Ausdrücken. Dieses Mal möchten wir eine Liste von Bildern (filter-type=image) erstellen, die im Dateinamen eine Jahreszahl zwischen 2010 und 2019 enthalten. Dafür nutzen wir den regulären Ausdruck 201[0-9], der jeden Text matcht, der mit 201 beginnt und mit einer beliebigen Ziffer endet. Damit dieser Text als regulärer Ausdruck interpretiert und nicht der Text als solcher gesucht wird, übergeben wir zusätzlich "filter-name-regex=1". Als Spalten definieren wir den Namen der Datei und das Erstellungsdatum und speichern die Dateiliste als HTML-Dokument unter dem Namen "Bilder2010-2019.html":
FilelistCreator.exe -cl C:\Medien filter-type=image filter-name=201[0-9] filter-name-regex=1 cols=name,date_created save=C:\Bilder2010-2019.html
Auch für den dritten Parameter "filter-name-matchall" möchten wir uns ein Beispiel ansehen. Mit dem folgenden Aufruf listen wir alle Textdateien, deren Namen ausschließlich aus Ziffern bestehen:
FilelistCreator.exe -cl C:\Texte filter-type=text filter-name=[0-9]+ filter-name-regex=1 filter-name-matchall=1 cols=name save=C:\NumFileNames.txt
Dafür nutzen wir den regulären Ausdruck [0-9]+ (beliebig lange Zahl aus mindestens einer Ziffer von 0 bis 9) in Kombination mit filter-name-matchall=1. Würden wir filter-name-matchall=1 weglassen oder filter-name-matchall=0 schreiben, würden auch Dateien gefunden werden, die neben anderen Zeichen lediglich eine Zahl enthalten.
Natürlich können wir auch alle drei Parameter zusammen verwenden, zum Beispiel um reguläre Ausdrücke unter Berücksichtigung der Groß- und Kleinschreibung für unsere Dateisuche nach kompletten Dateinamen zu verwenden.
Mehrere Suchwörter können separiert mit einem Schrägstrich gelistet werden. Das folgende Beispiel erstellt eine Liste aller Dateien, die entweder "abc" oder "def" heißen.
FilelistCreator.exe -cl C:\Ordner filter-name=abc/def filter-name-matchall=1 cols=name save=C:\Liste.txt
Würden wir den Parameter "filter-name-matchall=1" weglassen, würden auch alle Dateien gelistet, deren Namen entweder den Text "abc" oder den Text "def" lediglich enthalten.
Die Filter-Einstellungen, unabhängig davon ob es sich um die Filter für die Dateiendung, den Dateitypen oder den Dateinamen handelt, können statt über die hier vorgestellten Parameter auch über die grafische Benutzeroberfläche des DateilistenSchreibers konfiguriert und anschließend über Einstellungsdateien übergeben werden. Wie das funktioniert erfahren Sie im Abschnitt über die Nutzung von Einstellungsdateien.
Spalten und deren Reihenfolge
Neben den enthaltenen Dateien und Ordnern, deren Auswahlmöglichkeiten wir uns in den letzten Abschnitten angesehen haben, besteht der zweitwichtigste Bestandteil von Dateilisten aus den Spaltentypen der Tabelle beziehungsweise der Liste. Wie wir bereits in allen bisherigen Beispielen gesehen haben, lassen sich die gewünschten Spalten über den Parameter "cols" definieren.
Ein Beispiel dafür sehen wir in dem folgenden Aufruf, mit dem wir eine Liste aller Dateien aus dem Ordner "C:\Musik" erstellen und als "C:\MeineMusik.xlsx" in Form eines Excel-Spreadsheets abspeichern:
FilelistCreator.exe -cl C:\Musik cols=audio_artist,
Mit der Hilfe des Parameters "cols" definieren wir hier für unsere Liste die Spalten Interpret, Titel, Album, Tracknummer, Spieldauer, Jahr, Genre sowie den Dateipfad zur betreffenden Datei in genau dieser Reihenfolge. Die Reihenfolge der Spalten richtet sich demnach immer genau nach der Reihenfolge, in der die Parameter der Spalten im Parameter "cols" definiert sind. Die Parameter der einzelnen Spalten müssen darüber hinaus getrennt durch ein Komma aufgelistet werden.
Alle verfügbaren Parameter für die Spalten haben wir für Sie in der Übersichtstabelle aller Parameter für Spalten am Ende dieses Tutorials zusammengestellt. In der aktuellen Version des DateilistenSchreibers CL sind über 70 verschiedene Spalten verfügbar, die Sie in einer beliebigen Zusammenstellung und in einer beliebigen Reihenfolge für Ihre Dateilisten verwenden können. Allein für Audio-Dateien sind über 10 Spaltenparameter verfügbar. Neben den Spalten aus dem Beispiel sind beispielsweise noch die Spalten audio_discnumber, audio_comment, audio_samplerate, audio_bitrate und audio_channels verfügbar.
Sortierung der Dateiliste
In unseren bisherigen Beispielen haben wir uns noch keine Gedanken darüber gemacht, in welcher Reihenfolge die Dateien und Ordner in unserer Dateiliste auftauchen. Steuern können wir dies über den Parameter "sort", mit dem wir sowohl eine Spalte, nach der sortiert werden soll, als auch die Richtung der Sortierung, definieren können. Wie das funktioniert schauen wir uns in den nächsten Beispielen an:
FilelistCreator.exe -cl C:\Ordner cols=name,size,path sort=name save=C:\Dateiliste1.xlsx
FilelistCreator.exe -cl C:\Ordner cols=name,size,path sort=path-up save=C:\Dateiliste2.xlsx
FilelistCreator.exe -cl C:\Ordner cols=name,size,path sort=size-down save=C:\Dateiliste3.xlsx
Mit allen drei Aufrufen erstellen wir jeweils eine Dateiliste der Dateien aus dem Ordner "C:\Ordner" mit den drei Spalten Name, Größe und Pfad. Der Unterschied dieser drei Dateilisten liegt in deren Sortierung. Die erste Liste ist aufsteigend sortiert nach der Spalte "Name", die zweite Liste ist aufsteigend sortiert nach der Spalte "Pfad" und die dritte Liste ist absteigend sortiert nach der Dateigröße.
Die Parameter "name", "path" und "size" stammen aus der Tabelle "Parameter für Spalten", in der Sie für jede der über 70 Spalten des DateilistenSchreibers den jeweiligen Parameter finden, den Sie an dieser Stelle verwenden können. Die gewünschte Richtung der Sortierung kann mittels "-up" (aufsteigend) oder "-down" (absteigend) an den Spaltenparameter angehängt werden. Falls kein Richtungsparameter definiert ist, wie in unserem ersten Beispiel, wird standardmäßig aufsteigend sortiert. Falls der Parameter "sort" gar nicht definiert ist, erscheinen die Dateien in der Reihenfolge in der Dateiliste, wie sie hinzugefügt wurden.
Die Spalte, nach der sortiert werden soll, muss übrigens nicht zwingend auch in der Dateiliste selber enthalten sein. Ein Beispiel dafür ist dieser Aufruf:
FilelistCreator.exe -cl C:\Ordner cols=name,size,path sort=date_modified-down save=C:\Dateiliste4.xlsx
Obwohl unsere Dateiliste nur die Spalten Name, Größe und Dateipfad enthält, sortieren wir absteigend nach dem letzten Änderungsdatum der Dateien. In der resultierenden Liste wird also die Datei, die als letztes bearbeitet wurde ganz oben erscheinen.
Darüber hinaus ist natürlich auch die Sortierung nach formatsspezifischen Spalten möglich, wie die nächsten drei Aufrufe zeigen:
FilelistCreator.exe -cl C:\Ordner cols=name,video_duration sort=video_duration save=C:\Dateiliste5.xlsx
FilelistCreator.exe -cl C:\Ordner cols=name,text_wordcount sort=text_wordcount save=C:\Dateiliste6.xlsx
FilelistCreator.exe -cl C:\Ordner filter-ext=pdf cols=name,document_author sort=document_author save=C:\Dateiliste7.xlsx
Der erste Aufruf sortiert die Videodateien in der Dateiliste nach deren Spieldauer, der zweite Aufruf die Textdateien nach der Anzahl der darin enthaltenen Wörter und der dritte Aufruf beschränkt die Dateiliste mit dem Filter für die Dateiendung auf PDF-Dokumente und sortiert nach deren Autor.
Speicherformat der Dateiliste
Wenn Sie keine abweichenden Einstellungen vornehmen, ergibt sich das Format, in dem die Dateiliste abgespeichert wird, durch die Dateiendung der Datei für die Speicherung der Dateiliste. Wie wir schon in allen bisherigen Beispielen dieses Tutorials gesehen haben, wird diese Exportdatei mit dem save-Parameter festgelegt. Also zum Beispiel:
FilelistCreator.exe -cl C:\Ordner cols=name,date_created,size,path save=C:\Dateiliste.txt
FilelistCreator.exe -cl C:\Ordner cols=name,date_created,size,path save=C:\Dateiliste.csv
FilelistCreator.exe -cl C:\Ordner cols=name,date_created,size,path save=C:\Dateiliste.xlsx
FilelistCreator.exe -cl C:\Ordner cols=name,date_created,size,path save=C:\Dateiliste.ods
FilelistCreator.exe -cl C:\Ordner cols=name,date_created,size,path save=C:\Dateiliste.html
FilelistCreator.exe -cl C:\Ordner cols=name,date_created,size,path save=C:\Dateiliste.png
Jeder dieser sechs Aufrufe erstellt eine Dateiliste der Dateien aus dem Ordner "C:\Ordner" mit den vier Spalten Name, Erstellungsdatum, Dateigröße sowie Dateipfad. Über den Parameter "save" haben wir jedoch sechs verschiedene Exportformate durch voneinander abweichende Dateiendungen definiert. Der erste Aufruf speichert die Dateiliste als simple Textdatei (TXT), der zweite Aufruf als Comma-Separated Values (CSV), der dritte als Excel-Spreadsheet (XLSX), der vierte als Open Document Spreadsheet (ODS), der fünfte als HTML-Website und der letzte als Bild im PNG-Format. Unterstützt werden die Formate beziehungsweise Dateiendungen txt, csv, xlsx, ods, dif, htm, html, bmp, png, gif, jpg und jpeg.
Wenn das Format nicht durch die Dateiendung ersichtlich ist, können Sie das Format alternativ auch durch den Parameter "format" festlegen, der ebenfalls die Werte txt, csv, xlsx, ods, dif, htm, html, bmp, png, gif, jpg und jpeg annehmen kann:
FilelistCreator.exe -cl C:\Ordner cols=name,size format=csv save=C:\Dateiliste.dat
Hier möchten wir unsere Dateiliste unter dem Namen "C:\Dateiliste.dat" abspeichern. Durch die Dateiendung "DAT" geht jedoch kein eindeutiges Format hervor, so dass wir das Speicherformat durch den Parameter "format=csv" festgelegt haben. Wir erhalten also eine CSV-Datei mit der Dateiendung DAT.
Den format-Parameter können wir auch nutzen, um ein bestimmtes Speicherformat unabhängig von der Dateiendung zu erzwingen. Ein Beispiel wäre der folgende Aufruf, der trotz der Dateiendung "TXT" der Exportdatei das Format "CSV" erzwingt:
FilelistCreator.exe -cl C:\Ordner cols=name,size format=csv save=C:\Dateiliste.txt
Für diesen Aufruf erhalten wir demnach eine CSV-Datei mit der Dateiendung TXT. Ohne "format=csv" würde dieser Aufruf zu einer Speicherung als Textdatei führen.
Bei einer Speicherung der Dateiliste in einem Textformat wie TXT, CSV oder HTML können Sie darüber hinaus die Parameter "enc", "bom", "lb" und "fs" ergänzen, um Einfluss auf die Kodierung, die Byte Order Mark (BOM) und den verwendeten Zeilenumbruchtyp sowie das verwendete Feldtrennungszeichen der Datei zu nehmen. Standardmäßig, also wenn Sie keinen dieser drei Parameter explizit definieren, wird als UTF-8 ohne BOM mit dem System-Zeilenumbruch-Typ (CRLF für Windows) gespeichert. Als Feldtrennungszeichen für CSV-Dateien wird je nach Systemeinstellungen standardmäßig das Semikolon oder das Komma verwendet. Über die vier Parameter können diese Standardwerte je nach Bedarf überschrieben werden:
FilelistCreator.exe -cl C:\Ordner cols=name,size save=C:\Dateiliste.txt bom=1
FilelistCreator.exe -cl C:\Ordner cols=name,size save=C:\Dateiliste.txt lb=lf
FilelistCreator.exe -cl C:\Ordner cols=name,size save=C:\Dateiliste.txt enc=utf16le bom=1
FilelistCreator.exe -cl C:\Ordner cols=name,size save=C:\Dateiliste.csv lb=crlf fs=tab
Der erste Aufruf speichert die Dateiliste als UTF-8 mit BOM und dem Systemzeilenumbruch (nur der BOM-Parameter wird gesetzt, ENC und LB bleiben auf ihrem Default-Wert). Der zweite Aufruf speichert die Dateiliste als UTF-8 ohne BOM (die Default-Werte) mit LF-Zeilenumbruch (Linux, macOS). Der dritte Aufruf speichert die Dateiliste in der Kodierung UTF-16 Little Endian mit BOM und unter Verwendung des Systemzeilenumbruchs (der Default-Wert). Der letzte Aufruf speichert die Dateiliste als CSV-Datei mit einem Tab als Feldbegrenzungszeichen (fs=tab) sowie einem CRLF-Zeilenumbruch als Zeilenbegrenzer (lb=crlf).
Eine Übersicht über alle verwendbaren Parameter für die verschiedenen Kodierungen und Zeilenumbruchtypen finden Sie in der Übersichtstabelle der Parameter unter "enc" und "lb". Der Parameter "bom" akzeptiert die Werte "1" (ja) oder "0" (nein).
Wenn Sie den Parameter "save" weglassen und keine Exportdatei definieren, erfolgt die Ausgabe der Dateiliste direkt in der Konsole. Mehr dazu erfahren Sie im Abschnitt über die Ausgabe von Dateilisten in der Konsole.
Datum und Uhrzeit in den Dateinamen der Dateiliste schreiben
Wenn wir die Erstellung von Dateilisten über Skripte automatisieren, kann es nützlich sein, einen dynamischen Dateinamen zu verwenden, zum Beispiel indem wir immer das aktuelle Datum und/oder die aktuelle Uhrzeit in den Dateinamen hineinschreiben. Bei regelmäßiger Ausführung des Skripts und gleichzeitiger Verwendung eines statischen Dateinamens kann es ansonsten dazu führen, dass wir mit jeder neuen Listenerstellung die letzte Dateiliste überschreiben. Ist dies nicht gewünscht, ermöglicht die Einfügung des aktuellen Datums, gegebenenfalls in Kombination mit der aktuellen Uhrzeit, einen immer eindeutigen Dateinamen.
Zu diesem Zweck stellt Ihnen der DateilistenSchreiber einige Platzhalter für das aktuelle Datum und die aktuelle Uhrzeit zur Verfügung, die Sie in beliebiger Weise und in Kombination mit beliebigen anderen Zeichen in den Dateinamen einfügen können. Eine Übersichtstabelle aller zur Verfügung stehenden Platzhalter finden Sie am Ende dieses Tutorials unter der Überschrift Platzhalter für den Dateinamen.
Das aktuelle Datum können Sie mit dem Platzhalter %date% einfügen:
FilelistCreator.exe -cl C:\Ordner cols=name,size save=C:\Dateiliste_%%date%%.xlsx
Der aktuelle Zeit liefert uns der Platzhalter %time%:
FilelistCreator.exe -cl C:\Ordner cols=name,size save=C:\Dateiliste_%%date%%_%%time%%.xlsx
Das %-Zeichen müssen wir in den Skriptaufrufen verdoppeln, damit die Platzhalter nicht als Variablen interpretiert werden.
Der Platzhalter %date% liefert uns das aktuelle Datum im Format "Jahr-Monat-Tag" mit führenden Nullen für Monat und Tag (für einstellige Monate oder Tage). %time% liefert uns die aktuelle Zeit im Format "Stunde-Minute" ebenfalls mit führenden Nullen. Falls Sie eine andere Formatierung, Kombination oder Reihenfolge der einzelnen Bestandteile wünschen, finden Sie in der Übersichtstabelle genügend andere Platzhalter für jede Situation. Zwei weitere Beispiele dafür sehen Sie hier:
FilelistCreator.exe -cl C:\Ordner cols=name,size save=C:\%%yyyy%%-%%mm%%.xlsx
FilelistCreator.exe -cl C:\Ordner cols=name,size save=C:\%%date%%-%%hh-mm-ss%%.xlsx
Der erste dieser beiden Aufrufe schreibt das Datum beispielsweise nur in der Form "Jahr-Monat" und verzichtet dabei auf den Tag, der zweite Aufruf gibt die Zeit inklusive der Sekunden aus (statt ohne Sekunden mit %time%).
Natürlich können die Platzhalter für das Datum und die Zeit nicht nur im Dateinamen sondern auch im Dateipfad verwendet werden. Ein Beispiel dafür ist der folgende Aufruf des DateilistenSchreibers:
FilelistCreator.exe -cl C:\Ordner cols=name,size save=C:\%%yyyy%%\%%mm%%\%dd%_%%time%%.xlsx
Mit diesem Aufruf erstellen wir jeweils einen Ordner für das aktuelle Jahr und darin einen weiteren Ordner für den aktuellen Monat. In diesem Ordner speichern wir die Dateiliste schließlich unter einem Namen, der Tag und Zeit der Speicherung enthält. Bei wiederholten über Jahre andauernden Aufrufen dieser Art erhalten wir unsere Dateilisten ordentlich sortiert nach Jahr und Monat in der angesprochenen Ordnerstruktur.
Listeneigenschaften in den Dateinamen der Dateiliste schreiben
Neben den Platzhaltern für das aktuelle Datum und die aktuelle Uhrzeit verfügt der DateilistenSchreiber über weitere Platzhalter, mit denen Sie Eigenschaften Ihrer Dateiliste in den Dateinamen aufnehmen können. Zu dieser Gruppe von Platzhaltern, die Sie ebenfalls in der Übersichtstabelle aller Platzhalter für den Dateinamen finden können, zählen Platzhalter für die Anzahl der Dateien in der Liste, die Gesamtspieldauer aller gelisteten Audio- und Videodateien sowie für die Anzahl aller Zeilen, Zeichen und Wörter von Textdateien. In den nächsten Beispielen möchten wir uns all diese Platzhalter ansehen.
In unserem ersten Beispiel möchten wir die Platzhalter für die Gesamtanzahl der Dateien in der Liste (%total_files%) sowie die Gesamtdateigröße aller Dateien in der Liste (%total_size%) präsentieren:
FilelistCreator.exe -cl C:\Ordner cols=name,size "save=C:\Dateiliste mit %%total_files%% Dateien (%%total_size%%).xlsx"
Ein möglicher Dateiname, der durch diesen Aufruf generiert werden könnte, könnte "Dateiliste mit 100 Dateien (20 MB).xlsx" lauten.
Mit dem nächsten Aufruf möchten wir eine Liste unserer Videodateien (filter-type=video) erstellen. Neben dem Dateinamen (Spalte name) schreiben wir in die zweite Spalte unserer Dateiliste die Spieldauer der einzelnen Videos (Spalte video_duration). Im Dateinamen nutzen wir die Platzhalter %total_files% und %total_duration% um die Gesamtanzahl der Videos sowie die Gesamtspieldauer aller Videos der Liste in den Dateinamen aufzunehmen:
FilelistCreator.exe -cl C:\Ordner filter-type=video cols=name,video_duration "save=C:\Meine Videos (%%total_files%% Dateien, %%total_duration%% Spieldauer).xlsx"
Zuletzt möchten wir uns ein Beispiel auch für die Platzhalter für die Gesamtanzahl der Zeilen, Zeichen und Wörter von Textdateien ansehen:
FilelistCreator.exe -cl C:\Ordner filter-ext=txt cols=name,
Dieser Aufruf erstellt uns eine Liste aller Textdateien mit der Dateiendung "TXT" (filter-ext=txt) aus dem Ordner "C:\Ordner" und listet für jede der einzelnen Dateien den Namen sowie die jeweilige Anzahl von Zeilen, Zeichen, Wörtern und ersten Zeichen der Datei. Die Gesamtanzahl der Dateien, Zeilen, Zeichen und Wörter schreiben wir mit den Parametern %total_files%, %total_lines%, %total_chars% und %total_words% in den Dateinamen.
Dateiliste nach dem Speichern öffnen
Ob eine Dateiliste, die über einen Skriptaufruf des DateilistenSchreibers CL erstellt wurde, direkt nach dem Speichern automatisch geöffnet wird oder nicht, kann über den Parameter "openfile" festgelegt werden. Ein Beispiel für die Verwendung von "openfile" ist der folgende Aufruf des Programms:
FilelistCreator.exe -cl C:\Ordner cols=path,checksum_md5 save=C:\MD5.csv openfile=1
Mit diesem Aufruf erstellen wir eine Liste der Pfade und MD5-Prüfsummen aller Dateien aus dem Ordner "C:\Ordner", speichern die Liste als "C:\MD5.csv" und öffnen die Datei direkt nach dem Erstellen automatisch über das im Betriebsystem hinterlegte Standardprogramm für CSV-Dateien.
Für das Öffnen sorgt die Übergabe des Parameters "openfile=1". Standardmäßig, also wenn wir den Parameter "openfile=1" nicht explizit angeben, findet keine Öffnung der Dateiliste statt. Dies entspricht dem Parameter "openfile=0".
Ausgabe der Dateiliste in der Konsole
In sämtlichen unserer bisherigen Beispiele haben wir unsere Dateiliste immer über den save-Parameter als Datei abgespeichert. Alternativ können wir die Dateiliste jedoch auch direkt in der Konsole ausgeben. Das einzige, was wir dafür an unseren Aufrufen ändern müssen, ist den save-Parameter, über den die Exportdatei definiert wird, wegzulassen:
FilelistCreator.exe -cl C:\Ordner filter-ext=txt cols=path,text_encoding,text_linebreaktype
Dieser Aufruf liefert uns eine Übersicht der Kodierung und des Zeilenumbruchtyps aller Textdateien mit der Dateiendung "TXT" aus dem Ordner "C:\Ordner" direkt in die Konsole.
Standardmäßig wird die Dateiliste in der Konsole im Textformat ausgegeben. Wir können dieses Format aber über den format-Parameter überschreiben, den wir bereits im Abschnitt über das Speicherformat der Dateiliste als Datei kennengelernt haben. Ein Beispiel ist der folgende Aufruf, in dem wir die Kodierung und das Vorhandensein einer Byte Order Mark in Textdateien im CSV-Format innerhalb der Konsole ausgeben, indem wir den Parameter "format=csv" übergeben:
FilelistCreator.exe -cl C:\Ordner filter-ext=txt cols=path,text_encoding,text_bom format=csv
Im Konsolen-Modus werden aktuell die Formate txt, csv, dif, htm und html unterstützt. Die anderen Formate wie Bilder (BMP, PNG, GIF und JPG) oder Spreadsheet-Formate wie XLSX und ODS werden aktuell nur als Exportformat in Form von Dateien unterstützt.
Verwendung von Einstellungsdateien
In den bisherigen Beispielen dieses Tutorials haben wir alle Konfigurationen unserer Dateiliste wie unsere gewünschten Spalten für die Liste oder die Filter für den Dateityp, die Dateiendung oder den Dateinamen stets über eigene Parameter an den DateilistenSchreiber CL übergeben. Es gibt jedoch noch eine andere Möglichkeit, die wir uns in diesem Abschnitt ansehen möchten:
Statt der Verwendung der einzelnen Parameter können wir auch einfach den DateilistenSchreiber öffnen, unsere gewünschte Konfiguration bequem über die Benutzeroberfläche vornehmen, unsere Einstellungen über das Menü "Einstellungen > Speichern > Als Datei speichern" speichern und dem Programm anschließend lediglich die resultierende Einstellungsdatei übergeben. Einstellungsdateien des DateilistenSchreibers haben die Dateiendung FLS (File List Settings) und können folgendermaßen im Skriptaufruf verwendet werden:
FilelistCreator.exe -cl C:\Ordner C:\Einstellungen.fls save=C:\DateiListe.xlsx
In diesem Aufruf geben wir nur noch unsere gewünschten Dateien für die Liste (hier der Inhalt des Ordners "C:\Ordner") sowie die Exportdatei, in der wir die Dateiliste speichern möchten (hier "C:\DateiListe.xlsx") an. Der Rest steckt in der Einstellungsdatei "C:\Einstellungen.fls", die wir einfach als solche übergeben. In dieser Datei können alle Konfigurationsmöglichkeiten des DateilistenSchreibers wie zum Beispiel die gewünschten Spalten, die gewünschten Dateifilter oder die gewünschte Kodierung für Textdateien stecken, ohne dass wir explizit Parameter dafür übergeben müssten.
Einstellungsdateien können auch für Konfigurationen genutzt werden, für die es aktuell noch keinen eigenen Parameter gibt. Dies betrifft zum Beispiel die Spaltenüberschriften, die Spaltenausrichtung oder Formatierungseinstellungen einzelner Spalten. Ohne Einstellungsdateien würden stets die Standardwerte für diese Konfigurationen genutzt.
Die Verwendung von Einstellungsdateien bedeutet übrigens nicht, dass Sie auf die in diesem Tutorial vorgestellten sonstigen Parameter verzichten müssen. Vielmehr lassen sich Einstellungsdateien auch problemlos mit anderen Parametern kombinieren, wie das nächste Beispiel zeigt:
FilelistCreator.exe -cl C:\Ordner C:\Einstellungen.fls cols=name,date_accessed save=C:\DateiListe.txt
Zusätzlich zur Einstellungsdatei "C:\Einstellungen.fls" übergeben wir hier den Parameter "cols=name,date_accessed" mit dem wir unsere gewünschten Spalten definieren. Dieser Parameter überschreibt die Spaltenkonfiguration aus der Einstellungsdatei. Mit diesem Aufruf würden also zwar die Spaltenüberschriften und sonstigen Konfigurationen aus der Einstellungsdatei übernommen - unabhängig davon, welche Spalten in der Einstellungsdatei hinterlegt sind, würden aber immer nur die mit dem Parameter "cols" definierten Spalten in die Dateiliste aufgenommen werden. Mehr zu diesem Thema erfahren Sie im nächsten Abschnitt über die kombinierte Anwendung von Einstellungsdateien und Parametern.
Wenn Sie eine Einstellungsdatei des DateilistenSchreibers in einem Texteditor öffnen, werden Sie sehen, dass die Einstellungsdateien auch viele für die Skriptsteuerung nicht benötigte Informationen enthält. Dazu gehören beispielsweise Einstellungen für die grafische Benutzeroberfläche wie die Größe und Position des Programmfensters. Diese Einträge werden im Batch-Modus des Programms einfach ignoriert und müssen von Ihnen für die Nutzung im Skriptaufruf nicht entfernt werden. Trotzdem kann es Situationen geben, in denen das Editieren von Einstellungsdateien sinnvoll ist. So können Sie zum Beispiel Einstellungsdateien erstellen, die nur einzelne Konfigurationen enthalten, um diese dann mit anderen Einstellungsdateien oder Parametern zu kombinieren. Diese Kombination von mehreren Einstellungsdateien kann effektiver sein, als für jede Konfiguration eine einzelne Einstellungsdatei zu erstellen. Wenn Sie dem DateilistenSchreiber mehrere Einstellungsdateien übergeben möchten, können Sie diese einfach hintereinander als einzelne Parameter übergeben. Die Dateien werden dann der Reihe nach geladen und überschreiben gegebenenfalls die Werte aus der oder den vorherigen Einstellungsdateien.
Kombinierte Anwendung von Einstellungsdateien und Parametern
Im letzten Abschnitt wurde erläutert, wie wir die Konfiguration unserer Dateiliste über Einstellungsdateien übergeben können statt über Parameter. Gleichzeitig wurde bereits angedeutet, dass dies nicht bedeutet, dass wir auf unsere Parameter gänzlich verzichten müssten. Vielmehr können wir Einstellungsdateien und Parameter auch gemeinsam verwenden, sogar mehrere Einstellungsdateien gleichzeitig übergeben.
Da ein solches Szenario zu sich widersprechenden Konfigurationen führen kann, zum Beispiel wenn über Parameter andere Spalten für die Dateiliste definiert werden als über eine gleichzeitig übergebene Einstellungsdatei, möchten wir in diesem Abschnitt diskutieren, was in einem solchen Fall passiert und welche Konfigurationen vorrangig für die Erstellung unserer Dateiliste genutzt werden. Dafür ist es erfolderlich den internen Vorgang des Programms nachzuvollziehen, den wir uns im folgenden ansehen möchten.
Bei der Verarbeitung der Parameter geht der DateilistenSchreiber CL folgendermaßen vor:
- Zunächst setzt der DateilistenSchreiber CL alle Einstellungen und Parameter auf ihre Grundeinstellungen. Die Grundeinstellungen der Parameter finden Sie in der Tabelle aller Parameter. Die sonstigen Grundeinstellungen des Programms können Sie erkunden, indem sie den DateilistenSchreiber ohne gespeicherte Einstellungen öffnen.
- Anschließend werden die übergebenen Parameter ausgewertet. Im ersten Schritt werden alle Einstellungsdateien der Reihe nach geladen. Einstellungsdateien erkennt das Programm an der Dateiendung FLS (File List Settings). Werden mehrere Einstellungsdateien übergeben, wird also zuerst die zuerst angegebene Einstellungsdatei geladen. Danach wird die zweite Einstellungsdatei geladen und überschreibt gegebenenfalls die Einstellungen aus der ersten Einstellungsdatei und so weiter. Sonstige Parameter, unabhängig davon, ob sie vor, zwischen oder nach den Einstellungsdateien in der Parameterabfolge angeben sind, werden in diesem Schritt ignoriert.
- Als nächstes werden alle sonstigen Parameter geladen und überschreiben gegebenenfalls die Einstellungen, die durch die Einstellungsdateien geladen wurden. Die Reihenfolge der Parameter spielt keine Rolle. Ob Sie Ihre gewünschten Spalten über den col-Parameter in der Mitte oder am Ende der Parameterreihe definieren oder vor, nach oder zwischen möglichen Einstellungsdateien macht also keinen Unterschied. Immer werden zuerst alle Einstellungsdateien geladen, anschließend der Reihe nach die sonstigen Parameter.
- Im dritten Schritt werden die übergebenen Dateien und Ordner, die zur Dateiliste hinzugefügt werden sollen, unter Berücksichtigung möglicher Filtereinstellungen geladen.
- Jetzt sind alle Parameter und Dateien geladen und es kommt zur Erstellung der Dateiliste.
Zusammenfassend werden demnach zuerst der Reihe nach alle übergebenen Einstellungsdateien geladen. Anschließend werden der Reihe nach alle übergebenen Parameter geladen. Mit jedem Ladevorgang werden die bisherigen Einstellungen überschrieben sofern abweichende Werte angegeben sind.
Übersicht über alle verfügbaren Parameter
In der folgenden Tabelle haben wir für Sie alle Parameter aufgelistet, die Sie im Batch-Modus des DateilistenSchreibers CL verwenden können. In der ersten Spalte finden Sie den Namen des Parameters. Die nächste Spalte enthält eine Liste aller möglichen Werte, die der jeweilige Parameter annehmen kann. Die dritte Spalte zeigt den Default-Wert, der verwendet wird, falls der jeweilige Parameter nicht explizit angegeben wurde. Eine Kurzbeschreibung finden Sie darüber hinaus in der letzten Spalte, in der auch Abschnitte dieses Tutorials verlinkt sind, in denen der betreffende Parameter ausführlich und mit Beispielen erklärt wird.
| Parameter | Werte | Default | Beschreibung |
| [Ordner] | beliebige(r) Ordnerpfad(e) | - | Pfad zu einem oder mehreren Ordnern, die zur Dateiliste hinzugefügt werden sollen. Es können mehrere Ordner hintereinander angegeben werden, um mehrere Ordner gleichzeitig hinzuzufügen. Über die Parameter add-files und add-folders bestimmen Sie, ob die Dateien aus dem Ordner und/oder der Ordner selber zur Dateiliste hinzugefügt wird. Um nicht alle Dateien aus dem Ordner zu Ihrer Dateiliste hinzuzufügen, können Sie die Parameter search-subdirs, filter-ext, filter-name, filter-name-matchcase, filter-name-matchall, filter-name-regex sowie filter-hiddenfiles, filter-onlytextfiles und filter-onlybinaryfiles verwenden, um die Dateisuche einzugrenzen. Mehr Informationen und Beispiele finden Sie im Abschnitt über das Hinzufügen von Ordnern. |
| [Dateien] | beliebige(r) Dateipfad(e) | - | Pfad zu einer oder mehreren Dateien, die zur Dateiliste hinzugefügt werden sollen. Es können mehrere Dateien hintereinander angegeben werden, um mehrere Dateien gleichzeitig hinzuzufügen. Mehr Informationen und Beispiele im Abschnitt über das Hinzufügen von Dateien. |
| [FLS-Dateien] | Einstellungsdateien mit der Dateiendung *.fls | - | Pfad zu einer Einstellungsdatei mit der Dateiendung FLS (File List Creator Settings), die alle Einstellungen des DateilistenSchreibers wie Spaltenkonfigurationen oder Speicheroptionen enthalten kann. Einstellungsdateien können über die graphische Benutzeroberfläche des DateilistenSchreibers erstellt werden und mit allen anderen Parametern kombiniert und überschrieben werden. Es können mehrere Einstellungsdateien hintereinander angegeben werden, die dann hintereinander geladen werden. Mehr zur Verwendung und Erstellung von Einstellungsdateien im Abschnitt über die Anwendung von Einstellungsdateien. |
| cols | <spalte1>,<spalte2>,... | - | Spalten und deren Reihenfolge für die Dateiliste. Die Spalten werden komma-getrennt über deren Spaltenparameter der Reihe nach angegeben. Beispiel: cols=name,date_created,size (erste Spalte: Dateiname, zweite Spalte: Erstellungsdatum, dritte Spalte: Dateigröße). Eine detaillierte Erklärung und Beispiele finden Sie im Abschnitt über Spalten und deren Reihenfolge. |
| sort | <spalte>-up oder <spalte>-down | - | Spalte, nach der die Dateien der Dateiliste sortiert werden sollen. Die Spalte wird über Ihren Spaltenparameter angegeben. Optional können "-up" und "-down" angehängt werden, je nachdem ob aufsteigend oder absteigend sortiert werden soll. Wird kein "-up" oder "-down" angehängt, wird standardmäßig aufsteigend sortiert. Beispiele: "sort=name" (Sortierung aufsteigend nach dem Namen), "sort=size-down" (Sortierung absteigend nach der Dateigröße) oder "sort=audio_duration-up" (Sortierung aufsteigend nach der Spieldauer von Audiodateien). Eine detaillierte Erklärung und Beispiele finden Sie im Abschnitt Sortierung der Dateiliste. |
| save | Pfad zu beliebiger Datei | - | Datei unter der die Dateiliste abgespeichert wird. Das Exportformat ergibt sich aus der Dateiendung (unterstützte Formate/Dateiendungen: txt, csv, xlsx, ods, dif, htm, html, bmp, png, gif, jpg und jpeg) oder kann durch den Parameter "format" festgelegt beziehungsweise überschrieben werden. Im Dateinamen können Platzhalter für das aktuelle Datum, die aktuelle Zeit oder Listeneigenschaften verwendet werden. Falls der save-Parameter nicht spezifiziert wurde, erfolgt eine Ausgabe der Dateiliste direkt in der Konsole. Beispiele und mehr Informationen zum save-Parameter finden Sie im Abschnitt Speicherformat der Dateiliste. |
| format | txt, csv, xlsx, ods, dif, htm, html, bmp, png, gif, jpg oder jpeg | txt | Exportformat für die Dateiliste. Bei einer direkten Ausgabe der Dateiliste in die Konsole kann dieser Parameter dazu verwendet werden, das Ausgabeformat festzulegen. Bei einer Konsolenausgabe werden aktuell nur Textformate wie TXT, CSV, DIF, HTM und HTML unterstützt. Dokument-, Spreadsheet- oder Bildformate werden bei einer Konsolenausgabe nicht unterstützt. Bei einer Speicherung der Dateiliste als Datei ergibt sich das Format normalerweise aus der Dateiendung der angegebenen Exportdatei, so dass die explizite Angabe des format-Parameters nur notwendig ist, wenn das gewünschte Exportformat nicht aus der Dateiendung hervorgeht. Beispiele dafür wären "save=liste.dat format=csv" oder "save=liste.txt format=html". Beispiele und mehr Informationen zu diesem Parameter finden Sie im Abschnitt Speicherformat der Dateiliste. |
| filter-ext | beliebiger Text | - | Falls nur Dateien mit einer bestimmten Endung zur Dateiliste hinzugefügt werden sollen, können Sie die betreffenden Endungen mit diesem Parameter angeben. Also zum Beispiel filter-ext=mp4 um nur Videos mit der Dateiendung MP4 hinzuzufügen. Mehrere Endungen können mit einem Schrägstrich (/) getrennt werden. Also zum Beispiel filter-ext=avi/webm/mp4 um nur Dateien mit den Endungen AVI, WEBM oder MP4 zu berücksichtigen. Wenn Sie diesen Parameter weg oder leer lassen, werden Dateien mit allen Endungen akzeptiert. Detaillierte Erläuterungen und Beispiele finden Sie im Abschnitt über die Filter für die Dateiendung und den Dateityp. |
| filter-type | image, audio, video, text, document, spreadsheet, website, font, executable, archive, playlist, sourcecode, other oder all | all | Wenn Sie nur Dateien eines bestimmten Dateityps beziehungsweise einer bestimmten Gattung zur Dateiliste hinzufügen möchten, können Sie diese Typen mit diesem Parameter definieren. Mit filter-type=archive listen Sie beispielsweise nur Dateien wie ZIP, RAR oder 7Z. Mehrere Typen können sowohl mit einem Semikolon (;) als auch mit einem Komma (,) oder Bindestrich (-) getrennt werden. Mit filter-type=audio;video lässt sich die Dateisuche zum Beispiel auf Audio- und Video-Dateien beschränken. Entsprechend werden mit diesem Filter nur Dateien wie MP3, MP4, WAV, WMA, WMV, MPG oder AVI zu Ihrer Dateiliste hinzugefügt. Wenn Sie diesen Parameter weglassen oder mit "all" aufrufen, werden Dateien jeden Dateityps akzeptiert. Detaillierte Erläuterungen und Beispiele finden Sie im Abschnitt über die Filter für die Dateiendung und den Dateityp. |
| filter-name | beliebiger Text | - | Falls nur Dateien mit einem bestimmten Namen gelistet werden sollen, können Sie diesen Namen mit diesem Parameter angeben. Gelistet werden alle Dateien die die mit "filter-name" angegebenen Zeichen in ihrem Namen enthalten. Mit filter-name=ab also zum Beispiel Dateien wie abc.pdf oder xab.docx. Mehrere Suchbegriffe können mit einem Schrägstrich getrennt definiert werden (zum Beispiel filter-name=abc/def um alle Dateien zu finden, in deren Namen entweder "abc" oder "def" vorkommt). Wenn Sie diesen Parameter weglassen oder leer lassen, werden Dateien mit allen Namen berücksichtigt. Dieser Parameter kann mit den Parametern filter-name-matchcase, filter-name-matchall und filter-name-regex kombiniert werden. Detaillierte Erläuterungen und Beispiele für die Nutzung dieses Parameters finden Sie im Abschnitt über den Filter für den Dateinamen. |
| filter-name-matchcase | 0 oder 1 | 0 | Soll der mit dem Parameter "filter-name" angegebene Text oder reguläre Ausdruck gemäß seiner Groß- und Kleinschreibung interpretiert werden? 0 für nein, 1 für ja. Falls 1 muss der Text/RegEx im Dateinamen genau so in der gleichen Schreibweise vorkommen. Falls 0 wird unabhängig von der Groß- und Kleinschreibung gesucht. |
| filter-name-matchall | 0 oder 1 | 0 | Soll der mit dem Parameter "filter-name" angegebene Text oder reguläre Ausdruck dem Dateinamen komplett entsprechen? 0 für nein, 1 für ja. Falls 1 muss der gesamte Dateinamen den Suchbegriff vollständig matchen. Falls 0 ist es ausreichend wenn der Suchbegriff lediglich irgendwo im Dateinamen vorkommt. |
| filter-name-regex | 0 oder 1 | 0 | Falls der unter "filter-name" angegebene Suchfilter als regulärer Ausdruck interpretiert werden soll, verwenden Sie 1. Falls einfach nur nach dem angegebenen Text gesucht werden soll, 0. |
| filter-hiddenfiles | 0 oder 1 | 0 | Sollen beim Durchsuchen von Ordnern auch versteckte Dateien gefunden werden? 0 für nein, 1 für ja. Mit dem Wert 0 werden keine versteckten Dateien zu Ihrer Dateiliste hinzugefügt, mit dem Wert 1 werden auch versteckte Dateien gelistet. |
| filter-onlytextfiles | 0 oder 1 | 0 | Sollen beim Durchsuchen von Ordnern nur Textdateien gefunden werden? 0 für nein, 1 für ja. Falls ja, wird jede Datei vor dem Hinzufügen geprüft, ob sie eine Binärdatei ist und die Datei nur dann in die Dateiliste aufgenommen, falls die Datei keine Binärdatei ist. |
| filter-onlybinaryfiles | 0 oder 1 | 0 | Sollen beim Durchsuchen von Ordnern nur Binärdateien gefunden werden? 0 für nein, 1 für ja. Falls ja, wird jede Datei vor dem Hinzufügen geprüft, ob sie eine Binärdatei ist und die Datei nur dann in die Dateiliste aufgenommen, falls dies zutrifft. |
| search-subdirs | 0 oder 1 | 1 | Sollen beim Durchsuchen von Ordnern auch Unterordner durchsucht werden? 0 für nein, 1 für ja. Mit dem Wert 0 werden nur diejenigen Dateien zu Ihrer Dateiliste hinzugefügt, die direkt in dem angegebenen Ordner liegen. Unterordner werden nicht durchsucht. Mit dem Wert 1 werden sowohl die Dateien gelistet, die direkt im Ordner liegen, als auch alle Dateien, die sich in einem Unterordner unterhalb des angegebenen Ordners befinden. Beispiele und weitere Erläuterungen zu diesem Parameter finden Sie im Abschnitt über das Hinzufügen von Dateien und Ordnern zur Dateiliste. |
| add-files | 0 oder 1 | 1 | Sollen Dateien zur Dateiliste hinzugefügt werden? 0 für nein, 1 für ja. Erklärungen und Beispiele zu diesem Parameter finden Sie im Abschnitt über die Generierung von Dateilisten und Ordnerlisten. |
| add-folders | 0 oder 1 | 0 | Sollen Ordner als solche zur Dateiliste hinzugefügt werden? 0 für nein, 1 für ja. Wenn Sie eine reine Ordnerliste ohne gelistete Dateien erstellen möchten, können Sie die Parameter "add-folders=1" und "add-files=0" verwenden. Erklärungen und Beispiele zu diesem Parameter finden Sie im Abschnitt über die Generierung von Dateilisten und Ordnerlisten. |
| enc | ascii, latin1, latin2, win-ansi, win-1250, win-1251, win-1252, win-1253, cp437, utf7, utf8, utf16le, utf16be, utf32le oder utf32be | utf8 | Kodierung für die gespeicherte Dateiliste, falls in einem Textformat wie TXT, CSV oder HTML gespeichert wird. Die Kodierung "win-ansi" ist abhängig von der Lokalisierung Ihrer Windows-Version. Es wird die Windows-Codepage verwendet, die Ihrer Sprachversion von Windows entspricht. Eine Übersicht und Erläuterungen zu den verschiedenen Kodierungen finden Sie im Artikel über die verschiedenen Textformate und Kodierungen. Mehr Informationen zu diesem Parameter und Beispiele für dessen Verwendung finden Sie im Abschnitt über die Speicherung der Dateiliste. |
| bom | 0 oder 1 | 0 | Soll eine Byte Order Mark in die Datei geschrieben werden, falls in einem Textformat wie TXT, CSV oder HTML gespeichert wird? 0 für nein, 1 für ja. Mehr Informationen zu diesem Parameter und Beispiele für dessen Verwendung finden Sie im Abschnitt über die Speicherung der Dateiliste. |
| lb | system, crlf, lf, cr, nl, ff, nel, ls, ps, vt, tab oder nochar | system | Zeilenumbruch-Typ für die Datei der Dateiliste, falls die Liste in einem Textformat wie TXT, CSV oder HTML gespeichert wird. Der Wert "system" entspricht dem Standard-Zeilenumbruch-Typ des Betriebssystems, auf dem der DateilistenSchreiber CL aktuell ausgeführt wird. Also zum Beispiel crlf für Windows. Die Konstante "nochar" steht für kein Zeichen. Sie können "nochar" verwenden, um eine Liste ohne Zeilenumbruchszeichen zu erstellen. Mehr Informationen zu diesem Parameter und Beispiele für dessen Verwendung finden Sie im Abschnitt über die Speicherung der Dateiliste. |
| fs | system, comma, semicolon, pipe, hyphen, space, tab, nochar oder ein beliebiger String | system | Feldtrennungszeichen für den CSV-Export. Der Wert "system" entspricht dem Standard-Feldtrennungszeichen des Betriebssystems, auf dem der DateilistenSchreiber CL aktuell ausgeführt wird (Komma oder Semikolon). Die Konstante "nochar" steht für kein Zeichen. Mehr Informationen zu diesem Parameter und Beispiele für dessen Verwendung finden Sie im Abschnitt über die Speicherung der Dateiliste. |
| openfile | 0 oder 1 | 0 | Soll die Dateiliste nach der Erstellung geöffnet werden? Mit openfile=1 wird die neu erstellte Datei geöffnet. Beispiele im Abschnitt über das automatische Öffnen von Dateilisten. |
Prinzipiell können alle aufgeführten Parameter miteinander kombiniert und innerhalb des selben Aufrufs des DateilistenSchreibers CL gemeinsam miteinander verwendet werden. In welcher Reihenfolge Sie die einzelnen Parameter übergeben spielt dabei keine Rolle. Wie die verschiedenen Parameter miteinander interagieren - insbesondere für den Fall, dass sich einzelne Parameter widersprechen - erfahren Sie im Abschnitt über die kombinierte Anwendung von Parametern und Einstellungsdateien.
Wird der DateilistenSchreiber CL aufgerufen ohne einen bestimmten Parameter zu definieren, wird für diesen Parameter der Wert aus der Spalte "Default" angenommen. Steht in der "Default"-Spalte der Wert "-" heißt dies, dass der betreffende Parameter per Default leer ist.
Übersicht über die Parameter für Spalten
In der folgenden Tabelle finden Sie alle verfügbaren Parameter für Spalten. Diese Parameter benötigen Sie für den Parameter "cols", mit dem Sie angeben können, welche Spalten in Ihre Dateiliste aufgenommen werden sollen sowie für den Parameter "sort", mit dem Sie angeben können, nach welcher Spalte Ihre Dateiliste sortiert werden soll.
Die Spaltenparameter in dieser Übersichtstabelle sind sortiert nach ihrer Kategorie, welche Sie in der ersten Spalte finden. In der zweiten Spalte steht der Name beziehungsweise eine Erklärung der jeweiligen Spalte, während der Parameter selber in der letzten Spalte gelistet ist.
| Kategorie | Spalte | Parameter |
| Allgemein | Nummer der Datei in der Liste | number |
| Allgemein | Dateiname | name |
| Allgemein | Dateiformat | format |
| Allgemein | Dateityp | type |
| Allgemein | Dateigröße | size |
| Allgemein | Dateipfad | path |
| Allgemein | Pfadlänge | path_length |
| Dateidatum | Datum der letzten Änderung | date_modified |
| Dateidatum | Datum der Dateierstellung | date_created |
| Dateidatum | Datum des letzten Zugriff | date_accessed |
| Dateidatum | Datum der letzten Attributänderung | date_attrchanged |
| Ordner | Ordnername | folder |
| Ordner | Ordnerebene | folder_level |
| Ordner | Dateianzahl (alle) | filecount_all |
| Ordner | Dateianzahl (erste Ebene) | filecount_direct |
| Ordner | Ordneranzahl (alle) | foldercount_all |
| Ordner | Ordneranzahl (erste Ebene) | foldercount_direct |
| Ordner | Ordnergröße (erste Ebene) | foldersize_direct |
| Ordner | Ordnertiefe | folder_deepness |
| Datenträger | Datenträgername | volume_name |
| Audio | Interpret | audio_artist |
| Audio | Titel | audio_title |
| Audio | Album | audio_album |
| Audio | Track-Nummer | audio_track |
| Audio | Disc-Nummer | audio_discnumber |
| Audio | Spieldauer | audio_duration |
| Audio | Jahr | audio_year |
| Audio | Genre | audio_genre |
| Audio | Kommentar | audio_comment |
| Audio | Sample Rate | audio_samplerate |
| Audio | Bitrate | audio_bitrate |
| Audio | Kanäle | audio_channels |
| Video | Breite | video_width |
| Video | Höhe | video_height |
| Video | Seitenverhätnis | video_aspectratio |
| Video | Spieldauer | video_duration |
| Video | Bitrate | video_bitrate |
| Video | Frames pro Sekunde (FPS) | video_fps |
| Bilder | Breite | image_width |
| Bilder | Höhe | image_height |
| Bilder | Seitenverhätnis | image_aspectratio |
| Bilder | Farbtiefe | image_colordepth |
| Bilder | Farbraum | image_colorspace |
| Bilder | Horizontale Auflösung | image_resx |
| Bilder | Vertikale Auflösung | image_resy |
| Bilder | Bildanzahl | image_imagecount |
| Textdateien | Kodierung | text_encoding |
| Textdateien | Byte Order Mark (BOM) | text_bom |
| Textdateien | Zeilenumbruchtyp | text_linebreaktype |
| Textdateien | Zeilenanzahl | text_linecount |
| Textdateien | Zeichenanzahl | text_charcount |
| Textdateien | Wortanzahl | text_wordcount |
| Textdateien | Erste Zeichen | text_firstchars |
| Dokumente | Autor | document_author |
| Dokumente | Titel | document_title |
| Dokumente | Seitenanzahl | document_pagecount |
| Kombinationen | Breite von Bildern oder Videos | combined_width |
| Kombinationen | Höhe von Bildern oder Videos | combined_height |
| Kombinationen | Seitenverhältnis von Bildern oder Videos | combined_aspectratio |
| Kombinationen | Dauer von Audios oder Videos | combined_duration |
| Attribute | Versteckt | attribute_hidden |
| Attribute | Schreibgeschützt | attribute_readonly |
| Attribute | Versteckte Dateiendung | attribute_hiddenext |
| Attribute | Bewertung | attribute_rating |
| Attribute | Link | attribute_link |
| Checksummen | MD5 | checksum_md5 |
| Checksummen | CRC-32 | checksum_crc32 |
| Checksummen | CRC-32B | checksum_crc32b |
| Checksummen | SHA-1 | checksum_sha1 |
| Checksummen | SHA-224 | checksum_sha224 |
| Checksummen | SHA-256 | checksum_sha256 |
| Checksummen | SHA-384 | checksum_sha384 |
| Checksummen | SHA-512 | checksum_sha512 |
Mehrere dieser Parameter können mit einem Komma getrennt werden. Falls Sie zum Beispiel eine Dateiliste mit dem Dateinamen sowie mit Angaben über die Breite und die Höhe von Bildern kreieren möchten, können Sie die Spaltenparameter in der Form "cols=name,image_width,image_height" verwenden. Informationen darüber, welche Formate und Arten von Audiodateien, Videodateien, Bilddateien und Dokumenten die formatspezifischen Spalten unterstützt werden, finden Sie in der Übersicht der unterstützten Formate des DateilistenSchreibers.
Übersicht über alle Platzhalter für den Dateinamen
Im Dateinamen, mit dem die Dateiliste gespeichert wird (definiert über den save-Parameter), können die folgenden Platzhalter für das aktuelle Datum, die aktuelle Zeit sowie für diverse Listeneigenschaften verwendet werden:
| Platzhalter | Bedeutung |
| %date% | Aktuelles Datum im Format "Jahr-Monat-Tag" (jeweils zwei- beziehungsweise vierstellig mit führenden Nullen falls nötig; Kurzform für %yyyy%-%mm%-%dd%) |
| %dd.mm.yyyy% | Aktuelles Datum im Format "Tag.Monat.Jahr" (jeweils zwei- beziehungsweise vierstellig mit führenden Nullen falls nötig; Kurzform für %dd%.%mm%.%yyyy%) |
| %yyyy-mm-dd% | Aktuelles Datum im Format "Jahr-Monat-Tag" (jeweils zwei- beziehungsweise vierstellig mit führenden Nullen falls nötig; Kurzform für %yyyy%-%mm%-%dd%) |
| %time% | Aktuelle Zeit im Format "Stunde-Minute-Sekunde" (jeweils zweistellig mit führenden Nullen falls nötig; Kurzform für %hh%-%ii%-%ss%) |
| %hh-mm-ss% | Aktuelle Zeit im Format "Stunde-Minute-Sekunde" (jeweils zweistellig mit führenden Nullen falls nötig; Kurzform für %hh%-%ii%-%ss%) |
| %hh-mm% | Aktuelle Zeit im Format "Stunde-Minute" (jeweils zweistellig mit führenden Nullen falls nötig; Kurzform für %hh%-%ii%) |
| %yyyy% | Aktuelles Jahr mit vier Ziffern |
| %yy% | Aktuelles Jahr mit zwei Ziffern |
| %mm% | Aktueller Monat, immer zweistellig, führende Nullen falls nötig |
| %m% | Aktueller Monat, ein- oder zweistellig ohne führende Nullen |
| %dd% | Aktueller Tag, immer zweistellig, führende Nullen falls nötig |
| %d% | Aktueller Tag, ein- oder zweistellig ohne führende Nullen |
| %hh% | Aktuelle Stunde, immer zweistellig, führende Nullen falls nötig |
| %h% | Aktuelle Stunde, ein- oder zweistellig ohne führende Nullen |
| %ii% | Aktuelle Minute, immer zweistellig, führende Nullen falls nötig |
| %i% | Aktuelle Minute, ein- oder zweistellig ohne führende Nullen |
| %ss% | Aktuelle Sekunde, immer zweistellig, führende Nullen falls nötig |
| %s% | Aktuelle Sekunde, ein- oder zweistellig ohne führende Nullen |
| %total_files% | Gesamtanzahl aller Dateien in der Dateiliste |
| %total_size% | Summe der Dateigröße aller Dateien der Dateiliste |
| %total_duration% | Gesamte Spieldauer aller Audio- und Videodateien in der Dateiliste |
| %total_lines% | Summe der Zeilen aller Textdateien in der Dateiliste |
| %total_chars% | Summe der Zeichen aller Textdateien in der Dateiliste |
| %total_words% | Summe der Wörter aller Textdateien in der Dateiliste |
Beispiele für die Verwendung dieser Platzhalter finden Sie in den Abschnitten über das Schreiben von Datum und Uhrzeit in den Dateinamen sowie über das Schreiben von Listeneigenschaften in den Dateinamen. Beachten Sie bitte, dass das %-Zeichen im Skriptaufruf verdoppelt werden muss, damit die Platzhalter nicht als Variablen interpretiert werden.
Download des DateilistenSchreibers CL
Für die auf dieser Seite vorgestellten Funktionen benötigen Sie den DateilistenSchreiber in der CL-Version. Diese erhalten Sie auf dieser Seite. Die Standardversion des DateilistenSchreibers enthält keine Funktionen zur Skriptsteuerung.