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

Другое · 7 мин

Как вызвать экспортную процедуру модуля формы в 1С

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

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

Порядок действий
  1. 1
    Убедиться, что процедура в модуле формы объявлена с ключевым словом Экспорт
  2. 2
    Получить ссылку на нужный экземпляр формы
  3. 3
    Вызвать процедуру через ссылку на форму с необходимыми параметрами
  4. 4
    Проверить, что форма осталась открытой и данные изменились ожидаемым образом

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

Что понимать под вызовом экспортной процедуры модуля формы

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

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

Как получить ссылку на форму

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

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

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

Форма открыта и доступна
Норма

Ссылка на форму получена, процедура выполняется

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

Ошибка получения ссылки или форма закрыта

Параметры процедуры
Норма

Типы и количество параметров совпадают с описанием

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

Ошибка типов или лишние параметры

Данные после вызова
Норма

Ожидаемые реквизиты и элементы формы изменились

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

Данные не изменились или форма закрылась

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

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

Пример объявления в модуле формы:

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

Прямой вызов экспортной процедуры формы

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

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

Подходит для повторно используемой логики; не требует открытой конкретной формы

Процедура ОтправитьЗаказ(НомерЗаказа) Экспорт
// действия с элементами формы и данными
КонецПроцедуры

Пример вызова из другого модуля при наличии ссылки МояФорма:

МояФорма.ОтправитьЗаказ("12345");

Синтаксис вызова и передача параметров

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

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

Вызов из клиентского и серверного контекста

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

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

Ограничения и условия безопасного вызова

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

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

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

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

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

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

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

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

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

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

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

Итог

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

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

Часто задаваемые вопросы

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

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

Что делать, если форма закрывается пользователем во время вызова?

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

Подходит ли вызов процедуры формы для серверного кода?

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

Нужно ли передавать форму в параметр при вызове её же процедуры?

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