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