# Контролы формы — Справочник

Справочник типовых контролов формы (ДП): карта типов, ключевые настройки по группам, быстрый выбор документа для диагностики и важные ограничения. Для инженеров поддержки при разборе инцидентов с формами задач.

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

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

| Группа | Тип ДП | Ключевая таблица настроек |
|---|---|---|
| Деньги | `Money` (сохранение: blur, Enter, Tab (v2.267+), pointerdown) | `ExtParamNumericSettings` (общие для числовых) |
| Число | `NumericValue` (сохранение: blur, Enter, Tab, pointerdown) | `ExtParamNumericSettings` |
| File / MultiFile | `File` | `ExtParamsFileSettings` |
| Текст | `Text` | `TextEpOptions` (маска, регулярное выражение, подсказка, режим телефона) |
| Большой текст с форматированием | `TextArea` | `TextEpOptions.EditorType` (редактор разметки, блочный редактор, встроенный фрейм, заметки, виджет, markdown) |
| Большой текст без форматирования | `TextareaWOFormat` | — |
| Lookup | `LookUpField` | `LookupParamSettings` |
| MultiLookup | `MultiSlctSubcatTasks` | `LookupParamSettings` + `ExtParamValueSelectedTask*` |
| SelectUsers | `SelectUsers` | `ExtParamSelectUserSettings` |
| Table EP | `Table` | `ExtParamTableCommonSettings`, `ExtParamTableSettings` |
| Общий dropdown | — (shared-контрол, не тип ДП) | `valueField`, `multiple`, `triggerTemplate` |

### Ключевые настройки по группам

**File / MultiFile:** `IsMultifile`, `RenameMethod`, `RenameOnUpload`, `SmartRenameOnUpload`, `MaxFileSizeKb`, `ExtParamFileSource`, `ProtectFileView`, `IsLogFileReadsAction`, `FileProviderId`.

**Lookup / MultiLookup:** `SubcatId` / `UnionId` (источник), `SmartFilterId` (фильтр источника), `ShowAsRadioButtons`, `DisplayAsText`, `IsHierarchical`, каскадные связи (через `ExtParamLink`).

![Настройка источника Lookup ДП в AdminSPA](https://help.1forma.ru/help-images/ext-params/lookup_source_settings.png)

**SelectUsers:** `SingleUserMode`, `AllowUsers`, `AllowGroups`, `AllowOrgUnits`, `TypeFiltration`, `GroupId`, `SmartFilterId`, `OrgUnitTypeFiltration`, `OrgUnitId`, `OrgUnitSmartFilterId`.

**Table EP:** общие настройки таблицы (`DisplayMode`, `AutosaveEnabled`, `ImportEnabled`, `ExportEnabled`), настройки колонок (`Type`, required/readonly/hidden, default/smart value), секции (`ExtParamTableSections`), специализированные типовые настройки колонок (Lookup/File/SelectUsers/etc.).

Важные различия между типами контролов:

1. `Lookup` и `MultiLookup` имеют общую таблицу настроек, но разные модели хранения значений.
2. `File` и `MultiFile` — один тип ДП с переключением через `IsMultifile`.
3. `SelectUsers` хранит три независимые группы значений (users/groups/orgunits).
4. `Table EP` одновременно использует и общие, и типоспецифические настройки колонок.