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

Другое · 7 мин

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

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

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

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

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

Что понимать под модулем в 1С

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

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

Где создавать общий модуль

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

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

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

Создание модуля объекта конфигурации

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

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

Свойства модуля и контекст выполнения

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

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

Типичные ошибки
01
Размещение серверного кода в клиентском контексте и наоборот
02
Изменение стандартной конфигурации без резервной копии и режима поддержки
03
Избыточное число экспортируемых процедур без документации

Проверка синтаксиса и отладка

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

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

Контрольные точки

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

Модуль отображается в дереве конфигурации
Норма

Нет значков ошибок рядом с модулем

Тревожный признак

Модуль помечен ошибкой или отсутствует после сохранения

Экспортируемая процедура вызывается из другого модуля
Норма

Вызов выполняется без ошибок синтаксиса и выполнения

Тревожный признак

Ошибка компиляции или процедура не найдена

Код работает в целевом клиентском приложении
Норма

Одинаковый результат в толстом, тонком или веб-клиенте

Тревожный признак

Ошибка только в одном из клиентских режимов

Ограничения и безопасные изменения

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

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

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

Итог

Итог

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

Можно ли создать модуль прямо в режиме предприятия?

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

Нужно ли всегда использовать расширение конфигурации?

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

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

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

Как понять, что модуль работает корректно после обновления?

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