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

Другое · 8 мин

Процедуры в 1С: что это, зачем нужны и как создаются

Процедура в 1С — именованный блок кода на встроенном языке, который выполняет действия, но не возвращает результат. Разберём отличия от функций, модули, параметры и вызовы.

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

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

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

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

В языке 1С ключевое слово Процедура объявляет подпрограмму без результата. Код между Процедура Имя() и КонецПроцедуры выполняется по вызову, но программа не получает обратно вычисленное значение. Если нужно получить результат, например сумму или проверку условия, используется Функция с оператором Возврат.

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

Где создавать процедуры: модули объектов, форм и общие модули

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

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

Параметры и способы вызова

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

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

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

Серверные и клиентские процедуры: контекст выполнения

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

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

Процедуры как обработчики событий

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

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

Ограничения, риски и проверка результата

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

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

Типичные ошибки
01
Путаница процедуры с функцией и ожидание возврата значения
02
Вызов серверной процедуры из клиентского контекста без необходимого перехода
03
Изменение типовых процедур без понимания зависимостей

Типичные ошибки при работе с процедурами

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

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

Итог

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

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

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

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

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

Где лучше разместить процедуру: в модуле объекта или общем модуле?

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

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

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

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

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