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