Выгрузка конфигурации в файл .cf и подготовка файла обновления .cfu

· 9 мин

Содержание

Чтобы создать 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
Выполнено: 0 / 5

Как сохранить конфигурацию в CF файл через Конфигуратор

Пошагово для 1С 8.3 с интерфейсом «Такси»:

  1. Запустите 1С, выберите базу и нажмите «Конфигуратор».
  2. Если дерево конфигурации не открыто, выполните Конфигурация → Открыть конфигурацию.
  3. Выберите Конфигурация → Сохранить конфигурацию в файл....
  4. Укажите папку и имя файла. Имя лучше делать говорящим: BP_3.0_доработки_2026-10-07.cf.
  5. Нажмите «Сохранить» и дождитесь сообщения о завершении.

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

Как обновить другую базу этим файлом

Дальше два пути, и они сильно отличаются по последствиям.

  • 🔄 Конфигурация → Поддержка → Обновить конфигурацию → «Выбор из файла» → ваш .cf. Программа сравнит версии и покажет окно объединения. Доработки целевой базы сохранятся, если правильно настроить объединение.
  • 🧨 Конфигурация → Загрузить конфигурацию из файла. Конфигурация целевой базы полностью заменяется содержимым файла. Свои доработки в целевой базе пропадут.

Перед загрузкой или обновлением сделайте резервную копию целевой базы (Администрирование → Выгрузить информационную базу в Конфигураторе). Загрузка .cf поверх доработанной базы необратима без копии.

После любого из вариантов изменения применяются к данным командой Конфигурация → Обновить конфигурацию базы данных (F7). Для этого шага уже нужен монопольный доступ или динамическое обновление, поэтому попросите пользователей выйти.

Файлы поставки и обновления: настройки для разработчика

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

Шаг 1. Настройка поставки

Откройте Конфигурация → Поставка конфигурации → Настройка поставки. Здесь задаются правила для объектов, которые попадут в поставку. Перед этим заполните в свойствах корня конфигурации:

  • 🏷 «Поставщик» — название вашей организации;
  • 🔢 «Версия» — номер в формате 1.0.5.12;
  • © «Авторские права» и адрес информации о конфигурации, если нужно.

Номер версии меняйте при каждом выпуске. Две поставки с одинаковой версией не дадут собрать корректный .cfu.

Шаг 2. Создание файлов

Выберите Конфигурация → Поставка конфигурации → Создать файлы поставки и обновления. В окне:

  1. Отметьте «Создать файл поставки» и укажите путь к .cf.
  2. Отметьте «Создать файл обновления » и укажите путь к .cfu.
  3. В список дистрибутивов, из которых возможно обновление, добавьте .cf предыдущих выпущенных версий. Именно от них клиенты смогут перейти на новую.
  4. Нажмите «Выполнить».

💡 Храните .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. Тестовая база

Самый надёжный способ:

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

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

Ошибки при создании и применении CF файла

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

Если ничего не помогло

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

Если ошибка появляется именно при чтении конфигурации, выполните в копии базы «Тестирование и исправление» (Администрирование → Тестирование и исправление). Режим требует монопольного доступа, поэтому запускайте его на копии или в нерабочее время.

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

Можно ли создать CF файл из базы, не заходя в Конфигуратор?
Да, пакетным запуском 1cv8.exe DESIGNER с ключом /DumpCfg. Окно Конфигуратора при этом не открывается, но лицензия и учётная запись с правами администратора всё равно нужны.
Попадут ли данные базы в CF файл?
Нет. В .cf только конфигурация: справочники, документы и регистры как структура, без записей. Данные переносятся файлом .dt.
Нужно ли выгонять пользователей, чтобы сохранить конфигурацию в файл?
Нет, сохранение в файл работает при подключённых пользователях. Монопольный доступ нужен потом, на этапе обновления конфигурации базы данных.
Подойдёт ли CF из базы на новой платформе для базы на старой?
Не всегда. Если в конфигурации включён режим совместимости с более новой версией, чем стоит у получателя, загрузить файл не выйдет. Номер платформы у получателя должен быть не ниже того, что требует режим совместимости.
Чем отличаются «Сохранить конфигурацию в файл» и «Сохранить конфигурацию БД в файл»?
Первая команда берёт основную конфигурацию с вашими несохранёнными в базу правками. Вторая — конфигурацию, с которой сейчас работают пользователи.