Scripts (версия 3.xx)/Обзвон абонентов
Версия от 09:21, 25 октября 2013; McBurns (обсуждение | вклад)
- Первая часть скрипта подготавливает классы и объекты, необходимые для работы скрипта. Описание дано в комментариях к каждой строке за исключением класса 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\\Sound.js')); // Воспроизведение звуков
eval (Script.GetFileContent ('Common\\Classes\\Device.js')); // Устройство
eval (Script.GetFileContent ('Common\\Classes\\Recording.js')); // Запись разговора
eval (Script.GetFileContent ('Common\\Classes\\DataRead.js')); // Чтение данных
// локальные модули для конкретного решения
eval (Script.GetFileContent ('Solutions\\Basic\\OutgoingCall\\Info.js')); // Информация и статистика
eval (Script.GetFileContent ('Solutions\\Basic\\OutgoingCall\\CDataWrite.js')); // Запись данных
eval (Script.GetFileContent ('Solutions\\Basic\\OutgoingCall\\COptions.js')); // Расширенные настройки
// =================== Начало работы сценария ===================
- Командой Script.SetDebug включается/отключается режим вывода дополнительных отладочных сообщений во время работы сценария. Как правило, это излишняя информация. Включать данный параметр рекомендуется только в случае, если сценарий выполняется некорректно и надо отправить разработчикам журнал с большим количеством информации. Без передачи параметра (true/false) функция включает режим отображения так, как установлено в конфигурации.
Script.SetDebug ();
- Команда Script.InLogInfo позволяет выводить информацию в журнал в интерфейсе программы и одновременно записывать её в системный журнал. В данном случае будет отметка о том, что сценарий загрузил все необходимые данные и запустился.
Script.InLogInfo ('Старт');
try {
- Далее определяется переменная Device класса CDevice, отвечающая за управление нашим устройством обзвона (модем, SIP и т.д.). Используется метод Open для устройства с проверкой успешности.
- Устанавливается в единицу переменная CycleCount, отвечающая за количество сеансов обзвона.
var Device = new CDevice ();
if (Device.Open ()) { // Если устройство открыто успешно
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) {
- Определяется переменная DataWrite класса CDataWrite, отвечающая за запись результатов в базу данных. Проверяется наличие полей в источнике данных, необходимых для чтения и/или записи данных во время выполнения сценария.
var DataWrite = new CDataWrite ();
if (DataRead.CheckFields (Record) &&
DataWrite.CheckFields (Record)) { // Проверка наличия полей для чтения и записи
- Запускается цикл обзвона для выбранных записей базы данных.
while (Record.Fetch ()) {
Script.WaitPause (); // Ожидание, если нажали на Паузу
Info.DataShow (Record); // Показываем текущую запись в информационном окне
- Определяется переменная Time класса CTime, отвечающая за работу с временем и расписание.
- Устанавливается пустое значение для переменной Status, в которую записывается результат звонка.
var Time = new CTime ();
Time.WaitTime (); // Ожидаем время начала обзвона, если указано
var Status = '';
- Определяется массив Phone, содержащий номера очередных телефонов из базы данных. Даже если не указан параметр «Несколько номеров в ячейке», всё равно приходит в виде массива.
var Phone = DataRead.GetPhone (Record);
if (!empty (Phone)) { // Если номер телефона не пуст
if (!DataRead.CheckIsOK (Record, Phone)) { // Если статус - не прозвонен
// и не достигнут предел количества попыток
try {
- Запускается цикл внутри массива Phone. Добавляется глобальная для сценария переменная [Phone], заменяемая в выражениях на значение текущего номера телефона.
- Выполняется проверка на остановку сценария пользователем или в результате возникшей ошибки.
for (var i in Phone) {
Script.AddVariable ('Phone', Phone[i]);
if (!Script.IsStop () &&
DataRead.WaitBeforeCall ()) { // Ожидание перед звонком
- Определяется переменная Sound класса CSound, отвечающая за воспроизведение абоненту звукового сообщения.
- Выполняются необходимые действия перед набором номера (например, предварительный синтез сообщений). Устанавливается статус текущего звонка в переменной PhoneStatus.
var Sound = new CSound ();
Sound.BeforeDial (Record);
var PhoneStatus = ''; // Начало звонка, текущий статус пуст
- Набор текущего номера абонента. Определяется переменная Result, содержащая результат набора номера.
var Result = Device.Dial (Phone[i]); // Набираем номер
- Определяется переменная Options класса COptions, отвечающая за параметры дозвона:
- время дозвона, после которого программа переходит к следующему номеру;
- время прослушивания сообщения абонентом;
- дублирование процесса соединения с абонентом на звуковую карту компьютера.
var Options = new COptions ();
- Действия при успешном дозвоне:
- определение переменной StartTime, содержащей время начала разговора;
- определение переменной Recording класса CRecording, отвечающая за запись ответа абонента в звуковой файл;
- включение записи ответа перед произнесением сообщения, если указано в конфигурации;
- произнесение сообщения;
- включение записи ответа после произнесения сообщения, отключение записи и сохранение записанных данных в файл, если указано в конфигурации;
- проставляется статс по времени прослушивания сообщения абонентом, если указано в конфигурации.
Завершение действий при успешном дозвоне.
if (Result == 0) { // Если абонент снял трубкy
var StartTime = new Date (); // Время начала разговора
var Recording = new CRecording ();
Recording.Start (Device); // Включение записи перед сообщением
Sound.Say (Device, Record); // Воспроизвести сообщение
Recording.Stop (Device, Record); // Завершаем запись сообщения
PhoneStatus = Options.CheckCallTime (StartTime); // Текущий статус по времени прослушивания
}
- При неудачном дозвоне причина заносится в переменную статуса текущего звонка PhoneStatus.
else {
PhoneStatus = Device.GetDialErrorText (Result); // Текущий статус при неудачном дозвоне
}
- Трубка положена.
- Подготавливается статус для базы данных. Если статус не успешный, заносим в переменную статуса значение статуса текущего звонка PhoneStatus.
Device.HangUp ();
if (Status != 'OK') Status = PhoneStatus; // Статус записи
- Проверяется статус текущего звонка и необходимость звонить по оставшимся номерам в ячейке.
if (DataRead.IsRemaining (PhoneStatus)) {
break; // Если удачный дозвон
// и не включен параметр звонить
// по оставшимся номерам в ячейке
}
- Выполняется проверка на остановку сценария пользователем. Записывается при необходимости соответствующий статус.
if (Script.IsStop ()) break;
} else Status = 'Прервано пользователем.';
- Завершение цикла внутри массива Phone.
}
}
- Действия сценария при возникновении ошибки. Записывается при необходимости соответствующий статус.
catch (Err) {
Device.HangUp ();
Status = Err.description;
Script.StopError (Err.description);
}
- Сохранение статуса в базу данных. Обновление окна статистики.
DataWrite.SetStatus (Record, DataRead.GetPhone (Record, true), Status); // Запись результата звонка
Info.Update (Status); // Обновление статистики
if (Script.IsStop ()) break;
}
- Сообщение в журнал, если пустой номер телефона в базе данных. Проверка на необходимость остановки в случае возникновения некритической ошибки.
} else Script.StopError ('Номер телефона пуст.');
if (Script.IsStop ()) break;
- Переход к следующей записи базы данных.
Record.Next ();
}
} // Отсутствуют необходимые поля базы данных
- Закрывается соединение с выбранными записями при достижении последней записи или в результате ошибки необходимых полей базы данных.
Record.Close ();
} else Script.InLogError ('Ошибка получения данных для обзвона.');
} else Script.InLogInfo ('Отсутствуют кандидаты на обзвон.');
- Ожидание между звонками, если нет сигнала остановки сценария.
if (!Script.IsStop ()) DataRead.CycleWait ();
- Закрывается соединение с базой данных.
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 ('Стоп');