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