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

Настройка — дизайн CRF (Library + Builder)

Каноническая страница по дизайну CRF: библиотека форм, версии и конструктор. Фокус на практику: как создать/импортировать форму, как безопасно менять её в ходе исследования и почему “нельзя редактировать активную версию”.

Где это в UI​

  • CRF Library: /studies/[studyId]/crfs
  • CRF Builder: /crf-builder/[studyId]

Для кого​

  • Study Director / Data Manager (design),
  • System Administrator (если он управляет дизайном),
  • иногда: Lead Data Entry (по SOP).

Права (минимум)​

ДействиеТребуемое право (study‑scope)
Просмотр CRFcrfs.view_crf
Создать CRFcrfs.add_crf
Импорт CRFcrfs.add_crf + доступ к импорту (в UI это та же кнопка)
Редактировать структуру в Buildercrfs.manage_crf_structure (и study в PENDING/AVAILABLE)
подсказка

Кнопки CRF Builder / Импорт / Создать CRF в библиотеке появляются только если: есть crfs.add_crf и исследование в статусе, где дизайн редактируем.

Модель​

1) CRF и версия: что важно понять один раз​

  • CRF — контейнер/“имя формы” в дизайне.
  • CRF Version — конкретная структура (секции/группы/поля/валидации/логика).
  • В операциях данные всегда вводятся в Event CRF, который связан с конкретной CRF Version.

Практическое следствие:

  • существующие данные не “перепрыгивают” между версиями автоматически;
  • назначение CRF на визит фиксирует, какая версия будет использована по умолчанию.

2) Жизненный цикл версии (Draft → Active → Inactive)​

Версии CRF имеют жизненный цикл (в терминах статусов):

  • PENDING (Draft) — структура редактируется в Builder;
  • AVAILABLE (Active) — рабочая версия для ввода данных;
  • UNAVAILABLE (Inactive) — архивная/нерабочая версия.

Общее правило (SOP‑friendly):

  • структуру редактируем только в Draft;
  • для изменений в ходе исследования создаём новую версию, затем активируем.

3) Что делается в CRF Library (быстрые действия)​

На странице /studies/[studyId]/crfs вы делаете три базовые операции:

  1. Создать CRF (ручное создание):
    • задаёте имя, код (опционально), описание;
    • задаёте имя первой версии (например, v1.0);
    • после создания система автоматически откроет Builder для настройки структуры.
  2. Импорт:
    • загружаете файл ODM XML (.xml) или Excel (.xlsx/.xls);
    • система создаёт CRF и структуру;
    • после успешного импорта автоматически открывается Builder.
  3. Просмотр деталей CRF и preview версии (без изменения структуры).

4) Что проектируется в Builder (структура и поведение)​

  • структура: секции, группы, поля;
  • типы ответов;
  • опции для select/radio/check;
  • валидации;
  • display logic;
  • формулы и вычисляемые поля.

5) Базовый безопасный процесс изменений (рекомендуемый)​

  1. Откройте Draft-версию.
  2. Внесите изменения в структуру.
  3. Протестируйте на сценариях (минимум: сохранить, завершить ввод, query, SDV, экспорт).
  4. Проведите ревью с DM/Monitor (особенно если меняется смысл данных).
  5. Активируйте версию и обновите назначения визитов при необходимости.

Частые проектные ошибки​

ОшибкаРиск
Сложная взаимная display logicНепредсказуемое поведение полей
Несогласованные коды опцийПроблемы в аналитике и интеграциях
Редактирование активной версии без процедурыНарушение трассируемости

Практические рекомендации​

  • именуйте поля и секции стабильно и однозначно;
  • не меняйте смысл существующего кода опции в середине исследования;
  • для крупных изменений создавайте новую версию.

6) Диагностика (если “не получается”)​

СимптомПричинаЧто делать
В Builder нельзя редактировать структуруверсия не Draft или нет правубедиться, что версия PENDING и есть crfs.manage_crf_structure
Визит “не даёт стартовать CRF”на назначении нет версии или версия не AVAILABLEобновить assignment на AVAILABLE версию
После импорта “что-то странно”файл не в поддерживаемом формате/структуреначать с минимального файла, затем усложнять; при ошибке приложить данные из /profile/about

Смежные страницы​