Dateien

FileCopy#

Die Aktion FileCopy kopiert eine angegebene Datei (Attribut: Source) zu dem angegebenen Ziel (Attribut: Destination). Mit dem Attribut Overwrite kann bestimmt werden, ob eine bereits existierende Datei überschrieben werden soll.

<FileCopy Source="" Destination="" Overwrite="true" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• Source: Quellpfad oder Quelldatei.
• Destination: Zielpfad oder Zieldatei.
• Overwrite: (Optional) Gibt an, ob eine vorhandene Datei überschrieben werden soll (true oder false, Standardwert: false).
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Variable, in der gespeichert wird, ob die Aktion erfolgreich ausgeführt wurde (true oder false).
• IgnoreError: (Optional) Gibt an, ob Fehler ignoriert werden sollen (true oder false, Standardwert: false).
   

FileMove#

Die Aktion FileMove verschiebt eine angegebene Datei (Attribut: Source) in das angegebene Ziel (Attribut: Destination).

<FileMove Source="" Destination="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• Source: Quellpfad oder Quelldatei.
• Destination: Zielpfad oder Zieldatei.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Variable, in der gespeichert wird, ob die Aktion erfolgreich ausgeführt wurde (true oder false).
• IgnoreError: (Optional) Gibt an, ob Fehler ignoriert werden sollen (true oder false, Standardwert: false).
   

FileRename#

Die Aktion FileRename verändert den Pfad, Dateinamen und Dateiendung einer angegebenen Datei (Attribut: Source) und weist der Datei einen neuen Pfad, Dateinamen und Dateiendung zu (Attribut: Destination).

<FileRename Source="" Destination="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• Source: Quellpfad oder Quelldatei.
• Destination: Zielpfad oder Zieldatei.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Variable, in der gespeichert wird, ob die Aktion erfolgreich ausgeführt wurde (true oder false).
• IgnoreError: (Optional) Gibt an, ob Fehler ignoriert werden sollen (true oder false, Standardwert: false).
   

FileDelete#

Die Aktion FileDelete löscht eine angegebene Datei (Attribut: File).

<FileDelete File="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• File: Pfad zur Datei.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Variable, in der gespeichert wird, ob die Aktion erfolgreich ausgeführt wurde (true oder false).
• IgnoreError: (Optional) Gibt an, ob Fehler ignoriert werden sollen (true oder false, Standardwert: false).
   

FileExists#

Die Aktion FileExists prüft, ob eine angegebene Datei (Attribut: File) existiert. Falls Ja wird in das Attribut Variable true zurückgegeben 

<FileExists File="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• File: Pfad zur Datei.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Variable, in der gespeichert wird, ob die Aktion erfolgreich ausgeführt wurde (true oder false).
• IgnoreError: (Optional) Gibt an, ob Fehler ignoriert werden sollen (true oder false, Standardwert: false).
   

GetFileName#

Die Aktion GetFileName gibt den Dateinamen inkl. der Dateiendung der angegebenen Datei (Attribut: Source) in das Attribut Variable zurück.

<GetFileName Source="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• Source: Quellpfad oder Quelldatei.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Variable, in der gespeichert wird, ob die Aktion erfolgreich ausgeführt wurde (true oder false).
• IgnoreError: (Optional) Gibt an, ob Fehler ignoriert werden sollen (true oder false, Standardwert: false).
   

GetFileNameWithoutExtension#

Die Aktion GetFileNameWithoutExtension gibt den Dateinamen ohne die Dateiendung der angegebenen Datei (Attribut: Source) in das Attribut Variable zurück.

<GetFileNameWithoutExtension Source="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• Source: Quellpfad oder Quelldatei.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Variable, in der gespeichert wird, ob die Aktion erfolgreich ausgeführt wurde (true oder false).
• IgnoreError: (Optional) Gibt an, ob Fehler ignoriert werden sollen (true oder false, Standardwert: false).
   

GetExtension#

Die Aktion GetExtension gibt die Dateiendung der angegebenen Datei (Attribut: Source) in das Attribut Variable zurück. Hinweis: Die Dateiendung wird mit dem Trennzeichen "." übernommen z.B. ".pdf".

<GetExtension Source="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• Source: Quellpfad oder Quelldatei.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Variable, in der gespeichert wird, ob die Aktion erfolgreich ausgeführt wurde (true oder false).
• IgnoreError: (Optional) Gibt an, ob Fehler ignoriert werden sollen (true oder false, Standardwert: false).
   

GetEscapedFileName#

Die Aktion GetEscapedFileName entfernt alle ungültigen Zeichen aus einem Dateinamen, die unter Windows nicht erlaubt sind (z.B. \ / : * ? " < > |). Das Ergebnis wird in der angegebenen Variable gespeichert. Wichtig: Es darf nur ein reiner Dateiname übergeben werden, kein vollständiger Pfad – da sonst auch die Backslashes des Pfades entfernt werden.

<GetEscapedFileName Source="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• Source: Der Dateiname, der bereinigt werden soll. Kein vollständiger Pfad, nur der Dateiname.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: Die Variable, in der der bereinigte Dateiname gespeichert wird.
• IgnoreError: (Optional) Gibt an, ob Fehler ignoriert werden sollen (true oder false, Standardwert: false).

Beispiel:

<GetEscapedFileName Source="Rechnung: Müller / 2024.docx" Condition="" Variable="{@SafeName}" IgnoreError="false" />

In diesem Beispiel wird der Dateiname Rechnung: Müller / 2024.docx bereinigt. Das Ergebnis Rechnung Müller 2024.docx wird in der Variable {@SafeName} gespeichert.
 

FileListDirectory#

Die Aktion FileListDirectory erstellt eine Daten-Tabelle, das Dateien und Ordner enthält, die unter dem angegebenen Pfad (Attribut: Source) verfügbar sind. Dabei kann angegeben werden werden ob nur Dateien (Attribut: OnlyFiles) oder nur Ordner (Attribut: OnlyDirectories) in das DataTable Objekt übernommen werden. Zusätzliche Informationen können über das Attribut WithInformations angefordert werden. Die Informationen, die eine Daten-Tabelle zur Laufzeit hält, können über den Inspektor eingesehen werden (Hauptartikel: Inspektor & Debugging). Dieses Objekt kann dazu verwendet werden, um in einer ForEach Schleife über die Einträge der Daten-Tabelle zu iterieren. Siehe Beispiel: Datensicherung.

<FileListDirectory Source="" Data="{@myData}" OnlyFiles="false" OnlyDirectories="false" WithInformations="false" DataCount="{@ResultCount}" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• Source: Quellpfad oder Quelldatei.
• Data: Variable, in der die Ergebnisdaten gespeichert werden.
• OnlyFiles: (Optional) Wenn true, werden nur Dateien aufgelistet (true oder false, Standardwert: false).
• OnlyDirectories: (Optional) Wenn true, werden nur Verzeichnisse aufgelistet (true oder false, Standardwert: false).
• WithInformations: (Optional) Wenn true, werden zusätzliche Dateiinformationen abgerufen (true oder false, Standardwert: false).
• DataCount: (Optional) Variable, in der die Anzahl der Datensätze gespeichert wird.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Variable, in der gespeichert wird, ob die Aktion erfolgreich ausgeführt wurde (true oder false).
• IgnoreError: (Optional) Gibt an, ob Fehler ignoriert werden sollen (true oder false, Standardwert: false).
   

FileCreateSymbolicLink#

Die Aktion FileCreateSymbolicLink erstellt eine symbolische Verknüpfung zu einer Datei innerhalb des Dateisystems.

<FileCreateSymbolicLink Source="" Destination="" Variable="{@Result}" />

Attribute:

• Source: Quellpfad oder Quelldatei.
• Destination: Zielpfad oder Zieldatei.
• Variable: (Optional) Variable, in der gespeichert wird, ob die Aktion erfolgreich ausgeführt wurde (true oder false).
   

FileGetCreationTime#

Die Aktion FileGetCreationTime ermittelt zu einer angegebenen Datei (Attribut: File) das Erstellungsdatum liefert das Ergebnis in das Attribut Variable zurück.

<FileGetCreationTime File="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• File: Pfad zur Datei.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Variable, in der gespeichert wird, ob die Aktion erfolgreich ausgeführt wurde (true oder false).
• IgnoreError: (Optional) Gibt an, ob Fehler ignoriert werden sollen (true oder false, Standardwert: false).
   

FileSetCreationTime#

Mit der Aktion FileSetCreationTime versieht das Erstellungsdatum einer angegebenen Datei (Attribut: File) mit einem neuen Zeitstempel (Attribut: Value).

<FileSetCreationTime File="" Value="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• File: Pfad zur Datei.
• Value: Der zu setzende Wert.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Variable, in der gespeichert wird, ob die Aktion erfolgreich ausgeführt wurde (true oder false).
• IgnoreError: (Optional) Gibt an, ob Fehler ignoriert werden sollen (true oder false, Standardwert: false).
   

FileIsReadOnly#

Die Aktion FileIsReadOnly prüft, ob die angegebene Datei (Attribut: File) schreibgeschützt ist.

<FileIsReadOnly File="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• File: Pfad zur Datei.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Variable, in der gespeichert wird, ob die Aktion erfolgreich ausgeführt wurde (true oder false).
• IgnoreError: (Optional) Gibt an, ob Fehler ignoriert werden sollen (true oder false, Standardwert: false).
   

FileSetReadOnly#

Die Aktion FileSetReadOnly versieht die angegebene Datei (Attribut: File) mit einem Schreibschutz.

<FileSetReadOnly File="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• File: Pfad zur Datei.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Variable, in der gespeichert wird, ob die Aktion erfolgreich ausgeführt wurde (true oder false).
• IgnoreError: (Optional) Gibt an, ob Fehler ignoriert werden sollen (true oder false, Standardwert: false).
   

FileSetWriteable#

Die Aktion FileSetWriteable entfernt den Schreibschutz der angegebenen Datei (Attribut: File).

<FileSetWriteable File="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• File: Pfad zur Datei.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Variable, in der gespeichert wird, ob die Aktion erfolgreich ausgeführt wurde (true oder false).
• IgnoreError: (Optional) Gibt an, ob Fehler ignoriert werden sollen (true oder false, Standardwert: false).
   

FileVersion#

Die Aktion FileVersion ermittelt zu einer angegebenen Datei (Attribut: File) die Dateiversion. Ist das Attribut ProductVersion auf True gesetzt, wird die Produktversion der Datei in das Attribut Variable zurückgegeben.

<FileVersion File="" ProductVersion="false" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• File: Pfad zur Datei.
• ProductVersion: (Optional) Wenn true, wird die Produktversion statt der Dateiversion zurückgegeben (true oder false, Standardwert: false).
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Variable, in der gespeichert wird, ob die Aktion erfolgreich ausgeführt wurde (true oder false).
• IgnoreError: (Optional) Gibt an, ob Fehler ignoriert werden sollen (true oder false, Standardwert: false).
   

CreateShortcut#

Die Aktion CreateShortcut erstellt eine Dateiverknüpfung zu der angegebenen Datei (Attribut: Source) unter einem angegebenen Zielpfad (Attribut: Destination). Der Name und das Icon der Dateiverknüpfung werden über die gleichnamigen Attribute gesetzt. Argumente, die dem Aufruf des Shortcuts angehangen werden sollen, werden über das Attribut Arguments angegeben. Über das Attribut Workpath kann angegeben werden in welchem Verzeichnis die Dateiverknüpfung ausgeführt wird.

<CreateShortcut Source="" Destination="" Name="" Icon="" Workpath="" Arguments="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• Source: Quellpfad oder Quelldatei.
• Destination: Zielpfad oder Zieldatei.
• Name: Name des Elements.
• Icon: Der Wert für Icon.
• Workpath: Der Wert für Workpath.
• Arguments: Der Wert für Arguments.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Variable, in der gespeichert wird, ob die Aktion erfolgreich ausgeführt wurde (true oder false).
• IgnoreError: (Optional) Gibt an, ob Fehler ignoriert werden sollen (true oder false, Standardwert: false).
   

FileMirror#

Die Aktion FileMirror kopiert Dateien von einer Quelle (Attribut: Source) in ein Zielverzeichnis (Attribut: Destination). Über das Attribut Message wird ein Bericht des Kopiervorgangs zurückgegeben. Verzeichnisse und Dateien, die ausgeschlossen werden sollen, können über die Attribute ExludeFiles und ExcludeDirectories angegeben werden. Mehrere Verzeichnisse bzw. Dateien werden dabei mit einem Semikolon getrennt. Zudem kann eine Wildcard (*) verwendet werden (siehe Beispiel).

<FileMirror Source="" Destination="" ExcludeFiles="" ExcludeDirectories="" Message="{@ResultMessage}" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• Source: Quellpfad oder Quelldatei.
• Destination: Zielpfad oder Zieldatei.
• ExcludeFiles: (Optional) Semikolon-getrennte Liste von Dateimustern, die ausgeschlossen werden sollen.
• ExcludeDirectories: (Optional) Semikolon-getrennte Liste von Verzeichnismustern, die ausgeschlossen werden sollen.
• Message: Variable, in der die Ausgabe oder Meldung gespeichert wird.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Variable, in der gespeichert wird, ob die Aktion erfolgreich ausgeführt wurde (true oder false).
• IgnoreError: (Optional) Gibt an, ob Fehler ignoriert werden sollen (true oder false, Standardwert: false).

Beispiel:

<Batch>
    <FileMirror Source="\\...\Software" Destination="D:\Software" ExcludeFiles=".windows*;AlbumArt*;Thumbs.db" ExcludeDirectories=".*" Message="{@ResultMessage}" Condition="" Variable="{@Result}" IgnoreError="false" />
    <Print Text="{@ResultMessage}" Condition="" Variable="{@Result}" IgnoreError="false" />
</Batch>

 

Zip#

Die Aktion Zip packt eine angegebene Datei/Verzeichnis (Attribut: Source) in ein Zip-Archiv (Attribut: Destination). 

<Zip Source="" Destination="" Password="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• Source: Quellpfad oder Quelldatei.
• Destination: Zielpfad oder Zieldatei.
• Password: Passwort für die Authentifizierung.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Variable, in der gespeichert wird, ob die Aktion erfolgreich ausgeführt wurde (true oder false).
• IgnoreError: (Optional) Gibt an, ob Fehler ignoriert werden sollen (true oder false, Standardwert: false).
   

UnZip#

Die Aktion UnZip entpackt ein angegebenes Zip-Archiv (Attribut: Source) in ein Zielverzeichnis (Attribut: Destination).

<UnZip Source="" Destination="" Password="" Condition="" Variable="{@Result}" IgnoreError="false" />

Attribute:

• Source: Quellpfad oder Quelldatei.
• Destination: Zielpfad oder Zieldatei.
• Password: Passwort für die Authentifizierung.
• Condition: (Optional) Steuert die Ausführung der Aktion. Wenn die Bedingung nicht erfüllt ist, wird die Aktion übersprungen.
• Variable: (Optional) Variable, in der gespeichert wird, ob die Aktion erfolgreich ausgeführt wurde (true oder false).
• IgnoreError: (Optional) Gibt an, ob Fehler ignoriert werden sollen (true oder false, Standardwert: false).