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

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

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

Что такое расширение и когда его стоит использовать

Расширение конфигурации (файл с расширением .cfe) содержит доработанные формы, процедуры, роли, печатные формы или новые объекты, которые накладываются поверх типовой конфигурации. Платформа объединяет типовые и расширенные объекты при запуске сеанса, поэтому исходная конфигурация физически не меняется.

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

Подготовка: что проверить перед подключением

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

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

Пошаговое подключение расширения

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

1. 1
   Откройте базу в режиме «Предприятие» под учётной записью администратора.
2. 2
   Перейдите: «Администрирование» → «Печатные формы, отчёты и обработки» → «Расширения».
3. 3
   Нажмите «Добавить из файла» и выберите файл с расширением .cfe.
4. 4
   Дождитесь загрузки: расширение появится в списке. Обратите внимание на колонку «Безопасный режим» — при необходимости снимите флаг.
5. 5
   Проверьте сообщения о конфликтах и предупреждениях в окне подключения.
6. 6
   Перезапустите сеанс: закройте программу и войдите снова, чтобы расширение применилось.

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

Безопасный режим и профили безопасности

По умолчанию расширения подключаются в безопасном режиме: в нём запрещены обращения к файловой системе, внешним компонентам и COM-объектам. Если расширение работает с файлами, оборудованием или внешними сервисами, безопасный режим придётся отключить — снимите соответствующий флаг в списке расширений. На серверных базах администратор кластера может дополнительно ограничивать расширения через профили безопасности.

Подключение через конфигуратор

Альтернативный способ — подключение через конфигуратор. Он удобен разработчику: позволяет сразу увидеть состав расширения, порядок применения и конфликты объектов. Откройте конфигуратор, в главном меню выберите «Конфигурация» → «Расширения конфигурации», затем «Создать» или загрузите готовый файл через пункт «Загрузить из файла».

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

Сравнение вариантов

Подключение из режима «Предприятие»

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

Подключение через конфигуратор

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

Проверка результата и типичные ошибки

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

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

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

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

Норма

Стоит отметка «Подключено», нет значков предупреждений

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

Жёлтый или красный значок, сообщение о несовместимости

Работа доработки после перезапуска

Норма

Новые кнопки, поля или печатные формы доступны и работают

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

Интерфейс не изменился или форма открывается с ошибкой

Журнал регистрации

Норма

Нет ошибок применения расширений

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

Ошибки вида «Обнаружены конфликты применения расширения»

Обновление, отключение и удаление расширения

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

Чтобы временно отключить расширение без удаления, снимите флаг «Подключено» в списке и перезапустите сеанс. Для полного удаления выделите расширение и нажмите «Удалить». Перед удалением убедитесь, что доработка действительно не используется: если сотрудники привыкли к кнопке или печатной форме из расширения, её исчезновение вызовет вопросы и остановку работы.

Частые вопросы

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

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

Почему расширение подключено, но изменений не видно?

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

Что произойдёт с расширением при обновлении конфигурации?

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

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

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

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

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