РуководствоДата-менеджер

Собрать формы в конструкторе

Черновик дизайна собирается визуально — в конструкторе CRF. Здесь вы создаёте формы, разделы и поля, настраиваете их свойства, заводите списки вариантов, правила проверки и автозаполнение — всё на одном экране, без файлов и ручной разметки.

Кому и когда

Дата-менеджер — дизайнер исследования (Study Builder) или дата-менеджер, которому выдано право «править версию дизайна» (studyversion.update) на исследование. Без него конструктор открывается только на просмотр. Утверждать и публиковать собранное будет другой человек — см. Опубликовать версию.

Задача возникает после создания исследования и при каждой поправке протокола — на новом черновике.

Перед началом

Есть версия дизайна в статусе Черновик. Если дизайна ещё нет — на странице Дизайн нажмите Новый черновик дизайна.
Под рукой протокол: список форм и вопросов, единицы измерения, диапазоны.
Если дизайн уже подготовлен файлом — его можно не собирать руками, а импортировать из файла по шаблону.

Шаги

0:000:00

Конструктор CRF: формы, поля с типами и логика формы — визуально, без кода.

Дерево дизайна: версия → формы → разделы → поля; списки вариантов подключаются к полям-выборам отдельно.

Откройте раздел Дизайн исследования и в зоне черновика нажмите Открыть конструктор.
На вкладке Формы левой панели нажмите Добавить форму и задайте название. Имя данных (OID) конструктор присвоит сам.
Во вкладке Структура центральной панели нажмите Добавить раздел — смысловую секцию формы. Раздел можно сделать журналом: при вводе он превратится в таблицу строк (например, серия измерений давления).
В разделе нажмите Добавить поле и напечатайте название в строке-композере; тип задайте командой в конце строки (см. Быстрый ввод).
Выберите поле и настройте его в инспекторе Свойства справа: Обязательное, Ед. изм., Мин. / Макс. значение, Список вариантов, Условие отображения (полный список — в Подробнее).
Для полей-выборов заведите справочники на вкладке Списки: Добавить список → пары «код → подпись» (например, M → Мужской, F → Женский).
Добавьте логику формы на вкладке Логика: проверки и автозаполнение.
Откройте Проблемы в шапке и разберите находки — каждая ведёт к месту проблемы.
Вернитесь на страницу Дизайн и нажмите Превью: пройдите каждую форму с типичными и граничными значениями.

Порядок элементов меняется стрелками Переместить выше / Переместить ниже или перетаскиванием; поле можно перетащить и в соседний раздел. Форму, раздел, поле и список можно дублировать через меню ⋯ рядом с элементом: копия сохраняет свойства, а конструктор присваивает ей новые OID.

Быстрый ввод: композер и вставка из буфера

Кнопка Добавить поле открывает строку-композер прямо в разделе: напечатайте название и нажмите Enter — поле создано, строка ждёт следующее. Тип задаётся командой в конце строки (/число /дата /время /выбор /данет /текст), юнит — скобками, варианты выбора — двоеточием:

Вес /число (кг)
Дата рождения
Курит /данет
Пол /выбор: Мужской, Женский

«Пол» сразу получит список вариантов — отдельно создавать его не нужно. ⌥Enter создаёт поле и открывает его свойства, Esc закрывает композер. Для формулы или тонкой настройки формата остаётся полный диалог — ссылка под строкой композера.

Вставка из буфера: скопируйте список вопросов из протокола или Excel и вставьте в композер — каждая строка станет полем по той же грамматике (с подтверждением, сколько полей будет создано).

Шаблоны

Меню ⋯ центральной панели (и пустой черновик) предлагают Из шаблона… — галерею готовых заготовок: Демография, Витальные показатели, Нежелательное явление (со своими словарями), стандартные списки. Повторная вставка допустима — имена данных получат суффикс, ссылки перепишутся. Свою форму или список можно сохранить как шаблон из их меню ⋯ — форма уедет вместе с используемыми словарями и станет доступна во всех исследованиях организации.

Удалить и вернуть

Удаление поля, раздела, формы или списка не спрашивает подтверждения — вместо этого тост «Удалено · Отменить» и ⌘Z возвращают удалённое со всеми свойствами, правилами и прежней позицией.

Что произойдёт

Каждая правка сохраняется сразу — в шапке видно «Сохраняем…» → «Сохранено». Отдельной кнопки сохранения нет.
Каждое изменение дизайна пишется в аудиторский след и видно в Хронике изменений дизайна на странице Дизайн («Создано поле», «Изменена форма», «Создана проверка»…).
Обязательность и диапазон поля сразу порождают системные проверки — они появляются в блоке Из свойств полей вкладки Логика.
Версия остаётся в статусе Черновик, пока вы не отправите её На ревью. Ни один центр пока не видит изменений: данные собираются только по опубликованной версии.

Если не получилось

Плашка «Только чтение»: «Версия уже не черновик» — версия на ревью, утверждена или опубликована. Любая правка опубликованного дизайна — это новый черновик (поправка); версию с ревью можно Вернуть в черновик.
«Нет права править дизайн — доступен только просмотр» — нет права studyversion.update на исследование. Попросите администратора.
«Не удалось применить изменение» — сервер отверг правку; причина — в тексте сообщения.
Поле помечено «нет списка» — у поля типа «Выбор из списка» не выбран Список вариантов.
«Минимум больше максимума — границы не сработают» — поправьте Мин. / Макс. значение.
Отправка на ревью недоступна: «Валидация дизайна нашла N ошибок» — откройте Проблемы и исправьте ошибки.

Дальше

Настроить правила проверкиСистемные и межполевые проверки — блок «Проверки» вкладки «Логика».

Настроить скип-логику и автозаполнениеУсловия отображения, вычисляемые поля и язык выражений.

Составить расписание визитовМатрица SoA: визиты, окна и привязка форм.

Опубликовать версию и запуститьРевью, публикация, UAT и go-live.

Подробнее

Где открыть конструктор

Вход — со страницы Дизайн исследования. Если дизайна ещё нет, нажмите Новый черновик дизайна, а затем в зоне черновика — Открыть конструктор. Рядом кнопки Матрица SoA (привязка форм к визитам) и Превью (прожить форму до публикации). Опубликованную версию та же страница открывает кнопкой Посмотреть дизайн — конструктор запускается в режиме только чтения.

Три панели конструктора

Экран разделён на три зоны — слева направо, от общего к частному:

Панель	Что в ней
Слева — список	Две вкладки — Формы и Списки — и поле поиска. На вкладке «Формы» — все формы черновика; клик выбирает форму для работы. На вкладке «Списки» — справочники значений.
По центру — форма	Открытая форма в двух вкладках: Структура (разделы и поля в порядке отображения; у каждого поля виден его тип — Текст · Выбор из списка · Дата …) и Логика (проверки и автозаполнение формы).
Справа — инспектор свойств	Свойства выбранного элемента — формы, раздела или поля. Всё, что определяет поведение элемента, настраивается здесь.

В шапке экрана — кнопка Проблемы (со счётчиком находок) и меню Ещё (⋯): Языки CRF, а также экспорт и Импорт JSON для переноса дизайна файлом (см. Импортировать дизайн из файла).

Рядом с полем видны признаки: условие — у поля задано условие отображения, автозаполняется — значение вычисляет система, слепое — значение маскируется.

Имя данных (OID)

У каждой формы, раздела и поля есть имя данных (OID) — идентификатор колонки в экспортах и адрес поля в правилах. Конструктор генерирует его из названия («Дата рождения» → DATA_ROZHDENIYA), а в свёрнутом блоке Технические детали инспектора его можно переименовать, пока версия — черновик: все ссылки (условия, проверки, формулы) система перепишет сама. После публикации имя данных фиксируется навсегда. Префикс SYS. зарезервирован за системными проверками.

Инспектор свойств поля

Свойство	Что задаёт
Название	Подпись поля, как её увидит координатор.
Раздел	В каком разделе формы лежит поле; переключение переносит поле в другой раздел (то же делает перетаскивание).
Список вариантов	Для типа «Выбор из списка» — из какого справочника выбирается значение.
Обязательное	Пустое поле будет считаться недоработкой — система сама создаст проверку «поле не должно быть пустым».
Ед. изм.	Единицы измерения — показываются рядом с полем.
Мин. / Макс. значение	Границы допустимых значений — система сама создаст проверку диапазона.
Нарушение диапазона	Мягкое (записать значение и открыть запрос) или жёсткое (отклонить значение) — для числа с заданным диапазоном.
Макс. длина	Для текста — ограничение длины.
Условие отображения	Выражение от других полей формы: истина — поле видно (см. Скип-логика и автозаполнение).

Мониторинг и слепота — Подлежит SDV, Требует медицинского кодирования и Слепое (значение маскируется) — собраны в свёрнутом блоке Дополнительно. Свёрнутый блок Технические детали держит Имя данных и полный Тип данных (Текст · Целое число · Число · Да/Нет · Дата · Неполная дата · Дата и время · Выбор из списка …) — тип обычно задаётся «Типом вопроса» ещё при создании поля.

Если поле участвует в проверках или автозаполнении, инспектор показывает блок Правила поля со связанными правилами; клик по автозаполнению открывает его редактор. Поле-цель автозаполнения помечено признаком автозаполняется: ручной ввод в нём закрыт, а тип данных менять нельзя.

Списки вариантов

Вкладка Списки — справочники значений для полей типа «Выбор из списка»: пары «код → подпись». Список создаётся один раз и подключается к любому числу полей. Коды внутри списка не должны повторяться — конструктор за этим следит. Готовый список можно дублировать через меню ⋯.

Логика формы

Вкладка Логика держит правила поведения открытой формы: правило принадлежит форме и версионируется вместе с дизайном — правка после публикации создаёт новую версию. Блоки:

Проверки — правила контроля качества («запрос» и «блок»), срабатывающие при вводе. Кнопка Добавить проверку; готовое правило можно изменить (клик по нему) или удалить. Подробно — Настроить правила проверки.
Автозаполнение — вычисляемые поля: система заполняет их сама из других полей. Кнопка Добавить автозаполнение. Подробно — Настроить скип-логику и автозаполнение.
Из свойств полей — проверки, которые ядро создаёт само из Обязательное и границ диапазона. Блок только для чтения: эти проверки меняют свойствами поля.

Редактор выражений проверяет формулу на лету: под полем сразу видно «Выражение корректно» или конкретную ошибку, а также от каких полей выражение зависит.

Панель «Проблемы»

Кнопка Проблемы в шапке несёт счётчик находок и открывает живой отчёт Проблемы дизайна с разбивкой «Ошибки · Предупреждения · Инфо». Конструктор постоянно просматривает черновик и подсвечивает недоработки, например:

в версии нет ни одной формы или ни одного визита;
форма пустая — в ней нет полей;
форма не привязана ни к одному визиту (вне SoA);
поле-выбор без списка вариантов;
минимум больше максимума;
визит без форм, список вариантов без вариантов, список вариантов не используется ни одним полем.

Каждый пункт ведёт к месту проблемы: находка внутри дизайна открывает нужный элемент в конструкторе (Показать в конструкторе), а находка про расписание — Открыть матрицу SoA. Разбирать их лучше по ходу сборки: те же проверки встроены в отправку версии на ревью — дизайн с ошибками дальше черновика не уйдёт.

Превью формы: прожить до публикации

Кнопка Превью на странице Дизайн открывает форму так, как её увидит координатор, и позволяет вводить значения и смотреть, как форма реагирует.

Работают скип-логика (поля появляются и скрываются по условиям), автозаполнение (вычисляемые поля пересчитываются мгновенно) и проверки — сработавшие перечисляются под формой.
Ошибки форматов подсвечиваются как при реальном вводе.
Всё это — вхолостую: превью ничего не сохраняет, не создаёт запросов и не пишет в аудиторский след. Плашка над формой напоминает: «Это превью — данные не сохраняются». Введённое можно сбросить и начать заново.
Журнал (повторяющийся раздел) показывается одной строкой — при реальном вводе строк будет несколько.

Языки CRF: одноязычный дизайн по умолчанию

Многоязычный CRF нужен меньшинству исследований, поэтому по умолчанию его нет: у нового черновика список языков пуст, и название элемента и есть текст, который увидит центр. Отдельной ссылки «Переводы» при этом нет.

Многоязычность включается по желанию: меню Ещё (⋯) → Языки CRF — отметьте языки, на которых собирают CRF, и сохраните. После этого в навигации дизайна появляется экран Переводы, а публикация версии начинает требовать утверждённый перевод каждого отмеченного языка. Пока языки не объявлены, гейт переводов при публикации пуст.

Палитра команд ⌘K

⌘K (или Ctrl+K) открывает палитру команд: создать форму, раздел или поле, вставить шаблон, открыть «Проблемы», аннотированный CRF или экспорт — не отрывая рук от клавиатуры. Начните печатать название поля, формы или списка — палитра найдёт его в любом месте версии и откроет с выделением.

Замечания ревью

Внизу инспектора живёт тред Замечания ревью: ревьюер оставляет замечание к выделенному элементу (или к версии в целом), не редактируя дизайн, — комментирование работает и в режиме «только чтение», на черновике и на версии, отправленной на ревью (права designcomment.read / designcomment.write). Автор отвечает правками и отмечает замечание Решено; решённые сереют и остаются историей ревью. Нерешённые замечания видны счётчиком на странице Дизайн и дают предупреждение рядом с кнопкой утверждения — предупреждение, а не запрет: решение остаётся за утверждающим.