Расширение .cfu в 1С 8.3: зачем нужен файл обновления и что с ним делать
Содержание
Файл с расширением .cfu — это файл обновления конфигурации 1С:Предприятия 8. Открывают его только в Конфигураторе: Конфигурация → Поддержка → Обновить конфигурацию, затем выбрать файл и применить изменения к базе. Двойным щелчком, в блокноте или архиваторе его не прочитать — это служебный формат платформы, а не документ.
Типичная ситуация: бухгалтер скачал обновление Бухгалтерии, запустил setup.exe, а в папке появились 1cv8.cfu, 1cv8.mft и пара текстовых файлов. Что из этого открывать и куда — разберём по порядку: от устройства файла до пакетного обновления из командной строки.
Чем файл CFU отличается от CF, CFE и DT
Все четыре формата выглядят похоже, но решают разные задачи. Путают их постоянно, отсюда половина вопросов «почему не загружается».
| Расширение | Что внутри | Где применяют |
|---|---|---|
.cf | Полная конфигурация: все объекты, модули, макеты | Загрузка конфигурации целиком, сравнение и объединение, создание новой базы из шаблона |
.cfu | Изменения между версиями: «от каких версий → к какой» | Обновление конфигурации, стоящей на поддержке |
.cfe | Расширение конфигурации | Подключение доработок без изменения основной конфигурации |
.dt | Выгрузка информационной базы: данные плюс конфигурация | Перенос и резервное копирование базы |
Главное отличие CFU от CF — в CFU нет полной конфигурации. Там лежит описание того, как получить новую версию из одной или нескольких предыдущих. Поэтому файл обновления обычно заметно меньше полного дистрибутива.
Отсюда два практических следствия:
- 📌 CFU подходит не к любой базе. Он срабатывает, только если текущая версия конфигурации есть в списке версий, из которых он умеет обновлять.
- 📌 Создать из CFU новую базу нельзя. Для пустой базы нужен полный
.cfили шаблон конфигурации. - 📌 Загрузить CFU
командой
Конфигурация → Загрузить конфигурацию из файлане получится: эта команда ждёт.cf.
Если в базе стоит версия, которой нет в списке поддерживаемых, CFU придётся применять цепочкой: сначала промежуточный релиз, потом следующий. Номера промежуточных версий указаны в описании обновления.
Откуда берётся файл обновления CFU
Поставщик конфигурации обычно отдаёт обновление в виде дистрибутива с программой установки. Запуск setup.exe распаковывает файлы в каталог шаблонов. По умолчанию это:
%APPDATA%\1C\1cv8\tmplts\
Внутри — папки по поставщику, конфигурации и версии, например tmplts\1c\Accounting\3_0_xxx_yy\. В папке версии обычно лежат:
- 📦
1cv8.cfu— сам файл обновления; - 📦
1cv8.cf— полная конфигурация, если поставщик включил её в дистрибутив; - 📄
1cv8.mft— манифест шаблона: по нему платформа показывает конфигурацию в списке шаблонов при создании базы; - 📄
UpdInfo.txt— служебная информация о версиях; - 📄
ReadMe.txtили описание изменений.
Как проверить, подойдёт ли файл к вашей базе
Откройте UpdInfo.txt в блокноте. Там строки примерно такого вида:
Version=3.0.150.24
FromVersions=;3.0.149.31;3.0.149.34;
UpdateDate=...
Version — версия, которая получится после обновления. FromVersions — версии, из которых этот CFU умеет обновлять. Номер своей версии посмотрите в программе: Справка → О программе или в Конфигураторе в свойствах корня конфигурации. Если вашего номера в FromVersions нет, файл не подойдёт — нужен промежуточный релиз.
Список каталогов шаблонов можно изменить в окне запуска 1С: кнопка Настройка, блок Каталоги шаблонов конфигураций и обновлений. Это удобно, если обновления хранятся на общем сетевом диске для всех администраторов.
Как открыть CFU и обновить конфигурацию в Конфигураторе
Перед любым обновлением сделайте выгрузку базы: Администрирование → Выгрузить информационную базу в Конфигураторе. Без резервной копии не обновляйте рабочую базу: откат неудачного обновления без .dt — это долгое ручное восстановление.
Пошагово
- Откройте базу в режиме Конфигуратора под пользователем с полными правами.
- Откройте конфигурацию:
Конфигурация → Открыть конфигурацию. - Выберите
Конфигурация → Поддержка → Обновить конфигурацию. - В окне выбора источника отметьте
Выбор файла обновленияи укажите путь к1cv8.cfu. Второй вариант —Поиск доступных обновлений: платформа сама просмотрит каталоги шаблонов и покажет подходящие файлы. - Платформа покажет, какую версию получите. Подтвердите.
- Если конфигурация типовая без доработок, изменения применятся сразу. Если доработки есть, откроется окно сравнения и объединения: в нём решаете, что брать из новой версии, а что оставить своим.
- Обновите конфигурацию базы данных:
Конфигурация → Обновить конфигурацию базы данныхили клавишаF7. Примите изменения структуры в появившемся окне. - Запустите базу в режиме 1С:Предприятие под администратором. Дождитесь, пока программа выполнит обработчики обновления данных. До этого пользователей в базу не пускайте.
Обновление структуры базы данных требует монопольного доступа. Пользователей придётся выгнать из базы, их несохранённые данные пропадут. Планируйте обновление на вечер или выходной и предупреждайте коллег заранее.
Обновление из пользовательского режима
В типовых конфигурациях на БСП (Бухгалтерия 3.0, ЗУП 3.1, УТ 11) есть встроенный помощник: Администрирование → Обслуживание → Обновление версии программы. Он умеет обновлять как через интернет
-поддержку, так и из файла на диске. В качестве файла можно указать полученный .cfu.
Этот способ подходит для типовых баз без доработок. Если конфигурацию дорабатывали, надёжнее обновлять через Конфигуратор и смотреть объединение своими глазами.
Если конфигурация снята с поддержки
CFU работает только с конфигурацией, которая стоит на поддержке поставщика. Проверить режим можно в Конфигурация → Поддержка → Настройка поддержки.
| Режим поддержки | Что будет с CFU |
|---|---|
| На поддержке, без возможности изменения | Обновится без вопросов |
| На поддержке, с возможностью изменения | Обновится через сравнение и объединение |
| Снята с поддержки полностью | CFU применить нельзя. Нужен полный .cf и Сравнить, объединить с конфигурацией из файла |
Что проверить после обновления
Обновление прошло без ошибок — это ещё не значит, что база готова к работе. Пять минут проверки:
- Откройте
Справка → О программеи убедитесь, что номер версии совпадает сVersionизUpdInfo.txt. - Проверьте, что обработчики обновления завершились: программа не должна снова предлагать «завершить обновление » при входе.
- Откройте пару документов текущего периода и сформируйте ключевой отчёт, например оборотно-сальдовую ведомость. Цифры должны совпасть с теми, что были до обновления.
- Проверьте печатные формы и обмены, если они дорабатывались или настроены отдельно.
- Только после этого открывайте базу для пользователей.
Если что-то пошло не так, загрузите выгрузку .dt, сделанную перед обновлением, и разбирайтесь на копии, а не в рабочей базе.
Как создать файл поставки и обновления CFU
Этот раздел нужен разработчикам, которые выпускают свои конфигурации или отраслевые решения для клиентов. Механизм тот же, что у поставщика типовых.
Подготовка
- 🔧 В свойствах корня конфигурации заполните
ПоставщикиВерсия. Каждая новая поставка должна получать новый номер версии. - 🔧 Сохраните полные
.cfпредыдущих версий, которые были у клиентов. Без них файл обновления собрать нельзя. - 🔧 При необходимости задайте правила поставки объектов:
Конфигурация → Поставка конфигурации → Настройка поставки.
Создание файлов
- Откройте
Конфигурация → Поставка конфигурации → Создать файлы поставки и обновления. - Отметьте
Создать файл дистрибутива— получится полный.cfновой версии. - Отметьте
Создать файл обновления дистрибутиваи укажите путь для.cfu. - В списке дистрибутивов предыдущих версий добавьте
.cfвсех версий, из которых клиенты должны обновляться. Чем больше версий добавлено, тем больше итоговый файл. - Нажмите
Выполнить.
Не тащите в один CFU десятки старых версий. Хватит последних двух-трёх релизов: клиенты на совсем старых версиях пройдут цепочку обновлений через промежуточный релиз.
Если нужен дистрибутив с программой установки, как у типовых, его собирают отдельно: Конфигурация → Поставка конфигурации → Шаблоны конфигураций и обновлений. Там формируют файл описания комплекта и пакет, который клиент распакует в каталог шаблонов.
CFU и расширения конфигурации
Расширения хранятся в файлах .cfe. Файла обновления в формате CFU для расширений нет: новую версию расширения загружают поверх старой целиком. В Конфигураторе это Конфигурация → Расширения конфигурации, в пользовательском режиме — Администрирование → Печатные формы, отчеты и обработки → Расширения.
С CFU расширения связаны другим образом. После обновления основной конфигурации расширение может перестать подходить: в новой версии переименовали реквизит, изменили модуль, на который расширение ставило перехват. Отсюда порядок действий:
- До обновления выпишите список подключённых расширений и их назначение.
- Обновите основную конфигурацию из CFU и обновите конфигурацию базы данных.
- В списке расширений Конфигуратора выполните проверку применимости для каждого.
- Расширение с ошибками отключите или передайте разработчику на доработку, затем загрузите исправленный
.cfe.
Именно для того, чтобы спокойно обновляться из CFU, доработки и выносят в расширения. Основная конфигурация остаётся на поддержке без возможности изменения, и обновление проходит без ручного объединения.
Обновление из CFU через командную строку
Когда баз десятки, обновлять каждую вручную долго. Конфигуратор умеет работать в пакетном режиме. Базовая команда для файловой базы:
"C:\Program Files\1cv8\8.3.xx.xxxx\bin\1cv8.exe" DESIGNER /F"D:\Bases\Buh" /N"Администратор" /P"пароль" /UpdateCfg "D:\Update\1cv8.cfu" /UpdateDBCfg /Out "D:\Logs\update.log" /DisableStartupDialogs
Для клиент-серверной базы путь /F заменяют на /S"server\base".
Что делает каждый ключ:
- ⚙️
DESIGNER— запуск в режиме Конфигуратора; - ⚙️
/UpdateCfg— обновить конфигурацию , стоящую на поддержке, из файла.cfuили.cf; - ⚙️
/UpdateDBCfg— сразу обновить конфигурацию базы данных; - ⚙️
/Out— записать протокол в файл, чтобы потом проверить результат; - ⚙️
/DisableStartupDialogs— не показывать стартовые диалоги, которые остановят скрипт.
Создать файлы поставки тоже можно из командной строки — ключом /CreateDistributionFiles с параметром -cfufile. Точный набор параметров для вашей версии платформы смотрите в справке Конфигуратора, раздел о командной строке.
Пакетный режим не умеет решать конфликты объединения. Если в конфигурации есть доработки, скрипт завершится с ошибкой или применит настройки объединения по умолчанию. Для доработанных баз пакетное обновление подходит только после проверки на копии.
Пароль в bat-файле открытым текстом — плохая практика. Храните скрипт в папке с доступом только для администраторов или передавайте пароль через переменную окружения.
Ошибки при работе с файлом CFU
Отдельно про ошибку «Неверный формат» при попытке загрузить CFU через Загрузить конфигурацию из файла. Файл здесь ни при чём: команда предназначена для полного .cf. Используйте Поддержка → Обновить конфигурацию.