Дополнительные действия | Документация АвтоГРАФ.WEB

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

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

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

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

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

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

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

Рабочий каталог.

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

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

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

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

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

примечание

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

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

В текстовом поле задается URL сервера, формат HTTP-запроса выбирается из выпадающего списка. Типы данных, соответствующие доступным в выпадающем списке форматам:

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 — массив со всеми свойствами объекта мониторинга.

Включение или выключение любого из имеющихся правил схемы.

Правило и действие (включение или выключение) выбираются из выпадающих списков.

примечание

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

подсказка

Можно создать несколько других правил, которые при срабатывании будут включать и выключать одно и то же правило.

Изменение данных во внешнем приложении. Эта функция позволяет при срабатывании правила передавать, изменять или удалять данные в стороннем приложении, которое взаимодействует с сервером АвтоГРАФ посредством API.

Приложение и действие выбираются из выпадающих списков, данные вводятся в текстовом поле.