Шаблоны

Для создания, редактирования и удаления шаблонов отчетов используется команда 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>,
						"s":<text>,
						"sl":<text>,
						"p":<text>,
						"sch":{	
							"f1":<uint>,
							"f2":<uint>,
							"t1":<uint>,
							"t2":<uint>,
							"m":<uint>,
							"y":<uint>,
							"w":<uint>,
							"fl":<uint>
						},
						"f":<uint>
					}
				]}

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

В этом параметре задаётся группировка для таблицы и другие настройки.

Пример

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

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

Дополнительные типы группировки можно узнать, получив информацию о таблице (параметр 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>
}" 

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

order_filter («Фильтр»)

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

Для таблицы unit_counter_sensors («Датчики счётчиков») могут быть использованы параметры:

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

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

Для графиков:

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

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

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

Для таблиц с фильтрами по Геозонам/Объектам можно передавать такие настройки в параметр 'p'

1) Для добавления группы в фильтр «Объекты» (например таблица «Поездки») в запросе редактирования шаблона report/update_report указать:

{\"geozones_ex\":{\"zones\":\"gu5813000_100\",\"types\":\"1,1\",\"flags\":0}}
где "gu"– обозначение группы объектов, 5813000 – ид группы, _100 – радиус действия

2) Для добавления группы в фильтр «Геозоны/объекты» (например таблица Объекты для Геозон) в запросе редактирования шаблона report/update_report указать:

"p":"{\"units\":\"5813000\"}" 

где 5813000 – ид группы.

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

Пример таблицы маркера.

{"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_unit_events\"]"},

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

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

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

Для изменения фона графика в зависимости от состояния объекта нужно добавить в шаблон таблицу маркера/состояния,и в таблицу графика добавить параметр chart_regions.

Пример изменения фона графика.

"p":"{...,
\"chart_regions\":[
  {\"id\":\"chart_stops_regions\",\"color\":14413564,\"priority\":5,\"name\":\"Stops\"},
  {\"id\":\"chart_engine_hours_regions\",\"color\":16381105,\"priority\":4,\"name\":\"Engine hours\"},
  {\"id\":\"chart_conn_quality_regions\",\"color\":14474460,\"priority\":3,\"name\":\"Connection loss\"},
  {\"id\":\"chart_stays_regions\",\"color\":16773056,\"priority\":2,\"name\":\"Parkings\"},
  {\"id\":\"chart_trips_regions\",\"color\":16766408,\"priority\":1,\"name\":\"Trips\"}],
  ... }

Доступные состояния.

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

Доступные настройки

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

При создании и редактировании:

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

Типы шаблонов рассмотрены в разделе Получить данные о шаблонах.

При удалении:

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