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

Другое · 7 мин

Как из формы 1С обратиться в модуль объекта

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

В модуле формы 1С основная точка доступа к редактируемому объекту — свойство Объект модуля формы. В управляемых формах это обычно записывается как эта.Объект, а в коде формы можно использовать эту.Объект. Через эту ссылку форма получает доступ к данным и к экспортным процедурам и функциям, объявленным в модуле самого объекта.

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

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

Прямой вызов выглядит так: в модуле формы пишется эта.Объект.ИмяПроцедуры(параметры) или эта.Объект.ИмяФункции(параметры). Метод должен быть помечен как экспортный в модуле объекта. Если процедура возвращает значение, результат можно присвоить переменной формы или использовать в условии.

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

Как получить объект и проверить доступ к нему

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

Ссылка эта.ОбъектЗаполнена

Объект формы доступен, можно вызывать его методы

Метод в модуле объектаЭкспортный

Виден из формы и других модулей

Метод не экспортныйЗакрыт

Прямой вызов из формы невозможен без обёртки

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

Порядок вызова процедуры модуля объекта

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

Порядок действий
  1. 1
    Откройте модуль формы и убедитесь, что эта.Объект доступна
  2. 2
    Найдите экспортную процедуру или функцию в модуле объекта
  3. 3
    Напишите вызов через эту.Объект.ИмяМетода с нужными параметрами
  4. 4
    Проверьте синтаксис и протестируйте на копии базы

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

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

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

Серверный и клиентский контекст

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

Типичные ошибки
01
Вызов неэкспортной процедуры модуля объекта из формы — метод недоступен
02
Клиентский вызов серверной логики объекта — ошибка контекста или зависание формы
03
Изменение объекта без проверки состояния — возможная потеря данных при одновременной работе

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

Когда прямой вызов не подходит

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

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

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

Вызов метода объекта
Норма

Метод отработал без исключений, данные обновлены

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

Ошибка компиляции, метод не найден или данные не изменились

Состояние формы после вызова
Норма

Реквизиты отражают результат, интерфейс не завис

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

Форма зависла, данные не сохранились, появилось необработанное исключение

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

Проверка результата и границы самостоятельной работы

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

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

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

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

Итог

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

Доступ через эта.Объект, только экспортные методы, учёт контекста клиент/сервер и тестирование на копии базы перед работой с реальными данными.

Частые вопросы

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

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

Что делать, если метод объекта работает на сервере, а форма клиентская?

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

Почему эта.Объект не определена?

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

Нужно ли сохранять объект перед вызовом его метода?

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