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