Перейти к основному содержимому

Отчёты и экспорт

В X7 Insight выгрузка выполняется в два шага: создаётся описание выгрузки (что и в каком формате выгружать), затем по нему запускаются задания экспорта. На этой странице описаны семь форматов экспорта, жизненный цикл задания, возможности на запуск экспортов и выгрузку идентифицирующих данных, а также различие между экспортами исследования и глобальным мониторингом.

Кто что делает​

ДействиеКтоВозможность
Создаёт описание выгрузкиМенеджер данных, Директорreports.run_exports, studies.manage_study_config
Запускает задание экспортаМенеджер данных, Директор, Монитор (ограниченно)reports.run_exports
Выгружает идентифицирующие данные (PHI / PII)Те, кому отдельно назначена возможностьreports.export_phi
Скачивает результатТот, кто запустил заданиеreports.run_exports
Просматривает все задания экспорта в системеСистемный администраторreports.run_exports + core.manage_system
Экспортирует журнал аудитаМенеджер данных, Директор, Системный администраторaudit.export_audit
предупреждение

Возможность reports.export_phi назначается отдельно и не входит автоматически в reports.run_exports. Без неё в выгрузке идентифицирующие поля (ФИО, дата рождения, контакты) будут заменены на маркеры, даже если пользователь видит их в интерфейсе.

Где смотреть​

  • Описания и задания исследования: /studies/[studyId]/reports.
  • Журнал аудита (источник для выгрузки аудита): /studies/[studyId]/audit.
  • Глобальный мониторинг всех заданий экспорта в системе: /admin/exports — только для Системного администратора.
Скриншот

Страница отчетов с вкладками описаний и заданий экспорта Содержание: страница /studies/[studyId]/reports — вкладки «Описания» и «Задания», список заданий со статусами и кнопкой «Скачать».

Поддерживаемые форматы​

В системе семь форматов выгрузки данных исследования (reports.enums.ExportFormat):

ФорматКогда выбирать
CSVТабличный анализ, импорт в статистику, простая работа в Excel или LibreOffice
TSVАльтернатива CSV, если в значениях встречаются запятые
Excel (.xlsx)Ручная проверка, обмен с пользователями без специального ПО
CDISC ODM XML (с метаданными)Передача спонсору по стандарту CDISC, включая структуру форм и правил
CDISC ODM XML (только данные)Та же передача, но без метаданных — когда они уже синхронизированы у получателя
JSON (плоский список)Программная интеграция; одна строка — одно значение
JSON (вложенная структура)Программная интеграция; иерархия «субъект → визит → форма → поле»

Для журнала аудита поддерживаются отдельные форматы:

  • CSV — для внутренней аналитики и проверки;
  • PDF — для регуляторной отчётности.

Описание выгрузки​

Описание — переиспользуемый набор параметров (область, типы данных, формат, временной диапазон). Удобно для регулярных срезов и для финального экспорта.

  1. Откройте /studies/[studyId]/reports.
  2. «Создать описание выгрузки».
  3. Параметры:
    • область (всё исследование / выбранные центры / выбранные визиты);
    • типы данных (формы, запросы, аудит, статусы);
    • формат файла;
    • включать ли заблокированные данные и субъектов в статусах Не прошёл скрининг / Выбыл;
    • включать ли PHI / PII — поле появляется только у пользователя с reports.export_phi;
    • временной диапазон (по датам визитов или датам изменения).
  4. Сохраните. Описание появится в списке.

Запуск задания​

  1. На /studies/[studyId]/reports нажмите «Новое задание экспорта».
  2. Выберите описание или задайте параметры разово.
  3. Запустите. Задание встаёт в очередь и получает идентификатор.
  4. По мере выполнения статус меняется (см. ниже). После Завершён появляется кнопка «Скачать». Срок хранения файла задан в настройках исследования (обычно несколько дней).

Статусы задания​

Жизненный цикл задания описывается перечислением reports.enums.ExportJobStatus.

СтатусЧто означает
ОжидаетПринято, ещё не поставлено в очередь обработки
В очередиПоставлено в очередь, ждёт свободного воркера
ВыполняетсяИдёт сборка файла
ЗавершёнГотов к скачиванию
ОшибкаНе выполнено; в карточке задания — причина и идентификатор ошибки
ОтменёнПрервано пользователем

Переходы:

Ожидает → В очереди → Выполняется → Завершён
            │              │
            └→ Отменён ←──┴→ Ошибка
                        Отменён

Завершён, Ошибка и Отменён — терминальные состояния, дальше задание не меняется.

Какой формат выбрать​

  • Быстрая проверка глазами или работа в Excel — Excel (.xlsx).
  • Передача аналитику или статистику — CSV или TSV.
  • Передача спонсору по CDISC — CDISC ODM XML (с метаданными), или CDISC ODM XML (только данные), если метаданные уже синхронизированы.
  • Программная интеграция — JSON (плоский список) (проще читать построчно) или JSON (вложенная структура) (удобнее с иерархией).
  • Регуляторная проверка аудита — PDF, внутренняя аналитика аудита — CSV.

Casebook субъекта​

Casebook — сводная выгрузка всех данных одного субъекта. Запускается из карточки субъекта (см. Субъекты и визиты). Поддерживаются HTML и PDF; в настройках можно включить журнал аудита и запросы. Используется при закрытии визитов мониторинга и для архивного хранения.

Где смотреть «свои» и «все» экспорты​

  • В рамках одного исследования: /studies/[studyId]/reports — все задания этого исследования (свои и коллег с правом просмотра).
  • Глобально в системе: /admin/exports — все задания экспорта во всех исследованиях. Доступно только Системному администратору и используется для технического мониторинга очереди и сбоев.

Что делать, если…​

СитуацияЧто проверить
Раздел отчётов не виденНет роли Менеджера данных, Директора или Монитора в исследовании
Нет нужного форматаФормат не поддерживается для выбранного типа данных (например, аудит — только CSV и PDF)
В выгрузке заменены идентифицирующие поляУ вас нет reports.export_phi, либо в описании выгрузки PHI отключён
Задание зависло в ВыполняетсяБольшой объём — дождитесь; если более часа, сохраните идентификатор и передайте в поддержку
Статус ОшибкаВ карточке задания — причина и идентификатор
Файл не скачиваетсяИстёк срок хранения — запустите задание повторно
/admin/exports не открываетсяНужна роль Системного администратора

См. также​