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