> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/ru/dashboard-studio/creating-reports.md). # Создание отчетов Отчеты предоставляют вам структурированный способ анализа данных IoT Query через три согласованных представления, основанных на одном SQL-запросе: табличные данные с пагинацией, график и интерактивная карта. Используйте отчеты, когда вам нужен фиксированный, пригодный для экспорта результат, а не свободно настраиваемое полотно дашборда. Пользовательские SQL-отчеты мгновенно адаптируются к любому бизнес-вопросу за счет изменения запросов и параметров: * **Автоматизация** экономит время за счет повторного использования запросов и интеграции с BI-инструментами для быстрых обновлений. * **Глубокий анализ** возможен за счет объединения, агрегирования и сегментации данных из нескольких источников. * **Точность и релевантность** обеспечиваются за счет работы напрямую с сырыми, актуальными данными базы. * **Интерактивные визуализации** позволяют пользователям динамически исследовать данные, настраивая оси, фильтры и метрики. Посмотрите это видео, чтобы ознакомиться с созданием отчетов в интерфейсе приложения Dashboard Studio: {% embed url="" %} Создание отчетов в Dashboard Studio шаг за шагом {% endembed %} ## Отчеты и дашборды И отчеты, и дашборды выполняют SQL-запросы к вашей базе IoT Query и отображают результаты в виде визуализаций. Ключевое различие заключается в том, как структурированы запросы и результат: | | Отчеты | Панели мониторинга | | ---------------------- | -------------------------------------------------------------- | -------------------------------------- | | SQL-запросы | Один запрос обслуживает все представления | Каждая плитка имеет собственный запрос | | Макет | Фиксированные: таблица данных, диаграмма, карта местоположения | Холст с перетаскиванием | | Экспорт | HTML, Excel, PDF | Только схема JSON | | Сценарий использования | Экспортируемый анализ одного набора данных | Много-панельный оперативный мониторинг | Используйте отчеты, когда один набор данных нужно одновременно просматривать в виде таблицы, визуализировать как график и отображать на карте, или когда результат необходимо экспортировать и передавать вне Dashboard Studio. Используйте дашборды, когда вам нужны несколько независимых визуализаций на одном полотне, например: объединение плитки со сводной статистикой поездки, графика расхода топлива и таблицы посещений зон в одном представлении. Подробнее о создании дашбордов см. [Создание панелей мониторинга](/docs/analytics/ru/dashboard-studio/creating-dashboards.md). ## Как создать отчет {% stepper %} {% step %} #### Шаг 1: Откройте редактор отчета В левой боковой панели нажмите **Инструменты**, затем выберите **Новый отчет**. Dashboard Studio предложит выбрать раздел в структуре общего меню. Выберите существующий раздел или Root, чтобы разместить отчет на верхнем уровне. {% endstep %} {% step %} #### Шаг 2: Введите основную информацию Редактор открывается с двумя полями в верхней части: * **Название** (обязательно): имя, отображаемое в меню и заголовках экспорта. * **Описание** (необязательно): дополнительный контекст, видимый в редакторе. {% endstep %} {% step %} #### Шаг 3: Напишите SQL-запрос 1. Нажмите вкладку **SQL Query** и введите оператор SELECT для таблиц IoT Query. Запрос определяет все три компонента (таблицу, график и карту), поэтому включите все столбцы, которые вы планируете использовать во всех представлениях, например: {% code title="Пример базового запроса отчета" expandable="true" %} ```sql SELECT t.device_id, o.object_label, -- Преобразование масштабированных целочисленных координат в десятичные градусы t.latitude::float / 10000000 AS latitude, t.longitude::float / 10000000 AS longitude, -- Преобразование масштабированной целочисленной скорости в км/ч t.speed::float / 100 AS speed, t.device_time FROM raw_telematics_data.tracking_data_core t JOIN raw_business_data.objects o ON t.device_id = o.device_id LIMIT 1000 ``` {% endcode %} {% hint style="info" icon="lightbulb-exclamation" %} #### Несколько советов по созданию запроса: * Добавьте предложение LIMIT на этапе настройки отчета. Это сокращает время выполнения запроса и ускоряет предварительный просмотр компонентов. Уберите или увеличьте ограничение перед сохранением, если вам нужен полный набор данных для загрузки. * После написания запроса вы можете нажать **Определить столбцы** чтобы проверить, какие столбцы фактически извлекаются этим запросом. Это помогает настроить селекторы столбцов на вкладке **Компоненты** . Этот шаг необязателен. Вы можете настроить компоненты вручную, но сначала его выполнение упрощает выбор осей и полей. * Любой SQL-запрос, используемый на панели дашборда, является подходящей отправной точкой для отчета. Скопируйте запрос из панели и адаптируйте его под цель отчета. Например, добавьте столбцы, необходимые для карты местоположений, или удалите агрегации, которые не применимы к табличному представлению. * Книга рецептов IoT Query содержит общие и отраслевые примеры запросов, готовые к использованию в качестве основы для отчетов. См. [SQL Recipe Book](/docs/analytics/ru/example-queries.md) полный список. {% endhint %} {% endstep %} {% step %} #### Шаг 4: Настройте компоненты Нажмите вкладку **Компоненты** вкладка. Доступны три компонента: **Таблица**, **График**, и **Карта**. У каждого есть переключатель, который включает или исключает его из отчета. Вы можете удалить любой ненужный компонент. {% tabs %} {% tab title="Таблица данных" %} Таблица данных отображает результаты запроса в постраничных строках. * **Размер страницы**: задает, сколько строк отображается на странице в интерактивном виде. Это не влияет на экспорт, который всегда содержит полный набор результатов. * **Показывать строку итогов**: при включении добавляет строку итогов в нижней части таблицы. {% endtab %} {% tab title="График" %} Доступны два типа графиков: * **Временной ряд (линейный)**: подходит для данных, отображаемых во времени. * **Столбчатая диаграмма**: подходит для сравнения категорий (также называется столбчатой диаграммой). Настройте оси: * **Столбец оси X**: обычно столбец времени, такой как `device_time`. * **Столбцы оси Y**: один или несколько числовых столбцов, например скорость или `fuel_level`. * **Группировать по**: при необходимости разделите серии по категориальному столбцу, например `object_label`, чтобы отображать отдельную линию или группу столбцов для каждого устройства. {% endtab %} {% tab title="Карта местоположений" %} Карта местоположений отображает точки данных с использованием GPS-координат. Dashboard Studio может автоматически определять столбцы широты и долготы в результате вашего запроса. Когда включен переключатель **Автоопределение GPS-столбцов** , столбцы, необходимые для определения местоположения (обычно `latitude` : Изучите исходные схемы ( `longitude`), выбираются автоматически, если ваш запрос их возвращает. Вы также можете отключить опцию **Автоопределение** и выбрать нужные столбцы вручную. {% endtab %} {% endtabs %} {% endstep %} {% step %} #### Шаг 5: Сохраните отчет Нажмите Сохранить. Отчет появится в разделе меню, выбранном на шаге 1, и будет доступен всем пользователям, у которых есть доступ к этому разделу. {% endstep %} {% endstepper %} ## Просмотр отчета После создания отчет открывается сразу. Вы увидите все настроенные компоненты, отображаемые с актуальными данными из вашей базы IoT Query. В заголовке отчета отображаются отметка времени последнего обновления, общее количество строк и время выполнения запроса. Страница отчета также напрямую отображает SQL-запрос, поэтому вы можете обновлять его в любое время. 1. Разверните **SQL Query** раздел, чтобы просмотреть или отредактировать оператор прямо на месте. 2. Примените изменения: 1. Нажмите **Сохраните** чтобы сохранить изменения без запуска. Вам потребуется нажать **Обновить** чтобы повторно выполнить запрос и обновить все представления текущими данными. 2. **Сохранить и выполнить** чтобы немедленно применить обновленный запрос. ### Таблица данных Узел **Таблица данных** раздел показывает результаты запроса, при этом в заголовке раздела отображается общее количество строк, возвращенное запросом. В интерактивном виде отображается только ограниченное число строк, а в нижней части указано точное количество. Используйте раскрывающийся список **Скачать** в разделе, чтобы экспортировать полный набор результатов в формате Excel (.xlsx) или CSV (.csv), независимо от того, сколько строк отображается в интерактивном виде. Если вам нужны местоположения вместо сырых координат, установите флажок **Геокодировать в адрес** в правом верхнем углу **Таблица данных** заголовка. При включении он преобразует столбцы координат в читаемые адреса улиц. {% hint style="warning" %} Преобразование адресов создает значительную нагрузку на сервер. Используйте эту опцию только для агрегированных или отфильтрованных наборов данных. Для сырых телематических данных с десятками тысяч строк оставляйте координаты в числовом виде. {% endhint %} ### График Раздел Chart отображается под таблицей данных. Он наследует настройки, примененные в редакторе отчета, но вы также можете настраивать оси непосредственно в представлении: * **Ось X**: выберите столбец для отображения по горизонтальной оси. * **Ось Y**: выберите столбец для отображения по вертикальной оси. * **Группировать по**: при необходимости разделите серии по категориальному столбцу, например `object_label`, чтобы отображать отдельную линию или группу столбцов для каждого устройства. На графике отображается автоматически сгенерированный заголовок, описывающий текущий выбор оси и группировки, например: `speed over device_time (grouped by object_label)`. Когда вы изменяете настройки осей без сохранения, рядом с кнопкой **Несохраненные изменения** появляется индикатор **Сохранить настройки графика** . Нажмите его, чтобы сохранить изменения конфигурации в отчете. ### Карта местоположений Узел **Карта местоположений** раздел отображает каждую строку запроса как точку в ее GPS-координатах. В заголовке раздела показано количество нанесенных точек. GPS-столбцы определяются при создании отчета (автоматически или вручную), после этого их нельзя изменить. Если запрос не возвращает распознанных столбцов координат, в разделе отображается сообщение "В результатах запроса не обнаружены GPS-координаты." Для телематических данных с временными метками нанесенные точки представляют полный маршрут объекта за запрошенный период. {% hint style="info" %} Карта интерактивна: масштабируйте и перемещайте ее, чтобы изучать отдельные точки. Нажмите **Показать все** чтобы уменьшить масштаб и поместить все нанесенные точки в видимую область карты. {% endhint %} ## Экспорт отчета Dashboard Studio предоставляет два уровня экспорта. ### Экспорт таблицы данных Используйте раскрывающийся список **Скачать** внутри **Таблица данных** раздела, чтобы экспортировать только данные таблицы. Экспорт всегда содержит полный набор результатов, возвращенный запросом, независимо от ограничения отображения в интерактивном виде. ### Полный экспорт отчета Используйте кнопки в заголовке отчета, чтобы экспортировать все компоненты вместе. | Кнопка | Выход | | --------------------- | ------------------------------------------------------------------------ | | Excel → Excel (.xlsx) | Таблица с полным набором данных | | Excel → CSV (.csv) | Файл со значениями, разделенными запятыми, с полной таблицей данных | | HTML | Интерактивный файл с таблицей данных, графиком и картой местоположений | | PDF | Статический документ с таблицей данных, графиком и картой местоположений | {% hint style="info" %} Экспортированный HTML-файл сохраняет интерактивность: график поддерживает всплывающие подсказки при наведении, а карта местоположений — масштабирование и перемещение. {% endhint %} ## Редактирование и удаление отчета Чтобы отредактировать сохраненный отчет, отдельный диалог редактора больше не нужен. Откройте отчет из меню и измените в нем SQL-запрос или параметры компонентов напрямую. Единственное исключение — столбцы местоположения, они определяются один раз при создании отчета. Чтобы удалить отчет, нажмите **Инструменты** в левой боковой панели, затем выберите **Редактировать меню**. Найдите отчет в дереве меню и нажмите меню с тремя точками рядом с его именем, затем подтвердите удаление. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://navixy.com/docs/analytics/ru/dashboard-studio/creating-reports.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.