Выгрузка конфигурации в файл .cf и подготовка файла обновления .cfu
Содержание
Чтобы создать CF файл для обновления 1С, откройте базу в Конфигураторе и выберите Конфигурация → Сохранить конфигурацию в файл. Укажите папку и имя, например 1Cv8.cf. Через минуту-другую файл готов, и им можно обновить другую базу той же конфигурации.
Если же вы разработчик и готовите обновление для чужих баз, обычного сохранения мало. Нужен файл поставки .cf и файл обновления .cfu с номером версии. Разберём оба сценария, выгрузку из bat-файла и проверку результата до того, как файл уйдёт в рабочую базу.
Какой файл вам нужен: .cf, .cfu или .dt
Три расширения часто путают. От выбора зависит, получится ли потом обновиться.
| Файл | Что внутри | Когда нужен |
|---|---|---|
.cf | Полная конфигурация: метаданные, модули, макеты, свойства (поставщик, версия) | Перенести доработки, обновить базу из «эталонной», загрузить конфигурацию в новую базу |
.cfu | Только разница между версиями плюс список версий, от которых она применима | Выпуск обновления для баз, которые стоят на поддержке |
.dt | Конфигурация вместе с данными | Резервная копия, перенос базы целиком |
📌 Короткое правило:
- ✅ обновить одну базу так же, как уже обновлена другая — хватит
.cf; - ✅ раздать обновление многим клиентам — делайте пару
.cf+.cfu; - ❌
.dtдля обновления не подходит: его загрузка заменит данные целевой базы.
Файл .cf не содержит расширений конфигурации. Каждое расширение сохраняется отдельно в .cfe.
Подготовка информационной базы к выгрузке
Сохранение в файл не требует монопольного доступа. Пользователи могут работать. Но несколько проверок до выгрузки избавят от сюрпризов.
1. Сравните основную конфигурацию и конфигурацию базы данных
В Конфигураторе их две. Основная — та, что вы редактируете. Конфигурация базы данных — та, с которой реально работают пользователи. Команда «Сохранить конфигурацию в файл» берёт основную.
Если в основной есть незавершённые правки, они попадут в файл. Проверьте через Конфигурация → Сравнить конфигурации: выберите сравнение основной конфигурации с конфигурацией базы данных. Пустой список отличий — всё синхронно.
💡 Нужна именно рабочая версия без черновых правок? Используйте Конфигурация → Конфигурация базы данных → Сохранить конфигурацию БД в файл.
2. Проверьте свойства конфигурации
Откройте свойства корня дерева конфигурации (правый клик → «Свойства»). Посмотрите поля «Поставщик», «Версия», «Имя». По ним целевая база решает, подходит ли файл для обновления. У типовой конфигурации их не трогайте.
3. Хранилище конфигурации
Если база подключена к хранилищу, сначала поместите свои изменения в хранилище и обновите конфигурацию из него. Иначе в файл уйдёт ваша локальная версия, а не согласованная командой.
4. Место и права
Папка назначения должна быть доступна на запись тому пользователю Windows, под которым запущен Конфигуратор. Для крупных типовых конфигураций закладывайте на диске запас в несколько сотен мегабайт.
Как сохранить конфигурацию в CF файл через Конфигуратор
Пошагово для 1С 8.3 с интерфейсом «Такси»:
- Запустите 1С, выберите базу и нажмите «Конфигуратор».
- Если дерево конфигурации не открыто, выполните
Конфигурация → Открыть конфигурацию. - Выберите
Конфигурация → Сохранить конфигурацию в файл.... - Укажите папку и имя файла. Имя лучше делать говорящим:
BP_3.0_доработки_2026-10-07.cf. - Нажмите «Сохранить» и дождитесь сообщения о завершении.
Для типовой Бухгалтерии сохранение обычно занимает от одной до нескольких минут. Зависит от диска и размера конфигурации.
Как обновить другую базу этим файлом
Дальше два пути, и они сильно отличаются по последствиям.
- 🔄
Конфигурация → Поддержка → Обновить конфигурацию→ «Выбор из файла» → ваш.cf. Программа сравнит версии и покажет окно объединения. Доработки целевой базы сохранятся, если правильно настроить объединение. - 🧨
Конфигурация → Загрузить конфигурацию из файла. Конфигурация целевой базы полностью заменяется содержимым файла. Свои доработки в целевой базе пропадут.
Перед загрузкой или обновлением сделайте резервную копию целевой базы (Администрирование → Выгрузить информационную базу в Конфигураторе). Загрузка .cf поверх доработанной базы необратима без копии.
После любого из вариантов изменения применяются к данным командой Конфигурация → Обновить конфигурацию базы данных (F7). Для этого шага уже нужен монопольный доступ или динамическое обновление, поэтому попросите пользователей выйти.
Файлы поставки и обновления: настройки для разработчика
Если вы выпускаете свою конфигурацию или отраслевую доработку и хотите, чтобы клиенты обновлялись штатно, как с типовой, понадобится механизм поставки.
Шаг 1. Настройка поставки
Откройте Конфигурация → Поставка конфигурации → Настройка поставки. Здесь задаются правила для объектов, которые попадут в поставку. Перед этим заполните в свойствах корня конфигурации:
- 🏷 «Поставщик» — название вашей организации;
- 🔢 «Версия» — номер в формате
1.0.5.12; - © «Авторские права» и адрес информации о конфигурации, если нужно.
Номер версии меняйте при каждом выпуске. Две поставки с одинаковой версией не дадут собрать корректный .cfu.
Шаг 2. Создание файлов
Выберите Конфигурация → Поставка конфигурации → Создать файлы поставки и обновления. В окне:
- Отметьте «Создать файл поставки» и укажите путь к
.cf. - Отметьте «Создать файл обновления
» и укажите путь к
.cfu. - В список дистрибутивов, из которых возможно обновление, добавьте
.cfпредыдущих выпущенных версий. Именно от них клиенты смогут перейти на новую. - Нажмите «Выполнить».
💡 Храните .cf каждой выпущенной версии в архиве. Без старого файла поставки нельзя собрать обновление с этой версии: базы на ней придётся обновлять полным .cf.
Шаг 3. Шаблон для установки (по желанию)
Команда Конфигурация → Поставка конфигурации → Создать шаблоны конфигураций и обновлений собирает комплект с описанием и программой установки. Клиент ставит его в каталог шаблонов, и обновление видно в списке так же, как типовое.
| Что раздаёте | Плюс | Минус |
|---|---|---|
Только .cf | Подходит для любой исходной версии | Большой файл, дольше сравнение при обновлении |
.cf + .cfu | Файл обновления маленький, обновление быстрее | Работает только от версий из списка |
| Шаблон с установкой | Удобно клиенту, привычный путь | Нужно собирать и тестировать комплект |
Как создать CF файл из командной строки
Ночная выгрузка, бэкап конфигурации перед каждым обновлением, сборка поставки на сервере сборки — всё это делается пакетным запуском Конфигуратора. Окно не открывается, результат пишется в лог.
Выгрузка конфигурации в .cf
Файловая база:
@echo off
set V8="C:\Program Files\1cv8\8.3.xx.xxxx\bin\1cv8.exe"
set BASE=C:\Bases\Buh
set OUT=D:\cf_backup
%V8% DESIGNER /F"%BASE%" /N"Администратор" /P"пароль" ^
/DumpCfg "%OUT%\1Cv8.cf" ^
/Out "%OUT%\dump.log" /DisableStartupDialogs /DisableStartupMessages
if %ERRORLEVEL% NEQ 0 echo Выгрузка завершилась с ошибкой, смотрите dump.log
Для клиент-серверной базы вместо /F укажите /S"сервер\имя_базы". Вместо 8.3.xx.xxxx подставьте установленную у вас версию платформы.
Полезные ключи:
/DumpCfg <файл>— сохраняет основную конфигурацию, аналог команды из меню;/DumpDBCfg <файл>— сохраняет конфигурацию базы данных;/DumpCfg <файл> -Extension <имя>— выгружает расширение в.cfe;/Out <файл>— лог, без него о причине сбоя не узнать.
Как не затирать прошлые выгрузки
Если bat-файл запускается по расписанию, каждый раз пишите файл в новую папку. Проще всего добавить к имени номер запуска или дату, полученную через PowerShell, а не через %date%: формат %date% зависит от региональных настроек Windows и может содержать точки и слэши.
Старые копии удаляйте по сроку, например оставляйте выгрузки за последние 30 дней. Так у вас всегда будет конфигурация «до обновления», к которой можно вернуться.
Сборка поставки и обновления
%V8% DESIGNER /F"%BASE%" /N"Администратор" /P"пароль" ^
/CreateDistributionFiles -cffile "D:\release\1Cv8.cf" ^
-cfufile "D:\release\1Cv8.cfu" -f "D:\archive\1.0.4\1Cv8.cf" ^
/Out "D:\release\build.log"
Ключ -f можно повторить для нескольких предыдущих версий. Полный синтаксис смотрите в справке платформы по параметрам командной строки.
Пароль в bat-файле хранится открытым текстом. Создайте для пакетных операций отдельного пользователя базы, а файл положите в папку, доступную только администратору.
Применение файла в пакетном режиме
Для обновления целевой базы из готового файла используется /UpdateCfg <файл.cf или .cfu>, затем /UpdateDBCfg для применения к данным. Для /UpdateDBCfg пользователи должны выйти из базы: запускайте такие задания ночью и предупредите людей заранее.
Как проверить CF файл до обновления рабочей базы
Файл создан без ошибок — ещё не значит, что он годится. Три проверки, от быстрой к надёжной.
Проверка 1. Размер и время
Файл весом в несколько килобайт почти наверняка битый или пустой. Типовая конфигурация весит десятки и сотни мегабайт. Сравните с размером прошлой выгрузки.
Проверка 2. Сравнение без загрузки
В любой базе откройте Конфигурация → Сравнить, объединить с конфигурацией из файла и выберите созданный .cf. Если окно сравнения открылось и показывает ожидаемые отличия, файл читается. Нажмите «Закрыть», не выполняя объединение.
Проверка 3. Тестовая база
Самый надёжный способ:
- Создайте пустую файловую базу без конфигурации.
- В Конфигураторе выполните
Конфигурация → Загрузить конфигурацию из файла. - Обновите конфигурацию базы данных (F7).
- Запустите
Конфигурация → Проверка конфигурациииСинтаксический контроль модулей. - Откройте базу в режиме «1С:Предприятие» и пройдите по разделам, где были доработки.
Для .cfu проверка одна: возьмите копию базы
на одной из версий из списка и обновитесь. Если программа не принимает файл, значит, версия базы не входит в список, указанный при сборке.
Ошибки при создании и применении CF файла
Если ничего не помогло
Выгрузите конфигурацию другим способом: если .cf не создаётся, сделайте .dt через Администрирование → Выгрузить информационную базу. Загрузите его в копию базы на другом компьютере и сохраните .cf уже оттуда. Так вы исключите проблемы с правами, диском и самой рабочей базой.
Если ошибка появляется именно при чтении конфигурации, выполните в копии базы «Тестирование и исправление» (Администрирование → Тестирование и исправление). Режим требует монопольного доступа, поэтому запускайте его на копии или в нерабочее время.
Частые вопросы
Можно ли создать CF файл из базы, не заходя в Конфигуратор?
1cv8.exe DESIGNER с ключом /DumpCfg. Окно Конфигуратора при этом не открывается, но лицензия и учётная запись с правами администратора всё равно нужны.Попадут ли данные базы в CF файл?
.cf только конфигурация: справочники, документы и регистры как структура, без записей. Данные переносятся файлом .dt.