> 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, PDF | | Сценарий использования | Анализ одного набора данных, поддающийся экспорту | Многопанельный операционный мониторинг | Используйте отчеты, когда один набор данных нужно одновременно исследовать в виде таблицы, визуализировать в виде графика и отобразить на карте, или когда результат нужно экспортировать и передать за пределами Dashboard Studio. Используйте панели мониторинга, когда вам нужны несколько независимых визуализаций на одном полотне, например: объединить плитку со сводкой поездки, график нормы расхода топлива и таблицу посещений зон в одном представлении. Для получения сведений о создании панелей мониторинга см. [Создание панелей мониторинга](/docs/analytics/ru/dashboard-studio/creating-dashboards.md). ## Как создать отчет {% stepper %} {% step %} #### Шаг 1: Откройте редактор отчета В левой боковой панели нажмите **Tools**, затем выберите **New report**. Dashboard Studio предложит вам выбрать раздел в общей структуре меню. Выберите существующий раздел или выберите Root, чтобы поместить отчет на верхний уровень. {% endstep %} {% step %} #### Шаг 2: Введите основную информацию Редактор открывается с двумя полями вверху: * **Title** (обязательное): имя, отображаемое в меню и заголовках экспорта. * **Description** (необязательное): дополнительный контекст, видимый в редакторе. {% 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, -- Преобразовать масштабированную целочисленную скорость в km/h 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 при настройке отчета. Это уменьшает время выполнения запроса и ускоряет предварительный просмотр компонента. Если вам нужен полный набор данных для скачивания, удалите или увеличьте лимит перед сохранением. * После написания запроса вы можете нажать **Detect Columns** чтобы проверить, какие столбцы фактически извлекаются этим запросом. Это помогает настроить селекторы столбцов на вкладке **Components** . Шаг необязателен. Вы можете настроить компоненты вручную, но если сначала выполнить его, это упростит выбор осей и полей. * Любой SQL-запрос, используемый на панели мониторинга, является подходящей отправной точкой для отчета. Скопируйте запрос с панели и адаптируйте его под цель отчета. Например, добавив столбцы, необходимые для карты местоположения, или удалив агрегации, которые не применимы к табличному представлению. * Книга рецептов IoT Query содержит общие и отраслевые примеры запросов, готовые к использованию в качестве основы для отчетов. См. [Книга рецептов SQL](/docs/analytics/ru/example-queries.md) для полного списка. {% endhint %} {% endstep %} {% step %} #### Шаг 4: Настройте компоненты Нажмите вкладку **Components** вкладка. Доступны три компонента: **Таблица**, **График**, и **Карта**. У каждого есть переключатель, чтобы включить или исключить его из отчета. Вы можете удалить любой ненужный компонент. {% tabs %} {% tab title="Таблица данных" %} Таблица данных отображает результаты запроса в постранично разбитых строках. * **Размер страницы**: задает, сколько строк отображается на каждой странице в интерактивном представлении. Это не влияет на экспорт, который всегда содержит полный набор результатов. * **Показывать строку итогов**: добавляет итоговую строку внизу таблицы, когда включено. {% endtab %} {% tab title="График" %} Доступны два типа диаграмм: * **Временной ряд (линейный)**: подходит для данных, отображаемых во времени. * **Столбчатая диаграмма**: подходит для сравнения категорий (также называется столбчатой диаграммой). Настройте оси: * **Колонка оси X**: обычно столбец времени, такой как `device_time`. * **Столбцы оси Y**: один или несколько числовых столбцов, таких как скорость или `fuel_level`. * **Группа по**: при необходимости разделите серии по категориальному столбцу, например `метка_Объект`, чтобы отображать отдельную линейную или столбчатую группу для каждого устройства. {% endtab %} {% tab title="Карта местоположения" %} Карта местоположения отображает точки данных, используя GPS-координаты. Dashboard Studio может автоматически определять столбцы широты и долготы по результату вашего запроса. Когда **Автоопределение столбцов GPS** переключатель включен, столбцы, необходимые для определения местоположения (обычно `широта` и `долгота`) выбираются автоматически, если ваш запрос возвращает их. Вы также можете отключить **Auto-detect** опцию и выбрать нужные столбцы вручную. {% endtab %} {% endtabs %} {% endstep %} {% step %} #### Шаг 5: Сохраните отчет Нажмите Save. Отчет появится в разделе меню, который вы выбрали на шаге 1, и будет доступен всем пользователям, у которых есть доступ к этому разделу. {% endstep %} {% endstepper %} ## Просмотр отчета После того как вы создадите отчет, он откроется сразу. Вы увидите все настроенные компоненты, отображенные с актуальными данными из вашей базы данных IoT Query. В заголовке отчета отображаются метка времени последнего обновления, общее количество строк и время выполнения запроса. На странице отчета также напрямую отображается SQL-запрос, поэтому вы можете обновить его в любое время. 1. Разверните **SQL Query** раздел, чтобы просмотреть или отредактировать запрос прямо на месте. 2. Примените изменения: 1. Нажмите **Сохранить** чтобы сохранить изменения без запуска. Вам нужно будет нажать **Обновить** чтобы повторно выполнить запрос и обновить все представления текущими данными. 2. **Сохранить и запустить** чтобы немедленно применить обновленный запрос. ### Таблица данных Эта **Таблица данных** раздел показывает результаты запроса, а в заголовке раздела отображается общее количество строк, возвращенных запросом. В интерактивном представлении отображается только ограниченное количество строк, нижний колонтитул подтверждает точное количество. Используйте **Скачать** выпадающее меню для экспорта полного набора результатов в Excel (.xlsx) или CSV (.csv) независимо от того, сколько строк отображается в интерактивном представлении. Если вам нужны адреса вместо необработанных координат, установите флажок **Геокодировать в адрес** флажок в правом верхнем углу **Таблица данных** заголовка. При включении он преобразует столбцы координат в читаемые адреса. {% hint style="warning" %} Определение адресов создает значительную нагрузку на сервер. Используйте этот параметр только с агрегированными или отфильтрованными наборами данных. Для необработанных телематических данных с десятками тысяч строк оставляйте координаты в числовом виде. {% endhint %} ### График Раздел диаграммы отображается под таблицей данных. Он наследует настройки, которые вы применили в редакторе отчета, но вы также можете настраивать конфигурацию осей непосредственно в представлении: * **Ось X**: выберите столбец для отображения на горизонтальной оси. * **Ось Y**: выберите столбец для построения по вертикальной оси. * **Группа по**: при необходимости разделите серии по категориальному столбцу, например `метка_Объект`, чтобы отображать отдельную линейную или столбчатую группу для каждого устройства. Диаграмма отображает автоматически сгенерированный заголовок, описывающий текущий выбор оси и группировки, например: `скорость по device_time (с группировкой по object_label)`. Когда вы изменяете настройки оси без сохранения, **Несохраненные изменения** индикатор отображается рядом с **Сохранить настройки диаграммы** кнопка. Нажмите ее, чтобы сохранить изменения конфигурации в отчете. Когда **Группа по** разделяет диаграмму на группы, диаграмма отображает первые 10 групп. Чтобы выбрать другие группы, нажмите **Группы**, которая показывает, сколько групп отображается из общего числа. В списке нажмите группу, чтобы отобразить ее или убрать ее из диаграммы. Чтобы найти группу, выполните поиск по ее названию. Строки без значения в **Группа по** столбце не принадлежат ни одной группе, и диаграмма не отображает их. **Выбрать все** и **Очистить** применяются к группам, которые соответствуют поиску. **Выбрать все** недоступно, если оно отобразит более 1,000 групп в общей сложности. Список показывает до 100 не отображаемых групп, поэтому найдите остальные с помощью поиска. Чтобы вернуться к первым 10 группам, нажмите **Сбросить по умолчанию**. Dashboard Studio не сохраняет выбор групп. Выбор сбрасывается, когда вы снова открываете отчет или выбираете другой **Группа по** столбец. ### Карта местоположения Эта **Карта местоположения** раздел отображает каждую строку запроса как точку в ее GPS-координатах. Заголовок раздела показывает количество отображаемых точек. Столбцы GPS задаются при создании отчета (автоматически или вручную), после этого их нельзя редактировать. Если запрос не возвращает распознанных столбцов координат, раздел показывает "В результатах запроса не обнаружены GPS-координаты." Для телематических данных с отметками времени отображаемые точки представляют полный путь объекта за запрашиваемый период. {% hint style="info" %} Карта интерактивна: увеличивайте масштаб и панорамируйте ее, чтобы рассмотреть отдельные точки. Нажмите **Показать все** чтобы уменьшить масштаб и поместить все отображаемые точки в видимую область карты. {% endhint %} ## Экспорт отчета Dashboard Studio предоставляет два уровня экспорта. ### Экспорт таблицы данных Используйте **Скачать** выпадающий список в **Таблица данных** разделе, чтобы экспортировать только данные таблицы. Экспорт всегда содержит полный набор результатов, возвращенный запросом, независимо от ограничения отображения в интерактивном представлении. ### Полный экспорт отчета Используйте кнопки в заголовке отчета, чтобы экспортировать все компоненты вместе. | Кнопка | Вывод | | --------------------- | -------------------------------------------------------------------------- | | Excel → Excel (.xlsx) | Электронная таблица с полными данными | | Excel → CSV (.csv) | Файл CSV с полными данными | | HTML | Интерактивный файл с таблицей данных, диаграммой и картой местоположения | | PDF | Статический документ с таблицей данных, диаграммой и картой местоположения | Диаграмма в файле HTML или PDF отображает те же группы, что и диаграмма на экране. Когда диаграмма отображает только часть групп, файл показывает количество отображаемых групп и общее количество групп. {% hint style="info" %} Экспортированный файл HTML сохраняет интерактивность: диаграмма поддерживает всплывающие подсказки при наведении, а карта местоположения поддерживает масштабирование и панорамирование. {% endhint %} ## Редактирование и удаление отчета Чтобы отредактировать сохраненный отчет, вам больше не нужен отдельный диалог редактора. Откройте отчет из меню и измените в нем SQL-запрос или настройки компонентов напрямую. Единственное исключение — столбцы местоположения, они определяются один раз при создании отчета. Чтобы удалить отчет, нажмите **Tools** в левой боковой панели, затем выберите **Меню редактирования**. Найдите отчет в дереве меню и нажмите меню с тремя точками рядом с его названием, затем подтвердите удаление. --- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` 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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.