Другое · 6 мин
Функции и процедуры в 1С: зачем они нужны и как выбрать
Разбор назначения функций и процедур в 1С: когда возвращать результат, а когда выполнять действия, параметры, ошибки и проверка кода.
В конфигурациях 1С логика часто разделяют на вычисления и действия. Функция предназначена для получения результата, который можно использовать в выражениях, отчётах, формах и проверках. Процедура выполняет последовательность действий: запись данных, открытие формы, вызов других процедур или изменение состояния объекта. Разделение упрощает поддержку, повторное использование и отладку.
Если одна и та же формула нужна в нескольких местах, удобнее вынести её в функцию, а не дублировать код. Если нужно выполнить несколько связанных операций без возврата значения, подходит процедура. Правильный выбор снижает вероятность ошибок при изменении правил учёта.
Основное различие не в сложности, а в том, возвращает ли конструкция значение или нет. Функция обязана вернуть результат через оператор Возврат, процедура может завершаться без возврата. Это влияет на то, где конструкцию можно вызвать и как обрабатывать её результат.
Отличие функции от процедуры на практике
Функция подходит, когда нужно получить число, строку, дату, ссылку на объект или табличное значение. Её результат можно присвоить переменной, использовать в условии или вывести в поле формы. Процедура подходит, когда цель — изменить данные, провести документ, вывести сообщение или запустить последовательность операций.
Вызов функции в контексте, который не ожидает значения, может привести к ошибке компиляции или выполнения. Вызов процедуры внутри выражения, где требуется результат, недопустим. Перед написанием кода определите, какая задача стоит: вычислить или сделать.
Проверьте наличие оператора Возврат на всех путях выполнения
Убедитесь, что вызов не встроен в арифметическое выражение
Сравните данные с эталонным расчётом
Когда использовать функцию
Функция уместна для расчёта суммы, налога, остатка, срока или любого показателя, который повторяется в разных обработках. Она должна принимать входные параметры и возвращать одно значение определённого типа. Такой код легче тестировать: можно подать на вход известные данные и сравнить результат с ожидаемым.
Если функция не возвращает значение во всех ветках условий, платформа может выдать предупреждение или ошибку. Нужно обеспечить оператор Возврат на всех возможных путях выполнения, включая обработку исключений. Это требование предсказуемой работы конфигурации.
Как выбрать действие
Сценарий: расчёт показателя в отчёте
В отчёте можно вызвать функцию для каждой строки и подставить результат в колонку. Если алгоритм изменится, достаточно поправить функцию в одном месте, а не править каждый отчёт. Это снижает риск расхождений между формами.
Когда использовать процедуру
Процедура подходит для записи в регистры, проведения документов, заполнения табличных частей, вызова внешних сервисов или изменения интерфейса. Она может не иметь параметров и не возвращать результат. Основной признак — последовательность действий, а не получение значения.
Процедуру можно вызывать из команд формы, обработки событий, других процедур и функций. При вызове из функции нужно учитывать, что процедура не вернёт значение для дальнейшего вычисления. Не пытайтесь использовать вызов процедуры как часть арифметического выражения.
Параметры, возврат и видимость
Параметры могут передаваться по значению или по ссылке в зависимости от типа и контекста. Изменение параметра внутри процедуры может отразиться на исходной переменной, если используется передача по ссылке. Это удобно для возврата нескольких значений, но требует осторожности.
Видимость функций и процедур зависит от модуля: общий модуль, модуль объекта, модуль формы. Функции из общих модулей доступны в конфигурации при правильных настройках доступа. Не выносите в общие модули логику, которая тесно связана с одним документом, без необходимости.
Проверка результата перед использованием
После вызова функции проверьте, что возвращаемое значение не пустое и имеет ожидаемый тип, особенно если результат пришёл из запроса или внешнего источника. Использование неопределённого значения в вычислениях может привести к некорректным данным. Процедуру проверяйте по факту изменений: документы проведены, записи созданы, формы открыты.
Как проверить результат
Стабильный и ожидаемый результат
Разные результаты при одинаковых условиях
Отсутствие ошибок компиляции и выполнения
Необработанные исключения и предупреждения
Документы проведены, записи созданы
Частично выполненные действия без отката
Частые ошибки и границы самостоятельной работы
Частая ошибка — забыть оператор Возврат в функции или вернуть значение в неподходящей ветке. Вторая ошибка — вызывать процедуру там, где платформа ожидает функцию, например в вычисляемом поле. Третья — изменять данные в процедуре без понимания порядка проведения и блокировок.
Самостоятельная правка возможна для простых вычислений и действий в тестовой базе. Если затрагиваются регистры бухгалтерии, налоги, зарплата или закрытые периоды, изменения лучше согласовывать с ответственным за учёт и проверять на копии базы. Ошибка может привести к неверным отчётам или сложностям при восстановлении данных.
Что важно запомнить
Функция возвращает значение для вычислений, процедура выполняет действия. Проверяйте возврат на всех путях и тестируйте изменения на копии базы.
Можно ли вызывать процедуру внутри функции?
Да, процедуру можно вызвать из функции, но результат вызова процедуры нельзя использовать как значение в вычислениях. Функция всё равно должна сама вернуть значение через оператор Возврат.
Что делать, если функция не возвращает результат в какой-то ветке?
Добавьте оператор Возврат на все возможные пути выполнения, включая условия и обработку ошибок. Иначе платформа может считать код некорректным или вернуть неопределённое значение.
Когда переносить код в общий модуль?
Переносите в общий модуль логику, которая нужна в нескольких объектах или формах. Логику, связанную только с одним документом, оставляйте в модуле этого объекта, если нет общей необходимости.
Как проверить, что процедура отработала правильно?
Проверяйте не возвращаемое значение, а факт изменений: проведение документа, создание записи, изменение табличной части или открытие формы. Сравните состояние до и после вызова.