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