Дополнительные действия

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

Для сохранения выполненных действий требуется нажать кнопку « OK» в окне создания/редактирования правила.

Играть звук
Имя файла
Web service
Изменить состояние
Изменить данные приложения

Воспроизведение звукового файла пользователю программы АвтоГРАФ.WEB.

Файл выбирается из выпадающего списка.

Выполнение действия с файлом в рабочем каталоге на сервере. Эта функция позволяет передавать сообщения и команды контроллеру АвтоГРАФ при выполнении определенного правила.

Действие выбирается из выпадающего списка, в текстовом поле задается относительное имя файла.

предупреждение

Для файла должно быть обязательно указано его расширение.

Рабочий каталог, в котором выполняются все действия, указывается в поле «Каталог файлов правил» на вкладке «Доступ к данным» меню «Системные настройки». Относительное имя файла отсчитывается относительно этого каталога и может содержать подкаталоги и переменные используемые в шаблонах сообщений.

Выбор рабочего каталога

Доступные действия с файлом:

Создать — создает новый файл с заданным именем и расширением и записывает в этот файл текст сообщения правила. При этом существующий файл будет удален перед созданием нового.
Добавить — добавляет текст сообщения правила в указанный существующий файл. При этом существующий файл не удаляется. Если указанный файл не существует, то при выполнении правила будет создан новый файл с заданным именем.
Удалить — удаляет указанный существующий файл из заданного каталога.

Пример задания относительного имени файла с переменной.

Пример настроек правила для создания файла

При выполнении указанного правила в рабочем каталоге сервера, в подкаталоге контроллера АвтоГРАФ, для которого выполнено правило, будет создан файл «rule.atc». Имя подкаталога определяется переменной {device.serial}, содержащей серийный номер контроллера.

примечание

В создаваемый файл записывается текст сообщения правила, указанный для языка «По умолчанию». Если в качестве текста сообщения задать строку DISPLAY=сообщение; (где сообщение — это произвольный текст), то при выполнении правила контроллеру АвтоГРАФ будет отправлена команда на вывод заданного сообщения на информационном дисплее АвтоГРАФ-ИНФО, подключенном к контроллеру.

Отправка HTTP-запроса с информацией о выполненном правиле на сторонний веб-сервер. HTTP-запрос использует метод POST и при отправке преобразуется в выбранный формат.

Формат HTTP-запроса выбирается из выпадающего списка, в текстовом поле задается URL сервера.

Типы данных, соответствующие доступным в выпадающем списке форматам:

JSON — application/json.
XML — text/xml.
Raw JSON — application/json.
Raw XML — text/xml.

HTTP-запрос включает в себя заголовки (Headers) и тело запроса. Описание заголовков:

"X-Schema-Org-ID" — идентификатор схемы.
"X-Schema-ID" — UID схемы.
"X-Server-Version" — версия программы АвтоГРАФ.WEB.
"X-TimeZone-Offset" — смещение часового пояса сервера от UTC в минутах.
"X-TimeZone-ID" — идентификатор часового пояса сервера.

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

{
  "config": {
    "parameter": "Overspeed",
    "parameterName": "Прев.",
    "value": "Превышение",
    "valueTo": ""
  },
  "body": "текущая \u003d 90,9 км/ч\n\nMaxSpeed \u003d -\nMinSpeed \u003d -",
  "subject": "Превышение",
  "value": "Превышение",
  "valuePrev": "",
  "date": "23.08.2023",
  "time": "09:17",
  "timefull": "09:17:27",
  "dateutc": "23.08.2023",
  "timeutc": "04:17",
  "timefullutc": "04:17:27",
  "durationSeconds": 46,
  "durationTime": "00:00:46",
  "address": "Каменка, Пензенская обл. Кузнецкий р-н",
  "lat": 53.102873333333335,
  "lon": 46.50814666666667,
  "serial": 9999999,
  "device": {
    "name": "Freightliner",
    "serial": 9999999,
    "group": "delete",
    "groupPath": "",
    "uid": "25f86189-adc9-445d-940c-abf860874622",
    "groupid": "9c60db53-5054-44f6-a708-8e3c9b62553f",
    "orgid": 51,
    "id": 1041
  },
  "values": [
    {
      "name": "Speed",
      "value": {
        "Value": 90.90790422120713,
        "Type": 4,
        "Formatted": "90,9 км/ч"
      }
    }
  ],
  "valuesFinal": [
    {
      "name": "Speed",
      "value": {
        "Value": 67.97675941594507,
        "Type": 4,
        "Formatted": "68,0 км/ч"
      }
    }
  ],
  "valuesPrev": [
    {
      "name": "Speed",
      "value": {
        "Value": 84.44569549144511,
        "Type": 4,
        "Formatted": "84,4 км/ч"
      }
    }
  ],
  "properties": [
    {
      "name": "Alias",
      "value": "Freightliner"
    }
  ]
}

где:

values, valuesPrev, valuesFinal — массивы со значениями параметров (табличных в текущей точке, табличных в предыдущей точке и финальных соответственно), участвующие в условии правила или в шаблоне сообщения;
properties — массив со всеми свойствами объекта мониторинга.

Пример формата тела запроса в формате JSON для правила, использующего финальный параметр.

{
  "body": "Дата последних данных 26.09.2023 04:53:20\nДата последних координат 26.09.2023 04:53:20",
  "subject": "Отсутствие данных",
  "date": "26.09.2023",
  "time": "09:56",
  "timefull": "09:56:23",
  "dateutc": "26.09.2023",
  "timeutc": "04:56",
  "timefullutc": "04:56:23",
  "lastdt": "26.09.2023 09:53:20",
  "lastdtutc": "26.09.2023 04:53:20",
  "lastcrddt": "26.09.2023 09:53:20",
  "lastcrddtutc": "26.09.2023 04:53:20",
  "address": "-",
  "lat": 55.648606666666666,
  "lon": 49.978093333333334,
  "serial": 9999999,
  "device": {
    "name": "Freightliner",
    "serial": 9999999,
    "group": "delete",
    "groupPath": "",
    "uid": "25f86189-adc9-445d-940c-abf860874622",
    "groupid": "9c60db53-5054-44f6-a708-8e3c9b62553f",
    "orgid": 51,
    "id": 1041
  },
  "valuesFinal": [
    {
      "name": "CoordsActuality",
      "value": {
        "Value": "00:03:03.6666487",
        "Type": 6,
        "Formatted": "00:03:03.6666487"
      }
    },
    {
      "name": "DataActuality",
      "value": {
        "Value": "00:03:03.6666798",
        "Type": 6,
        "Formatted": "00:03:03.6666798"
      }
    }
  ],
  "properties": [
    {
      "name": "Alias",
      "value": "Freightliner"
    }
  ]
}

где:

valuesFinal — массивы со значениями всех финальных параметров;
properties — массив со всеми свойствами объекта мониторинга.