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

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

Как установить CF-файл в 1С

Как установить CF-файл конфигурации в 1С: загрузка через конфигуратор, обновление базы, типичные ошибки и способы проверки результата.

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

Установить CF-файл можно только через конфигуратор 1С — в пользовательском режиме «Предприятие» такой функции нет. Понадобятся права администратора информационной базы, монопольный доступ к базе и сам файл с расширением .cf, полученный из надёжного источника: от поставщика решения, разработчика или выгруженный из другой базы.

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

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

CF (Configuration File) — бинарный файл, в который 1С упаковывает всю конфигурацию целиком. Его создают через «Конфигурация → Сохранить конфигурацию в файл». Внутри — структура метаданных, программный код модулей, формы, макеты, права и настройки. Данные (документы, справочники, проводки) в CF не входят — за них отвечает файл выгрузки .dt.

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

Подготовка: что проверить перед установкой

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

Второй шаг — проверка совместимости. Уточните, для какой версии платформы 1С собран CF-файл: конфигурация, созданная под платформу 8.3.22, может не загрузиться или работать некорректно на старой платформе. Также проверьте режим совместимости конфигурации, если он известен. Версию своей платформы можно посмотреть через «Справка → О программе» в конфигураторе.

Третий момент — пользователи. Загрузка конфигурации и последующее обновление базы требуют монопольного доступа: все сеансы должны быть завершены. В клиент-серверном варианте также убедитесь, что отключены регламентные задания, которые могут стартовать во время обновления.

Установка CF в пустую базу

Это самый простой и безопасный сценарий. Создайте новую информационную базу через стартер 1С: при добавлении базы выберите вариант «Создание информационной базы без конфигурации». Затем запустите её в режиме конфигуратора.

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

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

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

Установка CF в рабочую базу с данными

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

Порядок действий тот же: выгрузка .dt, монопольный доступ, «Загрузить конфигурацию из файла», обновление базы. Ключевой момент — внимательно изучить окно реструктуризации перед нажатием «Принять». В нём перечислены все изменения: добавляемые, изменяемые и удаляемые объекты. Если в списке на удаление есть справочники или документы, которых не должно быть, — отмените операцию и разберитесь в причинах.

Если задача — не заменить конфигурацию, а перенести отдельные доработки, правильнее использовать «Конфигурация → Сравнить, объединить с конфигурацией из файла». Этот режим позволяет выборочно перенести объекты и не трогать остальное.

Способы переноса конфигурации

Загрузить конфигурацию из файла

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

Сравнить, объединить с конфигурацией из файла

Выборочный перенос объектов из CF с контролем изменений. Подходит для доработок и частичного переноса.

Загрузить информационную базу (.dt)

Восстановление базы целиком вместе с данными. Подходит для развёртывания копии, но затирает текущие данные полностью.

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

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

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

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

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

Запуск режима «Предприятие»
Норма

База открывается без сообщений об ошибках, отрабатывают обработчики первого запуска

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

Ошибки при старте, сообщения о невозможности обновления или отсутствии объектов

Окно реструктуризации при обновлении
Норма

В списке только ожидаемые изменения, нет удаления рабочих объектов

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

К удалению предлагаются справочники, документы или регистры с данными

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

Номер версии соответствует версии CF-файла

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

Версия старая — обновление конфигурации базы данных не выполнено

Типичные ошибки и их решение

Ошибка «Нарушена целостность структуры конфигурации» или отказ загрузки обычно означает, что CF-файл повреждён при передаче или создан на несовместимой версии платформы. Запросите файл заново и проверьте версию платформы. Ошибки вида «Конфигурация базы данных не соответствует сохранённой конфигурации» после загрузки решаются выполнением обновления конфигурации базы данных (F7).

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

Типичные ошибки
01
Загрузка CF без резервной копии — при несовместимости структуры вернуть данные будет нечем
02
Игнорирование окна реструктуризации — объекты с данными удаляются без возможности отката
03
Использование CF вместо CFU для типового обновления — конфигурация снимается с поддержки и теряет штатный механизм обновлений
04
Загрузка в рабочую базу файла, собранного под другую версию платформы — ошибки при старте и в работе модулей

Ограничения и когда CF не подходит

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

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

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

Можно ли установить CF-файл через режим «Предприятие»?

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

Что делать, если после загрузки CF база не запускается?

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

Пропадут ли данные при загрузке CF?

Сама по себе загрузка конфигурации данные не удаляет, но при обновлении базы объекты, отсутствующие в новой конфигурации, удаляются вместе с данными. Контролируйте это в окне реструктуризации и всегда имейте резервную копию.

Чем отличается CF от расширения конфигурации (CFE)?

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

Можно ли установить CF на базу с другой конфигурацией?

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

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

Загрузите CF в пустую тестовую базу и посмотрите свойства конфигурации (номер версии указан в корневом элементе дерева метаданных). Прямого просмотра содержимого CF без загрузки в базу штатные средства 1С не предоставляют.

Итог

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

CF устанавливается через конфигуратор командой «Загрузить конфигурацию из файла» с последующим обновлением базы (F7). Перед загрузкой в рабочую базу обязательны резервная копия .dt, монопольный доступ и внимательный анализ окна реструктуризации. Для частичного переноса доработок используйте сравнение и объединение, для типовых обновлений — штатные механизмы вместо CF.