Настройка — правила и валидации
Каноническая страница по RuleSets и автоматизированному контролю качества: как устроены наборы правил, где смотреть логи, и почему правило может “не срабатывать”.
Где это в UI
/studies/[studyId]/rules- Конкретный RuleSet:
/studies/[studyId]/rules/[rulesetId] - Логи RuleSet:
/studies/[studyId]/rules/[rulesetId]/logs
Что дают правила
- проверка качества данных,
- создание системных queries,
- вычисления и автоматизация,
- предсказуемое поведение формы при вводе.
Для кого
- Data Manager (владение контуром качества),
- Study Director (утверждение изменений),
- System Administrator (если он управляет дизайном).
Права (минимум)
| Действие | Требуемое право (study‑scope) |
|---|---|
| Просмотр RuleSets | rules.view_rules |
| Создание/редактирование | rules.manage_rules (и study в PENDING/AVAILABLE) |
| Запуск/исполнение | rules.execute_rules |
1) Основные сущности
- RuleSet — контейнер правил по доменной задаче.
- Rule — условие + действие.
- Execution context — когда и где правило выполняется.
- Logs — подтверждение фактического срабатывания.
2) Базовый процесс (рекомендуемый)
- Создайте RuleSet под конкретный домен.
- Добавьте правила и действия.
- Запустите тестовое выполнение.
- Проверьте logs и ложноположительные срабатывания.
- Активируйте RuleSet.
3) Как читать RuleSet в UI
На странице RuleSet вы увидите:
- OID и execution context (где правило “живёт”),
- статус (активен/неактивен),
- список правил,
- действия:
- включить/выключить RuleSet,
- запустить выполнение,
- открыть логи.
4) Практика качественных правил (что реально помогает в проде)
- каждое правило должно иметь бизнес-обоснование;
- избегайте «шума» из-за слишком агрессивных WARNING;
- блокирующие ERROR применяйте только где это действительно нужно для процесса.
5) Типовые ошибки и диагностика
| Симптом | Причина | Что делать |
|---|---|---|
| Слишком много системных queries | Переусложнённые условия | Упростить/пересмотреть threshold |
| Нельзя изменить rule | Read-only статус или нет прав | Проверить статус и RBAC |
| Правило не влияет на Data Entry | Не тот контекст исполнения | Перепроверить context и logs |
| RuleSet “не запускается” | нет rules.execute_rules | дать право или делегировать запуск |
| Логи пустые | правило не применилось к данным или фильтр времени | уточнить выборку и перезапустить на тестовых данных |