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