Шаблоны
Для создания, редактирования и удаления шаблонов отчетов используется команда report/update_report:
svc=report/update_report¶ms={"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> } ]}
Параметры
| Название | Описание |
|---|---|
| itemId | ID ресурса |
| id | ID шаблона |
| callMode | режим: создание, редактирование, удаление (create, update, delete) |
Остальные параметры являются обязательными только при создании и редактировании, они рассмотрены в разделе Получить данные о шаблонах.
Параметр "p"
В этом параметре задаётся группировка для таблицы.
Пример
"p":"{ \"grouping\":\" {\\\"type\\\":\\\"total\\\",\\\"nested\\\": /* включить группировку "Итого" */ {\\\"type\\\":\\\"year\\\"}}\" /* включить вложенную группировку "Год" */ }
Основные типы группировки
| Тип | Описание |
|---|---|
| total | Итого |
| year | Год |
| month | Месяц |
| week | Неделя |
| wday | День недели |
| mday | Число |
| day | Дата |
| shift | Смена |
Дополнительные типы группировки можно узнать, получив информацию о таблице (параметр gt) Получить список типов таблиц
Для таблицы account_tree («Иерархия учетной записи») могут быть использованые следующие параметры:
"p": "{ \"account_tree\":{ \"group\":<bool>, \"types\":<text> } }"
| Параметр | Описание | По-умолчанию |
|---|---|---|
| group | группировать ли элементы: 0 - нет, 1 - да | 0 |
| types | типы элементов, включен- ных в отчет: avl_account avl_resource user avl_unit avl_unit_group avl_retranslator avl_route | включены все |
Пример (все двойные кавычки внутри значения должны быть экранированы):
"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> }"
| Значение | Описание |
|---|---|
| ddd | использовать данные из .ddd файлов (по умолчанию) |
| online | использовать данные из онлайн активностей |
Дополнительные настройки
Каждая настройка шаблона представляет собой отдельный столбец в таблице. Чтобы активировать опцию - нужно добавить в шаблон соответствующие столбцы.
Доступные настройки
| Таблица | Столбец | Описание |
|---|---|---|
| unit_stats | multi_drivers | Несколько водителей/прицепов |
| unit_stats | precise_calculations | Пробег/топливо/счетчики с точностью до сотых |
| unit_stats | exclude_thefts | Исключить сливы из расхода топлива |
| unit_stats | trips_mileage | Считать пробег только по поездкам |
| unit_stats | intersect_zone | Учитывать пересечение геозоны треком |
| unit_stats | address_format | Формат адреса |
| unit_stats | time_format | Формат времени |
| unit_stats | us_units | Система единиц |
| unit_stats | shifts | Смены |
| pois | render_pois | POI |
| pois | group_markers | Группировать иконки |
| pois | number_markers | Нумерация маркеров |
| pois | use_visibility_scales | Учитывать масштаб видимости POI |
| unit_trips | render_msgs | Все сообщения на карте |
| unit_trips | render_trips | Треки поездок |
| geozones | render_geozones | Геозоны |
| unit_videos | render_unit_videos | Маркеры видео |
| unit_fillings | render_filling_markers | Маркеры заправок |
| unit_photos | render_unit_photos | Маркеры изображений |
| unit_stops | render_stops_markers | Маркеры остановок |
| unit_speedings | render_speedings_markers | Маркеры превышений скорости |
| unit_thefts | render_theft_markers | Маркеры сливов |
| unit_events | render_events_markers | Маркеры событий |
| unit_stays | render_stays_markers | Маркеры стоянок |
| unit_location | render_location_markers | Последнее местоположение |
| unit_stats_zones | all_resources | POI и геозоны из всех ресурсов |
| unit_stats_zones | desc_address | Добавить поле описания к адресу |
| unit_stats_zones | address_pois | POI в качестве адресов |
| unit_stats_zones | address_zones | Геозоны в качестве адресов |
Формат адреса, времени и метрика указываются в параметре «p» .
Возвращаемый результат
При создании и редактировании:
[ <long>, /* ID шаблона */ { "id":<long>, /* ID шаблона */ "n":<text>, /* название */ "ct":<text>, /* тип шаблона */ "c":<uint> /* контрольная сумма (crc16) */ } ]
Типы шаблонов рассмотрены в разделе Получить данные о шаблонах.
При удалении:
[ <long>, /* ID шаблона */ null ]
