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

Другое · 8 мин

Вызов процедуры из другой процедуры в 1С

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

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

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

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

Когда вызов процедуры из другой процедуры уместен

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

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

Видимость процедур и модификатор Экспорт

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

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

Вызов процедуры в том же модуле

Внутри одного модуля вызов оформляется проще всего: достаточно указать имя процедуры и передать параметры. Примерно так может выглядеть код: МояПроцедура(Параметр1, Параметр2);. Дополнительные префиксы не требуются.

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

Вызов из общего модуля и модуля объекта или формы

Для обращения к процедуре общего модуля используется составное имя: сначала имя общего модуля, затем точка и имя процедуры. Например, ОбщийМодуль.МояБиблиотека.РассчитатьСкидку(Сумма);. Общий модуль должен быть подключён к конфигурации, а процедура помечена как Экспорт.

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

Вариант вызоваКогда подходитОграничение
В том же модулеПроцедура описана в этом же модулеНедоступна из других модулей без Экспорта
Из общего модуляОбщая логика для нескольких объектовТребуется подключение модуля и модификатор Экспорт
Из модуля объекта или формыДействие привязано к конкретному объекту или формеЗависит от существования объекта в контексте

Контекст выполнения: клиент, сервер, общий модуль

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

Порядок действий
  1. 1
    Убедитесь, что целевая процедура помечена как Экспорт
  2. 2
    Проверьте контекст выполнения клиент или сервер
  3. 3
    Составьте вызов с правильным путём к модулю
  4. 4
    Передайте все обязательные параметры
  5. 5
    Проверьте результат и отсутствие ошибок компиляции

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

Параметры, возврат результата и проверка

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

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

Ограничения, типичные ошибки и безопасность

Частая ошибка — циклический вызов, когда процедура А вызывает процедуру Б, а Б вызывает А. Это приводит к переполнению стека и аварийному завершению операции. Перед добавлением нового вызова полезно проследить цепочку зависимостей между процедурами.

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

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

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

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

Локальный вызов в одном модуле

Проще и быстрее, но ограничен одним модулем

Вызов из общего модуля

Подходит для общей логики, требует Экспорта и подключения модуля

Вызов метода объекта или формы

Привязан к конкретному экземпляру, требует наличия объекта в контексте.

Если вызов не срабатывает, первым делом открывайте синтаксис-помощник и проверяйте написание имени модуля и процедуры. Опечатка в имени или отсутствие точки в составном имени — наиболее частая причина ошибки «процедура не определена».

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

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

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

Компиляция конфигурации
Норма

Ошибок синтаксиса нет

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

Сообщение о неопределённой процедуре

Вызов в тестовой базе
Норма

Процедура отработала без исключений

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

Ошибка контекста или отсутствие ссылки

Изменение данных
Норма

Данные сохранены и согласованы

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

Неконсистентные данные после вызова

Практическая проверка перед внедрением

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

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

Итог

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

Вызывайте процедуру по имени с параметрами; из другого модуля только экспортные, с правильным путём и подходящим контекстом выполнения.

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

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

Да, если у вас есть ссылка на форму или объект и процедура доступна в текущем контексте. Прямое обращение по имени без ссылки на форму или объект не сработает.

Что делать, если платформа пишет, что процедура не определена?

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

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

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

Безопасно ли вызывать процедуру записи из события формы?

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