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

Другое · 5 мин

Добавление общего модуля в расширение 1С

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

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

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

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

Когда общий модуль выносится в расширение

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

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

Подготовка и открытие расширения для редактирования

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

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

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

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

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

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

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

В карточке модуля настройте флаги «Сервер», «Клиент», «Внешнее соединение» и другие свойства, которые определяют доступность кода на разных уровнях приложения.

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

Проверка результата и публикация изменений

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

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

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

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

Открытие модуля в редакторе
Норма

Модуль отображается в ветке расширения и доступен для правки

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

Ветка отсутствует или модуль открыт только для чтения

Вызов процедуры из объекта расширения
Норма

Процедура выполняется и возвращает ожидаемый результат

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

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

Если проверка прошла успешно, зафиксируйте версию расширения и уведомите пользователей о новом функционале.

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

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

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

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

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

Отсутствие экспорта делает процедуру невидимой для других объектов, хотя модуль сохранён без ошибок.

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

Соблюдение регламента обновления и тестирования на копии снижает риск потери данных и простоев при вводе в эксплуатацию.

Итог

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

Добавляйте модуль в ветку расширения, проверяйте уникальность имени и контекст выполнения, тестируйте на копии и переносите изменения только после проверки.

Можно ли добавить общий модуль в любое расширение?

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

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

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

Что делать, если модуль не виден после сохранения?

Проверьте ветку расширения, признак экспорта, контекст выполнения и обновите конфигурацию; возможно потребуется переоткрыть сеанс.

Можно ли править общий модуль базовой конфигурации через расширение?

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

Как перенести расширение в рабочую базу?

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