Файл .cf конфигурации: просмотр, загрузка в базу и разбор по модулям

· 9 мин

Содержание

Открыть CF файл в 1С 8.3 можно только через Конфигуратор: запустите любую базу в режиме Конфигуратор и выберите Файл → Открыть, указав файл .cf. Если нужно не посмотреть, а перенести конфигурацию в базу, используйте Конфигурация → Загрузить конфигурацию из файла.

Типичная ситуация: франчайзи прислал доработанную конфигурацию одним файлом 1Cv8.cf, и бухгалтер дважды щёлкает по нему в проводнике. Ничего не происходит: Windows не знает, чем открыть такой файл. Файл конфигурации — это не документ и не база. Это упакованный набор метаданных, форм и модулей, и прочитать его умеет только платформа 1С:Предприятие.

С чего начать: что нужно перед открытием CF

Перед работой проверьте три вещи.

  • 🧩 Установлена платформа 1С:Предприятие 8.3 с компонентом «1С:Предприятие — Конфигуратор» (он ставится вместе с толстым клиентом).
  • 🗂 Есть информационная база, через которую можно зайти в Конфигуратор. Для просмотра подойдёт пустая учебная база — рабочую трогать не нужно.
  • 🔢 Версия платформы не ниже той, в которой файл сохранён, и не ниже режима совместимости конфигурации. Узнать версию своей платформы можно в Конфигураторе: Справка → О программе.

Чтобы не рисковать рабочими данными, создайте отдельную пустую базу: в окне запуска Добавить → Создание новой информационной базы → Создание информационной базы без конфигурации. Она займёт пару мегабайт и пригодится для всех экспериментов с CF-файлами.

Сразу о том, чем отличаются способы. Выбор зависит от задачи, а не от вкуса.

ЗадачаСпособЗатрагивает базу?
Посмотреть объекты и кодФайл → ОткрытьНет
Заменить конфигурацию базыЗагрузить конфигурацию из файлаДа, полностью
Перенести часть доработокСравнить, объединить с конфигурацией из файлаДа, выборочно
Обновить типовую на поддержкеПоддержка → Обновить конфигурациюДа
Разобрать в текстовые файлыВыгрузить конфигурацию в файлы (после загрузки)Нет

Как открыть файл конфигурации в Конфигураторе для просмотра

Этот способ ничего не меняет в базе. Файл открывается в отдельном дереве, рядом с основной конфигурацией.

  1. В окне запуска выберите любую базу (лучше пустую) и нажмите кнопку Конфигуратор.
  2. В меню выберите Файл → Открыть (или Ctrl+O).
  3. В поле типа файлов укажите «Файл конфигурации (*.cf)» и выберите нужный файл.
  4. Откроется окно с деревом метаданных: справочники, документы, регистры, общие модули.

Дальше работайте как с обычной конфигурацией: открывайте модули, смотрите формы, ищите по тексту через Правка → Найти или глобальный поиск.

Этот режим годится для просмотра и анализа. Свойства объектов и тексты модулей видно сразу. Править конфигурацию здесь не стоит: изменения в открытом файле не попадут ни в одну базу.

Если вместо кода модуля вы видите пустое окно или сообщение об отсутствии исходного текста, разработчик поставил конфигурацию без исходных текстов части модулей. Это защита авторских прав, а не повреждение файла. Восстановить текст из такого файла нельзя — запросите у разработчика версию с открытым кодом.

Где взять CF-файл типовой конфигурации

Дистрибутив обновления типовой конфигурации обычно приходит в виде установщика setup.exe. После установки шаблон оказывается в каталоге шаблонов, по умолчанию %APPDATA%\1C\1cv8\tmplts\1c\<имя конфигурации>\<номер версии>\. Там лежат 1Cv8.cf (полная конфигурация) и 1Cv8.cfu (файл обновления).

Путь к каталогу шаблонов можно проверить в окне запуска: Настройка → поле с каталогами шаблонов конфигураций и обновлений.

Загрузка CF в информационную базу

Если цель — работать с конфигурацией из файла как с программой (вводить данные, проверять отчёты), её нужно загрузить в базу.

Загрузка полностью заменяет конфигурацию базы. Перед этим сделайте выгрузку базы в .dt или резервную копию сервера СУБД.

  1. Сделайте копию: Администрирование → Выгрузить информационную базу, сохраните .dt.
  2. Выберите Конфигурация → Открыть конфигурацию, если дерево ещё не открыто.
  3. Выберите Конфигурация → Загрузить конфигурацию из файла и укажите файл .cf.
  4. Подтвердите замену. Если текущая конфигурация стоит на поддержке, программа задаст вопрос о постановке новой на поддержку — для типовой ответьте утвердительно.
  5. Выполните Конфигурация → Обновить конфигурацию базы данных (F7).
  6. Просмотрите список изменений структуры и нажмите Принять.

На шаге 5 платформа может потребовать монопольный доступ, если меняется структура таблиц. В файловой базе это значит, что из неё должны выйти все пользователи.

Для разовой проверки чужого CF удобнее новая база: в окне запуска выберите Добавить → Создание новой информационной базы, затем создание из шаблона или пустую базу, и загрузите в неё файл. Рабочая база останется нетронутой.

Если загрузить CF в базу с данными от другой конфигурации, данные с изменившейся структурой могут быть удалены при обновлении. Список удаляемых объектов показывается в окне реорганизации — читайте его, прежде чем нажимать Принять.

Сравнение и объединение с конфигурацией из файла

Это способ для доработанных баз. Он позволяет взять из файла только нужное, например одну обработку или исправленный модуль, а остальное оставить как есть.

  1. Откройте основную конфигурацию базы.
  2. Выберите Конфигурация → Сравнить, объединить с конфигурацией из файла и укажите .cf.
  3. Если конфигурации не связаны поддержкой, программа предложит выбрать режим сопоставления объектов — обычно выбирают сопоставление по именам.
  4. В окне сравнения флажками отметьте объекты, которые нужно перенести.
  5. Для изменённых модулей откройте контекстное меню и посмотрите различия по тексту — там же можно настроить объединение по отдельным процедурам.
  6. Нажмите Выполнить, затем обновите конфигурацию базы данных (F7).

Если нужно только посмотреть разницу без переноса, в том же окне ничего не отмечайте и закройте его. Ещё удобнее: Конфигурация → Сравнить конфигурации — там можно сравнить основную конфигурацию с файлом и сформировать отчёт о различиях, который сохраняется в текстовый файл или табличный документ.

Обновление типовой конфигурации через CF

Для конфигураций на поддержке используется отдельная команда: Конфигурация → Поддержка → Обновить конфигурацию. В мастере выберите «Выбор файла обновления» и укажите .cf или .cfu. Платформа сама сравнит поставщика, ваши доработки и новую версию.

Выгрузка конфигурации в XML-файлы для анализа

Когда нужно поискать по коду внешними инструментами, сравнить версии в Git или просто прочитать модули в текстовом редакторе, конфигурацию разбирают на файлы.

Напрямую из .cf такая выгрузка не делается. Порядок такой:

  1. Загрузите CF в пустую базу (см. раздел выше).
  2. Выберите Конфигурация → Выгрузить конфигурацию в файлы.
  3. Укажите пустой каталог и формат выгрузки.
  4. Дождитесь окончания: типовая Бухгалтерия разворачивается в десятки тысяч файлов.

На выходе получите XML-описания объектов и модули в файлах .bsl. Их открывают любой редактор, VS Code с расширением для языка 1С или 1С:EDT.

Обратная операция — Конфигурация → Загрузить конфигурацию из файлов. После правок в XML можно собрать конфигурацию обратно и сохранить её в новый CF через Конфигурация → Сохранить конфигурацию в файл.

Для быстрого взгляда без платформы есть сторонняя утилита с открытым кодом v8unpack: она распаковывает .cf, .cfu и .epf в каталог с внутренними файлами контейнера. Модули получаются читаемыми, но структура менее удобна, чем в XML-выгрузке. Параметры запуска смотрите в справке самой утилиты.

Командная строка 1cv8: работа с CF без открытия окон

Пакетный режим Конфигуратора нужен, когда операцию надо повторять: ночная сборка, обновление десятка баз, проверка поставки. Исполняемый файл — 1cv8.exe из каталога bin нужной версии платформы.

Загрузить CF в файловую базу и сразу обновить конфигурацию БД:

"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" DESIGNER ^
  /F "D:\Bases\Test" /N "Администратор" /P "" ^
  /LoadCfg "D:\Dist\1Cv8.cf" /UpdateDBCfg ^
  /Out "D:\Logs\loadcfg.log" /DisableStartupDialogs

Номер версии в пути замените на свой. Для серверной базы вместо /F используется /S "сервер\имя_базы".

Основные параметры для работы с файлами конфигурации:

ПараметрЧто делает
/LoadCfg <файл>загружает конфигурацию из CF в базу
/UpdateDBCfgобновляет конфигурацию базы данных
/DumpCfg <файл>сохраняет конфигурацию базы в CF
/DumpConfigToFiles <каталог>выгружает конфигурацию в XML-файлы
/LoadConfigFromFiles <каталог>загружает конфигурацию из XML-файлов
/Out <файл>пишет результат и ошибки в лог
/DisableStartupDialogsотключает стартовые диалоги

Выгрузить конфигурацию рабочей базы в CF для архива:

"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" DESIGNER ^
  /F "D:\Bases\Buh" /N "Администратор" /P "" ^
  /DumpCfg "D:\Archive\buh_backup.cf" /Out "D:\Logs\dumpcfg.log"

Пакетный режим не выводит окон с ошибками. Всегда смотрите лог из /Out: код возврата и строки в нём — единственный способ понять, что пошло не так. Полный список параметров есть во встроенной справке платформы, раздел о параметрах командной строки.

Если /UpdateDBCfg потребует монопольного доступа, а в базе работают пользователи, обновление не выполнится. Запускайте такие сценарии в нерабочее время и предупреждайте коллег: их сеансы придётся завершить.

Чем CF отличается от CFU, DT и CFE

Путаница с расширениями — частая причина вопроса «файл не открывается». Платформа открывает каждый формат своей командой.

РасширениеЧто внутриГде открывать
.cfполная конфигурация без данныхФайл → Открыть, Загрузить конфигурацию из файла
.cfuфайл обновления: разница между версиямиКонфигурация → Поддержка → Обновить конфигурацию
.dtвыгрузка базы: конфигурация и данныеАдминистрирование → Загрузить информационную базу
.cfeрасширение конфигурацииКонфигурация → Расширения конфигурации → загрузить из файла
.epf / .erfвнешняя обработка / отчётФайл → Открыть в Конфигураторе или в режиме Предприятия

Главные различия на практике:

  • 📦 CF не содержит данных. Ни контрагентов, ни документов в нём нет. Если коллега прислал CF «с базой» — это ошибка, просите .dt.
  • 🔄 CFU нельзя загрузить как обычный CF. Он применяется только поверх определённой предыдущей версии и только через обновление на поддержке.
  • 💾 DT заменяет всю базу целиком, включая пользователей и данные. Загружать его в рабочую базу — значит стереть текущее содержимое.

Почему CF файл не открывается: ошибки и их причины

Диагностика: выберите симптом

Отдельный случай — CF от отраслевого разработчика с защитой лицензией. Такая конфигурация откроется в Конфигураторе, но в режиме Предприятия может потребовать ключ разработчика. Это не ошибка файла: решается только с правообладателем.

Частые вопросы

Можно ли открыть CF файл без установленной 1С?
Полноценно — нет. Для чтения модулей без платформы подойдёт сторонний распаковщик v8unpack, но объекты и формы удобно смотреть только в Конфигураторе.
Можно ли из CF файла достать данные базы?
Нет. В CF хранится только конфигурация: метаданные, формы, модули, макеты. Данные есть в выгрузке .dt или в самой базе.
Как сохранить конфигурацию своей базы в CF?
В Конфигураторе выберите «Конфигурация → Сохранить конфигурацию в файл». В пакетном режиме то же делает параметр /DumpCfg.
Подойдёт ли CF от 1С 8.2 для платформы 8.3?
Да, платформа 8.3 открывает и загружает такие файлы. Конфигурация будет работать в режиме совместимости с 8.2, пока его не сменят в свойствах конфигурации.
Чем «Загрузить конфигурацию из файла» отличается от обновления через поддержку?
Загрузка заменяет конфигурацию целиком и стирает ваши доработки. Обновление через поддержку сравнивает три версии и позволяет сохранить изменения.