Раздел «Скрипты» позволяет вызвать программу или скрипт либо отправить уведомление по электронной почте на определённом этапе выполнения задания.
- Перед Анализом
- После Анализа без изменений
- После Синхронизации
- Отправка электронных писем
- Вызов программ
- Примеры скриптов
Перед Анализом
Если поле не пустое, указанное действие выполняется непосредственно перед началом анализа.
Если вызванная программа возвращает ненулевой код возврата или завершается сбоем, анализ не запускается.
Если вызванная программа завершается успешно и возвращает нулевой код возврата, анализ выполняется.

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

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

Отправка электронных писем
Если значение поля скрипта содержит символ «@», GoodSync отправляет электронное письмо на адрес (адреса), указанный в параметре.
Несколько адресов электронной почты необходимо разделять запятой или точкой с запятой:
user1@server.com; user2@hotmail.com
Если в поле (полях) указаны только адреса электронной почты, отправляется письмо со стандартным текстом. Чтобы задать собственный текст письма, можно добавить перед командой (командами) некоторые из следующих параметров:

Пример:
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%

Выполнить пакетный скрипт перед анализом и передать ему путь к левой папке синхронизации в качестве аргумента:
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
С помощью этого скрипта можно запускать задания последовательно.
