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