Импорт и экспорт данных

Назначение

Раздел собирает все способы загрузить данные в систему и выгрузить их наружу: для отчётности, обмена с другими учётными системами, печати ведомостей, выполнения требований приватности (выгрузка персональных данных по запросу субъекта). Это не отдельный экран, а набор паттернов, доступных в разных модулях. Один раз поняв логику, клиент применяет её везде.

Кто работает с модулем

• Администратор — пользуется всеми возможностями: экспортирует таблицы для отчётности, печатает ведомости зарплаты, выгружает журнал аудита.
• Мастер — экспортирует свои рабочие списки (задания, смены, простои), печатает ведомости и расчётные листы зарплатного периода, выгружает журнал аудита для проверок.
• Оператор — может выгрузить свои собственные персональные данные в рамках реализации права субъекта на доступ. Других видов экспорта в OCULUS не предусмотрено.

Что можно экспортировать

Импорт массивов сотрудников, номенклатуры, спецификаций через клиентский интерфейс в текущей версии не предусмотрен. Первичная загрузка справочников (например, единиц измерения по госстандарту) выполняется командой OCULUS на этапе подключения организации.

Основные сценарии

Экспорт списка из таблицы

1. Пользователь открывает любой раздел с таблицей: задания, смены, простои, машины, сотрудники.
2. Применяет нужные фильтры и сортировку. Результат на экране — это и есть набор, который попадёт в файл.
3. Нажимает кнопку «Экспорт» в шапке таблицы.
4. Выбирает формат (если предложен выбор) — табличный файл для Excel или универсальный CSV.
5. Через несколько секунд скачивается файл с осмысленным именем (название раздела, период, дата).

На объём одной выгрузки наложено ограничение — это защита от случайной выгрузки «всего-за-всё-время» и от перегрузки. Если фильтры выбраны слишком широко и итоговый объём превышает допустимый, система просит сузить отбор.

Печать ведомости зарплаты

См. модуль 11. Кратко: на закрытом или рассчитанном периоде доступны два формата документа — ведомость (одна строка на сотрудника, итоги) и расчётный лист (детализация для каждого). Печать идёт удобными порциями, чтобы большая организация не «зависала» на формировании тысячи листов.

Выгрузка персональных данных субъекта

Действует право субъекта персональных данных на получение копии своей информации:

1. Сотрудник открывает свой профиль и нажимает «Запросить выгрузку моих данных».
2. Система собирает все его записи: личные поля (ФИО, контакты, должность, грейд, согласия), задания, смены, простои, обращения, фото-вложения по обращениям.
3. Формирует архив, который содержит несколько табличных файлов (по типу данных) и единый структурированный файл со ссылками на остальное.
4. Архив доступен для скачивания внутри профиля. Если запрос требует подтверждения — статус виден в списке запросов.

Чувствительные поля других пользователей в выгрузке не показываются; только данные самого запросившего.

Выгрузка журнала аудита

Раздел «Безопасность → Журнал аудита» позволяет администратору и мастеру выгрузить хронологический список критичных событий за период:

• Доступны фильтры по дате, пользователю, типу действия, сущности.
• Поддерживается потоковая выгрузка для длинных периодов: файл начинает скачиваться сразу, не ожидая, когда сервер «соберёт всё в память». Это позволяет выгружать выборки на сотни тысяч строк.
• Формат — табличный или построчный JSON для специализированных систем.
• Действует ограничение частоты полных выгрузок аудита на одного пользователя — защита от случайного «качаю каждую минуту» и от попыток вытащить весь журнал за одну сессию. При превышении система сообщает, через сколько можно повторить.

Загрузка справочника единиц измерения

Первичная загрузка единиц измерения по госстандарту (ОКЕИ — общероссийский классификатор) выполняется как административная операция на стороне OCULUS, не из клиентского интерфейса. На стороне клиента это уже готовый справочник, доступный к выбору в карточках номенклатуры.

Поля и данные

• Имена файлов формируются автоматически: имя раздела, период (если применим), дата выгрузки. Например, «zadaniya_2026-04-01_2026-04-30_2026-05-06.xlsx». Не нужно «вспоминать», что в файле было.
• Кодировка табличных файлов — UTF-8 с маркером в начале файла, чтобы Excel сразу открывал кириллицу без шаманства с настройками.
• Разделитель в CSV — точка с запятой (стандарт для российских локалей Excel) — числа с запятой как десятичным разделителем не путаются с разделителем колонок.
• Даты в файле выгружаются в локальном времени пользователя. Это согласовано с тем, что показано в интерфейсе.
• Статусы и роли выгружаются на русском языке («Завершено», «Активная», «Мастер») — файл сразу читаем без расшифровки кодов.
• Числа сохраняют ту же точность, что в интерфейсе (как правило, до четырёх знаков после запятой).

Списки, фильтры, поиск

Экспорт всегда работает по принципу «что вижу, то и выгружу»:

• Фильтры таблицы (по периоду, по сотруднику, по статусу и т. д.) применяются к выгрузке без отдельного диалога.
• Сортировка таблицы повторяется в файле — порядок строк такой же, как на экране.
• Скрытые колонки в файле тоже скрыты — пользователь сам решает, какие поля важны.

Это сильно упрощает рабочий процесс «настроил вид → выгрузил» — нет двух разных «настроек», в интерфейсе и в экспорте.

Автоматика и подсказки системы

• При попытке выгрузить слишком большой объём система явно сообщает «больше N строк, сузьте фильтры» — без молчаливого обрезания.
• При длинной выгрузке аудита данные начинают идти на устройство сразу, без ожидания «соберу всё на сервере». Большие выборки доступны без таймаутов.
• Имя файла включает дату выгрузки — папка «Загрузки» не превращается в стопку файлов с одинаковыми именами.
• Маркер UTF-8 в начале файла подкладывается автоматически — Excel открывает кириллицу без перекодировки.
• В CSV экранируются строки, начинающиеся с символов формул (=, +, -, @) — ячейка не пытается «выполнить» подозрительный текст при открытии в Excel.
• Лимит частоты выгрузок аудита фиксируется в журнале — администратор видит, кто и сколько раз качал.

Микро-фичи и детали интерфейса

• Кнопка «Экспорт» — единая для всех таблиц, рядом с шапкой; не нужно искать её в разных местах в разных разделах.
• Выгрузка задействует те же фильтры и сортировку, что в интерфейсе — нет «двух разных видов» данных.
• В CSV десятичный разделитель — точка, разделитель колонок — точка с запятой; это стандарт российских локалей Excel.
• Имя файла раскрывает суть содержимого: раздел, период, дата выгрузки. Не нужно открывать, чтобы понять, что внутри.
• Маркер UTF-8 BOM добавляется — Excel сразу понимает кодировку без дополнительных настроек.
• Статусы, роли, типы причин выгружаются на русском языке — файл читаем сразу без таблицы соответствий.
• Защита от формул в CSV: ячейки, начинающиеся с подозрительных символов, экранируются — открытие в Excel не приводит к выполнению чужого кода.
• Печать ведомостей зарплаты идёт партиями — большая организация не «упирается» в одну гигантскую печать.
• Выгрузка персональных данных собирает не только профиль, но и связанную историю — все обращения, задания, смены и согласия сотрудника в одном архиве.
• Ограничение объёма одной выгрузки защищает от случайной «выгрузки всего» и сохраняет производительность.
• Поточный режим выгрузки аудита позволяет качать выборки за квартал или год без ожидания.
• Ограничение частоты выгрузок аудита на пользователя — защита от перебора и автоматических скриптов.
• В выгрузке простоев исключённые из аналитики помечаются отдельной колонкой — внешние отчёты получают «честные» цифры без скрытого фильтра.
• На больших выгрузках интерфейс показывает прогресс или статус «формируется», а не молча зависает.
• При прерванном скачивании пользователь может повторить — частично сформированные файлы корректно очищаются.

Связи с другими модулями

• Все табличные модули (задания, смены, простои, машины, сотрудники, спецификации, расчётные периоды, обращения). Экспорт — стандартная функция любой их таблицы.
• Зарплата (11). Печать ведомостей и расчётных листов в табличный файл.
• Журнал аудита (рядом с 14). Поточная выгрузка с лимитом частоты.
• Пользователи и роли (03). Выгрузка персональных данных по запросу субъекта.
• Поиск, фильтры, сортировка (17). Экспорт всегда уважает текущий набор фильтров и сортировку.
• Файлы и вложения (13). Прикреплённые файлы попадают в архив выгрузки персональных данных.

Состояния и пограничные случаи

• Слишком большой объём выгрузки. Система явно говорит «сузьте фильтры», не выдаёт молчаливо обрезанный файл.
• Прерванное скачивание. Частичный файл корректно очищается; пользователь повторяет действие. Уже скачанная часть не «прилипает» к следующей попытке.
• Превышение лимита выгрузок аудита. Появляется сообщение «лимит выгрузок исчерпан, попробуйте через…» с указанием времени до следующей возможности.
• Запрос на выгрузку личных данных запущен повторно. Допустим, но создаст новый запрос; старый архив остаётся как был.
• Открытие файла в Excel со «странными» символами. Маркер UTF-8 BOM спасает — кириллица читается сразу, без перекодировки. Если всё же что-то не так — это значит локаль Excel настроена нестандартно, и админ предприятия может это поправить.
• Импорт сотрудников или номенклатуры. В клиентском интерфейсе не реализован. Если нужна массовая загрузка — обращение в службу поддержки OCULUS, специалист подгрузит данные на стороне платформы.
• Дублирование при импорте. Поскольку клиентский импорт сейчас не предусмотрен, эта ситуация не возникает в клиентском интерфейсе.
• Выгрузка ведомости зарплаты по большому периоду. Печать удобными порциями — браузер не блокируется на десятки минут.

Операторский интерфейс OCULUS

В приложении OCULUS импорт и экспорт не задействованы как отдельный сценарий. Единственный связанный путь для оператора — запрос выгрузки своих персональных данных через профиль (право субъекта). Все управленческие выгрузки — задания за смену, простои, ведомости, журнал аудита — делаются мастером и администратором в веб-интерфейсе.