Экспорт данных виджета

В Системе предусмотрена возможность экспорта (выгрузки) данных виджета. Данные экспортируются в текстовый файл формата .csv (текст с разделителями). Выполняются следующие правила:

  • кодировка полученного файла формата .csv – UTF-8-BOM;

  • разделители столбцов – символ «;» (точка с запятой);

  • для переноса строк (завершение строки) в текст вставляется управляющий символ переноса строки LF (ASCII HEX код – «0A»);

  • для разделения дробной и целой части чисел вставляется символ «,» (запятая);

  • значения, экспортируемые из текстовых полей, обрамляются двойными кавычками – до и после текстового значения вставляется символ " (ASCII HEX код – «22»).

Для экспорта данных виджета нажмите на кнопку в режиме редактирования или просмотра виджета. Откроется окно выбора состояния для экспорта данных (Рисунок «Окно выбора состояния для экспорта данных»).

Рисунок 25. Окно выбора состояния для экспорта данных

Окно выбора состояния для экспорта данных

Выберите состояние:

  • «Первичное» – для экспорта плоских данных;

  • «Агрегированное» – для экспорта агрегированных данных, после выбора данного состояния отобразятся доступные уровни вложенности (Рисунок «Отображение уровней вложенности для состояния «Агрегированное»). Выберите необходимый уровень вложенности;

    Рисунок 26. Отображение уровней вложенности для состояния «Агрегированное»

    Отображение уровней вложенности для состояния «Агрегированное»

  • «Полное» – для экспорта плоских и агрегированных данных.

Нажмите на кнопку «Экспорт». Произойдет экспорт данных виджета с примененными фильтрами и сортировками.

Условия доступа для экспорта данных

Экспорт данных виджета доступен при следующих условиях:

Таблица 1. Условия доступа для экспорта данных виджета

Вид виджета Условия доступа
Состояние «Первичное» Состояние «Агрегированное» Состояние «Полное»
Таблица

Выбран хотя бы один столбец

  • выбран хотя бы один столбец;

  • указана промежуточная агрегация;

  • выбрана хотя бы одна группа

Выбран хотя бы один столбец
Столбчатая диаграмма (верт.)
  • выбран хотя бы один столбец;

  • указана промежуточная агрегация;

  • выбрана хотя бы одна группа

Столбчатая диаграмма с накоплением (верт.)
  • выбран хотя бы один столбец;

  • указана промежуточная агрегация;

  • выбрана хотя бы одна группа

Столбчатая диаграмма (гор.)
  • выбран хотя бы один столбец;

  • указана промежуточная агрегация;

  • выбрана хотя бы одна группа

Столбчатая диаграмма с накоплением (гор.)
  • выбран хотя бы один столбец;

  • указана промежуточная агрегация;

  • выбрана хотя бы одна группа

Линейный график
  • выбран хотя бы один столбец;

  • указана промежуточная агрегация;

  • выбрана хотя бы одна группа

Радар
  • выбран хотя бы один столбец;

  • указана промежуточная агрегация;

  • выбрана хотя бы одна группа

Круговая диаграмма
  • выбран хотя бы один столбец;

  • указана промежуточная агрегация;

  • выбрана хотя бы одна группа

Кольцевая диаграмма
  • выбран хотя бы один столбец;

  • указана промежуточная агрегация;

  • выбрана хотя бы одна группа

Полярная диаграмма
  • выбран хотя бы один столбец;

  • указана промежуточная агрегация;

  • выбрана хотя бы одна группа

Тренд Выбран хотя бы один столбец
  • выбран хотя бы один столбец;

  • указана промежуточная агрегация;

  • выбрана хотя бы одна группа

Выбран хотя бы один столбец
Карта
  • выбран хотя бы один столбец;

  • указана промежуточная агрегация;

  • выбрана хотя бы одна группа

Древовидная карта
  • выбран хотя бы один столбец;

  • указана промежуточная агрегация;

  • выбрана хотя бы одна группа

Тепловая карта
  • выбран хотя бы один столбец;

  • указана промежуточная агрегация;

  • выбрана хотя бы одна группа

Сводная таблица
  • выбран хотя бы один агрегат (с промежуточной агрегацией);

  • выбрана хотя бы одна группа

Недоступно
Пузырьковая диаграмма

Выбраны как минимум два агрегата

  • выбраны как минимум два агрегата;

  • указана промежуточная агрегация;

  • выбрана хотя бы одна группа

Выбраны как минимум два агрегата
Комбинированная диаграмма
  • выбран хотя бы один столбец;

  • указана промежуточная агрегация;

  • выбрана хотя бы одна группа

HTML Выбран хотя бы один столбец
  • выбран хотя бы один столбец;

  • указана промежуточная агрегация;

  • выбрана хотя бы одна группа

Выбран хотя бы один столбец

Примечание
Если для виджета недоступно хотя бы одно из состояний для экспорта данных, то кнопка не отображается.

Ниже представлена структура файлов экспорта данных в зависимости от типа виджета для каждого состояния:

Уведомления и скачивание файла экспорта данных

После запуска процесса экспорта данных виджета отобразится сообщение о начале процесса (Рисунок «Сообщение о начале процесса экспорта данных виджета»).

Рисунок 36. Сообщение о начале процесса экспорта данных виджета

Сообщение о начале процесса экспорта данных виджета

Когда выгрузка виджета будет завершена, отобразится сообщение с названием экспортированного виджета и ссылкой для скачивания файла (Рисунок «Сообщение о завершении экспорта данных виджета»).

Рисунок 37. Сообщение о завершении экспорта данных виджета

Сообщение о завершении экспорта данных виджета

Данное сообщение отображается несколько секунд, после скрытия сообщения ссылку для скачивания файла можно посмотреть в разделе центра уведомлений (Рисунок «Переход в центр уведомлений», Рисунок «Просмотр уведомлений и ссылок для скачивания файлов»).

Рисунок 38. Переход в центр уведомлений

Переход в центр уведомлений

Рисунок 39. Просмотр уведомлений и ссылок для скачивания файлов

Просмотр уведомлений и ссылок для скачивания файлов

Чтобы скачать файл из центра уведомлений, нажмите на ссылку (см. Рисунок «Просмотр уведомлений и ссылок для скачивания файлов»). После нажатия в web-браузере отобразится процесс загрузки архива с файлом (выгруженным файлом) в формате .zip (Рисунок «Отображение процесса загрузки архива (краткая информация)», Рисунок «Отображение процесса загрузки архива (подробная информация)»).

Рисунок 40. Отображение процесса загрузки архива (краткая информация)

Отображение процесса загрузки архива (краткая информация)

Рисунок 41. Отображение процесса загрузки архива (подробная информация)

Отображение процесса загрузки архива (подробная информация)

Примечание

Администратор Системы может настраивать:

  • ограничения на максимальный размер формируемого файла – в конфигурационном файле реализован параметр AW_WIDGET_EXPORT_MAX_FILE_SIZE, по умолчанию равный 8 ГБ. При превышении лимита в сообщение и в конец файла добавляется строка с сообщением «Достигнут предельный размер файла, данные экспортированы не полностью»;

  • время жизни файла выгрузки (сек) – реализован параметр «file_lifetime», по умолчанию равный 604800 (7 дней). Проверяется по cron, по истечении срока реализуется механизм удаления старых данных из хранилища. Время указывается в секундах, если параметр равен «0» или значение не указано, то считается, что установлено значение «Неограниченное время жизни выгрузки», т.е. разрешено хранение всех версий выгрузок неограниченное количество времени;

  • количество хранимых копий выгрузок – реализован параметр «count_of_stored_files», по умолчанию равный 5. При превышении лимита реализуется метод по удалению старого неактуального набора данных по текущему виджету данного пользователя;

  • процент свободного места в хранилище – реализован параметр «free_storage_space», по умолчанию равный 10. Позволяет резервировать свободное место в хранилище для работы Системы;

  • частоту запуска очистки (сек) – реализован параметр «storage_cleared_start_interval», по умолчанию равный 86400 (1 день). Запускается принудительный механизм очистки хранилища:

    1. сначала очищается хранилище от копий, остаются только последние выгрузки пользователя по виджетам (на виджет по одной выгрузке);

    2. если необходимое место не освобождено, то удаляются самые старые файлы до тех пор, пока не будет освобождено необходимое пространство, регулируемое параметром «free_storage_space».

Если файл удален, в центре уведомлений вместо ссылки для скачивания архива отображается запись «Истекло время хранения файла» (Рисунок «Отображение записи в центре уведомлений при удалении файла»).

Рисунок 42. Отображение записи в центре уведомлений при удалении файла

Отображение записи в центре уведомлений при удалении файла