Скрипты (скрипты и email)

Раздел «Скрипты» позволяет вызвать программу или скрипт либо отправить уведомление по электронной почте на определённом этапе выполнения задания.

  1. Перед Анализом
  2. После Анализа без изменений
  3. После Синхронизации
  4. Отправка электронных писем
  5. Вызов программ
  6. Примеры скриптов

Перед Анализом

Если поле не пустое, указанное действие выполняется непосредственно перед началом анализа.

Если вызванная программа возвращает ненулевой код возврата или завершается сбоем, анализ не запускается.

Если вызванная программа завершается успешно и возвращает нулевой код возврата, анализ выполняется.

Снимок экрана, на котором выделено поле «Перед Анализом» в разделе «Скрипты» окна «Опции»

После Анализа без изменений

Если поле не пустое, указанное действие выполняется сразу после завершения анализа.

ПРИМЕЧАНИЕ: Действие выполняется, только если анализ завершился без изменений.

Снимок экрана, на котором выделено поле «После Анализа без изменений» в разделе «Скрипты» окна «Опции»

После Синхронизации

Если поле не пустое, указанное действие выполняется сразу после завершения синхронизации.

Снимок экрана, на котором выделено поле «После Синхронизации» в разделе «Скрипты» окна «Опции»

Отправка электронных писем

Если значение поля скрипта содержит символ «@», GoodSync отправляет электронное письмо на адрес (адреса), указанный в параметре.

Несколько адресов электронной почты необходимо разделять запятой или точкой с запятой:
user1@server.com; user2@hotmail.com

Если в поле (полях) указаны только адреса электронной почты, отправляется письмо со стандартным текстом. Чтобы задать собственный текст письма, можно добавить перед командой (командами) некоторые из следующих параметров:

Префиксы команд и примеры отправки электронных писем с помощью функции «Скрипты» в GoodSync

Пример:
noattach: user@example.com: Synced %SYNCOK% items, changed items were %CHANGED% 

Здесь «noattach» указывает, что журнал синхронизации не будет прикреплён к письму. Письмо будет отправлено на адрес user@example.com и будет содержать параметры %SYNCOK% (количество успешно синхронизированных файлов и папок) и %CHANGED% (количество успешно синхронизированных изменённых элементов).

ПРИМЕЧАНИЕ: Перед отправкой писем с помощью скриптов убедитесь, что параметры вашего SMTP-сервера настроены правильно.

Вызов программ

Если значение поля скрипта не содержит символа «@», GoodSync запускает указанную в параметре программу с переданными ей аргументами:
program-name %ARG1% %ARG2% %ARG3% ...
где аргументами могут быть следующие переменные (регистр букв в именах всех переменных учитывается):

%JOBNAME% Имя задания
%RESULT% Результат: "" при успешном выполнении или "сообщение о критической ошибке"
%LOGPATH% Путь к файлу журнала в кавычках "..."
%LF% Путь к левой папке в кавычках "..."
%LF_ACT% Фактический (=VolumeName\folder -> f:\folder) путь к левой папке в кавычках "..."
%RF% Путь к правой папке в кавычках "..."
%RF_ACT% Фактический (=VolumeName\folder -> f:\folder) путь к правой папке в кавычках "..."
%CHANGED% Количество изменённых элементов на этапе после анализа
%ERRORS% Количество ошибок на этапе после анализа или после синхронизации
%CONFLICTS% Количество конфликтов на этапе после анализа или после синхронизации
%SYNCOK% Количество успешно синхронизированных элементов на этапе после синхронизации
%TSTART% Время запуска задания
%TFINISH% Время завершения задания
%TELAPSED% Время выполнения задания в минутах, от запуска до завершения

ПРИМЕЧАНИЕ: Указывайте расположение программы или скрипта с помощью абсолютных путей. Если имя программы содержит пробелы, его необходимо заключить в двойные кавычки, например:
"C:\Documents and Settings\John Smith\My Documents\myscript.vbs"

Если перед скриптом или уведомлением по электронной почте указан префикс «errors:», он запускается только в следующих случаях:

  • при анализе или синхронизации возникли критические ошибки, ИЛИ
  • при анализе или синхронизации возникли некритические ошибки, ИЛИ
  • при анализе возникли конфликты.

Примеры скриптов

Вызвать Notepad, чтобы показать файл журнала после завершения синхронизации:
notepad %LOGPATH%

Пример вызова Notepad для показа файла журнала после завершения синхронизации

Выполнить пакетный скрипт перед анализом и передать ему путь к левой папке синхронизации в качестве аргумента:
C:\MyScripts\Script.bat %LF_ACT%

Пример выполнения пакетного скрипта с передачей пути к левой папке синхронизации в качестве аргумента перед анализом

Отправить уведомление по электронной почте на адрес user@example.com, если во время синхронизации возникнут ошибки. Файл журнала не прикреплять:
noattach: errors: user@example.com

Пример отправки уведомления по электронной почте без прикрепления журнала при возникновении ошибок во время синхронизации

Отправить на адрес user@example.com письмо с именем задания и конфликтами, обнаруженными во время анализа. Кроме того, прикрепить к письму файл журнала:
errors: user@example.com: Conflicts detected in %JOBNAME%, %CONFLICTS%

Пример отправки письма с именем задания и конфликтами, обнаруженными во время анализа, с прикреплённым файлом журнала

Запустить задание с именем «Job Name» после завершения текущего задания:
"C:\Program Files\Siber Systems\GoodSync\GoodSync.exe" job "Job Name" /sync

С помощью этого скрипта можно запускать задания последовательно.

Пример последовательного запуска заданий с помощью скриптов в GoodSync

Вернуться наверх