Расширение загружено, но не работает: включаем его в 1С 8.3

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

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

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

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

Перед активацией выясните у автора расширения (или посмотрите в его свойствах):

• 📌 Для какой конфигурации и какого релиза оно сделано. Расширение под БП 3.0 не заработает в УТ 11, а расширение под старый релиз может не встать на новый.
• 📌 Режим совместимости расширения. Он должен соответствовать режиму совместимости основной конфигурации. Расширение с более новым режимом база не примет.
• 📌 Назначение расширения: исправление, адаптация или дополнение. От этого зависит, как платформа отнесётся к нему при обновлении типовой.
• 📌 Нужен ли расширению небезопасный режим. Если оно работает с файлами на диске, внешними компонентами, COM-объектами или привилегированным режимом — в безопасном режиме эти функции работать не будут.

Совместимость с основной конфигурацией

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

Это главная причина, по которой расширение «вдруг перестало работать» после обновления релиза. Флажок при этом остаётся на месте.

Как установить и включить расширение в режиме «Предприятие»

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

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

Порядок действий

1. Откройте список расширений по пути из таблицы.
2. Нажмите кнопку добавления из файла и выберите файл расширения .cfe.
3. Если программа спросит про безопасный режим, оставьте его включённым, пока не убедитесь, что расширению нужен небезопасный.
4. Проверьте, что в строке расширения стоит флажок включения. В разных формах эта колонка называется «Активно» или «Подключено».
5. Закройте программу и откройте её заново. В формах БСП после добавления обычно сразу появляется предложение перезапустить — соглашайтесь.

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

💡 Если расширение уже есть в списке, но выключено, загружать файл повторно не нужно. Достаточно поставить флажок и перезапуститься.

Права пользователей и безопасный режим

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

Роли на новые объекты расширения

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

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

Признак проблемы с правами простой: администратор новый отчёт видит, а бухгалтер — нет.

Безопасный режим и защита от опасных действий

У каждого расширения есть два флажка:

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

Включение расширения через конфигуратор

Программист или администратор с доступом к конфигуратору управляет расширениями в отдельном окне: Конфигурация → Расширения конфигурации.

Загрузка и активация

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

В окне расширений видны и другие свойства:

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

Если расширение было выключено флажком

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

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

Самые частые ситуации — в диагностике ниже. Выберите симптом, похожий на ваш.

После обновления типовой конфигурации

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

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

Как убедиться, что расширение заработало

Активный флажок ещё не гарантия. Проверьте по делу:

1. Перезапустите 1С и откройте то место, которое дорабатывает расширение: новую печатную форму, реквизит в документе, отчёт.
2. Вернитесь в список расширений и убедитесь, что у строки нет отметки или сообщения о проблеме применения.
3. Зайдите под обычным пользователем, а не под администратором, — так вы проверите права.
4. Если расширение исправляет ошибку типовой, повторите сценарий, на котором ошибка возникала.

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

Расширения в клиент-серверной базе и в облаке

Клиент-серверный вариант

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

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

Облачные базы

В облаке (1С:Фреш и сервисы на его основе, а также аренда у партнёров) всё зависит от провайдера:

• ☁️ Сервисы с разделением данных обычно не дают загрузить произвольный .cfe. Расширение должно пройти проверку поставщика сервиса, после чего его включают из каталога или по заявке.
• ☁️ Аренда выделенного сервера или базы работает как обычная клиент-серверная база : включаете сами, по шагам выше, если у вашей учётной записи есть права администратора.

Если в облачной базе кнопка добавления расширения недоступна, это ограничение тарифа или сервиса, а не ошибка. Решение — обращение к провайдеру.

Автоматическая установка расширений для программистов

Когда баз много или расширение обновляется часто, ручная загрузка становится узким местом. Есть два способа автоматизации.

Пакетный режим конфигуратора

Загрузка и применение расширения из командной строки — те же два шага, что и вручную:

"C:\Program Files\1cv8\8.3.25.1445\bin\1cv8.exe" DESIGNER /S"srv1c\buh" /N"Администратор" /P"пароль" /LoadCfg "D:\ext\Доработки.cfe" -Extension "Доработки" /Out "D:\ext\load.log"

"C:\Program Files\1cv8\8.3.25.1445\bin\1cv8.exe" DESIGNER /S"srv1c\buh" /N"Администратор" /P"пароль" /UpdateDBCfg -Extension "Доработки" /Out "D:\ext\update.log"

Для файловой базы вместо /S"сервер\база" укажите /F"D:\Bases\Buh". Номер версии в пути замените на свой. Результат смотрите в лог-файле из параметра /Out.

Встроенный язык

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

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

Для загрузки нового файла используют РасширенияКонфигурации.Создать(), а затем Записать() с двоичными данными .cfe. Изменения, как и при ручной установке, вступают в силу в новом сеансе.

💡 В типовых конфигурациях на БСП лучше пользоваться штатной формой списка расширений: она дополнительно проверяет применимость и предлагает перезапуск. Прямая запись через РасширенияКонфигурации всё это пропускает.

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