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