Файл .cf конфигурации: просмотр, загрузка в базу и разбор по модулям
Содержание
Открыть CF файл в 1С 8.3 можно только через Конфигуратор: запустите любую базу в режиме Конфигуратор и выберите Файл → Открыть, указав файл .cf. Если нужно не посмотреть, а перенести конфигурацию в базу, используйте Конфигурация → Загрузить конфигурацию из файла.
Типичная ситуация: франчайзи прислал доработанную конфигурацию одним файлом 1Cv8.cf, и бухгалтер дважды щёлкает по нему в проводнике. Ничего не происходит: Windows не знает, чем открыть такой файл. Файл конфигурации — это не документ и не база. Это упакованный набор метаданных, форм и модулей, и прочитать его умеет только платформа 1С:Предприятие.
С чего начать: что нужно перед открытием CF
Перед работой проверьте три вещи.
- 🧩 Установлена платформа 1С:Предприятие 8.3 с компонентом «1С:Предприятие — Конфигуратор» (он ставится вместе с толстым клиентом).
- 🗂 Есть информационная база, через которую можно зайти в Конфигуратор. Для просмотра подойдёт пустая учебная база — рабочую трогать не нужно.
- 🔢 Версия платформы не ниже той, в которой файл сохранён, и не ниже режима совместимости конфигурации. Узнать версию
своей платформы можно в Конфигураторе:
Справка → О программе.
Чтобы не рисковать рабочими данными, создайте отдельную пустую базу: в окне запуска Добавить → Создание новой информационной базы → Создание информационной базы без конфигурации. Она займёт пару мегабайт и пригодится для всех экспериментов с CF-файлами.
Сразу о том, чем отличаются способы. Выбор зависит от задачи, а не от вкуса.
| Задача | Способ | Затрагивает базу? |
|---|---|---|
| Посмотреть объекты и код | Файл → Открыть | Нет |
| Заменить конфигурацию базы | Загрузить конфигурацию из файла | Да, полностью |
| Перенести часть доработок | Сравнить, объединить с конфигурацией из файла | Да, выборочно |
| Обновить типовую на поддержке | Поддержка → Обновить конфигурацию | Да |
| Разобрать в текстовые файлы | Выгрузить конфигурацию в файлы (после загрузки) | Нет |
Как открыть файл конфигурации в Конфигураторе для просмотра
Этот способ ничего не меняет в базе. Файл открывается в отдельном дереве, рядом с основной конфигурацией.
- В окне запуска выберите любую базу (лучше пустую) и нажмите кнопку
Конфигуратор. - В меню выберите
Файл → Открыть(илиCtrl+O). - В поле типа файлов укажите «Файл конфигурации (*.cf)» и выберите нужный файл.
- Откроется окно с деревом метаданных: справочники, документы, регистры, общие модули.
Дальше работайте как с обычной конфигурацией: открывайте модули, смотрите формы, ищите по тексту через Правка → Найти или глобальный поиск.
Этот режим годится для просмотра и анализа. Свойства объектов и тексты модулей видно сразу. Править конфигурацию здесь не стоит: изменения в открытом файле не попадут ни в одну базу.
Если вместо кода модуля вы видите пустое окно или сообщение об отсутствии исходного текста, разработчик поставил конфигурацию без исходных текстов части модулей. Это защита авторских прав, а не повреждение файла. Восстановить текст из такого файла нельзя — запросите у разработчика версию с открытым кодом.
Где взять CF-файл типовой конфигурации
Дистрибутив обновления типовой конфигурации обычно приходит в виде установщика setup.exe. После установки шаблон оказывается в каталоге шаблонов, по умолчанию %APPDATA%\1C\1cv8\tmplts\1c\<имя конфигурации>\<номер версии>\. Там лежат 1Cv8.cf (полная конфигурация) и 1Cv8.cfu (файл обновления).
Путь к каталогу шаблонов можно проверить в окне запуска: Настройка → поле с каталогами шаблонов конфигураций и обновлений.
Загрузка CF в информационную базу
Если цель — работать с конфигурацией из файла как с программой (вводить данные, проверять отчёты), её нужно загрузить в базу.
Загрузка полностью заменяет конфигурацию базы. Перед этим сделайте выгрузку базы в .dt или резервную копию сервера СУБД.
- Сделайте копию:
Администрирование → Выгрузить информационную базу, сохраните.dt. - Выберите
Конфигурация → Открыть конфигурацию, если дерево ещё не открыто. - Выберите
Конфигурация → Загрузить конфигурацию из файлаи укажите файл.cf. - Подтвердите замену. Если текущая конфигурация стоит на поддержке, программа задаст вопрос о постановке новой на поддержку — для типовой ответьте утвердительно.
- Выполните
Конфигурация → Обновить конфигурацию базы данных(F7). - Просмотрите список изменений структуры и нажмите
Принять.
На шаге 5 платформа может потребовать монопольный доступ, если меняется структура таблиц. В файловой базе это значит, что из неё должны выйти все пользователи.
Для разовой проверки чужого CF удобнее новая база: в окне запуска выберите Добавить → Создание новой информационной базы, затем создание из шаблона или пустую базу, и загрузите в неё файл. Рабочая база останется нетронутой.
Если загрузить CF в базу с данными от другой конфигурации, данные с изменившейся структурой могут быть удалены при обновлении. Список удаляемых объектов показывается в окне реорганизации — читайте его, прежде чем нажимать Принять.
Сравнение и объединение с конфигурацией из файла
Это способ для доработанных баз. Он позволяет взять из файла только нужное, например одну обработку или исправленный модуль, а остальное оставить как есть.
- Откройте основную конфигурацию базы.
- Выберите
Конфигурация → Сравнить, объединить с конфигурацией из файлаи укажите.cf. - Если конфигурации не связаны поддержкой, программа предложит выбрать режим сопоставления объектов — обычно выбирают сопоставление по именам.
- В окне сравнения флажками отметьте объекты, которые нужно перенести.
- Для изменённых модулей откройте контекстное меню и посмотрите различия по тексту — там же можно настроить объединение по отдельным процедурам.
- Нажмите
Выполнить, затем обновите конфигурацию базы данных (F7).
Если нужно только посмотреть разницу без переноса, в том же окне ничего не отмечайте и закройте его. Ещё удобнее: Конфигурация → Сравнить конфигурации — там можно сравнить основную конфигурацию с файлом и сформировать отчёт о различиях, который сохраняется в текстовый файл или табличный документ.
Обновление типовой конфигурации через CF
Для конфигураций на поддержке используется отдельная команда: Конфигурация → Поддержка → Обновить конфигурацию. В мастере выберите «Выбор файла обновления» и укажите .cf или .cfu. Платформа сама сравнит поставщика, ваши доработки и новую версию.
Выгрузка конфигурации в XML-файлы для анализа
Когда нужно поискать по коду внешними инструментами, сравнить версии в Git или просто прочитать модули в текстовом редакторе, конфигурацию разбирают на файлы.
Напрямую из .cf такая выгрузка не делается. Порядок такой:
- Загрузите CF в пустую базу (см. раздел выше).
- Выберите
Конфигурация → Выгрузить конфигурацию в файлы. - Укажите пустой каталог и формат выгрузки.
- Дождитесь окончания: типовая Бухгалтерия разворачивается в десятки тысяч файлов.
На выходе получите 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 от отраслевого разработчика с защитой лицензией. Такая конфигурация откроется в Конфигураторе, но в режиме Предприятия может потребовать ключ разработчика. Это не ошибка файла: решается только с правообладателем.