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