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

Другое · 7 мин

Вызов процедуры из формы в 1C: порядок и нюансы

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

В 1C:Предприятии процедура может находиться в модуле формы, общем модуле или серверном модуле. Вызов из формы зависит от того, где описана процедура, где находится вызывающий код и какая форма является текущей. Без учёта этих условий платформа выдаст ошибку компиляции или выполнения.

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

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

Что понимать под вызовом процедуры из формы

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

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

Вызов процедуры внутри модуля той же формы

Если процедура описана в модуле той же формы, вызывать её можно напрямую по имени, например: МояПроцедура();. Дополнительных ссылок на форму не требуется, потому что код уже находится в контексте экземпляра формы.

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

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

Вызов процедуры из другой формы

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

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

Открытие формы и вызов её процедуры

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

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

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

Внутри той же формы

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

Из другой формы

Требует ссылки на целевую форму и соблюдения клиент-серверных правил

Через ВызватьСервер

Необходим для серверного кода, вызываемого из клиента, но добавляет сетевой раунд

Серверные и клиентские процедуры: ВызватьСервер

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

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

Параметры, возвращаемое значение и обработка ошибок

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

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

Кнопки, команды и запуск при открытии формы

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

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

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

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

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

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

Итог

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

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

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

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

Нужно ли открывать другую форму, чтобы вызвать её процедуру?

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

Что делать, если после вызова процедуры данные не обновились?

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

Может ли процедура формы быть недоступной из другого модуля?

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