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

Этот обзор раздела «Скрипты» в окне «Опции» задания относится как к GoodSync для Windows, так и к GoodSync для Mac, если не указано иное.

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

  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

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