Scripts (версия 3.xx)/Обзвон абонентов

Материал из Call Office Wiki
Перейти к навигации Перейти к поиску
Первая часть скрипта подготавливает классы и объекты, необходимые для работы скрипта. Описание дано в комментариях к каждой строке за исключением класса 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 ('Стоп');