update_report

Для создания, редактирования и удаления шаблонов отчетов используйте метод report/update_report.

svc=report/update_report&params={
  "itemId":<long>,
  "id":<long>,
  "callMode":"<text>",
  "n":"<text>",
  "ct":"<text>",
  "p":"<text>",
  "tbl":[
    {
      "n":"<text>",
      "l":"<text>",
      "c":"<text>",
      "cl":"<text>",
      "cp":"<text>",
      "s":"<text>",
      "sl":"<text>",
      "filter_order":"<text>",
      "p":"<text>",
      "sch":{"f1":<uint>,"f2":<uint>,"t1":<uint>,"t2":<uint>,"m":<uint>,"y":<uint>,"w":<uint>,"fl":<uint>},
      "f":<uint>
    }
  ]
}

Запрос должен содержать следующие параметры:

Остальные параметры нужны только для создания и редактирования шаблонов. Они описаны на странице get_report_data.

Параметр tbl[].n — это системное название таблицы. Оно зависит от типа шаблона, указанного в ct. Подробнее см. в разделе Названия и типы таблиц.

Параметр p определяет группировку таблицы и другие настройки. Некоторые настройки доступны только для отдельных таблиц.

Параметр grouping определяет, как группируются строки таблицы:

"p":"{
    \"grouping\":\"   
        {\"type\":\"total\",\"nested\":    /* включить группировку \"Итого\" */
            {\"type\":\"year\"}}\"         /* включить вложенную группировку \"Год\" */
}"

Основные типы группировки:

Чтобы узнать дополнительные типы группировки, запросите информацию о таблице с помощью запроса get_report_tables (параметр gt).

Для таблицы account_tree можно использовать следующие параметры:

"p": "{
    \"account_tree\": {
        \"group\": <bool>,
        \"types\": \"<text>\"
    }
}"

Пример (все двойные кавычки внутри значения должны быть экранированы):

    "p":"{\"account_tree\":{\"group\":1,\"types\":\"avl_account,avl_resource,user,avl_unit,avl_unit_group,avl_retranslator,avl_route\"}}"

Для таблицы driver_ddd можно использовать параметр drv_activity (Источник активности водителя):

"p": "{
	\"drv_activity\":"<text>"
	}" 

Параметр drv_activity может иметь следующие значения:

Для таблицы driver_orders (Заявки) можно использовать параметр order_filter (Фильтрация):

"p":"{
	\"order_filter\":<uint>
}"

Параметр order_filter может иметь следующие значения:

Для таблицы unit_counter_sensors (Датчики счетчиков) можно использовать следующие параметры:

• sensor_val:min (минимальное значение датчика);
• sensor_val:max (максимальное значение датчика).

"p": "{
	\"sensor_val\":{\"min\":\"10\",\"max\":\"14\"}
}" 

Для разделения на смены в таблицах со сменами используйте следующие параметры:

"p":{\"split_shifts\":1},
"s":{\"split_shifts\"}

График представляет собой таблицу в шаблоне. Для графиков можно использовать следующие параметры:

"p":"{
	\"sensor_mask\":"<text>",		/* маска датчика */
	\"instant_speed_base\":{
		\"mask\":"<text>"}}	/* маска датчика для раскрашивания линии графика по датчику */

Чтобы добавить маркеры на график, добавьте таблицу маркеров в шаблон, а флаги маркеров — в таблицу графика. Пример таблицы маркеров:

{"n":"unit_events",
 "l":"",
 "f":0,
 "c":"",
 "cl":"",
 "p":"",
 "sch":{
   "y":0,
   "m":0,
   "w":0,
   "f1":0,
   "f2":0,
   "t1":0,
   "t2":0},
 "sl":"",
 "s":"[\"chart_events_markers\"]"},

Пример флагов маркеров:

"p":"{
  \"chart_markers\":{
    \"f\":2556}
  }"

Доступные маркеры/состояния:

Флаг 0x4 также добавляет на график маркеры нарушений.

Интервалы таких событий, как поездки, остановки, стоянки, потери связи и моточасы, можно использовать в качестве фона графика. О том, как фон выглядит в интерфейсе, см. на странице Свойства графиков.

Для фона требуются два объекта массива tbl: таблица-источник, которая предоставляет интервалы, и таблица графика.

В таблице-источнике добавьте в параметр s название одного из столбцов с интервалами. Например, чтобы показать интервалы поездок, добавьте в объект unit_trips следующее:

"s":"[\"chart_trips_regions\"]"

В таблице графика добавьте в параметр p объект chart_regions:

"p":"{
  \"chart_regions\":{
    \"0\":{
      \"id\":\"<text>\",
      \"name\":\"<text>\",
      \"color\":<uint>,
      \"priority\":<uint>}
  }}"

Ключи объекта — это индексы интервалов, начиная с 0. Чтобы показать на одном графике несколько типов интервалов, добавьте объект для каждого из них.

Если параметр id или name пуст, интервал не добавляется на график.

Если строки таблицы-источника не нужны в отчете, оставьте ее параметры c и cl пустыми. Таблица все равно рассчитывается и предоставляет интервалы для графика.

Доступны следующие столбцы:

Каждая настройка шаблона представляет собой столбец таблицы. Для активации опции добавьте в шаблон соответствующий столбец.

Доступны следующие настройки:

Формат адреса, формат времени, смены и система измерения указываются в параметре p.

Если запрос выполнен успешно, возвращается ответ следующего формата.

Для запросов на создание и изменение:

[
	<long>,		/* ID шаблона */
	{
		"id":<long>,	/* ID шаблона */
		"n":"<text>",	/* название */
		"ct":"<text>",	/* тип шаблона */
		"c":<uint>	/* контрольная сумма (crc16) */
	}
]

Для запросов на удаление:

[
	<long>,		/* ID шаблона */
	null
]

Типы шаблонов описаны в разделе Типы шаблонов на странице get_report_data.

В противном случае возвращается код ошибки.