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