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

Другое · 5 мин

Возврат выбранного значения из формы выбора 1С

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

Форма выбора в 1С не возвращает значение как обычная функция. Результат передаётся через структуру параметров, которую вызывающая форма заполняет перед открытием, а форма выбора записывает в неё перед закрытием.

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

Основное правило: не обращайтесь к элементам формы после её закрытия и не храните ссылку на саму форму в глобальных переменных. Достаточно структуры параметров и проверки на Неопределено.

Подготовка параметров перед открытием формы

Создайте структуру Параметры и укажите в ней выбранное значение как Неопределено. Передайте её в ОткрытьФорму вместе с именем формы выбора и текущей формой в качестве владельца.

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

Порядок действий
  1. 1
    Создайте структуру параметров и задайте выбранное значение как Неопределено
  2. 2
    Откройте форму выбора, передав структуру параметров
  3. 3
    В форме выберите запись и нажмите Выбрать
  4. 4
    После закрытия проверьте параметр на Неопределено и используйте значение

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

Проверьте тип выбранного значения перед записью в реквизит: ссылка справочника, документа или перечисления должна соответствовать ожидаемому типу.

Код в форме выбора: команды Выбрать и Отмена

Кнопка Выбрать должна присвоить Параметры.ВыбранноеЗначение текущей строке или ссылке и вызвать Закрыть. Для множественного выбора используйте коллекцию выбранных строк или строк таблицы.

Одиночный выбор

Достаточно взять ТекущиеДанные элемента списка, получить ссылку и записать её в Параметры.ВыбранноеЗначение. Если текущая строка не выбрана, лучше отказать в закрытии с выбором и показать сообщение.

Множественный выбор

При включённом множественном выборе записывайте все отмеченные строки в Параметры.ВыбранныеЗначения или соответствующую коллекцию. Вызывающий код должен быть готов к обработке списка, а не одной ссылки.

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

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

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

Параметры.ВыбранноеЗначение после закрытия
Норма

Содержит ссылку нужного типа

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

Неопределено или тип не соответствует реквизиту

Доступ к форме после закрытия
Норма

Не используется

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

Обращение к закрытым элементам формы

Чтение результата в вызывающей форме

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

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

Ограничения и безопасность

Выбор значения не даёт права на его изменение. Перед записью выбранного контрагента, договора или номенклатуры в документ убедитесь, что у пользователя есть доступ к объекту и операция разрешена правилами доступа.

Не полагайтесь на жестко заданные имена форм и порядок колонок: при изменении конфигурации форма выбора может перестать открываться или вернуть другую структуру. Проверяйте изменения на копии базы перед вводом в эксплуатацию.

Типичные ошибки и как их избежать

Типичные ошибки
01
Чтение параметров до закрытия формы или внутри обработчика выбора
02
Обращение к элементам закрытой формы или хранение ссылки на неё в глобальных переменных
03
Запись выбранного значения без проверки типа и прав доступа

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

Не смешивайте обычные и управляемые формы без проверки контекста клиента: механизмы открытия и возврата результата могут отличаться в тонком и веб-клиенте.

Итог

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

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

Нужно ли передавать текущую форму в ОткрытьФорму?

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

Что делать, если пользователь нажал Отмена?

Обычно параметры не меняются и остаются с начальным значением Неопределено. Вызывающий код должен проверять это состояние и не записывать пустой выбор в реквизиты.

Можно ли выбрать несколько значений сразу?

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

Работает ли одинаково в тонком и веб-клиенте?

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

Нужно ли программировать серверный модуль для возврата значения?

Не обязательно. Возврат значения чаще всего реализуется в клиентском модуле формы выбора через структуру параметров. Сервер может понадобиться только для дополнительной проверки прав или загрузки данных.