Scripts (версия 3.xx)/Отправка SMS
Перейти к навигации
Перейти к поиску
- Первая часть скрипта подготавливает классы и объекты, необходимые для работы скрипта. Описание дано в комментариях к каждой строке за исключением класса Script, который отвечает за непосредственное выполнение скрипта.
eval (GetFileContent ('Common\\Classes\\Script.js')); // необходимо для работоспособности сценария
var Script = new Script (); // необходимо для работоспособности сценария
// =================== Подключение модулей ===================
eval (Script.GetFileContent ('Common\\Classes\\Database.js')); // База данных
eval (Script.GetFileContent ('Common\\Classes\\Time.js')); // Расписание
eval (Script.GetFileContent ('Common\\Classes\\Device.js')); // Устройство
eval (Script.GetFileContent ('Common\\Classes\\SMS.js')); // Обработка SMS
eval (Script.GetFileContent ('Common\\Classes\\DataRead.js')); // Чтение данных
// локальные модули для конкретного решения
eval (Script.GetFileContent ('Solutions\\Basic\\SendSMS\\Info.js')); // Информация и статистика
eval (Script.GetFileContent ('Solutions\\Basic\\SendSMS\\CDataWriteSMS.js')); // Запись данных
eval (Script.GetFileContent ('Solutions\\Basic\\SendSMS\\COptions.js')); // Расширенные настройки
// =================== Начало работы сценария ===================
- Командой Script.SetDebug включается/отключается режим вывода дополнительных отладочных сообщений во время работы сценария. Как правило, это излишняя информация. Включать данный параметр рекомендуется только в случае, если сценарий выполняется некорректно и надо отправить разработчикам журнал с большим количеством информации. Без передачи параметра (true/false) функция включает режим отображения так, как установлено в конфигурации.
Script.SetDebug ();
- Команда Script.InLogInfo позволяет выводить информацию в журнал в интерфейсе программы и одновременно записывать её в системный журнал. В данном случае будет отметка о том, что сценарий загрузил все необходимые данные и запустился.
Script.InLogInfo ('Старт');
try {
- Далее определяется переменная Device класса CDevice, отвечающая за управление нашим устройством рассылки сообщений (модем, SMS-шлюз). Используется метод Open для устройства с проверкой успешности.
var Device = new CDevice ();
if (Device.Open ()) { // Если устройство открыто успешно
Script.InLogDebug ('Устройство открыто успешно');
- Определяется переменная Options класса COptions, отвечающая за управление нашим устройством рассылки сообщений (модем, SMS-шлюз). Используется метод Open для устройства с проверкой успешности.
- Устанавливается в единицу переменная CycleCount, отвечающая за количество сеансов обзвона.
var Options = new COptions ();
var CycleCount = 1;
- Определяется переменная DataRead класса CDataRead, отвечающая за получение данных из базы данных, проверяется переменная CycleCount на превышение значения. Если переменная не превышает значения, записанного в конфигурации, пишется сообщение в журнал о порядковом номере цикла рассылки в текущем сеансе.
var DataRead = new CDataRead ();
while (DataRead.CheckCycle (CycleCount)) { // Проверка количества попыток обзвона в сеансе
Script.InLogInfo ('Цикл рассылки <b>%s</b>', CycleCount);
- Определяется переменная Database класса CDatabase, отвечающая за работу с источником данных. Проверяется соединение с базой данных.
var Database = new CDatabase ();
if (Database.Open ()) { // Если соединение с базой данных успешное
- Определяется переменная Info класса CInfo, отвечающая за отображение статистики во вкладке «Журнал». Проводится первый подсчёт статистики на основе выбранных в конфигурации параметров (учитывать/не учитывать отправку сообщений ранее, количество попыток отправки и т.д.)
var Info = new CInfo ();
if (Info.Count (Database, DataRead)) {
- Определяется переменная Record, содержащая набор методов и свойств работы с выборкой запроса, делается проверка на её корректность.
var Record = Database.Query (DataRead.Query ()); // Выбор записей в базе данных
if (Record) {
- Определяется переменная DataWriteSMS класса CDataWritSMSe, отвечающая за запись результатов в базу данных. Проверяется наличие полей в источнике данных, необходимых для чтения и/или записи данных во время выполнения сценария.
var DataWriteSMS = new CDataWriteSMS ();
if (DataRead.CheckFields (Record) &&
DataWriteSMS.CheckFields (Record)) {
- Запускается цикл рассылки для выбранных записей базы данных.
while (Record.Fetch ()) {
Script.WaitPause (); // Ожидание, если нажали на Паузу
Info.DataShow (Record); // Показываем текущую запись в информационном окне
- Определяется переменная Time класса CTime, отвечающая за работу с временем и расписание.
- Устанавливается пустое значение для переменной Status, в которую записывается результат отправления сообщения.
var Time = new CTime ();
if (Time.CheckTime ()) { // Проверка расписания
var Status = '';
- Определяется массив Phone, содержащий номера очередных телефонов из базы данных. Даже если не указан параметр «Несколько номеров в ячейке», всё равно приходит в виде массива.
var Phone = DataRead.GetPhone (Record);
if (!empty (Phone)) { // Если номер телефона не пуст
if (!DataRead.CheckIsOK (Record)) { // Если статус - не прозвонен
// и не достигнут предел количества попыток
try {
- Запускается цикл внутри массива Phone.
- Проверяется и выполняется, если задано, ожидание перед отправкой очередного сообщения.
for (var i in Phone) {
if (DataRead.WaitBeforeCall ()) { // Ожидание перед звонком
- Определяется переменная SMS класса CSMS, отвечающая за с сообщениями. В переменную TextSMS заносится текст сообщения для текущего абонента. При условии, что текст сообщения не пуст, запускается процесс рассылки.
var SMS = new CSMS ();
var TextSMS = SMS.GetText (Record);
if (!empty (TextSMS)) {
- Устанавливается статус текущей рассылки в переменной PhoneStatus.
var PhoneStatus = 'OK';
- Происходит отправка сообщения и вывод в журнал результата, который вернул метод SendSMS.
switch (Device.SendSMS (Phone[i], TextSMS, SMS.GetSender ())) {
case 0: Script.InLogInfo ('Сообщение по номеру %s отправлено успешно', Phone[i]); break;
case 4: PhoneStatus = 'Отправка сообщения прервана пользователем'; break;
case 5: PhoneStatus = 'Истекло время ожидания отправки сообщения абоненту ' + Phone[i]; break;
default: PhoneStatus = 'Ошибка отправки сообщения'; break;
}
- Вносится, если необходимо, результат текущей рассылки в переменную Status.
- Проверяется необходимость при успешной рассылке рассылать сообщения по оставшимся номерам в ячеке.
- Проверяется остановка скрипта пользователем.
if (Status != 'OK') Status = PhoneStatus; // Статус записи
if (DataRead.IsRemaining (PhoneStatus)) break; // Если удачный дозвон
// и не включен параметр звонить
// по оставшимся номерам в ячейке
if (Script.IsStop ()) break;
- В случае, если пустой текст сообщения, выводится соответствующее сообщение в журнал и останавливается выполнение сценария.
} else Script.StopError ('Отсутствует текст сообщения. Выполнение сценария прервано.');
if (!DataWriteSMS.SetStatus (Record, Phone[i],Status)) break;
}
if (Script.IsStop ()) break;
}
if (Script.IsStop ()) break;
}
- При возникновении ошибки в выполнении сценария выводится в журнал сообщение об ошибке и останавливается выполнение сценария.
catch (Err) {
Status = Err.description;
Script.StopError ('Ошибка в процессе отправки сообщений. ' + Err.description);
}
- Записывается при необходимости статус рассылки в базу данных, обновляется информация в окне статистики.
DataWriteSMS.SetStatus (Record, DataRead.GetPhone (Record, true), Status); // Запись результата звонка
Info.Update (Status);
}
- Останавливается скрипт, если пуст номер телефона. Выводится соответствующее сообщение в журнал.
} else Script.StopError ('Номер телефона пуст.');
- Если устройство не готово, ожидание в течение 1 секунды, затем проверка на остановку
} else Device.Wait (1000);
if (Script.IsStop ()) break;
- Переход к следующей записи в базе данных.
Record.Next ();
}
if (Script.IsStop ()) break;
- Если проверка на наличие необходимых полей в базе данных не прошла, закрывается выборка. Если нужна остановка, завершается цикл.
} // Отсутствуют необходимые поля базы данных
Record.Close ();
if (Script.IsStop ()) break;
- Не получены записи из базы данных. Выполнение сценария остановлено, соответствующее сообщение записывается в журнал.
} else Script.InLogError ('Ошибка получения данных для отправки сообщения');
- Ни одна запись в базе данных не соответствует условиям выполнения. Соответствующее сообщение записывается в журнал, закрывается соединение с базой данных.
} else Script.InLogInfo ('Отсутствуют кандидаты на отправку SMS');
Database.Close ();
}
- Увеличивается значение счетчика циклов CycleCount. Проводится проверка на остановку сценария.
CycleCount++;
if (Script.IsStop ()) break;
}
- Соединение с устройством закрывается. Конец цикла.
Device.Close ();
}
}
- Обработка ошибки выполнения сценария. Запись соответствующего сообщения в журнал. Закрытие соединения с базой данных. Закрытие устройства.
catch (Err) {
Script.InLogError ('Ошибка при работe сценария. %s. Код ошибки: %s', Err.description, Err.number);
if (Database) Database.Close ();
if (Device ) Device.Close ();
}
- Выводится в журнал метка остановки выполнения сценария.
Script.InLogInfo ('Стоп');