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

Другое · 6 мин

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

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

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

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

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

H2 Когда передача параметра при закрытии формы нужна

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

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

H2 Основные способы передачи значения при закрытии формы

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

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

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

H2 Порядок действий при реализации

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

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

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

H2 Ограничения и риски

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

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

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

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

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

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

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

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

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

Значение после закрытия формы
Норма

Реквизит вызывающей формы заполнен ожидаемым значением

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

Поле остаётся пустым или содержит предыдущее значение

Поведение при отмене
Норма

Значение не меняется, если пользователь отменил закрытие

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

Данные перезаписаны несмотря на отмену

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

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

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

Данные пропадают после повторного открытия

H2 Альтернативы и выбор способа

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

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

Итог

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

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

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

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

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

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

Что делать, если стандартная кнопка закрытия не вызывает вашу процедуру?

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

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

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