> 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). # Создание отчетов Генерируйте экспортируемые отчеты с согласованными таблицами данных, диаграммами и картами местоположений из одного SQL-запроса. Экспортируйте в HTML, Excel или PDF Отчеты дают вам структурированный способ анализировать данные IoT Query через три согласованных представления из одного SQL-запроса: постраничную таблицу данных, график и интерактивную карту. Используйте отчеты, когда вам нужен фиксированный, пригодный для экспорта результат, а не свободно настраиваемое полотно панели мониторинга. Пользовательские SQL-отчеты мгновенно адаптируются к любому бизнес-вопросу за счет изменения запросов и параметров: * **Автоматизация** экономит время за счет повторного использования запросов и интеграции с инструментами BI для быстрых обновлений. * **Глубокий анализ** возможен за счет объединения, агрегации и сегментации данных из нескольких источников. * **Точность и релевантность** обеспечиваются за счет работы непосредственно с сырыми, актуальными данными базы. * **Интерактивные визуализации** позволяют пользователям динамически исследовать данные, настраивая оси, фильтры и метрики. Посмотрите это видео, чтобы ознакомиться с созданием отчетов в интерфейсе приложения Dashboard Studio: {% embed url="" %} Создание отчетов в Dashboard Studio шаг за шагом {% endembed %} ## Отчеты vs. панели мониторинга И отчеты, и панели мониторинга выполняют SQL-запросы к вашей базе данных IoT Query и отображают результаты в виде визуализаций. Ключевое различие заключается в том, как структурированы запросы и вывод: | | Отчеты | Панели мониторинга | | ---------------------- | -------------------------------------------------------------- | --------------------------------------------- | | SQL-запросы | Один запрос обслуживает все представления | У каждой плитки свой запрос | | Макет | Фиксированный: таблица данных, диаграмма, карта местоположения | Холст с перетаскиванием | | Экспорт | HTML, Excel, PDF | JSON schema, PDF | | Сценарий использования | Анализ одного набора данных с возможностью экспорта | Оперативный мониторинг с несколькими панелями | Используйте отчеты, когда один набор данных нужно одновременно исследовать как таблицу, визуализировать как график и нанести на карту, или когда вывод нужно экспортировать и передавать вне 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, -- Convert scaled integer coordinates to decimal degrees t.latitude::float / 10000000 AS latitude, t.longitude::float / 10000000 AS longitude, -- Convert scaled integer speed to km/h t.speed::float / 100 AS speed, t.device_time ИЗ raw_telematics_data.Мониторинг_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 при настройке отчета. Оно сокращает время выполнения запроса и ускоряет предварительный просмотр компонента. Удалите или увеличьте limit перед сохранением, если вам нужен полный набор данных, доступный для загрузки. * После написания запроса вы можете нажать **Определить столбцы** чтобы проверить, какие столбцы действительно извлекаются этим запросом. Это помогает настроить селекторы столбцов на **Компоненты** вкладке. Шаг необязателен. Вы можете настроить компоненты вручную, но запуск этого шага сначала упрощает выбор осей и полей. * Любой SQL-запрос, используемый в панели мониторинга, является подходящей отправной точкой для отчета. Скопируйте запрос из панели и адаптируйте его под цель отчета. Например, добавьте столбцы, необходимые для карты местоположения, или удалите агрегации, которые не применимы к табличному представлению. * Книга рецептов IoT Query содержит общие и отраслевые примеры запросов, готовые к использованию в качестве основы для отчетов. См. [Книга SQL-рецептов](/docs/analytics/ru/example-queries.md) полный список. {% endhint %} {% endstep %} {% step %} #### Шаг 4: Настройте компоненты Нажмите на **Компоненты** вкладка. Доступны три компонента: **Таблица**, **График**, и **Карта**. У каждого есть переключатель, чтобы включить его в отчет или исключить из него. Вы можете удалить любой ненужный компонент. {% tabs %} {% tab title="Таблица данных" %} Таблица данных отображает результаты запроса постранично. * **Размер страницы**: задает, сколько строк отображается на странице в интерактивном виде. Это не влияет на экспорт, который всегда содержит полный набор результатов. * **Показывать строку итогов**: добавляет строку итогов внизу таблицы, когда включено. {% endtab %} {% tab title="График" %} Доступны два типа диаграмм: * **Временной ряд (линейный)**: подходит для данных, отображаемых во времени. * **Столбчатая диаграмма**: подходит для сравнения категорий (также называется столбчатой диаграммой). Настройте оси: * **столбец оси X**: обычно столбец времени, например `device_time`. * **Столбцы оси Y**: один или несколько числовых столбцов, например скорость или `Уровень топлива`. * **Группа по**: при необходимости разделите серии по категориальному столбцу, например `Объект_лейбл`, чтобы отображать отдельную строку или Группа столбцов для каждого устройства. {% endtab %} {% tab title="Карта местоположения" %} Карта местоположения наносит точки данных с использованием координат GPS. Dashboard Studio может автоматически определять столбцы широты и долготы в результате вашего запроса. Когда **Автоопределение столбцов GPS** если переключатель включен, столбцы, необходимые для определения местоположения (обычно `latitude` и `longitude`) автоматически выбираются, если ваш запрос возвращает их. Вы также можете отключить **Автоопределение** параметр и выбрать нужные столбцы вручную. {% endtab %} {% endtabs %} {% endstep %} {% step %} #### Шаг 5: Сохраните отчет Нажмите Save. Отчет появляется в разделе меню, который вы выбрали на шаге 1, и доступен всем пользователям, у которых есть доступ к этому разделу. {% endstep %} {% endstepper %} ## Просмотр отчета После создания отчет открывается сразу. Вы увидите все настроенные компоненты, отображаемые с актуальными данными из вашей базы данных IoT Query. В заголовке отчета отображаются время последнего обновления, общее количество строк и время выполнения запроса. Страница отчета также напрямую отображает SQL-запрос, так что вы можете обновлять его, когда вам нужно. 1. Разверните **SQL Query** раздел, чтобы просмотреть или отредактировать оператор на месте. 2. Примените изменения: 1. Нажмите **Сохранить** чтобы сохранить изменения без запуска. Вам нужно будет нажать **Обновить** чтобы повторно выполнить запрос и обновить все представления текущими данными. 2. **Save & Run** чтобы сразу применить обновленный запрос. ### Таблица данных Этот **Data Table** раздел показывает результаты запроса, а заголовок раздела отображает общее количество строк, возвращенных запросом. Интерактивное представление показывает только ограниченное число строк, а нижний колонтитул подтверждает точное количество. Используйте **Скачать** раскрывающийся список для экспорта полного набора результатов в Excel (.xlsx) или CSV (.csv), независимо от того, сколько строк отображает интерактивное представление. Если вам нужны местоположения вместо необработанных координат, установите флажок **Геокодировать в адрес** в правом верхнем углу **Data Table** заголовка. При включении он преобразует столбцы координат в удобочитаемые адреса улиц. {% hint style="warning" %} Разрешение адресов создает значительную нагрузку на сервер. Используйте эту опцию только с агрегированными или отфильтрованными наборами данных. Для необработанных телематических данных с десятками тысяч строк оставляйте координаты в числовом виде. {% endhint %} ### График Раздел графика отображается под таблицей данных. Он наследует настройки, которые вы применили в редакторе отчета, но вы также можете настроить оси напрямую в представлении: * **Ось X**: выберите столбец для отображения по горизонтальной оси. * **Ось Y**: выберите столбец для отображения по вертикальной оси. * **Группа по**: при необходимости разделите серии по категориальному столбцу, например `Объект_лейбл`, чтобы отображать отдельную строку или Группа столбцов для каждого устройства. На диаграмме отображается автоматически сгенерированный заголовок, описывающий текущий выбор оси и группировки, например: `Скорость по device_time (сгруппировано по object_label)`. При изменении настроек оси без сохранения, **Несохраненные изменения** индикатор появляется рядом с **Сохранить настройки графика** кнопка. Нажмите ее, чтобы сохранить изменения конфигурации в отчете. ### Карта местоположения Этот **Карта местоположения** Раздел отображает каждую строку запроса как точку по ее координатам GPS. Заголовок раздела показывает количество нанесенных точек. Столбцы GPS задаются при создании отчета (автоматически или вручную), позже их нельзя изменить. Если запрос не возвращает распознанных столбцов координат, раздел показывает "Координаты GPS не обнаружены в результатах запроса." Для телематических данных с метками времени нанесенные точки представляют полный путь Объект за выбранный период. {% hint style="info" %} Карта интерактивна: увеличивайте масштаб и перемещайте карту, чтобы просматривать отдельные точки. Нажмите **Показать все** чтобы уменьшить масштаб и уместить все нанесенные точки в видимой области карты. {% endhint %} ## Экспорт отчета Dashboard Studio предоставляет два уровня экспорта. ### Экспорт таблицы данных Используйте **Скачать** раскрывающийся список в **Data Table** раздел для экспорта только данных таблицы. Экспорт всегда содержит полный набор результатов, возвращенный запросом, независимо от ограничения отображения в интерактивном представлении. ### Полный экспорт отчета Используйте кнопки в заголовке отчета, чтобы экспортировать все компоненты вместе. | Кнопка | Вывод | | --------------------- | ------------------------------------------------------------------------ | | Excel → Excel (.xlsx) | Электронная таблица с полной таблицей данных | | Excel → CSV (.csv) | Файл значений, разделенных запятыми, с полной таблицей данных | | HTML | Интерактивный файл с таблицей данных, графиком и картой местоположения | | PDF | Статический документ с таблицей данных, графиком и картой местоположения | {% hint style="info" %} Экспортированный HTML-файл сохраняет интерактивность: график поддерживает всплывающие подсказки при наведении, а карта местоположения поддерживает масштабирование и панорамирование. {% endhint %} ## Редактирование и удаление отчета Чтобы отредактировать сохраненный отчет, вам больше не нужен отдельный диалог редактора. Откройте отчет из меню и измените SQL-запрос или настройки компонента непосредственно в нем. Единственное исключение — колонки местоположения: они задаются один раз при создании отчета. Чтобы удалить отчет, нажмите **Инструменты** в левой боковой панели, затем выберите **меню Edit**. Найдите отчет в древе меню и нажмите меню с тремя точками рядом с его названием, затем подтвердите удаление. --- # 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, and the optional `goal` query parameter: ``` GET https://navixy.com/docs/analytics/ru/dashboard-studio/creating-reports.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.