Другое · 6 мин
Как создать функцию в 1С: пошаговая инструкция
Создание функции в 1С: объявление в модуле, ключевое слово Экспорт, параметры, возврат результата, вызов и проверка на ошибки для начинающих.
Функция в 1С — именованный фрагмент кода, который принимает параметры и возвращает результат. Создавать её нужно в модуле конфигурации: общем модуле, модуле объекта, менеджера или формы, в зависимости от того, где будет использоваться логика.
Перед написанием определите, должна ли функция быть доступна из других модулей. Если да, добавьте модификатор Экспорт, иначе функция останется видимой только внутри своего модуля. После ввода кода модуль обязательно сохраняется и проверяется на синтаксис.
Что такое функция и где она хранится
Отличие функции от процедуры в том, что функция обязательно возвращает значение через оператор Возврат. Процедура может выполнять действия без возврата результата. Выбирайте функцию, когда нужно получить вычисленное значение, например сумму, дату или признак выполнения условия.
Место хранения зависит от области действия. Общий модуль подходит для логики, используемой в разных частях конфигурации. Модуль объекта или менеджера подходит для правил, связанных с конкретным справочником, документом или регистром. Модуль формы подходит для логики интерфейса, но его сложнее переиспользовать вне этой формы.
Как объявить функцию в модуле
Откройте конфигурацию в режиме Конфигуратор, найдите нужный модуль и откройте его на редактирование. Наберите заголовок в форме: Функция <Имя>(<Параметры>) Экспорт, затем тело функции и завершите конструкцией КонецФункции. В теле укажите вычисления и завершите оператором Возврат <Результат>.
Функция ВычислитьСкидку(Сумма, Процент) Экспорт
Возврат Сумма * Процент / 100;
КонецФункции
Если модификатор Экспорт опущен, функция будет доступна только внутри этого модуля. Для вызова из других модулей обычного общего модуля используется имя модуля и имя функции через точку. Сохраните модуль и выполните проверку синтаксиса, прежде чем использовать функцию в решениях.
- 1Определите модуль и область видимости функции
- 2Напишите заголовок с параметрами и модификатором Экспорт при необходимости
- 3Добавьте тело с вычислениями и оператором Возврат
- 4Сохраните модуль и проверьте синтаксис
- 5Вызовите функцию в тестовом сценарии и сверьте результат
Параметры и возврат значения
Параметры перечисляются в скобках через запятую. Можно описывать функции без параметров, если результат не зависит от входных данных. Типы параметров в 1С часто выводятся из контекста или указываются в зависимости от используемого подхода к разработке, поэтому избегайте жёстких предположений о типах без проверки в конкретной конфигурации.
Оператор Возврат завершает выполнение функции и передаёт результат вызывающему коду. Если функция не достигает Возврат из-за условия или ошибки, поведение может быть непредсказуемым. Продумайте все ветки кода, чтобы каждая возвращала допустимое значение или явно обрабатывала отсутствие результата.
Где вызывать функцию и контекст выполнения
Функцию из общего модуля с модификатором Экспорт вызывают по имени модуля: ИмяМодуля.ИмяФункции(Параметры). Функция модуля объекта вызывается в контексте этого объекта и может обращаться к его реквизитам. Функция формы доступна в рамках формы, но перенос такой логики в другой объект требует переноса кода в подходящий общий или объектный модуль.
Учитывайте контекст клиент-серверного взаимодействия: часть кода выполняется на клиенте, часть — на сервере. Если функция обращается к данным, уточните, где она будет вызываться, и не помещайте серверные операции в клиентский контекст без необходимости. Это помогает избежать ошибок выполнения и лишних обменов с сервером.
Проверка и отладка
После создания функции проверьте, что конфигуратор не выдаёт ошибок синтаксиса. Затем создайте простой тест: вызовите функцию с известными параметрами и сравните возвращаемое значение с ожидаемым. Если результат не совпадает, проверьте порядок операторов, условия и оператор Возврат.
Для поиска ошибок можно использовать отладчик, точки остановки или вывод промежуточных значений в сообщения, если это допустимо в текущей конфигурации. Не оставляйте отладочный код в рабочей конфигурации, так как он может замедлить работу или изменить поведение программы.
Как проверить результат
Ошибок синтаксиса нет
Конфигуратор подсвечивает ошибки или предупреждения
Возвращает ожидаемое значение
Возвращает неопределённое значение или ошибку выполнения
Функция видна при наличии Экспорт
Ошибка компиляции или функция не найдена
Частые ошибки и ограничения
Самая частая проблема — отсутствие модификатора Экспорт при необходимости вызова извне модуля. Вторая — функция существует, но не вызывается, потому что ошибка в имени модуля или неверный контекст выполнения. Третья — изменение данных внутри функции без понимания последствий для остальных документов и регистров.
Ограничение безопасности: самостоятельно вносите изменения только в те модули, логика которых вы понимаете. Если функция затрагивает документы, остатки или настройки учета, изменения лучше согласовать с ответственным за конфигурацию и проверить на резервной копии. Не редактируйте рабочую базу напрямую без понимания последствий.
Что важно запомнить
Функция создаётся в подходящем модуле, возвращает значение через Возврат, при необходимости помечается Экспорт, сохраняется и проверяется на синтаксис перед использованием.
Нужно ли всегда указывать Экспорт?
Нет. Экспорт нужен только если функция должна вызываться из других модулей. Если функция используется только внутри своего модуля, модификатор можно не указывать.
Можно ли создать функцию без параметров?
Да. Функция может не принимать параметры и возвращать значение, вычисленное из контекста или констант, но такие функции сложнее переиспользовать в разных ситуациях.
Что делать, если функция не компилируется?
Проверьте опечатки в имени функции, наличие КонецФункции, расстановку скобок и оператора Возврат. Сообщение конфигуратора обычно указывает на строку с ошибкой, начните проверку с неё.
Безопасно ли тестировать функцию в рабочей базе?
Не рекомендуется, особенно если функция изменяет данные. Используйте копию базы или отдельную тестовую конфигурацию, пока не убедитесь в корректности результата.