Загрузка данных из Excel и CSV

Файл в одну форму: сопоставление столбцов, те же сверки (edit checks), что при вводе, отчёт по строкам.

Загрузка переносит данные из Excel или CSV в формы исследования: выгрузки МИС, результаты лаборатории, старые таблицы. Один файл загружается в одну форму одного визита, а книга исследования загружает целых пациентов со всеми визитами сразу. Каждая строка проходит те же сверки (edit checks), что и ручной ввод, а в конце вы получаете отчёт по каждой строке.

Шаг 1. Файл

Откройте «Импорт» в меню исследования. Выберите визит и форму, куда загружать, и файл .xlsx или .csv. Первая строка файла содержит заголовки, всего до 20 000 строк. Из Excel читается первый лист. CSV может быть в UTF-8 или Windows-1251 с разделителем «;», «,» или табуляцией: портал определит это сам. Для визита-события, например «Нежелательное явление», каждая строка файла добавляет пациенту новое событие.

Кнопка «Шаблон Excel для этой формы» скачает пустой файл с правильными заголовками и подсказками: коды вариантов ответа, формат даты, допустимый диапазон чисел.

Шаг 2. Столбцы

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

Шаг 3. Отчёт

По каждой строке видно, что с ней стало:

• загружено: строка сохранена;
• загружено с пометкой: строка сохранена, но значение необычное (вне ожидаемого диапазона или сработало правило-предупреждение). На такое значение сразу открывается автоматический запрос;
• пропущено: форма уже заполнена;
• ошибка: строка не загружена. Так бывает с неверной датой, значением вне допустимого диапазона, неизвестным вариантом ответа или чужим центром. Исправьте такие строки в файле и загрузите только их.

Пример: анализы из лаборатории

В демо-исследовании REG-DIAB-01 (регистр сахарного диабета 2 типа) лаборатория прислала результаты визита «Месяц 6». Это файл lab_month6.csv из её системы, в кодировке Windows-1251 и с разделителем «;»:

1. Дата-менеджер выбирает «Месяц 6 · HbA1c и глюкоза» и файл.
2. «Дата взятия» и «Глюкоза натощак» совпали с названиями полей и сопоставились сами. Столбец «HbA1c, %» назван иначе, чем поле, поэтому его выбирают вручную. Пациента REGDIA-02-0006 в исследовании ещё нет, поэтому включена галочка «Создавать пациентов», а центр берётся из столбца «Центр».
3. Результат: загружено 4, ошибок 2, пропущено 1.
   • У REGDIA-02-0004 HbA1c 11,8 % выше ожидаемых 11 %. Строка загружена, и открыт автоматический запрос к центру 02.
   • У REGDIA-03-0003 вместо глюкозы стоит ND, то есть «нет данных». Поле это разрешает.
   • REGDIA-02-0006 создан в центре 02 вместе с формой.
   • У REGDIA-01-0001 форма «Месяц 6» уже заполнена, поэтому строка пропущена.
   • У REGDIA-03-0004 стоит HbA1c 71: это опечатка вместо 7,1, а допустимо от 3 до 20. У REGDIA-03-0005 указано 31.09.2026, а такой даты нет. Эти две строки исправляют в файле и загружают ещё раз, уже только их.

Целые пациенты из одной книги

Когда регистр переезжает из другой системы, загружать форму за формой долго. Книга исследования принимает всё одним файлом Excel: пациентов, их согласия и все формы всех визитов. У неё та же раскладка, что у выгрузки исследования в Excel, поэтому выгруженный файл тоже загружается обратно как есть, например в копию исследования.

1. На странице импорта в блоке «Целые пациенты из книги» скачайте шаблон книги исследования. В нём лист «Пациенты», лист «Согласия», если в исследовании ведутся согласия, и по листу на каждую форму с кодом формы в названии. В первой строке коды переменных. Последний лист объясняет, как заполнять, и в каких визитах есть каждая форма.
2. Заполните её из старой системы и загрузите. Портал показывает, что в файле, до загрузки: новые пациенты, пациенты уже в исследовании, строки по формам, листы и столбцы, которые он не тронет.
3. Решите, включать ли пациентов, которых ещё нет в исследовании, и менять ли уже заполненные формы, и нажмите «Загрузить в фоне». Со страницы можно уйти. Когда загрузка закончится, отчёт появится на странице импорта и в «Моих фоновых задачах», и придёт письмо.

Пример: в демо-регистр REG-DIAB-01 переносят 1 200 пациентов из старого регистра в таблицах. На листе «Пациенты» 1 200 строк, «Согласия» 1 200, в формах VS, LAB и AE 3 600, 2 400 и 310 строк. Сначала включаются пациенты, потом записываются согласия, потом загружаются формы, поэтому правило «данные только после согласия» продолжает работать. У пациента REGDIA-02-0117 версия согласия «Версия 0.9», которой в исследовании нет, поэтому эта строка согласия не загрузится, а с ней и все формы этого пациента. Ошибки в отчёте идут первыми: исправьте строки и загрузите только их.

Кто может загружать и что остаётся в аудите

• Загружают администратор проекта и дата-менеджер. Если дата-менеджеру открыта только часть центров, он загружает и видит в отчёте только пациентов своих центров. Строки других центров получают ошибку.
• Когда база закрыта, загрузка недоступна.
• В аудит пишется каждое изменённое значение с причиной «Импорт из файла „…“», каждый новый пациент и сама загрузка: файл, сколько загружено, с ошибками, пропущено.
• Внизу страницы «Импорт» хранится история загрузок, а из неё открывается отчёт любой прошлой загрузки.
• Книгу загружает фоновая задача от имени того, кто её запустил: в аудите стоит этот человек, а не система.
• Файл хранится до загрузки, но не дольше суток. После загрузки он удаляется, а остаётся только отчёт.