Примеры использования скриптовых системных событий — различия между версиями

Материал из TaxiMaster
Перейти к: навигация, поиск
 
(не показаны 3 промежуточные версии этого же участника)
Строка 1: Строка 1:
Пошаговая настройка нескольких примеров использования системных событий.
+
Пошаговая настройка нескольких примеров использования [[Системные события|системных событий]].
  
 
== Запрос погоды для глобального атрибута ==
 
== Запрос погоды для глобального атрибута ==
Строка 134: Строка 134:
 
#: [[Файл:Звонок, если водитель заехал в определенную зону действие.png|центр]]
 
#: [[Файл:Звонок, если водитель заехал в определенную зону действие.png|центр]]
 
# Нажимаем ОК в карточке системного события.
 
# Нажимаем ОК в карточке системного события.
 +
 +
== Проверка рейсов самолетов ==
 +
Система событий может проверять рейсы и информацию по ним, например, есть ли задержка прилета, в зависимости от времени задержки можно настроить нужные действия.
 +
 +
# В справочнике "Системные события" нажмем кнопку "Добавить".
 +
# В открывшемся окне указываем наименование, например "Проверка рейса".
 +
# Тип события выбираем в зависимости от того когда должно срабатывать событие, например, по расписанию, также можно сделать чтобы проверка происходила за определенное время до момента подачи.
 +
# Добавляем действие, которое будет происходить.
 +
## Тип действия - Задается скриптом.
 +
## Нажимаем кнопку "Исходный код" и вставляем текст скрипта (скрипт можно получить, обратившись в техническую поддержку ООО БИТ "Мастер"). Нажимаем ОК.
 +
## Заполняем значения параметров:
 +
### Уведомление оператору - включить/выключить. Текст сообщения, если нужно.
 +
### Уведомление водителю - включить/выключить. Текст сообщения, если нужно.
 +
### Изменение состояния заказа - включить/выключить. ИД нового состояния заказа, если нужно.
 +
### Изменение времени перехода в текущие - включить/выключить добавление резервных минут.
 +
### Ключ яндекса - ключ сервиса, который необходимо получить напрямую у представителя сервиса.
 +
### Количество резервных минут - количество минут, которые добавляются, чтобы изменить время перехода в текущие.
 +
### Снимать экипаж с заказа -  при задержке самолета заказ переводится в состояние с типом принят, при этом экипаж автоматически снимается.
 +
### Радиус поиска станций прилета - это радиус от координаты адреса подачи до возможных аэропортов.
 +
## Нажимаем ОК.
 +
##: [[Файл:Проверка рейсов самолетов.png|центр]]
 +
# Нажимаем ОК в карточке системного события.
 +
 +
== Проверка слов в заказе ==
 +
Система событий может в случае обнаружения определенных слов, применять какое-либо действие к заказу(менять состояние заказа, добавлять атрибут и прочее).
 +
 +
# В справочнике "Системные события" нажмем кнопку "Добавить".
 +
# В открывшемся окне указываем наименование, например "Проверка слов в заказе".
 +
# Тип события выбираем "Создание заказа".
 +
#: [[Файл:Проверка слов в заказе.png|центр]]
 +
# Добавляем действие, которое будет происходить.
 +
## Тип действия - Задается скриптом.
 +
## Нажимаем кнопку "Исходный код" и вставляем текст скрипта (скрипт можно получить, обратившись в техническую поддержку ООО БИТ "Мастер"). Нажимаем ОК.
 +
## Заполняем значения параметров:
 +
### Список запрещенных слов - указываем слова, которые не должны быть в заказах.
 +
### Список синонимов к слову ребенок - слова, при обнаружении которых необходимо подставить атрибут.
 +
### Далее следуя нужному бизнес процессу, заполняем остальные параметры скрипта.
 +
### Порт АПИ - порт, который указан в настройках Такси-Мастер.
 +
##: [[Файл:Проверка слов в заказе действие.png|центр]]
 +
## Нажимаем ОК.
 +
# Нажимаем ОК в карточке системного события.
 +
 +
== Смена группы экипажей у экипажа ==
 +
Система событий может изменить у экипажа группу экипажей, если экипаж имеет приоритет ниже определенного порога при уходе с линии.
 +
 +
# В справочнике "Системные события" нажмем кнопку "Добавить".
 +
# В открывшемся окне указываем наименование, например "Смена группы экипажей у экипажа".
 +
# Тип события выбираем "Экипаж ушел с линии".
 +
#: [[Файл:Смена группы экипажей у экипажа.png|центр]]
 +
# Добавляем действие, которое будет происходить.
 +
## Тип действия - Задается скриптом.
 +
## Нажимаем кнопку "Исходный код" и вставляем текст скрипта (скрипт можно получить, обратившись в техническую поддержку ООО БИТ "Мастер"). Нажимаем ОК.
 +
## Заполняем значения параметров:
 +
### Порог приоритета - значение приоритета, ниже которого будет происходить смена группы экипажей.
 +
### ИД группы экипажей, на которую будет смена. ИД группы экипажей можно посмотреть в карточке нужной группы в справочнике "Группы экипажей".
 +
###: [[Файл:ИД группы экипажей.png|центр]]
 +
### АПИ порт - порт, который указан в настройках Такси-Мастер.
 +
## Нажимаем ОК.
 +
##: [[Файл:Смена группы экипажей у экипажа действие.png|центр]]
 +
# Нажимаем ОК в карточке системного события.
 +
 +
[[Категория:Системные события]]

Текущая версия на 15:18, 7 июля 2021

Пошаговая настройка нескольких примеров использования системных событий.

Запрос погоды для глобального атрибута

Системные события позволяют в непогоду автоматически менять тариф или добавлять атрибут меняющий стоимость. Такой сценарий реализуется через запрос погоды в сервис Яндекс.Погода, а полученные данные записываются в глобальный атрибут.

Создаем нужные атрибуты в справочнике "Атрибуты":

  • Атрибут текущей температуры.
  • Атрибут скорость ветра.
  • Атрибут типа погоды.

Все атрибуты с типом значения "Число" (дополнительные параметры задавать не нужно) и признаком "Глобальный атрибут".

  1. В справочнике "Системные события" нажмем кнопку "Добавить".
  2. В открывшемся окне указываем наименование, например "Запрос погоды".
  3. Выбираем тип события "По расписанию".
  4. Указываем время, когда будет срабатывать событие. При этом обязательно нужно заполнить поля "Минуты" и "Секунды".
    Запрос погоды для глобального атрибута.png
  5. Добавляем действие, которое будет происходить.
    1. Тип действия - Задается скриптом.
    2. Нажимаем кнопку "Исходный код".
    3. Вставляем текст скрипта и нажимаем "ОК" (скрипт можно получить, обратившись в техническую поддержку ООО БИТ "Мастер").
    4. Вставляем значение своего ключа яндекс-погоды. Данный ключ нужно получить в своем кабинете разработчика на Яндекс.
    5. Указываем широту и долготу центра нужного населенного пункта.
    6. Устанавливаем следующие значения параметров:
      1. Текущее значение погоды.
        1. Атрибут текущей температуры - выбираем нужный глобальный атрибут.
        2. Список температур - задаем нужное количество периодов температур.
          1. Температура до - крайнее значение температуры данного периода. Заполняется для каждого периода.
          2. Значение для атрибута температуры - значение, которое будет принимать атрибут, если температура попадает в данный период. Заполняется для каждого периода.
        3. Атрибут скорость ветра - выбираем нужный глобальный атрибут.
        4. Список скорости ветра - задаем нужное количество периодов скорости ветра.
          1. Скорость ветра до - крайнее значение скорости ветра для данного периода. Заполняется для каждого периода.
          2. Значение для атрибута ветра - значение, которое будет принимать атрибут скорость ветра, если скорость ветра будет попадать в данный период. Заполняется для каждого периода.
        5. Атрибут типа погоды - выбираем нужный глобальный атрибут.
        6. Список типов погоды - задаем нужное количество периодов типов погоды.
          1. Тип погоды - указываем наименование типа погоды, которое может быть на сервисе погоды (значения должны быть указаны на одном из языков в точности как написано ниже). Возможные значения:
            1. clear — ясно.
            2. partly-cloudy — малооблачно.
            3. cloudy — облачно с прояснениями.
            4. overcast — пасмурно.
            5. drizzle — морось.
            6. light-rain — небольшой дождь.
            7. rain — дождь.
            8. moderate-rain — умеренно сильный дождь.
            9. heavy-rain — сильный дождь.
            10. continuous-heavy-rain — длительный сильный дождь.
            11. showers — ливень.
            12. wet-snow — дождь со снегом.
            13. light-snow — небольшой снег.
            14. snow — снег.
            15. snow-showers — снегопад.
            16. hail — град.
            17. thunderstorm — гроза.
            18. thunderstorm-with-rain — дождь с грозой.
            19. thunderstorm-with-hail — гроза с градом.
          2. Значение для атрибута типа погоды - значение, которое будет принимать атрибут при данном типе погоды.
      2. Остальные значения скрипта для веток "Погода на утро" и "Погода на вечер" заполняются аналогично.
    7. Нажимаем ОК.
      Запрос погоды для глобального атрибута действие.png
  6. Нажимаем ОК в карточке системного события.

Чтение глобального атрибута в расширенном тарифе

В расширенном тарифе (скрипт тарифа можно получить, обратившись в техническую поддержку ООО БИТ "Мастер") возможно выбрать глобальный атрибут, в зависимости от значения которого можно менять стоимость поездки.

Чтение глобального атрибута в расширенном тарифе.png

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

В "Значения атрибута" указываем количество значений, по которым будет меняться стоимость (столько значений, сколько указали для атрибута в скрипте изменения погоды).

Далее настраиваем параметры наценок, в зависимости от того, как должна происходить наценка.

Проверка штрафов ГИБДД

Система событий может автоматически проверять наличие штрафов на автомобилях, а при наличие штрафа сразу снимать нужную сумму со счета водителя.

  1. В справочнике "Системные события" нажмем кнопку "Добавить".
  2. В открывшемся окне указываем наименование, например "Проверка штрафов".
  3. Выбираем тип события "По расписанию".
  4. Указываем промежутки времени, через которые будет срабатывать событие.
    Проверка штрафов ГИБДД.png
  5. Добавляем действие, которое будет происходить.
    1. Тип действия - Задается скриптом.
    2. Нажимаем кнопку "Исходный код" и вставляем текст скрипта (скрипт можно получить, обратившись в техническую поддержку ООО БИТ "Мастер").
    3. Нажимаем ОК.
    4. Заполняем значения параметров:
      1. Апи ключ - ключ одного из сервисов проверки штрафов, который необходимо получить напрямую у представителя сервиса.
      2. Ид счета водителя - ИД счета, с которого будет происходить списание штрафа. ИД счета можно посмотреть в карточке нужного счета в справочнике "Типы счетов".
        Ид счета водителя.png
      3. Атрибут СТС - атрибут типа "Строка", который может быть привязан к автомобилю, в карточке каждого автомобиля в данный атрибут необходимо ввести полностью номер СТС.
      4. Блок уведомлений можно настроить как оповещать водителя, если это нужно, а также можно указать ИД типа события для записи в Журнал событий. ИД типа события можно посмотреть в карточке нужного типа события в справочнике "Типы событий для журнала событий".
        ИД типа события для записи в Журнал событий.png
        1. Можно использовать теги:
          1.  %carid% - ИД автомобиля.
          2.  %driverid% - ИД водителя.
          3.  %drivername% - ФИО водителя.
          4.  %penaltyday% - Дата штрафа.
          5.  %discountday% - До какого числа действует скидка на штраф.
          6.  %koapcode% - Номер статьи КОАП.
          7.  %koaptext% - Текст статьи КОАП.
          8.  %numpost% - Номер постановления.
          9.  %divisionname% - Номер дивизиона выписавшего штраф.
          10.  %divisionaddress% - Адрес данного дивизиона.
          11.  %divisioncode% - Код подразделения дивизиона.
          12.  %postkbk% - КБК.
          13.  %postsum% - Сумма штрафа.
        2. Нажимаем ОК.
      Проверка штрафов ГИБДД действие.png
  6. Нажимаем ОК в карточке системного события.

Звонок, если водитель заехал в определенную зону/район

Система событий может автоматически совершать звонки, когда водитель оказывается в определенной зоне или районе, например на шлагбаум, чтобы открыть его.

Нужен будет сценарий для телефонии.

Необходимы атрибуты "Атрибут флага дозвона" и "Атрибут последнего района" с типом "Число" и возможностью привязки к заказу и группе экипажей.

  1. В справочнике "Системные события" нажмем кнопку "Добавить".
  2. В открывшемся окне указываем наименование, например "Звонок на "шлагбаум".
  3. Выбираем тип события "По расписанию".
  4. Указываем промежутки времени, через которые будет срабатывать событие, то есть будет проводиться проверка в нужной ли зоне водитель, если да, то будет срабатывать отзвон. На примере проверка будет происходить 1 раз в минуту.
    Звонок, если водитель заехал в определенную зону.png
  5. Добавляем действие, которое будет происходить.
    1. Тип действия - Задается скриптом.
    2. Нажимаем кнопку "Исходный код" и вставляем текст скрипта (скрипт можно получить, обратившись в техническую поддержку ООО БИТ "Мастер"). Нажимаем ОК.
    3. Заполняем значения параметров:
      1. Список районов - количество районов, при въезде в которые нужно настроить отзвон.
        1. Район - выбрать нужный район, при въезде в который должен срабатывать отзвон. Настраивается для каждого района.
        2. Номер телефона для отзвона - номер телефона, куда будет совершаться звонок при въезде в данный район. Настраивается для каждого района.
      2. Наименование сценария отзвона - имя сценария телефонии.
      3. Атрибут флага дозвона - атрибут, который обозначает, что отзвон совершен.
      4. Атрибут последнего района - атрибут, который добавляется в заказ при заезде в район и удаляется при выезде.
    4. Нажимаем ОК.
    Звонок, если водитель заехал в определенную зону действие.png
  6. Нажимаем ОК в карточке системного события.

Проверка рейсов самолетов

Система событий может проверять рейсы и информацию по ним, например, есть ли задержка прилета, в зависимости от времени задержки можно настроить нужные действия.

  1. В справочнике "Системные события" нажмем кнопку "Добавить".
  2. В открывшемся окне указываем наименование, например "Проверка рейса".
  3. Тип события выбираем в зависимости от того когда должно срабатывать событие, например, по расписанию, также можно сделать чтобы проверка происходила за определенное время до момента подачи.
  4. Добавляем действие, которое будет происходить.
    1. Тип действия - Задается скриптом.
    2. Нажимаем кнопку "Исходный код" и вставляем текст скрипта (скрипт можно получить, обратившись в техническую поддержку ООО БИТ "Мастер"). Нажимаем ОК.
    3. Заполняем значения параметров:
      1. Уведомление оператору - включить/выключить. Текст сообщения, если нужно.
      2. Уведомление водителю - включить/выключить. Текст сообщения, если нужно.
      3. Изменение состояния заказа - включить/выключить. ИД нового состояния заказа, если нужно.
      4. Изменение времени перехода в текущие - включить/выключить добавление резервных минут.
      5. Ключ яндекса - ключ сервиса, который необходимо получить напрямую у представителя сервиса.
      6. Количество резервных минут - количество минут, которые добавляются, чтобы изменить время перехода в текущие.
      7. Снимать экипаж с заказа - при задержке самолета заказ переводится в состояние с типом принят, при этом экипаж автоматически снимается.
      8. Радиус поиска станций прилета - это радиус от координаты адреса подачи до возможных аэропортов.
    4. Нажимаем ОК.
      Проверка рейсов самолетов.png
  5. Нажимаем ОК в карточке системного события.

Проверка слов в заказе

Система событий может в случае обнаружения определенных слов, применять какое-либо действие к заказу(менять состояние заказа, добавлять атрибут и прочее).

  1. В справочнике "Системные события" нажмем кнопку "Добавить".
  2. В открывшемся окне указываем наименование, например "Проверка слов в заказе".
  3. Тип события выбираем "Создание заказа".
    Проверка слов в заказе.png
  4. Добавляем действие, которое будет происходить.
    1. Тип действия - Задается скриптом.
    2. Нажимаем кнопку "Исходный код" и вставляем текст скрипта (скрипт можно получить, обратившись в техническую поддержку ООО БИТ "Мастер"). Нажимаем ОК.
    3. Заполняем значения параметров:
      1. Список запрещенных слов - указываем слова, которые не должны быть в заказах.
      2. Список синонимов к слову ребенок - слова, при обнаружении которых необходимо подставить атрибут.
      3. Далее следуя нужному бизнес процессу, заполняем остальные параметры скрипта.
      4. Порт АПИ - порт, который указан в настройках Такси-Мастер.
      Проверка слов в заказе действие.png
    4. Нажимаем ОК.
  5. Нажимаем ОК в карточке системного события.

Смена группы экипажей у экипажа

Система событий может изменить у экипажа группу экипажей, если экипаж имеет приоритет ниже определенного порога при уходе с линии.

  1. В справочнике "Системные события" нажмем кнопку "Добавить".
  2. В открывшемся окне указываем наименование, например "Смена группы экипажей у экипажа".
  3. Тип события выбираем "Экипаж ушел с линии".
    Смена группы экипажей у экипажа.png
  4. Добавляем действие, которое будет происходить.
    1. Тип действия - Задается скриптом.
    2. Нажимаем кнопку "Исходный код" и вставляем текст скрипта (скрипт можно получить, обратившись в техническую поддержку ООО БИТ "Мастер"). Нажимаем ОК.
    3. Заполняем значения параметров:
      1. Порог приоритета - значение приоритета, ниже которого будет происходить смена группы экипажей.
      2. ИД группы экипажей, на которую будет смена. ИД группы экипажей можно посмотреть в карточке нужной группы в справочнике "Группы экипажей".
        ИД группы экипажей.png
      3. АПИ порт - порт, который указан в настройках Такси-Мастер.
    4. Нажимаем ОК.
      Смена группы экипажей у экипажа действие.png
  5. Нажимаем ОК в карточке системного события.