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

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

Главная ошибка новичков — попытка обратиться к функции через ссылку вида Документы.РеализацияТоваров.МояФункция(). Ссылка — это только идентификатор записи в базе, она не содержит исполняемого кода. Чтобы получить доступ к экспортным функциям модуля объекта, нужно создать объект документа методом ПолучитьОбъект() или СоздатьДокумент().

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

Как устроен модуль объекта документа и почему функция не видна снаружи

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

Пример объявления экспортной функции в модуле объекта:

Функция РассчитатьСуммуСоСкидкой(ПроцентСкидки) Экспорт
	СуммаДокумента = Товары.Итог("Сумма");
	Возврат СуммаДокумента * (100 - ПроцентСкидки) / 100;
КонецФункции

Без Экспорт при попытке вызова извне платформа выдаст ошибку «Процедура или функция с указанным именем не определена». Это самая частая причина, почему «функция есть, а не вызывается».

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

Вызов функции на сервере через ПолучитьОбъект

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

1. 1
   Убедитесь, что функция в модуле объекта объявлена с Экспорт
2. 2
   Получите объект: ДокОбъект = СсылкаНаДокумент.ПолучитьОбъект()
3. 3
   Вызовите функцию: Результат = ДокОбъект.МояФункция(Параметр1)
4. 4
   Если функция меняла данные объекта — выполните ДокОбъект.Записать()
5. 5
   Проверьте результат и обработайте возможные исключения

Пример кода вызывающей стороны:

ДокОбъект = СсылкаНаДокумент.ПолучитьОбъект();
ИтоговаяСумма = ДокОбъект.РассчитатьСуммуСоСкидкой(10);
// Если функция изменила табличные части:
ДокОбъект.Записать(РежимЗаписиДокумента.Проведение);

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

Вызов функции из формы документа

Внутри управляемой формы документа данные объекта доступны через реквизит формы (обычно Объект), но это данные формы, а не объект документа. Прямой вызов Объект.МояФункция() на клиенте не сработает — у формы нет доступа к методам модуля объекта.

Рабочий способ — серверная процедура формы с преобразованием данных формы в объект:

&НаСервере
Процедура ПересчитатьНаСервере()
	ДокОбъект = РеквизитФормыВЗначение("Объект");
	Итог = ДокОбъект.РассчитатьСуммуСоСкидкой(ПроцентСкидки);
	ЗначениеВРеквизитФормы(ДокОбъект, "Объект");
КонецПроцедуры

Пара РеквизитФормыВЗначение / ЗначениеВРеквизитФормы выполняет сериализацию данных формы в прикладной объект и обратно. Это заметная по стоимости операция, поэтому не стоит вызывать её на каждое изменение поля — группируйте пересчёты.

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

Вызов функции для нового, ещё не записанного документа

Если документа в базе ещё нет, объект создаётся через менеджер документа:

НовыйДок = Документы.РеализацияТоваров.СоздатьДокумент();
НовыйДок.Дата = ТекущаяДатаСеанса();
// заполнение реквизитов и табличных частей
Итог = НовыйДок.РассчитатьСуммуСоСкидкой(5);
НовыйДок.Записать();

Экспортные функции модуля объекта доступны сразу после СоздатьДокумент() — записывать документ перед вызовом не требуется. Это удобно для расчётов «на лету» перед проведением.

Альтернатива: модуль менеджера и общие модули

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

// В модуле менеджера документа:
Функция РассчитатьСуммуСоСкидкой(СсылкаНаДокумент, ПроцентСкидки) Экспорт
	// расчёт через запрос по ссылке
КонецФункции

// Вызов откуда угодно на сервере:
Итог = Документы.РеализацияТоваров.РассчитатьСуммуСоСкидкой(Ссылка, 10);

Типичные ошибки и их диагностика

Большинство проблем при вызове функции модуля документа сводится к нескольким повторяющимся ситуациям.

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

FAQ