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

Другое · 8 мин

Передача параметров при закрытии формы в 1С:Enterprise

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

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

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

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

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

Как форма возвращает значение при закрытии

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

Вызывающий код получает это значение как результат вызова метода ОткрытьФорму. Если форма открыта модально, выполнение вызывающего кода приостанавливается до закрытия окна, и переменной присваивается то, что форма оставила в ЗначениеВозврата. Если форма не модальная, метод возвращает ссылку на форму сразу, а значение читается отдельно.

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

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

Передача параметров через параметры формы и ссылку на объект

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

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

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

Общие модули и глобальный контекст как альтернатива

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

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

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

Модальные и немодальные формы: разница при передаче

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

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

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

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

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

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

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

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

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

Значение после нажатия «Сохранить»
Норма

Вызвующий код получает переданную структуру или объект

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

В вызывающем коде приходит неопределённость или пустая структура

Значение после нажатия «Отмена»
Норма

Передан признак отмены или неопределённость

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

Возвращаются данные, как будто пользователь сохранил изменения

Повторное открытие формы
Норма

Форма начинается с чистыми или переданными параметрами

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

В форме остаются данные из предыдущего сеанса

Как выбрать подходящий способ передачи

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

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

Итог

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

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

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

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

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

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

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

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

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

Работает ли передача значения одинаково в обычных и управляемых формах?

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