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

Другое · 6 мин

Передача параметров из одной формы в другую в 1С

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

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

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

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

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

Способы передачи параметров в управляемых формах

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

Типичная логика: создать Новый Структура, вставить элементы «ДокументСсылка» и «Режим», вызвать ОткрытьФорму с именем целевой формы и структурой. В целевой форме в ПриОткрытии проверить Параметры.Свойство и применить значение к реквизитам формы.

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

Открытие формы с параметрами через команду

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

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

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

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

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

Проверка параметров в открываемой форме

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

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

Типичные ошибки
01
Передача ссылки на удалённый объект приводит к ошибке при открытии формы
02
Забывание проверки наличия параметра вызывает пустые поля и исключения
03
Передача табличной части без проверки на пустоту ломает заполнение формы

Ограничения и альтернативы

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

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

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

Структура параметров при ОткрытьФорму

Подходит для управляемых форм и большинства типовых ситуаций

Глобальный контекст или общие модули

Подходит для обычных форм и сложных сценариев, но менее прозрачен

Границы безопасной работы и риски

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

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

Итог

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

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

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

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

Что делать, если параметр не пришёл в целевую форму?

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

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

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

В чем разница между параметрами команды и параметрами формы?

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

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

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