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

Материал из TaxiMaster
Перейти к: навигация, поиск
(Проверка штрафов ГИБДД)
(Проверка штрафов ГИБДД)
Строка 87: Строка 87:
 
### Апи ключ - ключ одного из сервисов проверки штрафов, который необходимо получить напрямую у представителя сервиса.
 
### Апи ключ - ключ одного из сервисов проверки штрафов, который необходимо получить напрямую у представителя сервиса.
 
### Ид счета водителя - ИД счета, с которого будет происходить списание штрафа. ИД счета можно посмотреть в карточке нужного счета в справочнике "Типы счетов".
 
### Ид счета водителя - ИД счета, с которого будет происходить списание штрафа. ИД счета можно посмотреть в карточке нужного счета в справочнике "Типы счетов".
##: [[Файл:Ид счета водителя.png|центр]]
+
###: [[Файл:Ид счета водителя.png|центр]]
 
### Атрибут СТС - атрибут типа "Строка", который может быть привязан к автомобилю, в карточке каждого автомобиля в данный атрибут необходимо ввести полностью номер СТС.
 
### Атрибут СТС - атрибут типа "Строка", который может быть привязан к автомобилю, в карточке каждого автомобиля в данный атрибут необходимо ввести полностью номер СТС.
 
### Блок уведомлений можно настроить как оповещать водителя, если это нужно, а также можно указать ИД типа события для записи в Журнал событий. ИД типа события можно посмотреть в карточке нужного типа события в справочнике "Типы событий для журнала событий".
 
### Блок уведомлений можно настроить как оповещать водителя, если это нужно, а также можно указать ИД типа события для записи в Журнал событий. ИД типа события можно посмотреть в карточке нужного типа события в справочнике "Типы событий для журнала событий".

Версия 14:47, 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. Нажимаем ОК в карточке системного события.