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

Другое · 5 мин

Процедура в 1С: что это, где создать и как проверить

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

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

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

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

Чем процедура отличается от функции

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

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

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

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

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

Контекст выполнения: клиент, сервер и вызов сервера

Процедуры могут исполняться на клиентском компьютере, на сервере 1С или в обоих контекстах. Директивы &НаСервере, &НаКлиенте и &ВызовСервера определяют, где выполняется код и как передаются данные между клиентом и сервером.

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

Создание и изменение процедуры в конфигураторе

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

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

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

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

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

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

Типичные ошибки и ограничения

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

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

Типичные ошибки
01
Опечатка в имени процедуры или параметра приводит к ошибке компиляции
02
Изменение стандартного модуля без копирования затрудняет обновление

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

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

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

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

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

Ожидаемое действие выполнено без сообщений об ошибке

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

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

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

При отклонении от нормы лучше откатить правку и повторить проверку на отдельной копии.

Итог

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

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

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

Может ли процедура возвращать значение?

Нет, процедура не возвращает результат. Для получения значения используйте функцию.

Где создать процедуру, доступную из всей конфигурации?

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

Нужно ли перезапускать 1С после изменения процедуры?

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

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

Можно, но прямое изменение стандартных модулей затрудняет обновление; предпочтительнее использовать расширения или отдельные общие модули.

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

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