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