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