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

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

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

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

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

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

Подготовка: права, резервная копия и настройки безопасности

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

Обязательно сделайте резервную копию базы (выгрузку .dt через конфигуратор или средствами СУБД для клиент-серверного варианта). Расширение с ошибками может вызвать сбои при запуске или в работе пользователей, и откат на копию — самый быстрый способ восстановления.

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

Способ 1: добавление расширения в режиме 1С:Предприятие

Этот способ не требует конфигуратора и подходит для установки готового файла .cfe пользователем с правами администратора.

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

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

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

Способ 2: подключение расширения через конфигуратор

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

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

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

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

// Проверка подключённых расширений из встроенного языка
Расширения = РасширенияКонфигурации.Получить();
Для Каждого Расш Из Расширения Цикл
    Сообщить(Расш.Имя + " — " + Расш.Версия);
КонецЦикла;

Настройка безопасности при подключении

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

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

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

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

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

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

Типичные ошибки и ограничения механизма

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

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

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