Другое · 6 мин
Передача параметров из одной формы в другую в 1С
Как передать параметры из одной формы в другую в 1С: управляемые и обычные формы, метод ОткрытьФорму, проверка параметров и типичные ошибки.
Передача параметров из одной формы в другую нужна, когда открываемая форма должна получить контекст: ссылку на документ, значение реквизита, набор отбора или флаг режима работы. Это позволяет заполнить поля автоматически и не заставлять пользователя вводить одно и то же дважды.
Механизм зависит от типа формы. В управляемых формах параметры обычно передаются через структуру Параметры при вызове метода ОткрытьФорму или через параметры команды. В обычных формах используется глобальный контекст или параметры формы, а способы различаются в зависимости от конфигурации и релиза платформы.
Перед передачей определите, что именно переносить: ссылку, значение, табличную часть или признак. Неправильно переданный параметр приводит к пустым полям, ошибке выполнения или открытию формы без нужного контекста.
Ниже рассмотрены основные способы, условия их применения, порядок проверки и типичные ошибки, которые помогают избежать потери данных и лишней отладки.
Способы передачи параметров в управляемых формах
В управляемой форме метод ОткрытьФорму принимает имя формы и структуру параметров. В вызывающей форме заполняют структуру, ключи которой становятся доступными в открываемой форме через параметр Параметры процедуры ПриОткрытии.
Типичная логика: создать Новый Структура, вставить элементы «ДокументСсылка» и «Режим», вызвать ОткрытьФорму с именем целевой формы и структурой. В целевой форме в ПриОткрытии проверить Параметры.Свойство и применить значение к реквизитам формы.
- 1Создайте структуру параметров в вызывающей форме
- 2Добавьте нужные ключи и значения
- 3Вызовите ОткрытьФорму с именем целевой формы и структурой
- 4В целевой форме получите параметры в обработчике ПриОткрытии и проверьте их наличие
Открытие формы с параметрами через команду
Если форма открывается по команде из интерфейса, параметры можно передать в обработчике команды перед вызовом открытия. Команда получает текущий объект, выделенную строку списка или ссылку на документ, которые упаковываются в структуру параметров.
Важно не путать параметры команды и параметры формы: команда инициирует открытие, а структура параметров доставляет данные уже внутри открытой формы. Если структура не передана, целевая форма открывается без контекста.
Передача из списка в форму документа
Из формы списка часто открывают форму документа по выделенной ссылке. В этом случае параметром передают ссылку на выбранный документ, а иногда и режим открытия: просмотр, редактирование или создание на основании.
Если список пуст или выделение отсутствует, передавать ссылку нечего. Перед открытием формы проверьте, что выделена строка, иначе целевая форма может открыться с пустым объектом или выдать исключение.
Проверка параметров в открываемой форме
В обработчике ПриОткрытии целевой формы первым делом проверяют, передан ли параметр, с помощью Параметры.Свойство или аналогичной проверки в зависимости от платформы. Если параметр отсутствует, форму можно открыть в режиме создания или выдать предупреждение.
После проверки значение присваивают реквизиту формы или используют для отбора. Рекомендую явно указывать тип ожидаемого параметра и обрабатывать случай, когда значение пришло не того типа или пустое.
Ограничения и альтернативы
Не все данные удобно передавать параметрами. Большие табличные части, сложные наборы записей или временные данные лучше сохранять в регистр временных данных, общее хранилище или передавать через объект метаданных, а не через структуру параметров.
Если одна и та же форма открывается из многих мест, унифицируйте набор параметров и порядок их проверки. Это снижает число вариантов открытия и упрощает поддержку при изменении конфигурации.
Сравнение вариантов
Подходит для управляемых форм и большинства типовых ситуаций
Подходит для обычных форм и сложных сценариев, но менее прозрачен
Границы безопасной работы и риски
Не передавайте через параметры конфиденциальные реквизиты, пароли или открытые сеансы, которые не предназначены для отображения в форме. Параметры формы видны в контексте открытия и могут попасть в журналы регистрации при неаккуратном использовании.
Если после передачи параметров форма открывается с ошибкой, сначала проверьте наличие ключа в структуре, соответствие типа и права доступа к объекту. Самостоятельная правка кода допустима, если вы понимаете последствия для открываемой формы и связанных документов.
Что важно запомнить
Параметры передаются структурой при открытии формы, читаются в ПриОткрытии и обязательно проверяются на наличие и тип перед использованием.
Нужно ли передавать параметры каждой открываемой форме?
Нет, только если целевой форме требуется контекст: ссылка, значение, отбор или режим. Для обычного открытия справочника или документа без предустановки параметры не обязательны.
Что делать, если параметр не пришёл в целевую форму?
Проверьте, что структура параметров была передана при вызове ОткрытьФорму, ключ написан верно и объект существует. В целевой форме добавьте проверку наличия параметра перед обращением к его значению.
Можно ли передать табличную часть через параметры?
Можно, но для больших табличных частей лучше использовать временное хранилище или регистр временных данных, а не структуру параметров, чтобы не перегружать контекст открытия формы.
В чем разница между параметрами команды и параметрами формы?
Параметры команды управляют действием открытия, а параметры формы доставляют данные уже внутри открытой формы. Команда может быть без параметров, а форма — получить структуру при открытии.
Безопасно ли передавать ссылки на документы через параметры?
Безопасно, если документ не удалён и у пользователя есть права на его просмотр. Перед открытием проверяйте наличие ссылки и доступ к объекту, иначе форма может открыться с ошибкой.