Script-Engine

Aus Dupe Files Wiki

Die Script-Engine von Dupe Files ermöglicht das Automatisieren von immer wiederkehrenden Prozessen (Tasks genannt).

Ein Script definiert eine Liste von durchzuführenden Arbeitsschritten (TaskItem), wie beispielsweise "Füge Verzeichnis xy hinzu, überprüfe, lösche Duplikate in Papierkorb, erstellte Bericht."

Inhaltsverzeichnis 1 Syntax 2 Meta Angaben 2.1 Name 2.2 Title 2.3 Author 2.4 Website 2.5 Description 2.6 Version 3 Deklaration von Variablen 4 Befehle ausführen 5 Befehlsliste 5.1 Objekte 5.2 Dialoge 5.3 Vergleich 5.4 Export 5.5 Anwendung 6 Beispiel Scripte

Syntax

Jede Zeile eines Scripts muss mit einem Semikolon (;) enden.

Befehle werden der Reihe nach abgearbeitet.

Meta Angaben

Meta Angaben dienen den Dupe Files dazu, Informationen aus den Scripten auslesen zu können.

Beispiel:

//Name=Create Hash List
//Title=Hash Liste erstellen...
//Author=dahead
//Website=http://blog.dahead.de/dupefiles
//Description=Erstellt einen Hash (Checksummen) Liste von Dateien...
//Version=1.0

Name

Gibt den internen Namen des Scripts an.

Title

Der Titel unter dem Dupe Files das Script im Menü anzeigt.

Author

Name des Skript Autors.

Website

URL der Webseite des Autors.

Description

Beschreibung über das Script (was tut es, wozu?)

Version

Die Versionsnummer des Scripts.

Deklaration von Variablen

Variablen werden ähnlich wie in anderen Programmiersprachen deklariert. Ein $-Zeichen signalisiert Dupe Files die Deklaration einer Variable. Gefolgt vom Namen der Variable und der Wertzuweisung:

Syntax:

$variablenname = variablenwert;

Die Verwendung der Variable sieht dann wie folgt aus:

Syntax:

Dialogs.ShowMessage($variablenwert);

Praxisbeispiel:

$test1 = "Dies ist ein Test!";
Dialogs.ShowMessage($test1);

Das obige Beispiel würde also der Variable $test1 den Wert "Dies ist ein Test!" zuweisen. Die Zeile "Dialogs.ShowMessage($test1)" zeigt den Dialog mit der Meldung $test1 an.

Befehle ausführen

Befehle werden in folgender Art notiert:

Syntax:

Befehlname;
Befehlname.Tuwas;

Befehle werden immer der Reihe nach ausgeführt, also Zeile für Zeile.

Befehlsliste

Objekte

• Objects.New;
• Objects.Save;
• Objects.Add($parameter);

Dialoge

• Dialogs.AddFiles;
• Dialogs.AddTwoFiles;
• Dialogs.AddDirectory;
• Dialogs.ShowMessage($parameter);

Vergleich

• Compare.Start;

Export

• Export.SFV($filename);
• Export.XML($filename);
• Export.CSV($filename);

Anwendung

• App.Exit;

Beispiel Scripte

Dieses Beispiel erstellt eine SFV-Datei von beliebig vielen Dateien, die der Benutzer auswählt und speichert diese Liste als Datei ab.

//Name=Create Hash List
//Title=Hash Liste erstellen...
//Author=dahead
//Website=http://blog.dahead.de/dupefiles
//Description=Erstellt einen Hash (Checksummen) Liste von Dateien...
//Version=1.0

ShowErrors=False;
SkipOnError=False;
Output=True;
OutputFilename=Dialogs.SelectFilename;

Objects.New;

Dialogs.AddFiles;

$file=C:\test.sfv;
Export.SFV($file);

App.Exit;