Другое · 8 мин
Стандартная управляемая форма как форма списка в 1C
Как в 1C:Предприятии на управляемых формах использовать стандартную форму в качестве формы списка: настройка, открытие, ограничения и проверка результата.
В управляемых формах 1C форма может выполнять разные роли: карточка объекта, форма списка, форма выбора или форма отчёта. Стандартная форма — это форма, созданная платформой автоматически для объекта конфигурации, если разработчик не создаёт свою. По умолчанию такая форма открывает карточку записи, но её можно назначить формой списка, чтобы пользователь видел таблицу записей с возможностью выбора, создания и редактирования.
Использование стандартной формы как списка оправдано, когда нужно быстро получить табличное представление справочника, документа или регистра без разработки отдельной формы списка. Это удобно для простых объектов, где не требуется сложная группировка, кастомизированные колонки или нестандартные действия в шапке списка. При этом платформа сама формирует набор колонок по реквизитам объекта, а разработчик может корректировать видимость и порядок полей через свойства формы.
Однако стандартная форма не всегда заменяет полноценную форму списка. Если объект имеет много реквизитов, требуется иерархическое представление, отбор по сложным условиям или интеграция с внешними обработками, лучше создать отдельную форму списка. Ниже разобраны условия, при которых стандартная форма подходит в качестве списка, и порядок её настройки.
Когда стандартную форму используют как список
Стандартная форма становится списком, когда конфигурация указывает её в качестве формы списка для справочника, документа, плана видов характеристик, плана обмена, регистра сведений или регистра накопления. В этом случае при открытии объекта из списка пользователь видит таблицу записей, а не сразу карточку одной записи. Такой подход уместен, когда достаточно стандартного набора действий: создание, чтение, изменение, удаление, копирование и выбор.
Признак того, что форма работает как список: при вызове команды «Список» или открытии объекта через интерфейс выбора отображается табличная часть со строками записей и панелью команд списка. Если же открывается сразу карточка одного элемента, форма не настроена как список или открыта в режиме формы объекта.
Отличие формы списка от обычной стандартной формы
Обычная стандартная форма открывает конкретную запись по её ссылке и показывает реквизиты в форме ввода. Форма списка открывает набор записей и предоставляет команды управления коллекцией._MODULE_ формы списка содержит обработчики событий списка, а не только события карточки. Поэтому одна и та же стандартная форма может вести себя по-разному в зависимости от того, какая роль ей назначена в конфигурации.
В форме списка доступны колонки, строки, отбор, сортировка, группировка и действия над выделением. В карточной форме эти элементы либо отсутствуют, либо имеют иное назначение. Если разработчик пытается использовать карточную форму как список, не меняя её роль, команды списка могут быть недоступны или работать некорректно.
Как задать форму списка для объекта конфигурации
В конфигураторе откройте объект, для которого нужна форма списка, перейдите к свойствам форм и укажите стандартную форму в качестве формы списка. После этого сохраните конфигурацию и обновите базу данных. Платформа привяжет форму к роли списка, и при открытии объекта через стандартный интерфейс будет использоваться табличное представление.
- 1Откройте объект конфигурации в конфигураторе
- 2В свойствах объекта укажите стандартную форму как форму списка
- 3Сохраните конфигурацию и выполните обновление базы
- 4Откройте объект в пользовательском режиме и проверьте отображение таблицы записей
Проверьте, что форма открывается именно как список: должны быть видны строки записей, панель команд списка и возможность выделения нескольких строк. Если открывается карточка одной записи, вернитесь в конфигуратор и проверьте свойство формы списка, а не только наличие модуля у формы.
Настройка команд и действий в форме-списке
В модуле формы списка можно переопределить команды создания, редактирования, удаления и выбора. Стандартная форма уже содержит набор типовых команд, но их состав можно сократить или расширить в зависимости от прав доступа и бизнес-логики. Например, для справочника контрагентов можно оставить только просмотр и выбор, запретив удаление.
Команды формы списка настраиваются через команду интерфейса формы и обработчики в модуле формы. Важно не путать команды формы списка с командами формы объекта: действие «Записать и закрыть» в карточке не заменяет команду «Создать» в списке. Если команда отсутствует в интерфейсе списка, проверьте права пользователя и видимость команды в свойствах формы.
Открытие формы-списка и передача параметров
Форму списка можно открыть стандартным способом через интерфейс конфигурации или программно методом ОткрытьФорму, указав имя формы и параметры. В форме списка параметры могут использоваться для начального отбора, установки текущей строки или открытия в режиме выбора. Параметры передаются структурой или значением, соответствующим ожиданиям обработчика открытия формы.
При программном открытии формы списка уточните, открывается ли она в режиме выбора или обычном режиме просмотра. В режиме выбора после выбора записи форма возвращает выбранную ссылку вызывающему коду. В обычном режиме пользователь остаётся в интерфейсе списка и может переходить к карточкам записей. Смешение режимов приводит к тому, что выбранное значение не возвращается в вызывающий документ или отчёт.
Ограничения и частые ошибки
Стандартная форма как список не подходит для объектов с очень большим количеством реквизитов, если требуется выводить все поля в таблице. Платформа может отображать только часть реквизитов, а остальные скрывать за командами или карточкой. Также стандартная форма списка не всегда поддерживает сложную иерархию справочников без дополнительной настройки представления.
Частая ошибка — разработчик создаёт собственную форму, но забывает указать её в свойстве «Форма списка» объекта. Тогда платформа продолжает использовать стандартную форму или форму по умолчанию, и изменения не отображаются. Другая ошибка — попытка обработать в модуле формы события карточки, хотя форма открыта как список. События формы списка и формы объекта различаются.
Проверка результата и безопасные изменения
После настройки откройте объект в пользовательском режиме от имени пользователя с разными правами. Убедитесь, что список отображает ожидаемые колонки, команды создания и редактирования доступны там, где нужно, а удаление ограничено для защищённых записей. Проверьте переход из списка в карточку и обратно, а также работу команды «Выбрать», если форма используется в формах выбора.
Изменения в конфигурации вносите только после резервного копирования базы и тестирования на отдельной копии. Не меняйте стандартные формы объектов конфигурации поставщика напрямую без понимания последствий обновления конфигурации: при обновлении правки могут быть перезаписаны. Если объект входит в типовую конфигурацию, предпочитайте расширение конфигурации или создание собственной формы вместо правки стандартной.
Что важно запомнить
Стандартная управляемая форма работает как список только после назначения свойством «Форма списка» объекта. Проверяйте табличное представление, команды списка и права доступа; для сложных сценариев создавайте отдельную форму списка.
Можно ли использовать одну стандартную форму и как карточку, и как список?
Да, одна форма может быть назначена разными ролями для разных объектов или использоваться в разных режимах открытия. Но для одного и того же объекта форма либо открывает список, либо карточку записи в зависимости от свойства формы списка и способа вызова. Не стоит пытаться сделать одну форму одновременно и списком, и карточкой без явного переключения режима.
Нужно ли создавать отдельный модуль для формы списка?
Отдельный модуль не обязателен: стандартная форма уже имеет модуль. Однако обработчики в модуле должны соответствовать роли формы. Если форма открывается как список, используются события и команды формы списка; если как карточка — события формы объекта. Смешивание логики без учёта режима открытия часто вызывает ошибки.
Что делать, если после настройки список не открывается?
Проверьте, что свойство «Форма списка» заполнено для нужного объекта, конфигурация сохранена, а база обновлена. Убедитесь, что у пользователя есть права на просмотр объекта и на команды списка. Если форма открывается программно, проверьте имя формы и переданные параметры.
Когда стандартная форма списка не подходит?
Не подходит, если нужна сложная группировка, иерархия с разным набором колонок, нестандартные действия в шапке списка или интеграция с внешними данными. В таких случаях создайте отдельную форму списка с собственным модулем и настройкой колонок, а стандартную форму оставьте для карточки записи.