Файл конфигурации .cf: что с ним делать в Конфигураторе 1С 8.3

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

Какой способ выбрать, зависит от задачи. Посмотреть, что внутри чужой доработки, — открыть файл. Перенести конфигурацию в пустую базу — загрузить. Обновить типовую базу — пропустить CF или CFU через механизм поддержки. Всё это общее для платформы 8.3 и одинаково работает в БП 3.0, ЗУП 3.1, УТ 11 и любой другой конфигурации.

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

Файл .cf — это полная конфигурация в одном файле: метаданные, модули, формы, макеты, роли. Данных базы (документов, справочников, остатков) в нём нет. Поэтому CF весит десятки мегабайт, а не гигабайты.

Рядом с ним встречаются ещё три формата. Их путают чаще всего:

Главное отличие CF от CFU — самодостаточность. CF можно загрузить в любую пустую базу и получить рабочую конфигурацию. CFU без базы предыдущей версии бесполезен: он «знает» только то, что изменилось по сравнению с перечисленными в нём старыми версиями.

Как открыть файл CF в Конфигураторе

Двойной щелчок по CF в Проводнике ничего полезного не делает: файл не связан с программой, а внутри — двоичный контейнер. Рабочих вариантов два.

Просмотр без изменения базы

Подходит, когда нужно посмотреть код доработки, найти модуль или сравнить объект вручную.

1. Запустите 1С в режиме Конфигуратор для любой базы, хоть пустой учебной.
2. Выберите Файл → Открыть и укажите файл .cf.
3. Откроется отдельное окно с деревом метаданных из файла. Конфигурация базы при этом не меняется.

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

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

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

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

Из командной строки

Для пакетной работы и регламентных заданий есть параметры пакетного режима Конфигуратора. Пример загрузки CF в файловую базу и обновления её структуры:

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

Номер платформы в пути подставьте свой. Лог /Out пригодится, если что-то пошло не так: пакетный режим не показывает окон с ошибками.

Выгрузка конфигурации в файл CF

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

1. Откройте базу в Конфигураторе.
2. Выполните Конфигурация → Сохранить конфигурацию в файл.
3. Укажите папку и имя. Удобно включать в имя версию и дату: BP_3.0.xxx_до_обновления.cf.

В Конфигураторе у базы две конфигурации, и сохранить можно каждую:

• 🛠️ основная конфигурация (та, что редактирует разработчик) — команда выше;
• 🗄️ конфигурация базы данных (та, с которой реально работают пользователи) — Конфигурация → Конфигурация базы данных → Сохранить конфигурацию БД в файл.

Если разработчик внёс правки и не обновил базу, эти две конфигурации различаются. Для архива «как сейчас работает» берите конфигурацию базы данных.

Аналог из командной строки — параметр /DumpCfg:

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

Для системы контроля версий есть ещё один формат: Конфигурация → Выгрузить конфигурацию в файлы сохраняет конфигурацию набором XML-файлов и текстов модулей. Такую выгрузку удобно хранить в Git и сравнивать построчно, а обратно её загружают командой Загрузить конфигурацию из файлов.

Конвертация CF в CFU и обратно

Прямого конвертера между форматами нет, и это не случайность. CFU описывает разницу относительно конкретных версий. Значит, чтобы получить CFU, нужны минимум два CF: текущий и тот, с которого будут обновляться.

Как сделать CFU из CF

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

1. Откройте в Конфигураторе базу с новой версией конфигурации. В свойствах конфигурации должна быть заполнена версия, например 1.2.0.0.
2. Выполните Конфигурация → Поставка конфигурации → Создать файлы поставки и обновления.
3. Отметьте создание файла поставки (это и есть .cf) и файла обновления (.cfu), укажите пути.
4. В списке версий, с которых возможно обновление, добавьте CF прошлых версий: 1.0.0.0, 1.1.0.0 и так далее.
5. Нажмите Выполнить.

Получится CFU, который обновит базу только с тех версий, что вы перечислили. Базу версии 1.0.5.0, не попавшей в список, этим файлом обновить не получится.

Как получить CF из CFU

Из одного CFU полный CF не собрать: в нём нет неизменившихся объектов. Порядок такой:

1. Возьмите базу (или пустую базу с загруженным CF) той версии, с которой CFU умеет обновлять.
2. Обновите её через Конфигурация → Поддержка → Обновить конфигурацию, указав CFU.
3. После обновления сохраните результат: Конфигурация → Сохранить конфигурацию в файл.

Для типовых конфигураций проще: дистрибутив обновления поставщика при установке кладёт в каталог шаблонов оба файла — 1Cv8.cf и 1Cv8.cfu. По умолчанию это %APPDATA%\1C\1cv8\tmplts\1c\ и подпапка с именем конфигурации и номером версии. Нужен полный CF — берите его оттуда.

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

Типовую базу на поддержке обновляют не загрузкой, а через механизм поддержки. Так сохраняются настройки поддержки и доработки, если они есть.

1. Сохраните .dt и CF текущей конфигурации.
2. Откройте Конфигуратор: Конфигурация → Открыть конфигурацию.
3. Выберите Конфигурация → Поддержка → Обновить конфигурацию.
4. Укажите Выбор файла обновления и задайте путь к .cfu или .cf.
5. На экране сравнения проверьте объекты с двойным изменением (изменены и у вас, и у поставщика). Для каждого решите, что взять.
6. Нажмите Выполнить, затем F7 — обновление конфигурации базы данных.
7. Запустите 1С:Предприятие и дождитесь окончания обработки обновления данных.

Когда что указывать:

Для серверной базы с большим объёмом данных обновление структуры может идти долго. Пробный прогон на копии базы покажет реальное время.

Сравнение двух файлов конфигурации CF

Сравнение нужно, чтобы понять, что изменил подрядчик, чем отличается выгрузка «до» от выгрузки «после» или почему две базы ведут себя по-разному.

1. Откройте любую базу в Конфигураторе.
2. Выполните Конфигурация → Сравнить конфигурации.
3. В левом и правом списках выберите источники. Кроме основной конфигурации и конфигурации базы данных, там есть вариант «Конфигурация из файла» — для него укажите путь к CF.
4. Нажмите ОК. Откроется дерево объектов с отметками отличий.
5. Чтобы увидеть разницу в модуле, вызовите на объекте сравнение текстов из контекстного меню.

Для документирования изменений есть отчёт о сравнении: его формируют из окна сравнения и сохраняют в файл. Удобно приложить к задаче или акту работ.

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

Частые ошибки при работе с файлами CF

Ещё две ситуации, которые не всегда видны как ошибка:

• 🔒 Конфигурация поставляется без возможности изменения. Модули в таком CF можно смотреть, а правка закрыта политикой поставщика. Доработки в этом случае делают расширением .cfe.
• 🔑 Часть модулей закрыта паролем или поставлена без исходных текстов. Это решение разработчика, обходить его не нужно и незаконно. Вопросы по доработке — к автору конфигурации.

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