Урок 23 Периодический запуск служебных сценариев

Материал из Oktell
Перейти к: навигация, поиск
Наверх К предыдущему уроку


Введение

На прошлом уроке рассматривался ручной запуск сценариев, однако такой способ на практике применяется очень редко. Благодаря тому, что служебные сценарии могут запускаться в любые моменты времени появляется еще один способ запуска - периодический.

Периодический запуск применяется для решения следующих задач:

  • Автоматический сбор данных и мониторинг внешних систем. В рамках задачи сценарий рассчитывает собственные показатели (например, из БД) или обращается во внешний сервис, например, ящик электронной почты, WebCRM, личный кабинет SMS-провайдера. Как правило, внешняя система имеет некоторый набор команд, называемый API, с помощью которого можно получить требуемую информацию. При запуске служебный сценарий выполняет команды API для получения количества заявок с помощью компонента “Web-запрос”. Полученный ответ записывается в переменную, которая затем анализируется с помощью компонента "Парсер". Полезная информация записывается в базу данных Oktell с пометкой о времени.
  • Вычисление данных. Во время сбора данных в таблицы обычно попадает детализированная информация по проекту. Например, в таблице фиксируется каждая активность и ее параметры, такие как дата начала и завершения работы, имена сотрудников, принимающих участие и другие. Для общих отчетов по работе компании необходимо дополнительно преобразовывать полученные данные - это может быть дополнительная фильтрация по менеджерам, суммирование всех заявок и времени их выполнения, разделение на подгруппы, вычисление минимальных, средних и максимальных значений, а также любые другие операции.
  • Контроль данных. Служебные сценарии также применяются для оповещения супервизоров. Например, сотрудники за весь день выполнили 70% плана. Если при очередном запуске система определяет критический уровень показателя, то она уведомляет об этом супервизора по SMS или E-mail. Возможны и другие варианты оповещения. С помощью таких настроек офис всегда остается под контролем, где бы ни находилось руководство.
  • Системные действия. Сценарии можно применять для управления файлами и загрузками, очищать или архивировать документы в системных папках и для других действий.


Проектирование сценария

Задача: В компании реализуется сервис "Обратный звонок с сайта" с помощью которого любой желающий может оставить свои контактные данные и в течении 5 минут ему перезвонит специалист по продажам.

Задачу планируется решать с помощью почтового сервиса. После заполнения формы с номером телефона, с сайта отправляется электронное письмо на определенный адрес. Oktell постоянно мониторит электронную почту и в случае распознавания целевого письма коммутирует клиента и оператора.

Решение задачи начинается с создания служебного сценария. Вид сценария показан на рисунке:


Урок23 001.png


Компонент "Получение Email". Получает электронное письмо и сохраняет его части в соответствующие переменные.

  • Способ получения - указываются настройки подключения к POP3-серверу.
  • Кому - переменная to (строковая)
  • От кого - переменная from (строковая)
  • Тема - переменная theme (строковая)
  • Текст письма - переменная text1 (строковая)
  • Текст письма часть 2 - переменная text2 (строковая)
  • Текст письма часть 3 - переменная text3 (строковая)
  • Удалять с сервера - Да
  • Путь к папке с вложениями в переменную - folder (строковая)

ВНИМАНИЕ: Включенная настройка "Удалять с сервера" считывает с почтового сервера последнее (позднее) письмо, после чего оно удаляется. Таким образом обеспечивается перебор всех писем. При выключенной настройке письма не удаляется и считывается самое первое (раннее) сообщение.


Компонент "Ошибка". Уведомление администратору системы об ошибке получения письма

  • Текст - строка Error.


Компонент "Писем нет". Уведомление администратору системы об отсутствии писем в почтовом ящике.

  • Текст - строка Error.


Компонент "Соединение частей письма". Чтобы получить единый текст письма в переменную, производится конкатенация (объединение) частей письма.

  • Переменная - text
  • Значение - выражение [text1]+endline+[text2]+endline+[text3]


Компонент "Ув1"- Отладочное уведомление для вывода значений переменных.

  • Текст - выражение
'To '+[to]+endline+
'From '+[from]+endline+
'Theme '+[theme]+endline+endline+
[text]+endline+endline+
'Folder '+[folder]


Компонент "В нижний регистр". Приводит текст письма к нижнему регистру. Это нужно для удобства поиска кодовой фразы и уменьшения ошибок при анализе. Среди функций Oktell подобного преобразования пока нет, поэтому используется функция SQL:

select @out=lower(@in)

где @in и @out - переменная text


Компонент "Определяем номер". Анализирует текст письма на предмет нахождения кодовой фразы "позвоните мне на номер" и выделяет все рядом стоящие цифры с помощью регулярных выражений.

  • Документ - переменная text
  • Алгоритм - регулярные выражения
  • Поисковый запрос - позвоните мне на номер[\s]+([0-9]+)
  • Функция - Содержимое
  • Номер элемента - 0
  • Результат в переменную - переменная number (строковая)


Компонент "Номер определился?". Проверяет переменную number на содержание в ней номера телефона клиента. Если строка пустая, то сценарий заканчивается.

  • Аргумент 1 - переменная number
  • Аргумент 2 - пустая строка
  • Тип сравнения - =


Компонент "Оповещаем оператора". Если переменная number не пустая, то эта информация выводится администратору для контроля и отладки.

  • Текст - выражение
'Задание на звонок с письма:'+endline+[number]


Компонент "Коммутация". Соединяет пользователя из группового номера 105 и абонента.

  • Абоненты А - строка 105
  • Абоненты Б - переменная number
  • Последовательность - Сначала А, потом Б
  • CallerId для A - строка Вызов с письма


ВНИМАНИЕ: Сценарий можно улучшить, добавив более строгую проверку номера, например, на количество цифр и маршрутизируя звонок в определенные линии. Однако, эта доработка не является принципиальной в рамках данного урока. Более того, при массовом приеме заявок с сайта рекомендуется сделать цикл по почтовому ящику.


Создание служебной задачи

Созданный сценарий необходимо запускать хотя бы раз в минуту для быстрого реагирования на поступающие заявки от клиентов. Oktell позволяет сделать это автоматически с помощью сервиса служебных задач. Фактически, вы назначаете сценарий на служебную задачу, которая после активации с некоторым периодом начинает его запускать.

1. Перейдите в модуль Администрирование/Общие настройки. Откройте вкладку "Служебные задачи".

2. Для создания служебной задачи нажмите "Добавить"

3. Настройте задание. Введите следующие параметры:

  • Название - наименование задания. В примере "Звонок с сайта".
  • Служебный сценарий - Выберите нужный служебный сценарий из списка. В примере "Урок 23".
  • Параметр запуска - При необходимости можно указать стартовый параметр. В примере не указан
  • Тип запуска - существуют три варианта запуска
    • Однократный в указанное время позволяет запустить сценарий отложенно в указанное время.
    • Периодический запуск - наиболее распространенный вариант, позволяет запускать сценарий с некоторым периодом.
    • При запуске сервера - вариант, который, как правило, применяется для выставления каких-либо первоначальных глобальных переменных, добавления динамических объектов карты сети или уведомления сторонних систем.

В примере выбран "Периодический".

Следующие настройки приведены только для периодического запуска:

    • Период актуальности - интервал дат, в течении которого можно запускать данный сценарий. В примере "12.08.2014 - 12.08.2015"
    • Запускать с интервалом - период запуска сценария. В примере "Раз в минуту"
    • Расписание - расписание задачи для запуска сценария. В примере будние дни с 10 до 16.

4. После ввода настроек нажмите "Сохранить".

5. Для активации задачи установите крестик напротив данной задачи.


Наверх К предыдущему уроку