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