Как применить расширение 1С: пошаговая инструкция

Расширение конфигурации — это файл с расширением .cfe, который изменяет поведение типовой конфигурации 1С без снятия её с поддержки. Через расширения добавляют печатные формы, дорабатывают документы, меняют алгоритмы проведения и подключают внешние обработки, при этом типовые обновления продолжают устанавливаться штатно. Это главный и самый безопасный способ доработки 1С в современных версиях платформы.

Применить расширение можно двумя способами: через пользовательский режим «1С:Предприятие» (подходит большинству бухгалтеров и администраторов) и через конфигуратор (нужен разработчикам и для тонкой диагностики). Оба способа описаны ниже с точным порядком действий и проверками результата.

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

Что такое расширение конфигурации и когда его применять

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

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

Подготовка: проверки перед подключением

Сначала убедитесь, что у вашей учётной записи есть права администратора — без них пункт управления расширениями будет недоступен. Затем проверьте версию платформы и конфигурации: расширение, собранное под другой релиз, может отказаться применяться или примениться с ошибками совместимости.

Сделайте резервную копию: в файловой базе достаточно скопировать файл 1Cv8.1CD при отсутствии активных сеансов, в клиент-серверной — выполните выгрузку через конфигуратор (Администрирование — Выгрузить информационную базу) или штатное средство СУБД. Это займёт несколько минут, но позволит откатиться за минуты, а не восстанавливать данные часами.

Применение расширения через режим «1С:Предприятие»

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

Нажмите «Добавить из файла» и укажите путь к CFE-файлу. Платформа загрузит расширение и покажет его в списке. Обратите внимание на колонку «Безопасный режим»: по умолчанию флажок установлен, и код расширения работает с ограничениями. Если доработке нужен доступ к файловой системе, COM-объектам или внешним компонентам, снимите флажок — но только если доверяете источнику.

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

1. 1
   Сделайте резервную копию информационной базы
2. 2
   Откройте Администрирование — Печатные формы, отчеты и обработки — Расширения
3. 3
   Нажмите «Добавить из файла» и выберите CFE-файл
4. 4
   Проверьте флажок безопасного режима и при необходимости снимите его
5. 5
   Перезапустите сеанс и проверьте работу доработки
6. 6
   Убедитесь, что типовые функции продолжают работать корректно

Применение расширения через конфигуратор

Разработчику удобнее работать через конфигуратор: там видны ошибки совместимости, контроль применимости и свойства расширения. Откройте конфигуратор, перейдите в меню «Конфигурация — Расширения конфигурации». В открывшемся окне выберите «Создать» для нового пустого расширения или загрузите готовое через «Конфигурация — Загрузить конфигурацию из файла» при активном расширении, указав CFE-файл.

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

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

Проверка результата после подключения

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

Затем проверьте смежные типовые механизмы: расширение, переопределяющее обработчики, может незаметно сломать другую функциональность. Особое внимание уделите обменам данными, регламентным заданиям и отчётам, затрагивающим изменённые объекты.

Контрольные точки

Как проверить результат

Статус расширения в списке

Норма

Флажок «Используется» установлен, ошибок применимости нет

Тревожный признак

Расширение отключено или отмечено как неприменимое

Работа доработанной функции

Норма

Новая форма, кнопка или алгоритм работают как задумано

Тревожный признак

Доработка не проявляется — вероятно, сеанс не перезапущен

Типовые механизмы

Норма

Проведение документов, отчёты и обмены работают как раньше

Тревожный признак

Ошибки в смежных функциях — расширение нужно отключить и доработать

Обновление и отключение расширения

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

Отключить расширение можно двумя способами: снять флажок «Используется» (доработка перестанет действовать, но файл останется в базе) или удалить расширение полностью. Первый вариант предпочтительнее при диагностике: если после отключения проблема исчезла, причина найдена, а вернуть доработку можно одним щелчком.

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

Типичные ошибки и ограничения

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

Помните об ограничениях: расширения не поддерживают некоторые изменения структуры данных, не работают в режиме совместимости со старыми версиями платформы и могут быть заблокированы настройками безопасности сервера 1С. В файловых базах с включённым режимом защиты от опасных действий система будет запрашивать подтверждение при добавлении расширения — это нормальное поведение, а не ошибка.

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

Можно ли подключить расширение, не прерывая работу пользователей?

Формально добавить файл в список можно и при активных сеансах, но доработка применится у пользователей только после перезахода в программу. Если расширение меняет структуру данных и требует реструктуризации, потребуется монопольный доступ — всех пользователей придётся попросить выйти.

Расширение добавлено, но доработка не видна. Что проверить в первую очередь?

Перезапустите сеанс, убедитесь, что флажок «Используется» установлен, и проверьте, в ту ли базу вы вошли. Затем посмотрите применимость расширения: если конфигурация обновлялась, платформа могла отметить его как несовместимое.

Чем расширение отличается от внешней обработки?

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

Безопасно ли снимать флажок безопасного режима?

Безопасно только для расширений из доверенного источника, код которых вы или ваш разработчик проверили. В безопасном режиме запрещены операции с файловой системой, COM и внешними компонентами — если доработке это не нужно, флажок лучше оставить включённым.

Что произойдёт с расширением при обновлении типовой конфигурации?

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

Можно ли вернуть всё как было, если расширение сломало работу базы?

Да. Отключите расширение, сняв флажок «Используется», или удалите его из списка — типовая конфигурация при этом не затрагивается. Если база перестала открываться, запустите конфигуратор и отключите расширение через меню «Конфигурация — Расширения конфигурации», а в крайнем случае восстановите базу из резервной копии.