Другое · 7 мин
Создание модуля в конфигурации 1С: порядок действий и проверка
Пошаговое руководство по созданию модуля в 1С: где добавлять общий и объектный модуль, как настроить контекст, проверить синтаксис и отладить код без риска для конфигурации.
Модуль в 1С не является отдельным файлом в привычном смысле: это часть конфигурации, в которой описываются процедуры и функции. Общий модуль используется для хранения повторно используемой логики, объектный модуль привязан к конкретному объекту конфигурации, а модуль формы или менеджера отвечает за логику интерфейса и работы с набором данных. Перед созданием важно определить, где именно будет выполняться код и какую задачу он должен решать.
Выбор типа модуля зависит от области применения. Если процедура нужна в нескольких подсистемах и не привязана к одному справочнику или документу, подходит общий модуль. Если код должен обрабатывать события объекта, например запись или удаление документа, логику размещают в модуле этого объекта. Для реакции на действия пользователя в форме используется модуль формы, а для операций над набором записей — модуль менеджера.
Работа ведётся в Конфигураторе при открытой конфигурации в режиме редактирования. Перед любыми изменениями рекомендуется сделать резервную копию информационной базы или конфигурации, а испытания проводить на копии, а не в рабочей базе. Если конфигурация защищена режимом поддержки, изменение стандартных объектов может быть ограничено, и тогда целесообразно использовать расширение конфигурации, если платформа и режим работы это позволяют.
Что понимать под модулем в 1С
Модуль содержит набор процедур и функций, которые могут быть экспортированными или локальными. Экспортируемые элементы видны из других модулей конфигурации, локальные доступны только внутри текущего модуля. Это позволяет выносить общие расчёты, формирование документов, обмен данными и проверки в отдельные блоки, избегая дублирования кода.
Различие между общим и объектным модулем влияет на способы вызова. Общий модуль вызывается по имени из любого места конфигурации, где доступен его контекст. Объектный модуль связан с экземпляром объекта: в нём можно обрабатывать события ПередЗаписью, ПриЗаписи, Удаление и другие, а также обращаться к реквизитам этого объекта через контекстную переменную.
Где создавать общий модуль
В дереве конфигурации раздел «Общие модули» предназначен для создания переиспользуемого кода. Создание выполняется через контекстное меню раздела, после чего открывается редактор модуля. В свойствах нового модуля указывают имя, синоним и контекст выполнения: сервер, клиент, толстый клиент, тонкий клиент или веб-клиент. Набор доступных свойств зависит от поддерживаемых режимов работы конфигурации.
После написания кода модуль сохраняется в конфигурации, а затем конфигурация обновляется в режиме предприятия. Если синтаксис содержит ошибки, конфигурация не будет принимать изменения до их устранения. Практический признак успешного создания — появление модуля в дереве конфигурации без значков ошибок и возможность обратиться к его экспортированным процедурам из других объектов.
- 1Открыть Конфигуратор и раздел «Общие модули»
- 2Создать новый модуль и задать имя и синоним
- 3Выбрать подходящий контекст выполнения
- 4Написать процедуры и функции в редакторе модуля
- 5Проверить синтаксис и обновить конфигурацию
- 6Протестировать вызов модуля на копии базы
Создание модуля объекта конфигурации
Для справочника, документа, плана обмена или другого объекта модуль создаётся внутри самого объекта. В дереве конфигурации открывают ветку соответствующего типа объектов, выбирают нужный элемент и переходят к его модулю. Если модуль ещё не создан, Конфигуратор предлагает добавить его. В модуле объекта доступны события жизненного цикла и реквизиты экземпляра.
Важно не путать модуль объекта с модулем менеджера. Модуль объекта работает с конкретной записью, а модуль менеджера — с набором записей и операциями над ними, например выборкой или созданием нового объекта. Неправильный выбор места размещения кода приводит к тому, что процедура не вызывается в нужный момент или не имеет доступа к необходимым данным.
Свойства модуля и контекст выполнения
Контекст определяет, на каком приложении может выполняться код: только на сервере, только на клиенте или в обоих режимах. Серверный код подходит для операций с базой данных и расчётов, клиентский — для работы с формой и взаимодействия с пользователем. Если процедура вызывается в неподдерживаемом контексте, возникает ошибка выполнения или недоступность метода.
Также настраиваются права доступа и видимость процедур. Экспортные процедуры можно вызывать из других модулей, но избыточное число экспортируемых элементов усложняет поддержку. Рекомендуется выносить наружу только то, что действительно нужно другим частям конфигурации, а вспомогательную логику делать локальной.
Проверка синтаксиса и отладка
После написания кода выполняется проверка синтаксиса. Конфигуратор указывает на строки с ошибками, пропущенными скобками, неопределёнными переменными или неправильными вызовами. Модуль не сохраняется и конфигурация не обновляется, пока все критические ошибки не устранены. Предупреждения не всегда блокируют сохранение, но могут сигнализировать о потенциальных проблемах в работе.
Отладка ведётся в режиме предприятия на отдельной копии информационной базы. Можно использовать точки остановки, просмотр значений переменных и пошаговое выполнение, если это поддерживается используемым режимом запуска. Перед вводом в эксплуатацию проверяют вызовы модуля в разных клиентских приложениях, если код должен работать и в толстом, и в тонком клиенте.
Как проверить результат
Нет значков ошибок рядом с модулем
Модуль помечен ошибкой или отсутствует после сохранения
Вызов выполняется без ошибок синтаксиса и выполнения
Ошибка компиляции или процедура не найдена
Одинаковый результат в толстом, тонком или веб-клиенте
Ошибка только в одном из клиентских режимов
Ограничения и безопасные изменения
Не все конфигурации позволяют свободно создавать и править модули. В типовых решениях с режимом поддержки прямое редактирование объектов может быть заблокировано или откатано при обновлении. В таких случаях правильнее создать расширение конфигурации, добавить туда нужный модуль и подключить расширение к базе. Если расширение невозможно, изменения вносятся только после согласования с поставщиком конфигурации.
Самостоятельная разработка допустима для типовых задач: выноса общих расчётов, обработки событий объектов, работы с формами. Обращаться к специалистам стоит при изменении механизмов обмена, интеграции с внешними системами, работе с закрытыми частями типовых конфигураций или при любом вмешательстве, которое может затрагивать накопленные данные.
Что важно запомнить
Итог
Модуль создаётся внутри конфигурации, тип и контекст выбираются под задачу, перед правками делается копия базы, а результат проверяется на отдельной информационной базе перед вводом в работу.
Можно ли создать модуль прямо в режиме предприятия?
Нет, создание и редактирование модулей выполняются в Конфигураторе. В режиме предприятия можно только использовать уже созданные и обновлённые модули, если конфигурация допускает такие изменения.
Нужно ли всегда использовать расширение конфигурации?
Не всегда. Расширение предпочтительно для типовых защищённых конфигураций, но в собственных или не защищённых конфигурациях модуль можно добавить напрямую, соблюдая резервное копирование и тестирование на копии.
Что делать, если модуль не сохраняется из-за ошибки синтаксиса?
Нужно открыть редактор модуля, найти строки, указанные Конфигуратором, исправить опечатки, неопределённые переменные или неправильные вызовы, повторно проверить синтаксис и только потом сохранять конфигурацию.
Как понять, что модуль работает корректно после обновления?
Признаком корректной работы является отсутствие ошибок при компиляции, успешный вызов экспортируемых процедур и одинаковый результат в тех клиентских приложениях, для которых предназначен контекст модуля. Финальная проверка проводится на копии рабочей базы.