get_report_tables

Для получения списка таблиц, которые можно включить в отчеты, используйте метод report/get_report_tables.

svc=report/get_report_tables&params={}

Запрос не требует параметров.

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

[
	{
		"id":<uint>,		/* ID таблицы */
		"n":"<text>",			/* системное название таблицы */
		"l":"<text>",			/* название таблицы по умолчанию */
		"t":"<text>",			/* тип таблицы */
		"ct":"<text>",		/* тип шаблона, в котором может использоваться эта таблица */
		"pt":"<text>",		/* текстовые параметры */
		"gt":"<text>",		/* дополнительные настройки группировки */
		"col":[				/* массив столбцов */
			{
				"n":"<text>",		/* системное название столбца */
				"l":"<text>",		/* название столбца по умолчанию */
				"sl":"<text>",	/* список названий столбцов (если это таблица статистики) */
				"t":"<text>",		/* тип столбца */
				"f":<uint>		/* флаги столбца (см. ниже) */
				"calc_type":<uint>		/* значение группировки (если задано) */
				"available_calc_types":<uint>		/* значения группировки, доступные для столбца (если применимо) */
			}
		]
	}
]

Типы шаблонов отчетов описаны в разделе Типы шаблонов. Флаги таблиц описаны на странице exec_report.

Каждая таблица регистрируется отдельно для каждого типа шаблона, поэтому ее значение n уникально. Одна и та же таблица в разных типах шаблонов имеет разные названия. Например, таблица Поездки — это unit_trips в шаблоне типа avl_unit и unit_group_trips в шаблоне типа avl_unit_group. Значение n используется для указания таблиц в запросе report/update_report.

Таблицы с одинаковым значением t рассчитываются одинаково. Чтобы найти аналог таблицы в другом типе шаблона, найдите таблицу с таким же значением t и нужным значением ct.

Не все таблицы доступны для каждого типа шаблона. Например, таблицы График (обычный), Движение топлива, Изображения, Трассировка сообщений и Видео доступны для шаблонов типа avl_unit, но не имеют аналогов для avl_unit_group.

Содержимое таблицы unit_location (Последние данные) зависит от типа шаблона. Таблица существует как для avl_unit, так и для avl_unit_group, но в шаблоне типа avl_unit все ее столбцы являются столбцами статистики с флагом 0x02. В этом случае таблица не содержит строк, а только добавляет блок в статистику отчета. В качестве обычной таблицы Последние данные доступна только для шаблонов типа avl_unit_group.

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

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

Значение f представляет собой битовую маску, поэтому у столбца может быть несколько флагов одновременно. Например, 0x01 + 0x02 = 0x03 означает, что столбец показывается и как столбец таблицы, и как столбец статистики.

Столбцы с флагами 0x100 и 0x200 относятся к таблицам, которые предоставляют данные для графика (например, unit_events или unit_stays), а не к самой таблице графика. Они определяют, что отображается на графике. Подробнее см. в разделах Маркеры и Фон.

В параметре pt перечисляются текстовые параметры и опции, доступные для таблицы. Он может иметь следующие значения: