Как создать CF-файл для обновления 1С

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

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

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

Что такое CF-файл и когда он нужен

CF (Configuration File) — это файл с расширением .cf, в который платформа 1С сохраняет конфигурацию целиком. Внутри — только метаданные и программный код: структура объектов, формы, макеты, модули, роли. Данных (документов, записей справочников, проводок) в CF-файле нет, поэтому его размер обычно существенно меньше размера самой базы.

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

Важно не путать CF с DT-файлом. DT — это полная выгрузка информационной базы вместе с данными, а CF — только «скелет» конфигурации. Если цель — обновить программную часть без переноса данных, нужен именно CF. Если цель — сделать резервную копию всей базы, нужен DT или штатное резервное копирование СУБД.

Подготовка базы перед выгрузкой

Перед созданием CF-файла убедитесь, что у вашей учётной записи есть права администратора и не установлен запрет на запуск конфигуратора. В файловой базе достаточно монопольного доступа; в клиент-серверном варианте права проверяются на уровне кластера и самой базы.

Завершите активные сеансы пользователей. Хотя выгрузка конфигурации в файл технически возможна при работающих пользователях, любые параллельные изменения конфигурации другими разработчиками могут попасть в файл частично или вызвать конфликт. В консоли кластера или через «Администрирование → Активные пользователи» проверьте список сеансов.

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

Пошаговое создание CF-файла

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

1. 1
   Откройте базу в режиме «Конфигуратор» под учётной записью с правами администратора.
2. 2
   Если конфигурация закрыта, выполните «Конфигурация → Открыть конфигурацию».
3. 3
   Убедитесь, что конфигурация базы данных обновлена: «Конфигурация → Обновить конфигурацию базы данных».
4. 4
   Выберите «Конфигурация → Сохранить конфигурацию в файл».
5. 5
   Укажите папку и имя файла, например Trade_11_5_custom.cf, и нажмите «Сохранить».
6. 6
   Дождитесь завершения выгрузки и проверьте, что файл появился в указанной папке и имеет ненулевой размер.

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

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

"C:\Program Files\1cv8\8.3.22.1750\bin\1cv8.exe" DESIGNER /F"D:\Bases\Trade" /N Админ /P пароль /DumpCfg "D:\Backup\trade.cf"

Загрузка CF-файла для обновления целевой базы

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

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

Если целевая база должна остаться на поддержке с возможностью штатного обновления, полная загрузка CF — не лучший вариант: она может нарушить структуру поддержки. В этом случае используйте «Конфигурация → Поддержка → Настройка поддержки» и механизм сравнения и объединения конфигураций («Сравнить, объединить с конфигурацией из файла»), который позволяет перенести только нужные изменения.

Проверка результата после обновления

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

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

Типичные ошибки и ограничения

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

Вторая группа ошибок связана с расширениями конфигурации. CF-файл не содержит расширений — они хранятся отдельно в базе. После загрузки новой конфигурации расширения могут перестать работать, если изменились объекты, к которым они привязаны. После обновления проверяйте статус расширений в разделе «Администрирование → Печатные формы, отчёты и обработки → Расширения».

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

Часто задаваемые вопросы