Контролы формы — Администрирование

Документ описывает администрирование поведения контролов дополнительных параметров в MTF/NTF: настройки ДП и категории, влияющие на рендер, ввод, валидацию и сохранение. Аудитория — администраторы конфигурации. Внутри — обзор домена, механизмы AdminSPA/API, карта групп контролов, runtime-совместимость MTF/NTF, диагностика БД и типичные ошибки настройки.

Обзор

form-controls описывает администрирование поведения контролов дополнительных параметров в MTF/NTF: какие настройки ДП и категории влияют на рендер, ввод, валидацию, сохранение и обратное чтение значения.

Администратор настраивает:

• глобальный тип и type-specific настройки ДП;
• привязку ДП к категории, порядок, обязательность, скрытие, readonly и размещение в блоках;
• параметры конкретных групп контролов: File/MultiFile, Lookup/MultiLookup, SelectUsers, Table EP;
• совместимость сценария со старым MTF, новым MTF и NTF;
• диагностику сохранения значения через таблицы настроек, runtime-значений и link-таблицы.

Граница домена:

• form-controls — поведение конкретного контрола ДП на форме.

Механизмы администрирования

Автоадминка, AdminSPA и EntityEditor

Отдельной формы автоадминки только для домена form-controls не выявлено. Администрирование распределено между общими контурами ДП и категории.

Механизм	Что контролирует
AdminSPA / Admin API ДП	глобальная карточка ДП, тип, type-specific настройки, связи ДП
Настройки категории -> ДП	привязка ДП к категории, порядок, обязательность, скрытие, подсказки, блоки
Настройки формы задачи	контейнеры MTF/NTF, layout, порядок блоков и JS/CSS-вставки
Runtime MTF/NTF	фактический рендер, сохранение, refresh и realtime-обновления

EntityEditor-схем для form-controls как самостоятельного домена в прочитанных источниках не выявлено.

Admin API, влияющие на контролы

Профильные административные операции выполняются через контур ext-params.

Контроллер / маршрут	Назначение для form-controls
/api/admin/extparams	CRUD глобального ДП и базовой модели контрола
/api/admin/subcat/extparams	привязка ДП к категории, порядок, category-level настройки
/api/admin/extparams/settings	чтение и сохранение type-specific настроек ДП
/api/admin/subcat/extparams/blocks	блоки и группы блоков, в которых размещаются контролы
/api/admin/ext-params/links	master-slave связи ДП, влияющие на Lookup/MultiLookup
/api/admin/extparam/options	опции list/combobox и смежных выборов
/api/admin/ext-params/table	шаблон и рендер ДП типа Table

Ключевые настройки контролов

Карта групп контролов

Таблица показывает, к каким таблицам настроек относится каждая группа контролов.

Группа	Тип ДП	Таблицы настроек	Основной справочник
File / MultiFile	File	ExtParamsFileSettings	Справочник контролов
Lookup	LookUpField	LookupParamSettings	Справочник контролов
MultiLookup	MultiSlctSubcatTasks	LookupParamSettings, ExtParamValueSelectedTask*	Справочник контролов
SelectUsers	SelectUsers	ExtParamSelectUserSettings, ExtParamSelectUserSettingsOrgUnitTypes	Справочник контролов
Table EP	Table	ExtParamTableCommonSettings, ExtParamTableSettings, ExtParamTableSections	Справочник контролов

⚠️ Этот файл не дублирует полный перечень type-specific параметров. Для выбора конкретной настройки использовать Справочник контролов, а для ограничений старый MTF / новый MTF / NTF — Матрицу совместимости.

Параметры контролов в категории

Фактическое поведение контрола на форме определяется не только глобальным типом ДП, но и привязкой к категории.

Настройка	Эффект для form-controls
Порядок ДП в категории	порядок рендера контролов в MTF/NTF
Блок ДП и группа блоков	контейнер и визуальная группировка контролов
Количество занимаемых колонок	ширина контрола в форме
Скрытый / скрыть при постановке / скрыть в карточке	наличие контрола в NTF и MTF
Обязательный / readonly / права по статусам	валидация и доступность ввода
Подсказка и smart-подсказка	текст или smart-результат рядом с контролом
Master-slave связи ДП	фильтрация зависимых Lookup/MultiLookup контролов

⚠️ Если поле не отображается на форме, сначала проверять category-level привязку и блоки. Если поле отображается, но не сохраняется или сохраняется не тем форматом, переходить к type-specific настройкам.

SettingsCustom / sys_general_settings

Собственные SettingsCustom или sys_general_settings ключи для form-controls как отдельного домена в прочитанных источниках не выявлены.

Связанные настройки находятся у доменов-владельцев:

Ключ / настройка	Что влияет
HideEmptyEpOnNtf	скрытие пустых ДП на форме создания задачи
UseNewMTF, UseNewMTFStyle	выбор runtime MTF и стиль карточки задачи
type-specific настройки ДП	поведение конкретных контролов

Runtime-совместимость MTF/NTF

При настройке контролов учитывать режим формы.

Режим	Что важно администратору
Старый MTF	часть сценариев поддерживается ограниченно, особенно для табличного ДП и realtime
Новый MTF	основной runtime для интерактивных контролов и полного поведения Table EP
NTF	create-flow до создания задачи; часть сценариев File/Table/Lookup зависит от контекста будущей задачи

Полная матрица поддержки по группам контролов вынесена в Матрицу совместимости.

⚠️ Для инцидентов "работает в MTF, но не работает в NTF" сначала проверять, требует ли сценарий уже существующий TaskID, строки таблицы или link к файлу.

Аудит и диагностика

Объекты БД

Таблицы базы данных, задействованные при диагностике контролов, настроек и runtime-значений ДП.

Объект	Назначение
ExtParams	глобальная карточка ДП и тип контрола
ExtParamsInSubcat	привязка ДП к категории и category-level настройки
ExtParamValues	базовое значение ДП в задаче
ExtParamsFileSettings	настройки File/MultiFile
LookupParamSettings	настройки Lookup/MultiLookup
ExtParamSelectUserSettings, ExtParamSelectUserSettingsOrgUnitTypes	настройки SelectUsers
ExtParamTableCommonSettings, ExtParamTableSettings, ExtParamTableSections	настройки Table EP
ExtParamTableValues	значения ячеек табличного ДП
ExtParamValueSelectedTasks, ExtParamValueSelectedTaskFolders	выбранные задачи и папки MultiLookup
ExtParamSelectUsersValues*	значения SelectUsers по пользователям, группам и оргструктуре
FileStorageFileToExtParamLinks	связь файлов с ДП File/MultiFile и файловыми колонками таблицы

Минимальные проверки

SQL-запросы для быстрой диагностики значения, привязки и настроек ДП в задаче.

-- Глобальная карточка ДП
select *
from ExtParams
where ExtParamID = @extParamId;

-- Привязка ДП к категории
select *
from ExtParamsInSubcat
where ExtParamID = @extParamId
  and SubcatID = @subcatId;

-- Runtime-значение ДП в задаче
select *
from ExtParamValues
where ExtParamID = @extParamId
  and TaskID = @taskId;

-- File/MultiFile: есть ли link к ДП
select *
from FileStorageFileToExtParamLinks
where ExtParamID = @extParamId
  and TaskID = @taskId;

Для Lookup/MultiLookup, SelectUsers и Table EP использовать специализированные таблицы, потому что один ExtParamValues не показывает всю модель значения.

Типичные ошибки настройки

Таблица связывает симптом с наиболее вероятной точкой проверки и документом.

Симптом	Что проверить первым
Контрол не отображается	привязка в ExtParamsInSubcat, скрытие, блоки, режим NTF/MTF
Контрол виден, но readonly	права ДП, права по статусам, smart-access, режим формы
Lookup/MultiLookup пустой	источник, smart-фильтр, master-slave связи, доступ к задачам источника
SelectUsers показывает не тот набор	AllowUsers / AllowGroups / AllowOrgUnits, фильтрации по группе/оргструктуре/smart-фильтру
File загружается, но не отображается	link в FileStorageFileToExtParamLinks, ограничения размера/расширений, источник файла
Table EP не сохраняет строки	настройки колонок, readonly/required/key column, denorm-view и reload
Сценарий работает в MTF, но не в NTF	наличие TaskID, create-flow ограничения, матрица совместимости