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