Как добавить расширение в конфигурацию 1С

Расширение конфигурации — это механизм 1С, который позволяет добавлять или изменять функциональность типовой конфигурации без снятия её с поддержки. Доработки хранятся отдельно от основного кода, поэтому обновление конфигурации проходит без конфликтов и без риска потерять изменения. Расширение поставляется в виде файла с расширением .cfe, который загружается в информационную базу.

Подключить расширение можно двумя способами: через режим «Конфигуратор» и через режим «1С:Предприятие» (в типовых конфигурациях на базе БСП есть встроенная обработка управления расширениями). Оба способа дают одинаковый результат, но различаются по удобству и доступным настройкам безопасности.

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

Что проверить перед установкой расширения

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

Второе условие — резервная копия. Хотя расширение не изменяет основную конфигурацию, при ошибках в его коде возможны сбои в работе пользователей и даже повреждение данных, если расширение записывает что-то в базу. Для файловой базы достаточно скопировать файл 1Cv8.1CD, для клиент-серверной — сделать выгрузку .dt или резервную копию средствами СУБД.

Третий момент — источник файла. Расширение из непроверенного источника может содержать вредоносный код: расширения имеют доступ к данным базы и могут выполнять произвольные операции. Загружайте только файлы от разработчиков, которым доверяете, а при сомнениях — откройте расширение в конфигураторе на тестовой базе и просмотрите его состав и код.

Как добавить расширение через Конфигуратор

Это универсальный способ, который работает для любой конфигурации, даже самописной. Откройте базу в режиме «Конфигуратор» под пользователем с правами администратора. Убедитесь, что конфигурация открыта (меню «Конфигурация → Открыть конфигурацию»), иначе пункт работы с расширениями будет недоступен.

Далее перейдите в меню «Конфигурация → Расширения конфигурации». Откроется список подключённых расширений — у чистой типовой базы он может быть пустым или уже содержать расширения от поставщика. Нажмите кнопку «Добавить» (или клавишу Insert) — в списке появится новое пустое расширение.

Теперь, не закрывая список, выделите созданное расширение и в меню выберите «Конфигурация → Расширения конфигурации → Загрузить из файла» либо воспользуйтесь командой загрузки в окне свойств расширения. Укажите путь к файлу .cfe. После загрузки задайте понятное имя и префикс — они помогут отличать расширение от других.

Завершающий шаг — обновить конфигурацию базы данных (клавиша F7 или «Конфигурация → Обновить конфигурацию базы данных»). Без этого расширение загружено, но не применено. После обновления перезапустите сеансы пользователей, чтобы изменения вступили в силу.

1. 1
   Откройте базу в Конфигураторе и откройте конфигурацию
2. 2
   Перейдите: Конфигурация → Расширения конфигурации
3. 3
   Нажмите «Добавить», затем загрузите файл .cfe
4. 4
   Задайте имя и префикс расширения
5. 5
   Обновите конфигурацию базы данных (F7)
6. 6
   Перезапустите сеансы и проверьте работу функциональности

Как подключить расширение в режиме 1С:Предприятие

В типовых конфигурациях на базе Библиотеки стандартных подсистем (УТ, ERP, Бухгалтерия, ЗУП и другие) есть встроенный механизм подключения расширений без конфигуратора. Путь: «Администрирование → Печатные формы, отчеты и обработки → Расширения». Если пункта нет, проверьте, что включён функциональный опциональный механизм дополнительных отчетов и обработок, и что у пользователя есть права администратора.

В открывшемся списке нажмите «Добавить из файла» и выберите файл .cfe. Система может показать предупреждение безопасности — оно появляется, если расширение запрашивает небезопасные операции или профиль безопасности не настроен. После подтверждения расширение появится в списке со включённым флажком «Используется».

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

Проверка совместимости и контроль применения

После загрузки конфигуратор автоматически выполняет проверку применимости: платформа сравнивает заимствованные объекты расширения с объектами основной конфигурации. Если проверка не пройдена, в окне сообщений появятся ошибки вида «Объект не найден в основной конфигурации» или «Изменился тип реквизита».

Принудительно проверить применимость можно в списке расширений: выделите расширение и нажмите кнопку «Проверить возможность применения» (в разных версиях платформы она называется «Проверить» или находится в меню «Ещё»). Проверку рекомендуется запускать после каждого обновления основной конфигурации.

Косвенный признак корректной работы — функциональность расширения доступна пользователям: появились новые кнопки, отчёты, реквизиты или изменилось поведение форм. Если расширение в списке есть, флажок «Используется» установлен, но изменений в интерфейсе нет, проверьте права пользователей и перезапустите сеанс.

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

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

Статус в списке расширений

Норма

Флажок «Используется» установлен, ошибок применимости нет

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

Флажок сброшен или выводятся ошибки проверки

Проверка применимости

Норма

Сообщение об успешной проверке

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

Ошибки «объект не найден», «изменился тип»

Работа пользователей

Норма

Новая функциональность видна и работает в сеансе

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

Изменений нет даже после перезапуска сеанса

Типичные ошибки и их устранение

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

Вторая распространённая ситуация — конфликт нескольких расширений. Если два расширения изменяют один и тот же метод или форму, срабатывает то, которое выше в списке (порядок применения идёт снизу вверх, приоритет у верхнего). Проверьте порядок расширений и при необходимости переместите нужное выше.

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

Как отключить или удалить расширение

Временно отключить расширение можно, сняв флажок «Используется» в списке расширений — и в конфигураторе, и в режиме Предприятия. Само расширение при этом остаётся в базе, и его можно включить обратно в любой момент. Это удобно для диагностики: если после отключения проблема исчезла, причина была в расширении.

Полное удаление выполняется кнопкой «Удалить» в списке расширений конфигуратора с последующим обновлением конфигурации базы данных. Учтите: если расширение добавляло собственные объекты метаданных (справочники, регистры), данные этих объектов будут удалены вместе с расширением. Платформа предупредит об этом при обновлении — не подтверждайте удаление, пока не убедитесь, что данные не нужны.

Когда расширение не подходит и что делать вместо

Расширение имеет ограничения: через него нельзя изменять некоторые объекты и свойства, нельзя добавлять планы обмена, изменять роли отдельных объектов в полном объёме, а изменение структуры данных ограничено. Если задача требует глубокой переработки типовой логики, расширения может не хватить.

Альтернативы: для разовых отчётов и печатных форм используйте механизм внешних отчётов и обработок (.epf, .erf) — он проще и безопаснее. Для глубоких доработок, которые невозможно вынести в расширение, остаётся изменение основной конфигурации со снятием объектов с поддержки — но это усложнит последующие обновления, поэтому к такому решению прибегают только при реальной необходимости.

Сравнение вариантов доработки

Расширение конфигурации (.cfe)

Подходит для изменения форм, модулей, добавления реквизитов и отчётов; не ломает обновления; есть ограничения по объектам

Внешние отчёты и обработки (.epf/.erf)

Подходит для печатных форм, отчётов и сервисных обработок; не меняет конфигурацию вообще

Изменение основной конфигурации

Подходит для глубоких доработок; усложняет обновление и требует участия разработчика

Часто задаваемые вопросы

Можно ли добавить расширение, не останавливая работу пользователей?

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

Чем расширение отличается от внешней обработки?

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

После обновления конфигурации расширение отключилось. Что делать?

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

Можно ли посмотреть, что находится внутри файла расширения?

Да. Добавьте пустое расширение в конфигураторе, загрузите в него файл .cfe и откройте дерево объектов расширения — вы увидите заимствованные и добавленные объекты, а также весь программный код. Делать это лучше на тестовой базе.

Сколько расширений можно подключить к одной базе?

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

Нужны ли права администратора для подключения расширения?

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