Как добавить процедуру в документ 1С

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

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

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

Где размещать процедуру: модуль объекта, форма или общий модуль

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

Модуль формы работает в контексте пользовательского интерфейса. Процедуры с директивой &НаКлиенте выполняются на компьютере пользователя и не имеют доступа к запросам и прямой работе с базой. Процедуры &НаСервере выполняются на сервере, но работают с данными формы, а не с объектом напрямую.

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

Подготовка: резервная копия и режим изменения конфигурации

Перед правкой откройте конфигуратор и выполните «Администрирование → Выгрузить информационную базу». Выгрузка в файл .dt — минимальная страховка: при ошибке вы сможете вернуть базу в исходное состояние. Для файловой базы достаточно скопировать файл 1Cv8.1CD при закрытых сеансах.

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

Добавление процедуры в модуль объекта документа

Откройте конфигуратор, в дереве конфигурации найдите ветку «Документы» и нужный вид документа. Кликните правой кнопкой и выберите «Открыть модуль объекта» — откроется редактор кода, где уже могут находиться обработчики событий вроде ОбработкаПроведения.

Добавьте процедуру по стандартному синтаксису встроенного языка. Локальная процедура доступна только внутри модуля, экспортная — из других модулей через объект документа.

Процедура ЗаполнитьПоУмолчанию(Параметр1) Экспорт
	// Тело процедуры
	Сообщить("Процедура выполнена");
КонецПроцедуры

Слово «Экспорт» указывайте только если процедуру нужно вызывать извне — например, из общего модуля или обработки. Лишние экспортные методы загромождают интерфейс объекта и затрудняют сопровождение.

1. 1
   Откройте конфигуратор и дерево конфигурации
2. 2
   Найдите документ в ветке «Документы»
3. 3
   Правой кнопкой — «Открыть модуль объекта»
4. 4
   Добавьте объявление процедуры с телом
5. 5
   Сохраните модуль и выполните синтаксическую проверку
6. 6
   Обновите конфигурацию базы данных (F7)
7. 7
   Проверьте работу на тестовом документе

Добавление процедуры в модуль формы документа

Если логика связана с интерактивной работой — например, пересчёт суммы при изменении цены — процедуру размещают в модуле формы. Откройте документ, перейдите на закладку «Формы», откройте основную форму и перейдите на закладку «Модуль» внизу окна редактора формы.

Каждая процедура в модуле формы требует директивы компиляции. Директива определяет, где будет выполняться код, и от этого зависит, какие возможности платформы доступны.

&НаКлиенте
Процедура ПересчитатьСумму(Команда)
	Объект.Сумма = Объект.Цена * Объект.Количество;
КонецПроцедуры

&НаСервере
Процедура ЗаполнитьОстаткиНаСервере()
	// Здесь доступны запросы к базе
КонецПроцедуры

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

Вызов процедуры и проверка результата

Из команд формы процедура подключается через палитру свойств команды: в свойстве «Действие» укажите имя процедуры. Для кнопки на управляемой форме платформа сама предложит создать обработчик — выберите «На клиенте» или «На клиенте и сервере» в зависимости от задачи.

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

После добавления кода выполните «Конфигурация → Проверка конфигурации» с включённой проверкой модулей — это выявит синтаксические ошибки и обращения к несуществующим методам до обновления базы. Затем обновите конфигурацию базы данных и протестируйте сценарий на копии.

Типичные ошибки и ограничения

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

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

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