К статье
Практический материал

Другое · 5 мин

Добавление процедуры в документ 1С: порядок действий и проверка

Инструкция по добавлению процедуры в модуль документа 1С: где писать код, как сохранить и проверить, какие ограничения учитывать и где найти ошибки.

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

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

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

Где разместить процедуру документа

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

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

Модуль объектакод доступен во всех формах документа

Подходит для логики, не зависящей от интерфейса

Модуль формыкод привязан к конкретной форме

Подходит для обработки событий элементов формы

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

Откройте документ в конфигураторе, выберите «Модуль объекта» или «Модуль формы» в зависимости от задачи. В редакторе перейдите в нужное место, обычно в конец модуля, и введите объявление:

Процедура МояПроцедура(Параметр) Экспорт

// тело процедуры

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

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

Порядок добавления процедуры
  1. 1
    Откройте документ в конфигураторе и перейдите в нужный модуль
  2. 2
    Напишите объявление процедуры с параметрами
  3. 3
    Сохраните конфигурацию и выполните проверку компиляции
  4. 4
    Вызовите процедуру и убедитесь в результате

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

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

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

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

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

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

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

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

Типичные ошибки
01
Процедура описана в модуле формы, но вызывается из модуля объекта, где форма недоступна
02
Отсутствие директивы компиляции или опечатка в имени приводит к ошибке при сохранении
03
Изменения не сохранены в конфигурации, поэтому код не виден пользователям

Альтернативы и когда не стоит вносить изменения

Если логика нужна нескольким документам, рассмотрите общий модуль вместо дублирования процедуры в каждом документе. Общий модуль упрощает поддержку и уменьшает риск несоответствия кода.

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

Самостоятельная правка допустима на тестовой копии, с резервной копией и после проверки компиляции. В рабочей базе вносите изменения только после согласования и тестирования.

Сравнение вариантов размещения

Модуль объекта документа

Подходит для общей логики документа, доступен из форм и сервера

Модуль формы документа

Подходит для событий и команд конкретной формы, ограничен контекстом формы

Общий модуль

Подходит для логики, общей для нескольких документов, требует отдельного поддержания

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

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

Итог

Что важно запомнить

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

Нужно ли перезапускать 1С после добавления процедуры?

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

Можно ли вызывать процедуру из модуля объекта, если она описана в модуле формы?

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

Что делать, если конфигуратор не дает сохранить изменения?

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

Нужно ли помечать процедуру словом Экспорт?

Только если процедура должна быть видна из других модулей. Для внутреннего кода одного модуля слово Экспорт не обязательно.