Как подключить расширение 1С через конфигуратор

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

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

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

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

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

Проверьте версию платформы. Механизмы расширений активно развиваются: возможности, доступные в свежих релизах платформы 8.3, могут отсутствовать в старых. Если расширение использует новые объекты или свойства, на устаревшей платформе оно либо не загрузится, либо загрузится с ошибками применимости.

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

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

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

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

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

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

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

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

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

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

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

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

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

Как проверить результат подключения

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

Норма

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

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

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

Обновление конфигурации базы данных

Норма

Завершилось без ошибок, реструктуризация прошла

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

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

Работа в режиме 1С:Предприятие

Норма

Новые объекты и доработки расширения видны и работают

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

Ошибки при открытии форм, отсутствие ожидаемых изменений

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

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

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

Особенности для файловых и серверных баз

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

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

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

Если расширений несколько, давайте им осмысленные имена с префиксом автора или проекта, например «Интеграция_Склад_WMS». Через полгода по имени «Расширение1» никто не вспомнит, что оно делает и кого спрашивать при конфликте.

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

Чем подключение через конфигуратор отличается от подключения в режиме 1С:Предприятие?

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

Расширение загрузилось, но доработки не видны. Что делать?

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

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

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

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

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

Как полностью удалить расширение вместе с его данными?

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

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

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