Клонирование исследования
Клонирование позволяет быстро получить новое исследование с тем же дизайном, что и эталонное: формы, версии, визиты, правила, настройки и — по выбору — центры и состав команды. Собранные данные субъектов, журналы правил и экспорты при этом не копируются. Клонирование запускается из карточки исследования и выполняется фоновым заданием.
Когда имеет смысл
- Запуск следующей фазы с тем же протоколом.
- Серия похожих исследований (например, пост-маркетинговых) с типовым дизайном.
- Учебное исследование на базе реального — для обучения команды.
- Перенос дизайна другому спонсору или в другой регион.
Если достаточно мелких правок, удобнее редактировать исходное исследование напрямую. Клонирование оправдано, когда источник должен остаться нетронутым.
Где запускается
| Где | Маршрут |
|---|---|
| Карточка исходного исследования | /studies/[studyId] — действие «Клонировать» |
| Прогресс задания | Диалог поверх карточки исследования; список задач — там же |
Право запускать клонирование есть у Системного администратора и Директора исследования.
Содержание: диалог клонирования — выбор пресета, стратегия центров, стратегия команды, поля нового исследования и индикатор прогресса.
Что копируется и что нет
Что копируется:
- Настройки всех четырёх вкладок исследования (включая параметры сбора данных).
- Вся библиотека форм (CRF) с версиями.
- Все определения визитов (EventDefinition) и их версии.
- Назначения форм на визиты (VisitCRFAssignment) с признаками обязательности, двойного ввода, SDV.
- Наборы правил валидации и сами правила.
- Структура групп субъектов (TREATMENT / AGE / GENDER / CUSTOM), если использовалась.
Что не копируется:
- Субъекты и введённые по ним данные (EventCRF, ItemData).
- Запросы и обсуждения по ним.
- Журналы выполнения правил.
- Электронные подписи, статусы визитов и форм конкретных субъектов.
- Задания и описания экспорта.
- Центры и пользователи копируются только по выбранной стратегии (см. ниже).
Пресеты клонирования
Пресет — studies.enums.StudyClonePreset:
| Пресет | Кому подходит | Что делает |
|---|---|---|
| Production clone | Запуск нового продакшн-исследования по тому же дизайну | Полный клон дизайна; центры — по выбранной стратегии, команда — по выбранной стратегии |
| Draft duplicate | Параллельное «черновое» исследование для проектирования | Клон в «Черновик»; центры и команда обычно не копируются |
| Custom | Если стандартные стратегии не подходят | Доступ к раздельным переключателям центров и команды |
Стратегия центров — StudyCloneSiteStrategy
| Стратегия | Что копируется |
|---|---|
| Не копировать центры | Только структура исследования; центры заводите заново |
| Копировать shell-записи центров | Записи центров без целевых показателей набора |
| Копировать shell-зап иси и целевые показатели | Центры со всеми плановыми числами набора |
Стратегия команды — StudyCloneTeamStrategy
| Стратегия | Что копируется |
|---|---|
| Не копировать назначения команды | Назначения исследования не переносятся; приглашайте людей заново |
| Копировать study-level назначения | Назначения уровня исследования (Директор, Менеджер данных и т. п.) |
| Копировать назначения, кроме неактивных пользователей | То же, но пользователи в статусе «Неактивен» пропускаются |
Жизненный цикл задания
Каждый запуск клонирования создаёт фоновое задание StudyCloneJob со своим статусом — studies.enums.StudyCloneJobStatus:
| Статус | Что означает |
|---|---|
| Ожидает | Задание создано и поставлено в очередь обработки |
| Выполняется | Идёт копирование, у больших исследований занимает несколько минут |
| Завершено | Клон создан, новое исследование доступно в /studies |
| Ошибка | Клонирование прервано; детали — в диалоге задания |
| Отменено | Задание отменено вручную |
Этапы выполнения
Прогресс показывает текущий этап — StudyCloneJobStage:
| Этап | Что происходит |
|---|---|
| Ожидание запуска | Задание поставлено в очередь, ждёт обработчик |
| План проверен | Проверены параметры пресета и стратегии |
| Целевое исследование создано | Создана пустая оболочка целевого исследования |
| Структура скопирована | Перенесены формы, визиты, правила и (по выбору) центры |
| Ссылки переназначены | Внутренние ссылки между объектами адапти рованы под новые ID |
| Финальная проверка завершена | Контроль целостности дизайна перед публикацией |
| Ошибка выполнения | Этап-маркер на случай аварийной остановки |
Пока задание в «Ожидает» или «Выполняется», можно закрыть диалог — обработка продолжается на сервере. Прогресс виден по обновлению этапа.
Как сделать клон
- Откройте карточку источника
/studies/[studyId]и нажмите «Клонировать». - В диалоге укажите:
- название нового исследования и ID протокола;
- ответственного;
- пресет клонирования (или «Custom» с явными стратегиями).
- Подтвердите параметры. Откроется индикатор задания.
- Дождитесь статуса «Завершено». Перейдите по ссылке к новому исследованию.
После завершения новое исследование находится в статусе «Черновик» и готово к доработке: добавьте недостающие центры, пригласите команду по выбранной стратегии, пр оверьте версии форм и пройдите тестовый прогон по чеклисту из Создание и запуск исследования.
Что делать при ошибке
| Ситуация | Что сделать |
|---|---|
| Задание в «Ошибка» | Откройте диалог задания, скопируйте идентификатор ошибки. Запустите повтор тем же пресетом или сменой стратегии (например, без копирования команды) |
| Задание долго в «Ожидает» | Это нормально, если в очереди есть другие задания; через несколько минут перейдёт в «Выполняется» |
| Нужно прервать клонирование | Нажмите «Отменить» в диалоге — задание перейдёт в «Отменено», частично созданные объекты будут удалены |
| Источник изменился во время клонирования | Дождитесь окончания задания; повторите клон, если хотите получить актуальный снимок |
При повторной ошибке передайте идентификатор ошибки и параметры пресета в поддержку.
Рекомендации
- Перед клонированием убедитесь, что источник в консистентном состоянии: черновые версии форм закрыты, наборы правил включены.
- Если источник активно развивается, зафиксируйте в названии клона версию и дату — так проще отслеживать происхождение.
- Не переносите изменения из клона обратно в источник вручную — это приведёт к расхождениям.
- Для серий учебных исследований используйте пресет «Draft duplicate», чтобы избежать случайного запуска реального сбора.
Что делать, если…
| Ситуация | Что проверить |
|---|---|
| Нет кнопки «Клонировать» в карточке исследования | Вашу роль — клонирование доступно Системному администратору и Директору исследования |
| Клон создан, но без центров | Это ожидаемо при с тратегии «Не копировать центры». Создайте центры в /studies/[новый studyId]/sites |
| Клон создан, но без участников команды | Стратегия команды установлена на «Не копировать»; пригласите людей через Управление пользователями |
| После клонирования старая активная версия формы не активна в клоне | Откройте библиотеку форм и переведите нужную версию в «Активен» |
См. также
- Создание и запуск исследования — мастер из четырёх шагов.
- Настройки исследования — что хранится в каждой вкладке.
- Дизайн форм (CRF) — жизненный цикл версий.
- Управление пользователями — приглашения и области.
- Справочник статусов — каноничные статусы.