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

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

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

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

Как устроен механизм выбора в управляемой форме

Когда форма открывается в режиме выбора (например, по кнопке выбора поля ввода), платформа автоматически связывает её с элементом-владельцем. При интерактивном выборе строки форма вызывает у владельца событие ОбработкаВыбора и передаёт туда выбранное значение. Разработчику достаточно не блокировать этот механизм и при необходимости дописать свою логику в обработчике.

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

Способ 1: вернуть значение через ОповеститьОВыборе

Это самый частый сценарий для произвольных форм подбора. В форме выбора, когда пользователь подтверждает выбор (кнопка «Выбрать», двойной щелчок по строке), вызывается метод ОповеститьОВыборе(ВыбранноеЗначение). Платформа передаёт значение владельцу формы, и у него срабатывает ОбработкаВыбора.

// Модуль формы выбора
&НаКлиенте
Процедура СписокВыбор(Элемент, ВыбраннаяСтрока, Поле, СтандартнаяОбработка)
    СтандартнаяОбработка = Ложь;
    ТекущиеДанные = Элемент.ТекущиеДанные;
    ОповеститьОВыборе(ТекущиеДанные.Ссылка);
КонецПроцедуры

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

// Модуль вызывающей формы
&НаКлиенте
Процедура Подбор(Команда)
    ПараметрыФормы = Новый Структура("РежимВыбора", Истина);
    ОткрытьФорму("Справочник.Номенклатура.ФормаВыбора", ПараметрыФормы, Элементы.Товары);
КонецПроцедуры

&НаКлиенте
Процедура ОбработкаВыбора(ВыбранноеЗначение, ИсточникВыбора)
    НоваяСтрока = Объект.Товары.Добавить();
    НоваяСтрока.Номенклатура = ВыбранноеЗначение;
КонецПроцедуры

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

Способ 2: вернуть значение через Закрыть и ОписаниеОповещения

Этот способ удобен, когда форма выбора не привязана к конкретному элементу или результат нужно обработать именно в том месте кода, где форма открывалась. Форма открывается с параметром ОписаниеОповещения, а при выборе значение передаётся аргументом в Закрыть().

// Вызывающая форма
&НаКлиенте
Процедура ВыбратьКонтрагента(Команда)
    Оповещение = Новый ОписаниеОповещения("ПослеВыбораКонтрагента", ЭтотОбъект);
    ОткрытьФорму("Справочник.Контрагенты.ФормаВыбора", , ЭтотОбъект, , , , Оповещение);
КонецПроцедуры

&НаКлиенте
Процедура ПослеВыбораКонтрагента(Результат, ДопПараметры) Экспорт
    Если Результат <> Неопределено Тогда
        Объект.Контрагент = Результат;
    КонецЕсли;
КонецПроцедуры

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

Способ 3: стандартный выбор для полей ввода

Если форма выбора открывается штатно — по кнопке выбора у поля ввода, связанного со ссылочным реквизитом, — писать код возврата вообще не нужно. Платформа сама устанавливает выбранное значение в реквизит. Требуется только, чтобы у формы справочника была назначена форма выбора по умолчанию или чтобы открытие происходило с параметром РежимВыбора = Истина.

Дополнительная обработка при этом тоже доступна: у элемента формы есть событие ОбработкаВыбора, где можно, например, отменить стандартное присвоение (СтандартнаяОбработка = Ложь) и заполнить несколько полей на основании выбранного значения — цену, единицу измерения, ставку НДС.

Возврат нескольких значений и сложных данных

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

// Форма подбора: передаём массив структур
&НаКлиенте
Процедура ПеренестиВДокумент(Команда)
    Результат = Новый Массив;
    Для Каждого Строка Из ПодобранныеТовары Цикл
        Результат.Добавить(Новый Структура("Номенклатура, Количество, Цена",
            Строка.Номенклатура, Строка.Количество, Строка.Цена));
    КонецЦикла;
    ОповеститьОВыборе(Результат);
КонецПроцедуры

Для больших объёмов (тысячи строк подбора) массив структур перегружает клиент-серверный обмен. В этом случае на сервере формы подбора данные помещают во временное хранилище (ПоместитьВоВременноеХранилище), а через оповещение передают только адрес хранилища. Вызывающая форма читает данные по адресу в серверной процедуре.

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

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

Отдельная категория проблем — обычные формы в старых конфигурациях. Там механизм другой: используется ОткрытьФормуМодально и метод Закрыть(Значение) возвращает результат напрямую в точку вызова. При переносе кода из обычных форм в управляемые этот код требует полной переработки на асинхронную модель.

Ограничения и безопасные границы изменений

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

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

Частые вопросы