К статье
Практический материал

Другое · 8 мин

Как из формы списка 1C сделать форму выбора

Практика 1C: как из формы списка сделать форму выбора, настроить вид формы, колонки и отбор, вернуть выбранное значение и избежать типичных ошибок.

Форма списка в 1C предназначена для просмотра и редактирования набора объектов, а форма выбора — для возврата одного или нескольких выбранных значений в вызывающий объект. Если пользователю нужно не просто посмотреть справочник или документ, а выбрать элемент и передать его дальше, обычный список может оказаться недостаточен. В таких случаях целесообразно явно задать форме тип «Форма выбора» или открыть существующий список в режиме выбора.

Разница между этими видами форм проявляется не только в интерфейсе, но и в механизме возврата результата. Форма списка обычно закрывается без передачи данных, тогда как форма выбора ожидает подтверждения выбора и возвращает ссылку на выбранный объект. Неправильное смешение этих режимов приводит к тому, что после нажатия кнопки «Выбрать» вызывающая форма не получает значение, а пользователь остаётся без понятия, почему действие не сработало.

Ниже рассмотрены условия, при которых можно обойтись обычным списком с режимом выбора, а когда действительно нужно переделать форму в отдельную форму выбора. Также приводятся шаги настройки, способы обработки выбора, признаки корректной работы и типичные ошибки, которые стоит учитывать перед самостоятельными изменениями в конфигурации.

Что такое форма выбора и зачем её выделять из списка

Форма выбора — это специальный вид формы, который платформа 1C использует, когда нужно вернуть выбранный элемент в вызывающий алгоритм. В отличие от обычной формы списка, такая форма рассчитана на диалог «показать — выбрать — вернуть». После выбора пользователем строки и подтверждения действие завершается передачей ссылки на объект, а не просто закрытием окна.

Выделять форму выбора стоит, если выбор элемента является самостоятельным этапом бизнес-процесса: например, выбор контрагента при оформлении документа, номенклатуры при заполнении заказа или сотрудника при создании отдела. В этих случаях форма выбора явно сигнализирует пользователю, что от него требуется конкретное решение, а не просто просмотр справочника.

Когда достаточно режима выбора обычного списка

Не всегда нужно создавать отдельную форму выбора. Платформа позволяет открыть существующую форму списка в режиме выбора, передав соответствующий параметр при открытии формы. В этом случае список ведёт себя как форма выбора: пользователь помечает нужную строку, подтверждает действие, а вызывающая форма получает выбранное значение. Это подходит, когда внешний вид и набор колонок обычного списка уже устраивают.

Режим выбора удобен для быстрых доработок, когда не хочется дублировать форму и поддерживать два одинаковых интерфейса. Однако у такого подхода есть границы: если список содержит сложную иерархию, группировку или большое количество действий, не связанных с выбором, отдельная форма выбора будет понятнее и безопаснее для пользователя.

Как изменить тип формы на форму выбора

Для преобразования формы списка в форму выбора открывают форму в конструкторе и меняют её вид с «Форма списка» на «Форма выбора». После этого платформа доступ к свойствам и событиям, связанным с возвратом результата. Важно сохранить существующие настройки колонок, отбора и сортировки, чтобы пользователь не потерял привычный набор данных.

Далее проверяют модуль формы: события, которые раньше обрабатывали открытие или закрытие списка, могут потребовать корректировки под новый тип формы. Если в форме есть команды, не относящиеся к выбору, их следует скрыть или перенести, чтобы не вводить пользователя в заблуждение. Изменения рекомендуется вносить в копию конфигурации или с обязательным резервным копированием перед правкой.

Порядок действий
  1. 1
    Открыть форму списка в конструкторе и сменить вид формы на «Форма выбора».
  2. 2
    Проверить и при необходимости скорректировать набор колонок, отбор и сортировку.
  3. 3
    Настроить обработку выбора и возврат выбранного значения вызывающей форме.
  4. 4
    Проверить работу формы в режиме выбора на тестовой базе.

Настройка колонок и отбора для выбора

В форме выбора колонки должны содержать достаточно информации для принятия решения. Обычно это наименование объекта, код, статья затрат, контрагент или другой идентифицирующий признак. Лишние технические поля лучше скрыть, чтобы список не перегружал экран и не отвлекал от основной задачи — выбора.

Отбор на форме выбора настраивают так, чтобы пользователь видел только подходящие варианты. Например, при выборе номенклатуры можно ограничить список активными товарами, а при выборе контрагента — только действующими партнёрами. Корректный отбор снижает вероятность ошибки и ускоряет работу, особенно в больших справочниках.

Обработка выбора и возврат значения

Ключевой момент в форме выбора — обработка события подтверждения выбора. Когда пользователь выбирает строку и нажимает соответствующую кнопку, форма должна вернуть выбранное значение в вызывающий объект. Если обработчик отсутствует или ссылается на несуществующую процедуру, выбор будет визуально подтверждён, но данные не передадутся.

Также нужно продумать поведение при отмене выбора. Пользователь должен иметь возможность закрыть форму без возврата значения, и вызывающая форма должна корректно обрабатывать ситуацию «выбор не сделан». Иначе после нажатия «Отмена» может возникнуть неопределённое состояние или некорректно заполненное поле в документе.

Типичные ошибки
01
Смешение вида формы списка и формы выбора без обработки возврата значения.
02
Отсутствие проверки результата после закрытия формы выбора, что приводит к неопределённому состоянию вызывающего объекта.

Ограничения и частые ошибки

Одним из ограничений является невозможность использовать форму выбора для массового редактирования: её задача — вернуть выбор, а не изменить список целиком. Если задача заключается в массовой обработке, лучше оставить форму списка без режима выбора. Также не стоит делать форму выбора слишком сложной: вложенные таблицы, множество команд и сложные отборы могут замедлить открытие и запутать пользователя.

Частые ошибки — смешение видов форм, отсутствие обработки возврата значения и попытка использовать форму выбора в контексте, где платформа не поддерживает возврат данных. Ещё одна проблема — изменение типовых объектов конфигурации без выделения собственного расширения, что затрудняет обновление и поддержку. Перед правкой типовых форм стоит оценить, можно ли достичь цели через расширение или параметры открытия.

Контрольные точки

Как проверить результат

Выбрать элемент и подтвердить действие
Норма

Вызывающая форма получила выбранное значение

Тревожный признак

Значение не передано или поле осталось пустым

Закрыть форму выбора без выбора
Норма

Форма закрывается, целевое поле не меняется

Тревожный признак

Произошёл частичный или ошибочный перенос данных

Проверка результата и безопасные работы

После изменений формы выбора нужно проверить, что выбранное значение действительно попадает в целевое поле документа или справочника. Достаточно открыть форму в режиме выбора, выбрать элемент, подтвердить действие и убедиться, что вызывающая форма заполнилась корректно. Также стоит проверить отмену выбора: форма должна закрыться без передачи данных, а целевое поле не должно меняться.

Безопасная самостоятельная работа возможна при правке нетиповых форм и при наличии резервной копии конфигурации. Если форма входит в типовой объект конфигурации, изменения лучше выполнять через механизм расширений или с участием разработчика, чтобы не нарушить обновляемость. Любые правки в рабочей базе рекомендуется сначала отработать на копии или в тестовой среде.

Итог

Что важно запомнить

Форма выбора отличается от списка механизмом возврата значения; выбирайте подходящий вид формы, настраивайте отбор и обязательно проверяйте передачу выбранного элемента.

Часто задаваемые вопросы

Можно ли открыть обычный список в режиме выбора без создания новой формы?

Да, платформа позволяет открыть существующую форму списка в режиме выбора, передав соответствующий параметр при открытии. Это подходит, если текущий набор колонок и отбора уже удовлетворяет задаче, и отдельная форма выбора не требуется.

Что делать, если после выбора значение не возвращается в документ?

Нужно проверить, что форма имеет вид «Форма выбора» и что в модуле формы есть обработка события подтверждения выбора, передающая выбранную ссылку вызывающему объекту. Также стоит убедиться, что форма открыта именно в режиме выбора, а не как обычный список.

Нужно ли скрывать команды редактирования на форме выбора?

Рекомендуется скрыть или перенести команды, не относящиеся к выбору, чтобы пользователь не пытался редактировать объекты в режиме, предназначенном только для возврата значения. Это делает интерфейс понятнее и снижает риск ошибок.

Безопасно ли менять типовую форму списка на форму выбора?

Прямые изменения типовой формы могут затруднить обновление конфигурации. Лучше использовать механизм расширений или вносить правки в копию конфигурации с последующим тестированием на отдельной базе.

Как отличить форму выбора от обычного списка по работе с пользователем?

Форма выбора ожидает подтверждения выбора и возвращает выбранное значение вызывающей форме, тогда как обычный список обычно закрывается без передачи данных. Если после закрытия целевое поле не заполнилось, скорее всего, использовался обычный список, а не форма выбора.