watchDirectory Hilfe > Plugins > Dynamische Namen
Dynamische Namen erlauben es, den Zieldateien bzw. Zielverzeichnissen einen Namen zu geben, der vom aktuellen Datum und dem Namen der Originaldatei abhängt.
Dynamische Namen können in folgenden Plugins verwendet werden:
automatisch Dateien an einen anderen Ort kopieren
automatisch Dateien nach Regeln verschieben oder kopieren
automatisch komprimierte Dateien (zip) dekomprimieren
automatisch Dateien an einen FTP-Server übertragen (backslashes werden automatisch in normale Slashes geändert) und
automatisch Dateien umbenennen
Beispiel:
D:\Zielverzeichnis\{year}{month}{day}\{hour24}\{extension}\{filename}
Wenn die Datei hallo.txt erkannt wird, wird dafür dieser dynamischer Name (in Abhängigkeit des aktuellen Datums und der Zeit) erzeugt:D:\Zielverzeichnis\20051231\23\txt\hallo.txtNeue Verzeichnisse werden dabei - falls erforderlich - automatisch erzeugt.
Unterstützte Variablen für Dynamische Namen
Der Pfad, auf den sich die Beispielangaben unten beziehen, lautet: C:\Monitor\Unterverzeichnis\Verzeichnis\datei.txt und das überwachte Verzeichnis ist: C:\Monitor
| Variablenname | Beschreibung | Beispielswert |
|---|---|---|
| {drive} | Der Laufwerksbuchstabe des überwachten Verzeichnisses. Bleibt leer, wenn Sie ein Verzeichnis über den UNC-Namen überwachen | C |
| {dir} | Das Verzeichnis, in dem die erkannte Datei gefunden wurde | Monitor\Unterverzeichnis\Verzeichnis |
| {monitoreddir} | Das Verzeichnis, das von dieser Aufgabe überwacht wird | Monitor |
| {relativedir} | Wenn die neue Datei in einer Unterverzeichnisstruktur des überwachten Verzeichnisses gefunden wurde, enthält diese Variable den Pfad der Unterverzeichnisstruktur | Unterverzeichnis\Verzeichnis |
| {firstdir} | Der Name des Verzeichnisses, das sich direkt unterhalb des überwachten Verzeichnisses befindet | Unterverzeichnis |
| {parentdir} | Der Name des Verzeichnisses, in dem sich die erkannte Datei befindet | Verzeichnis |
| {filename} | Der Name der Datei und die Dateierweiterung | datei.txt |
| {filetitle} | Der Name der Datei ohne die Dateierweiterung | datei |
| {extension} | Die Dateierweiterung | txt |
| {originalfull} | Der komplette Pfad der Datei | Monitor\Unterverzeichnis\Verzeichnis\datei.txt |
| {originalrelative} | Der Pfad der Datei, beginnend vom überwachten Verzeichnis | Unterverzeichnis\Verzeichnis\datei.txt |
| {owner} | Der Name des Besitzers der Datei. Beachten Sie bitte, dass im Programm zunächst immer der Name "John" anzeigt wird. Wenn Sie die Aufgabe gestartet haben, wird der Name des tatsächlichen Besitzers übernommen. | John |
| Diverse selbsterklärende Variable zu Datum und Uhrzeit, wie z. Bsp. Jahr {year}, Monat {monthname} und Stunde {hour24} sind verfügbar. Diese Variablen verwenden die Systemuhreinstellungen. Sie können alternativ auch den Zeitstempel der erkannten Dateien verwenden, um einen Dynamischen Namen für die Zieldatei zu bilden. Fügen Sie einfach ":cr" (Zeitstempel "Erstellt"), ":lm" (Zeitstempel "Geändert am") oder ":la" (Zeitstempel "letzter Zugriff") an die Variable an. Beispiel: Die Variable {monthname} verwendet die Systemzeit, um den Namen des aktuellen Monats zu ermitteln. Die Variable {monthname:lm} ermittelt den Namen des Monats aus dem Zeitstempel "Geändert am" der Datei. |
||
| {taskname} | Der Name der Aufgabe | AutoCopy |
| {runnumber} | Die Ordnungszahl, die watchDirectory dieser
Ausführung gegeben hat. Diese Nummer kann dazu verwendet werden, nähere Informationen in der Ereignisansicht zu finden |
17 |
| {eventnumber} | Eine eindeutige Nummer, die watchDirectory dem
augenblicklichen Ereignis zuweist. Diese Nummer kann dazu verwendet werden, nähere Informationen in der Ereignisansicht zu finden oder auch, um einen eindeutigen Verzeichnis- oder Dateiname zu erstellen. Ereignisnummern sind eindeutig innerhalb einer Aufgabe | 16292 |
Unterstützte Funktionen für Dynamische Namen
| Funktion | Beschreibung | Beispielswert |
|---|---|---|
| {left{num,text}} | liefert eine definierte Anzahl von Zeichen zurück, links beginnend | {left{3,{extension}XXX}} Dies liefert die ersten 3 Zeichen der Dateierweiterung zurück. Für Dateien ohne Erweiterung wird XXX zurückgeliefert. |
| {right{num,text}} | liefert eine definierte Anzahl von Zeichen zurück, rechts beginnend | {right{5,00000{runnumber}}} Dies liefert die eine 5-ziffrige Ausführungsnummer mit führenden Nullen zurück. |
| {substring{start,length,text}} | liefert eine definierte Zeichenkette zurück. beginnt mit Position "Start" | {substring{0,3,{monthname}}} Dies liefert die Zeichenkette "Okt" (im Monat Oktober) zurück. |
| {stringbefore{tofind,completestring}} | Gibt die Buchstaben des Ausdrucks "completestring" bis zur definierten Zeichenfolge "tofind" bzw. den kompletten Ausdruck "completestring" zurück, wenn "tofind" nicht gefunden wurde. | {stringbefore{ober,{monthname}}} Dies gibt die Buchstaben "Okt" im Monat Oktober zurück. |
| {stringafter{tofind,completestring}} | Gibt die Buchstaben des Ausdrucks "completestring" zurück, beginnend mit dem Zeichen nach "tofind" bzw. den kompletten Ausdruck "completestring", wenn der Ausdruck "tofind" nicht gefunden wird. | {stringafter{_,{filetitle}}} Dies liefert alle Buchstaben in einem Ausdruck nach dem definierten Steuerzeichen "_". |
| {cutright{num,text}} | Entfernt die Anzahl "num" Buchstaben am Ende des Textes bzw. Dateinamens. | {cutright{4,abcdefg}} Diese Definition ergibt den Text "abc". |
| {reverse{text}} | liefert einen Text Rückwärts zurück | {reverse{abc}} Dies liefert die Zeichenkette "cba" zurück. |
| {lower{text}} | liefert einen Text in Kleinbuchstaben zurück | {lower{{monthname}}} Dies liefert die Zeichenkette "oktober" (im Monat Oktober) zurück. |
| {upper{text}} | liefert einen Text in Großbuchstaben zurück | {upper{{monthname}}} Dies liefert die Zeichenkette "OKTOBER" (im Monat Oktober) zurück. |
| {environment{variablename}} | Gibt den Wert einer Umgebungsvariablen zurück. Wenn Sie watchDirectory als Windows-Dienst gestartet haben, werden nur systembezogene Umgebungsvariablen benutzt. | {environment{COMPUTERNAME}} Dies gibt die Zeichenkette "Mein Computer" zurück (wenn Ihr Computer so benannt wurde). |
| {replace{old,new,string}} | Die Funktion "replace" sucht im Ausdruck "string" nach allen Werten "old" und ersetzt sie mit "new". Wenn der Wert "old" nicht gefunden wird, wird der Ausdruck "string" nicht geändert. Wenn im Wert "new" nichts eingegeben wird, werden alle gefundenen Stellen für den Wert "old" gelöscht. | {replace{\,/,{originalfull}}}
Diese Einstellung ersetzt im Dateipfad alle Backslashs mit normalen Schrägstrichen. Wenn {originalfull} "überwachtesVerzeichnis\unterverzeichnis\verzeichnis\datei.txt" ist, wird daraus "überwachtesVerzeichnis/unterverzeichnis/verzeichnis/datei.txt". {replace{\,,{originalfull}}}Diese Einstellung löscht alle Backslashes im Dateipfad. Wenn {originalfull} "überwachtesVerzeichnis\unterverzeichnis\verzeichnis\datei.txt" ist, wird daraus "überwachtesVerzeichnisunterverzeichnisverzeichnisdatei.txt". |
| {sequence{the-sequence-file}} | Liest den Dateinamen in einen Zählvariable, inkrementiert diesen Zähler und schreibt ihn zurück in den Dateinamen. Wenn die Datei noch nicht existiert, wird der Wert "1" dem Dateinamen angefügt. Der neue Zählwert wird zurückgegeben. | {sequence{c:\Daten\Sequenzen\{taskname}.txt}} Wenn die Aufgabe den Namen "Kopieren" trägt, wird der Inhalt der Datei C:\Daten\Sequenzen\Kopieren.txt - falls sie noch nicht existiert - durch die Zahl "1" ersetzt. Diese Zahl wird auch dem Dateinamen der kopierten Datei angehängt. Beim nächsten Anwenden der Regel wird diese Zahl um 1 inkrementiert, also zu 2. |
| {code{dllname,parameters}} | Läd eine DLL-Datei, die im Verzeichnis
<install dir>\Resolvers gespeichert sein muss, und ruft diese mit
den übergeben Parametern auf. Im Lieferumfang befindet sich eine DLL-Datei mit dem Namen resolveExample.dll. Der Quellcode dieser Datei kann unter herunterge laden werden. Diese DLL-Datei überprüft, ob die als Parameter übergeben Datei existiert. Wenn sie existiert, gibt die DLL-Datei den Dateinamen in folgender Form zurück: <dateiname>_1.dateierweiterung (bzw. _2, wenn _1 ebenfalls existiert). Wenn die Datei nicht existiert, gibt die DLL-Datei den Dateiname ohne Zusätze zurück. |
{code{resolveExample.dll,{drive}:\{originalfull}}} |