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

Другое · 7 мин

Процедуры и функции в 1С: отличие, создание и вызов

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

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

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

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

Процедура и функция: главное отличие

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

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

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

Где описывать процедуры и функции

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

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

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

Параметры, вызов и возврат значения

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

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

1C
Процедура ОбработкаЗаполнения(Элемент, ДанныеЗаполнения, СтандартнаяОбработка)
    СтандартнаяОбработка = Ложь;
КонецПроцедуры

Функция ВычислитьСумму(Знач Сумма, Знач Ставка) Экспорт
    Возврат Сумма * Ставка;
КонецФункции

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

Контекст выполнения и события платформы

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

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

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

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

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

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

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

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

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

Вызов процедуры
Норма

Изменения отражены в объектах и регистрах

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

Данные не изменились или появилась ошибка выполнения

Вызов функции
Норма

Возвращается ожидаемое значение в выражении

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

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

Синтаксис модуля
Норма

Модуль сохраняется без подчёркиваний и сообщений

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

Ошибки компиляции или не найден экспортируемый метод

Проверка и отладка

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

Используйте отладчик 1С: пошаговое выполнение, точки остановки и просмотр переменных помогают найти ошибку в параметрах или условии Возврат. Синтаксис проверяется при сохранении модуля, а ошибки выполнения проявляются только при запуске кода.

Итог

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

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

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

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

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

Что делать, если функция не возвращает значение?

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

Где хранить общие расчёты для нескольких справочников?

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

Безопасно ли править процедуры в типовой конфигурации?

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