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

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

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

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

Где в 1С размещается код функции

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

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

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

Как добавить функцию в общий модуль

Общий модуль — самый универсальный вариант. Порядок действий в конфигураторе:

1. Откройте конфигурацию: Конфигурация → Открыть конфигурацию.
2. В дереве конфигурации найдите ветку Общие → Общие модули.
3. Добавьте новый модуль (правой кнопкой — Добавить) или откройте существующий.
4. Задайте имя модуля, например РасчетыСервер, и настройте флажки: Сервер, Вызов сервера (если функции будут вызываться с клиента).
5. Дважды щёлкните по модулю и в редакторе кода добавьте функцию.

Пример простой функции:

Функция РассчитатьСуммуСНДС(Сумма, СтавкаНДС) Экспорт

Если СтавкаНДС = 0 Тогда
Возврат Сумма;
КонецЕсли;

Возврат Сумма + Сумма * СтавкаНДС / 100;

КонецФункции

Ключевое слово Экспорт делает функцию доступной из других модулей. Без него функция видна только внутри своего модуля. Вызов из любого места конфигурации выглядит так:

ИтоговаяСумма = РасчетыСервер.РассчитатьСуммуСНДС(10000, 20);

Функция РассчитатьСуммуСНДС(Сумма, СтавкаНДС) Экспорт
	Возврат Сумма + Сумма * СтавкаНДС / 100;
КонецФункции

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

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

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

&НаКлиенте
Процедура ПересчитатьИтоги(Команда)

Итог = РассчитатьИтогНаСервере();
ПоказатьОповещениеПользователя("Итог: " + Итог);

КонецПроцедуры

&НаСервере
Функция РассчитатьИтогНаСервере()

Возврат Объект.Товары.Итог("Сумма");

КонецФункции

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

Вызов функции из других модулей

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

• Из общего модуля: ИмяМодуля.ИмяФункции(Параметры).
• Из модуля объекта внутри самого объекта — просто по имени функции.
• Из модуля формы к функции общего модуля — через имя модуля, при этом у общего модуля должен стоять флажок Вызов сервера, если вызов идёт с клиента.

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

Проверка и отладка кода функции

После добавления функции выполните последовательность проверок:

1. Сохраните модуль и обновите конфигурацию базы данных: Конфигурация → Обновить конфигурацию базы данных (клавиша F7).
2. Проверьте синтаксис: Конфигурация → Проверка конфигурации или кнопка проверки модуля в редакторе кода.
3. Запустите отладку (F5), поставьте точку останова внутри функции (F9) и вызовите её в режиме «Предприятие».
4. Убедитесь, что параметры приходят в ожидаемом виде, а оператор Возврат срабатывает во всех ветках логики.

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

Типичные ошибки при размещении функций

Большинство проблем связано не с самим кодом, а с местом его размещения и видимостью:

• Забыто слово Экспорт — функция есть, но из других модулей не видна. Ошибка «функция не определена».
• Неверная директива компиляции — серверный код помещён в клиентскую функцию или наоборот.
• Имя функции совпадает с существующей в том же модуле — платформа сообщит о дублировании.
• Вызов серверного общего модуля с клиента без флажка «Вызов сервера».
• Изменение типовых модулей без расширения — потеря кода при обновлении конфигурации.

Альтернативы: расширения и внешние обработки

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

Второй вариант — внешняя обработка (файл .epf). Она подходит, когда код нужен как отдельный инструмент: откройте Файл → Новый → Внешняя обработка, добавьте форму и разместите функции в её модуле. Внешняя обработка не требует изменения конфигурации вообще, но её функции недоступны из модулей конфигурации.

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