Как в 1С настроить код выполняемой функции

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

Ошибки при настройке функций приводят к типичным проблемам: «Процедура или функция с указанным именем не определена», «Переменная не определена», нарушению контекста сервера и клиента. Чаще всего причина не в самом алгоритме, а в том, что функция размещена не в том модуле, не объявлена как экспортная или вызывается из недопустимого контекста.

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

Где в конфигураторе размещают код функции

Код функции в 1С нельзя написать «где угодно» — он всегда находится внутри модуля, а тип модуля определяет, откуда функцию можно вызвать. Основные варианты: общие модули, модули объектов (справочников, документов), модули форм, модули менеджеров и модули команд.

Общий модуль — самый частый выбор для функций, которые нужны в разных местах конфигурации. Общие модули создаются в ветке «Общие → Общие модули». В свойствах модуля задают флаги «Сервер», «Клиент (обычное приложение)», «Клиент (управляемое приложение)», «Вызов сервера» — от них зависит контекст исполнения.

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

Как создать функцию и объявить её доступной для вызова

Функция объявляется ключевым словом «Функция», за которым следуют имя, список параметров в скобках и тело, завершающееся «КонецФункции». Результат возвращается оператором «Возврат». Если функция должна вызываться из других модулей, после объявления добавляют слово «Экспорт» — без него функция видна только внутри своего модуля.

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

Функция РассчитатьСкидку(СуммаДокумента, ПроцентСкидки) Экспорт
	Если ПроцентСкидки > 100 Тогда
		ВызватьИсключение "Процент скидки не может превышать 100";
	КонецЕсли;
	Возврат СуммаДокумента * ПроцентСкидки / 100;
КонецФункции

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

Настройка параметров и возвращаемого значения

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

Для необязательных параметров задают значение по умолчанию: Функция НайтиКонтрагента(ИНН, ТолькоДействующие = Истина). Такой параметр можно не передавать при вызове. Важно: параметры со значениями по умолчанию должны стоять в конце списка, иначе вызов станет неоднозначным.

Возвращаемое значение формируется оператором «Возврат». Если функция завершилась без «Возврат», она вернёт «Неопределено» — это частый источник ошибок вида «попытка сложения с Неопределено». Хорошая практика — чтобы все ветки логики (все «Если...Иначе...») заканчивались возвратом осмысленного значения, включая ветку ошибки.

Директивы компиляции и контекст выполнения

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

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

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

Как привязать функцию к событию, кнопке или заданию

Сама по себе функция не выполняется — её должен кто-то вызвать. Основные способы привязки: обработчики событий формы, команды (кнопки), подписки на события и регламентные задания.

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

Подписка на событие. В ветке «Общие → Подписки на события» создайте подписку, укажите источник (например, документы) и событие (например, «ПриЗаписи»), а в поле «Обработчик» выберите экспортную процедуру серверного общего модуля. Так функция будет выполняться автоматически при каждом событии без изменения кода объектов.

Регламентное задание. В ветке «Общие → Регламентные задания» создайте задание и укажите в свойстве «Имя метода» экспортную процедуру общего модуля. Метод не должен принимать параметров. Расписание настраивается в консоли заданий уже в режиме предприятия.

1. 1
   Создайте резервную копию базы или работайте на тестовой копии
2. 2
   Откройте конфигуратор и выберите подходящий модуль (общий, объекта, формы)
3. 3
   Объявите функцию с параметрами, добавьте «Экспорт» при внешнем вызове
4. 4
   Реализуйте тело функции, завершив все ветки оператором «Возврат»
5. 5
   Укажите директиву компиляции для модулей формы
6. 6
   Привяжите функцию к событию, команде или регламентному заданию
7. 7
   Проверьте синтаксис (Ctrl+F7) и отладьте вызов в режиме отладки
8. 8
   Только после проверки обновите конфигурацию базы данных

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

Первый уровень проверки — синтаксический контроль модуля (меню «Конфигурация → Проверка конфигурации» или Ctrl+F7 в модуле). Он находит ошибки объявления, несуществующие методы и несоответствие контекстов. Второй уровень — отладка: запустите базу в режиме отладки, поставьте точку останова внутри функции и пошагово проверьте значения параметров и промежуточных переменных.

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

Частые вопросы