Как добавить расширение в 1С через конфигуратор

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

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

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

Что такое расширение и когда его стоит использовать

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

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

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

Подготовка: что проверить перед добавлением расширения

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

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

Также убедитесь, что у вашего пользователя есть право «Администрирование» и «Изменение конфигурации» (или полные права). В файловой базе без пользователей это не критично, а в серверной без нужных ролей пункт меню расширений будет недоступен или работа завершится ошибкой прав доступа.

Создание нового расширения в конфигураторе

Откройте конфигуратор и войдите в нужную информационную базу. В главном меню выберите «Конфигурация» → «Расширения конфигурации». Откроется окно со списком подключённых расширений — на чистой базе оно будет пустым.

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

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

1. 1
   Сделайте резервную копию базы (выгрузка .dt или копия файла 1Cv8.1CD)
2. 2
   Откройте конфигуратор и меню «Конфигурация» → «Расширения конфигурации»
3. 3
   Нажмите «Создать», задайте имя, синоним и префикс расширения
4. 4
   Добавьте в расширение нужные объекты или заимствуйте их из основной конфигурации
5. 5
   Нажмите F7 и дождитесь обновления конфигурации базы данных
6. 6
   Запустите режим 1С:Предприятие и проверьте работу доработки

Загрузка готового расширения из файла .cfe

Если расширение разработано сторонним специалистом или на другой базе, оно передаётся в виде файла .cfe. Чтобы подключить его, откройте то же окно «Расширения конфигурации», нажмите кнопку «Загрузить из файла» (иконка со стрелкой или пункт в меню «Все действия») и укажите путь к файлу.

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

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

Подключение расширения через режим 1С:Предприятие

Альтернативный путь — без конфигуратора. В режиме 1С:Предприятие откройте «Все функции» (если пункт скрыт, включите его: Сервис → Параметры → «Отображать команду "Все функции"») и найдите стандартную обработку «Расширения» (или «Управление расширениями конфигурации» в разделе администрирования типовых конфигураций).

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

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

Сравнение способов подключения

Через конфигуратор

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

Через режим 1С:Предприятие

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

Проверка результата и типичные ошибки

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

Если что-то пошло не так, откройте журнал регистрации (Администрирование → Журнал регистрации) и найдите ошибки, связанные с расширением. Типичные сообщения: «Объект не обнаружен» (расширение ссылается на переименованный объект типовой конфигурации), «Конфликт имён» (префикс не задан или совпадает с существующим объектом), ошибки прав доступа при обращении к объектам расширения.

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

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

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

Список расширений в конфигураторе

Норма

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

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

Флажок снят платформой, в состоянии текст об ошибке совместимости

Режим 1С:Предприятие

Норма

Новые кнопки, отчёты и проверки работают под обычным пользователем

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

Доработка видна только администратору или выдаёт ошибку прав

Журнал регистрации

Норма

Нет ошибок, связанных с расширением, за время проверки

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

Ошибки «Объект не обнаружен» или исключения в модулях расширения

Обновление типовой конфигурации при подключённых расширениях

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

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

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

Держите расширения компактными: одно расширение — одна логическая задача (печатные формы отдельно, интеграции отдельно). Так проще находить источник ошибки, отключать проблемную доработку без потери остальных и переносить расширения между базами.

Удаление и отключение расширения

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

Для полного удаления выделите расширение в списке и нажмите «Удалить», затем снова выполните обновление конфигурации базы данных. Учтите: если расширение добавляло собственные объекты с данными (например, свой справочник), данные этих объектов будут удалены вместе с расширением без возможности восстановления — поэтому перед удалением убедитесь, что нужные сведения сохранены.

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

Можно ли добавить расширение, если конфигурация полностью на поддержке?

Да, именно для этого механизм и создан. Расширения не требуют снятия конфигурации с поддержки и не изменяют режим поддержки. Типовая конфигурация остаётся полностью замкнутой, а обновления устанавливаются штатно.

Почему кнопка «Расширения конфигурации» неактивна в конфигураторе?

Чаще всего причина в недостатке прав: у пользователя нет права на изменение конфигурации или администрирование. Также проверьте, что конфигурация открыта (Конфигурация → Открыть конфигурацию) — без открытого окна конфигурации часть пунктов меню недоступна.

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

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

Расширение загрузилось, но в режиме предприятия ничего не изменилось. Что делать?

Проверьте три вещи: нажата ли F7 после загрузки, установлен ли флажок «Используется» у расширения и перезапущен ли сеанс пользователя. Если всё выполнено, посмотрите журнал регистрации — возможно, расширение отключилось из-за ошибки совместимости.

Можно ли перенести расширение из одной базы в другую?

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

Опасно ли отключать безопасный режим у расширения?

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