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

Другое · 8 мин

Как писать процедуры в 1C

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

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

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

Объявление процедуры и область видимости

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

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

Процедура без параметров

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

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

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

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

Параметры и передача значений

Параметры позволяют процедуре получать данные при вызове и работать с разными значениями без переписывания кода. В скобках после имени перечисляются имена параметров через запятую. Внутри процедуры к ним обращаются по этим именам как к обычным переменным.

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

Процедура с параметрами по значению и по ссылке

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

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

Вызов процедуры и обработка результата

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

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

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

Экспорт процедур и доступ из других модулей

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

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

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

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

Отладка, проверка и типичные ошибки

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

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

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

Когда процедура не подходит и альтернативы

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

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

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

Вызов процедуры с пустыми скобками
Норма

Процедура выполняется без ошибок синтаксиса

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

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

Изменения данных после вызова
Норма

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

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

Данные остались прежними или изменились не там

Доступ из другого модуля
Норма

Экспортная процедура видна и вызывается

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

Ошибка неопределена или процедура не видна

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

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

Итог

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

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

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

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

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

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

Когда делать процедуру экспортной?

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

Что делать, если процедура не сохраняет изменения?

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