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

Другое · 8 мин

Передача значения из формы в форму в 1С

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

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

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

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

Когда передача параметров при открытии подходит

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

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

Как принять параметры в открываемой форме

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

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

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

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

Как вернуть значение из модальной формы

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

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

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

Сравнение вариантов

Параметры открытия формы

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

Модальное окно с возвратом

Удобно для выбора и подтверждения; ограничение — блокирует вызывающую форму до закрытия.

Общие модули или сеансовые параметры

Подходят для косвенной связи между формами; ограничение — менее прозрачные зависимости и сложнее отладка.

Альтернативы прямой передаче параметров

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

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

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

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

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

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

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

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

Значение подставляется при открытии целевой формы
Норма

Поле заполнено автоматически без лишних действий

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

Поле пустое или требует ручного ввода

Работа формы без переданного параметра
Норма

Форма открывается и работает в обычном режиме

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

Форма выдаёт ошибку или не открывается

Отмена пользователем в модальном окне
Норма

Данные не изменяются, операция прерывается безопасно

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

Записываются некорректные или пустые значения

Границы самостоятельной работы и риски

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

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

Итог

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

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

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

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

Что делать, если принимающая форма не получает параметр?

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

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

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

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

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