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

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

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

Инструкция применима к конфигурациям на управляемых формах (Управление торговлей, Бухгалтерия предприятия, ERP, Зарплата и управление персоналом и другие), работающим на актуальных версиях платформы 8.3.

Что такое расширение конфигурации и когда оно нужно

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

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

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

Подготовка: что проверить перед установкой

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

Третье условие — права. Устанавливать расширения может пользователь с правами администратора (роль «Администратор системы» или полные права в зависимости от конфигурации). В файловой базе достаточно монопольного доступа для некоторых операций, в клиент-серверной — прав на уровне кластера обычно не требуется, достаточно прав внутри информационной базы.

Обязательно сделайте резервную копию: для файловой базы — скопируйте файл 1Cv8.1CD, для клиент-серверной — выполните выгрузку в .dt через конфигуратор или средствами СУБД. Это единственный гарантированный способ откатиться, если что-то пойдёт не так.

Установка расширения через интерфейс 1С:Предприятия

Стандартный способ установки не требует конфигуратора и выполняется прямо в режиме предприятия. Откройте базу под пользователем с правами администратора и перейдите в меню «Все функции» (кнопка с «бургер»-иконкой или через меню «Сервис» в зависимости от интерфейса). Если пункт «Все функции» недоступен, включите его: «Сервис» → «Параметры» → флажок «Отображать команду "Все функции"».

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

1. 1
   Откройте базу под администратором и перейдите в «Все функции» → «Стандартные» → «Управление расширениями конфигурации»
2. 2
   Нажмите «Добавить» и выберите CFE-файл расширения
3. 3
   Если появится предупреждение безопасности, подтвердите открытие, убедившись в надёжности источника файла
4. 4
   Дождитесь появления расширения в списке и проверьте, что флажок активности установлен
5. 5
   Перезапустите сеанс 1С для применения расширения
6. 6
   Проверьте работу добавленной функциональности

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

Установка через конфигуратор

Альтернативный способ подходит администраторам и разработчикам. Откройте конфигуратор, перейдите в меню «Конфигурация» → «Расширения конфигурации». В открывшемся окне нажмите «Создать» (или «Добавить»), задайте имя расширения, затем через «Конфигурация» → «Загрузить из файла» выберите CFE-файл.

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

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

Параметры безопасности и профили безопасности

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

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

Проверка результата и обновление расширения

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

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

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

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

Норма

Флажок активности установлен, ошибок нет

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

Сообщение о несовместимости или неприменённых изменениях

Работа доработанной функции

Норма

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

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

Ошибка при открытии объекта или отсутствие ожидаемых элементов

Запуск сеанса другими пользователями

Норма

Пользователи входят в базу без ошибок

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

Ошибки при входе или падение сеанса

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

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

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

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

Если после установки расширения база перестала запускаться, действуйте так: запустите конфигуратор, откройте «Конфигурация» → «Расширения конфигурации», снимите активность с проблемного расширения или удалите его и сохраните изменения. В критических случаях поможет очистка расширений через параметр запуска или восстановление из резервной копии.

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

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

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

Снимет ли расширение конфигурацию с поддержки?

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

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

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

Как удалить расширение?

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

Почему после обновления конфигурации расширение перестало работать?

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

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

Да, количество расширений не ограничено. Но если два расширения изменяют один и тот же объект, применяется то, которое находится ниже в списке (имеет более высокий приоритет применения). Порядок можно менять кнопками перемещения в списке расширений.