К статье
Практический материал

Администрирование · 9 мин

Как сделать CFU-файл в 1С и обновить конфигурацию

Что такое CFU-файл в 1С, как создать его в конфигураторе, как обновить конфигурацию через CFU и какие ошибки встречаются при обновлении.

Файл с расширением .cfu — это файл обновления конфигурации 1С:Предприятие. В отличие от полного файла поставки (.cf), который содержит всю конфигурацию целиком, CFU хранит только изменения относительно определённых версий и предназначен именно для обновления уже работающих информационных баз. Именно в таком виде фирма «1С» и партнёры распространяют релизы типовых конфигураций.

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

Чем CFU отличается от CF и когда какой файл нужен

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

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

CF или CFU — что выбрать

Файл .cf

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

Файл .cfu

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

Подготовка перед созданием файла обновления

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

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

Создание CFU-файла в конфигураторе: пошаговая инструкция

Процедура выполняется в конфигураторе и занимает несколько минут. Порядок действий одинаков для большинства версий платформы 1С:Предприятие 8.3.

Создание файла обновления
  1. 1
    Откройте конфигуратор и загрузите актуальную конфигурацию, для которой готовится обновление
  2. 2
    Перейдите в меню «Конфигурация — Поставка конфигурации — Создать файлы поставки и обновления конфигурации»
  3. 3
    Укажите каталог, куда будут сохранены файлы
  4. 4
    Отметьте флажок создания файла обновления конфигурации и укажите файл поставки предыдущей версии, относительно которой строится обновление
  5. 5
    При необходимости добавьте несколько предыдущих версий, чтобы обновление подходило разным клиентам
  6. 6
    Нажмите «Выполнить» и дождитесь формирования файлов
  7. 7
    Проверьте, что в указанном каталоге появился файл с расширением .cfu

В диалоге создания поставки можно одновременно сформировать и полный файл поставки (.cf), и файл обновления (.cfu) — обычно так и делают, чтобы комплект был полным. Если обновление должно подходить сразу для нескольких прошлых релизов, добавьте их файлы поставки в список: размер CFU вырастет, но клиенты с разными версиями смогут обновиться одним файлом.

Как обновить конфигурацию базы через CFU-файл

Обновление рабочей базы выполняется в монопольном режиме: все пользователи должны выйти, фоновые задания — завершиться. Перед началом обязательно сделайте резервную копию: выгрузку в .dt или средствами СУБД для клиент-серверных баз.

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

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

Типичные ошибки при работе с CFU

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

Типичные ошибки
01
Попытка обновить базу CFU-файлом, не содержащим текущую версию базы — обновление отклоняется платформой
02
Отсутствие резервной копии перед обновлением — при сбое реструктуризации данные могут быть потеряны
03
Обновление без монопольного режима — активные сеансы блокируют обновление конфигурации базы данных
04
Прерывание отложенных обработчиков обновления — данные остаются в промежуточном состоянии, часть функций не работает
05
Неверный номер версии при создании поставки — файл не находится механизмами поиска обновлений

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

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

Контрольные точки

Как проверить результат

Номер версии конфигурации
Норма

Совпадает с версией установленного обновления

Тревожный признак

Версия осталась прежней — обновление не применилось

Отложенные обработчики обновления
Норма

Все обработчики завершены без ошибок

Тревожный признак

Есть зависшие или завершившиеся с ошибкой обработчики

Работа ключевых функций
Норма

Документы проводятся, отчёты формируются

Тревожный признак

Ошибки при открытии форм или проведении документов

Настройки поддержки
Норма

Статус поддержки сохранён, доработки на месте

Тревожный признак

Объекты сняты с поддержки или доработки утеряны

Альтернативные способы обновления

Если CFU-файла нет, обновление возможно через полный файл конфигурации: «Конфигурация — Загрузить конфигурацию из файла» с последующим сравнением-объединением. Этот способ требует больше внимания к доработкам, но результат эквивалентен. Для типовых конфигураций доступно также автоматическое обновление через интернет-поддержку прямо из режима предприятия — платформа сама скачивает нужные файлы.

В распределённых командах вместо ручного создания CFU используют хранилище конфигурации и системы сборки: обновления формируются автоматически из контрольных точек хранилища. Это снижает риск человеческой ошибки при выборе версий и номенклатуре файлов поставки.

Итог

Что важно запомнить

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

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

Можно ли обновить базу CFU-файлом, если моя версия старше тех, что в файле?

Нет, платформа отклонит такой файл. Нужно либо найти CFU, включающий вашу версию, либо последовательно установить промежуточные обновления, либо использовать полный CF-файл со сравнением-объединением.

Чем открыть CFU-файл вне 1С?

Никак осмысленно: это внутренний формат платформы, он не предназначен для просмотра сторонними программами. Работать с ним можно только через конфигуратор 1С.

Обязателен ли монопольный режим при обновлении через CFU?

Да. Обновление конфигурации базы данных невозможно при активных сеансах пользователей. В клиент-серверном варианте сеансы завершают через консоль кластера или блокировку сеансов.

Что делать, если обновление прервалось на этапе реструктуризации?

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

Как сделать один CFU для клиентов с разными версиями?

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

Потеряются ли доработки при обновлении через CFU?

Нет, если обновление выполняется штатно через сравнение-объединение: изменённые вами объекты будут показаны в окне объединения, и вы сможете выбрать, какие изменения принять. Риск потери возникает только при невнимательной установке флажков в этом окне.