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