Перейти к содержанию

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

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

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

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

Группа Тип ДП Ключевая таблица настроек
Деньги 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

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 одновременно использует и общие, и типоспецифические настройки колонок.