Scripte (Skripte/E-Mail)

Im Abschnitt „Scripte“ legen Sie fest, dass in einer bestimmten Phase eines Auftragslaufs ein Programm, ein Skript oder eine E-Mail-Benachrichtigung ausgelöst wird.

  1. Vor Analyse
  2. Nach Analyse
  3. Nach Synchronisation
  4. E-Mails senden
  5. Programme aufrufen
  6. Skriptbeispiele

Vor Analyse

Ist das Feld nicht leer, wird die angegebene Aktion unmittelbar vor Beginn der Analyse ausgeführt.

Gibt das aufgerufene Programm einen Rückgabecode ungleich null zurück oder schlägt es fehl, wird die Analyse nicht gestartet.

Ist das aufgerufene Programm erfolgreich und gibt den Rückgabecode null zurück, wird die Analyse gestartet.

Screenshot mit hervorgehobenem Feld „Vor Analyse“ im Abschnitt „Scripte“ der Auftragsoptionen

Nach Analyse

Ist das Feld nicht leer, wird die angegebene Aktion unmittelbar nach Abschluss der Analyse ausgeführt.

HINWEIS: Die Aktion wird nur ausgeführt, wenn die Analyse ohne Änderungen abgeschlossen wird.

Screenshot mit hervorgehobenem Feld „Nach Analyse“ im Abschnitt „Scripte“ der Auftragsoptionen

Nach Synchronisation

Ist das Feld nicht leer, wird die angegebene Aktion unmittelbar nach Abschluss der Synchronisierung ausgeführt.

Screenshot mit hervorgehobenem Feld „Nach Synchronisation“ im Abschnitt „Scripte“ der Auftragsoptionen

E-Mails senden

Enthält der Wert eines Skriptfelds das Zeichen „@“, sendet GoodSync eine E-Mail an die in der Option angegebene(n) Adresse(n).

Mehrere E-Mail-Adressen müssen durch Komma oder Semikolon getrennt werden:
user1@server.com; user2@hotmail.com

Sind in den Feldern nur E-Mail-Adressen angegeben, wird ein Standard-E-Mail-Text gesendet. Für eigene E-Mails können Sie den Befehlen einige der folgenden Optionen voranstellen:

Befehlspräfixe und Beispiele für das Senden von E-Mails mit der Funktion Scripte in GoodSync

Beispiel:
noattach: user@example.com: Synced %SYNCOK% items, changed items were %CHANGED%

Hier legt „noattach“ fest, dass der E-Mail kein Synchronisierungsprotokoll angehängt wird. Die E-Mail wird an user@example.com gesendet und enthält die Parameter %SYNCOK% (Anzahl der erfolgreich synchronisierten Dateien/Ordner) und %CHANGED% (Anzahl der erfolgreich synchronisierten geänderten Elemente).

HINWEIS: Bevor Sie E-Mails über Scripte versenden, vergewissern Sie sich, dass Ihre SMTP-Servereinstellungen korrekt konfiguriert sind.

Programme aufrufen

Enthält der Wert eines Skriptfelds kein „@“, führt GoodSync das in der Option angegebene Programm aus und übergibt ihm Argumente:
program-name %ARG1% %ARG2% %ARG3% ...
Als Argumente sind folgende Werte möglich (bei allen Variablennamen wird zwischen Groß- und Kleinschreibung unterschieden):

%JOBNAME% Auftragsname
%RESULT% Ergebnis: "" bei Erfolg oder "Meldung des schwerwiegenden Fehlers"
%LOGPATH% Pfad der Protokolldatei in "..."
%LF% Pfad des linken Ordners in "..."
%LF_ACT% Aufgelöster (=VolumeName\folder -> f:\folder) Pfad des linken Ordners in "..."
%RF% Pfad des rechten Ordners in "..."
%RF_ACT% Aufgelöster (=VolumeName\folder -> f:\folder) Pfad des rechten Ordners in "..."
%CHANGED% Anzahl der geänderten Elemente in Nach Analyse
%ERRORS% Anzahl der Fehler in Nach Analyse oder Nach Synchronisation
%CONFLICTS% Anzahl der Konflikte in Nach Analyse oder Nach Synchronisation
%SYNCOK% Anzahl der erfolgreich synchronisierten Elemente in Nach Synchronisation
%TSTART% Startzeit des Auftrags
%TFINISH% Endzeit des Auftrags
%TELAPSED% Laufzeit des Auftrags von Start bis Ende in Minuten

HINWEIS: Geben Sie den Speicherort des Programms oder Skripts bitte mit einem absoluten Pfad an. Enthält der Programmname Leerzeichen, muss er wie folgt in doppelte Anführungszeichen gesetzt werden:
"C:\Documents and Settings\John Smith\My Documents\myscript.vbs"

Wird einem Skript oder einer E-Mail-Benachrichtigung „errors:“ vorangestellt, wird es bzw. sie nur ausgeführt, wenn:

  • bei der Analyse oder Synchronisierung schwerwiegende Fehler aufgetreten sind, ODER
  • bei der Analyse oder Synchronisierung nicht schwerwiegende Fehler aufgetreten sind, ODER
  • bei der Analyse Konflikte aufgetreten sind.

Skriptbeispiele

Notepad aufrufen, um nach Abschluss der Synchronisierung die Protokolldatei anzuzeigen:
notepad %LOGPATH%

Beispiel für den Aufruf von Notepad zur Anzeige der Protokolldatei nach Abschluss der Synchronisierung

Vor der Analyse ein Batch-Skript ausführen und ihm den Pfad des linken Synchronisierungsordners als Argument übergeben:
C:\MyScripts\Script.bat %LF_ACT%

Beispiel für das Ausführen eines Batch-Skripts, dem vor der Analyse der Pfad des linken Synchronisierungsordners als Argument übergeben wird

Eine E-Mail-Benachrichtigung an user@example.com senden, wenn bei der Synchronisierung Fehler auftreten, ohne die Protokolldatei anzuhängen:
noattach: errors: user@example.com

Beispiel für das Senden einer E-Mail-Benachrichtigung ohne angehängtes Protokoll, wenn bei der Synchronisierung Fehler auftreten

Eine E-Mail mit dem Auftragsnamen und den bei der Analyse erkannten Konflikten an user@example.com senden und zusätzlich die Protokolldatei anhängen:
errors: user@example.com: Conflicts detected in %JOBNAME%, %CONFLICTS%

Beispiel für das Senden einer E-Mail mit dem Auftragsnamen und den bei der Analyse erkannten Konflikten sowie angehängter Protokolldatei

Nach Abschluss des aktuellen Auftrags den Auftrag mit dem Namen „Job Name“ ausführen:
"C:\Program Files\Siber Systems\GoodSync\GoodSync.exe" job "Job Name" /sync

Mit diesem Skript können Sie Aufträge nacheinander ausführen.

Beispiel für das sequenzielle Ausführen von Aufträgen über Scripte in GoodSync

Nach oben