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

Разработка и Конфигурация · 11 мин

Что содержит файл конфигурации 1С

Из чего состоит файл конфигурации 1С (cf): объекты метаданных, модули, формы, макеты. Как открыть, сравнить и безопасно изменить конфигурацию.

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

Важно сразу различать файл конфигурации и файл базы данных. Конфигурация описывает, как устроена система, но не содержит самих учётных данных: документов, остатков, проводок. Данные хранятся в информационной базе — в файле 1Cv8.1CD для файлового варианта или в СУБД для клиент-серверного. Поэтому загрузка чужого .cf никогда не перенесёт в вашу базу чужие документы, но способна полностью заменить логику работы программы.

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

Общая структура: из каких разделов состоит файл конфигурации

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

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

Физически файл имеет внутренний контейнерный формат платформы: данные разбиты на именованные блоки, часть из них сжата. Редактировать его вручную внешними инструментами нельзя — корректная работа возможна только через Конфигуратор или механизмы пакетной выгрузки в файлы XML.

Объекты метаданных: справочники, документы, регистры

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

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

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

Программный код: модули и где они лежат

Вторая большая составляющая файла — код на встроенном языке 1С. Он распределён по модулям разных типов: общие модули (серверная и клиентская логика), модули объектов и менеджеров, модули форм, модуль приложения, модуль сеанса, модули команд. Каждый модуль хранится как текст внутри соответствующего объекта метаданных.

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

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

bash
"C:\Program Files\1cv8\<версия>\bin\1cv8.exe" DESIGNER /F"C:\Bases\MyBase" /N"Администратор" /DumpConfigToFiles "C:\Dump\ConfigXml" -format Hierarchical

Формы, макеты и интерфейс

Формы объектов и общие формы хранятся в файле как формализованное описание: состав элементов, их расположение, связь с данными, обработчики событий и код модуля формы. В режиме выгрузки в XML форма представляется парой файлов — описатель и модуль.

Макеты — это шаблоны печатных форм, табличные документы, схемы компоновки данных, HTML-страницы, двоичные данные (картинки, внешние компоненты, файлы поставки). Макет печатной формы акта или счёта — типичный объект, который меняют при локальных доработках.

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

Чего в файле конфигурации нет

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

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

Отдельно стоит упомянуть файлы поставки (.cfu): они содержат не полную конфигурацию, а только изменения относительно предыдущей версии. Загрузить .cfu можно лишь на конфигурацию строго определённой версии, тогда как .cf загружается полностью.

Файлы выгрузки 1С

.cf — конфигурация

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

.cfu — файл обновления

Только изменения между версиями поставщика. Работает строго на указанную версию, для сторонних баз не подходит.

.dt — выгрузка базы

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

.cfe — расширение

Доработки поверх основной конфигурации без её изменения. Загружается в разделе «Расширения конфигурации».

Как посмотреть содержимое файла конфигурации

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

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

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

Безопасная работа: риски и типичные ошибки

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

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

Типичные ошибки
01
Загрузка .cf вместо «сравнить и объединить» — все доработки стираются целиком
02
Попытка перенести данные через .cf — файл конфигурации данные не содержит, нужен .dt или обмен
03
Загрузка .cfu на неподходящую версию — обновление отклоняется или ломает структуру
04
Правка конфигурации поставщика вместо расширения — при следующем обновлении изменения конфликтуют или теряются
05
Отсутствие выгрузки текущего состояния перед экспериментами — нечего откатывать при ошибке

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

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

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

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

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

База открывается, нет сообщений об ошибках метаданных

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

Ошибки инициализации, требование обновить версию платформы

Проведение типового документа
Норма

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

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

Ошибки в модулях проведения, отсутствуют движения

Доработанные объекты
Норма

Ваши реквизиты, печатные формы и процедуры на месте

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

Доработки исчезли — признак полной загрузки вместо объединения

Роли и права
Норма

Пользователи входят и видят свои разделы

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

Ошибки доступа, пропавшие пункты меню

FAQ

Чем файл .cf отличается от файла .dt?

.cf содержит только описание конфигурации: метаданные, код, формы, макеты. .dt — это выгрузка всей информационной базы, включая конфигурацию и все данные: документы, справочники, пользователей, настройки. Для резервного копирования используют .dt, для переноса доработок — .cf.

Можно ли открыть файл конфигурации без Конфигуратора?

Штатных сторонних просмотрщиков нет: формат внутренний, и корректно его читает только платформа 1С. Практический путь — загрузить .cf в пустую базу и выгрузить конфигурацию в XML-файлы, которые читаются любым текстовым редактором.

Передастся ли вместе с .cf список пользователей и их пароли?

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

Что делать, если после загрузки .cf пропали доработки?

Это признак полной загрузки вместо объединения. Штатного отката нет: восстановите базу из резервной копии .dt или загрузите ранее выгруженный .cf с доработками. В дальнейшем для переноса изменений используйте «Сравнить, объединить с конфигурацией из файла».

Сколько весит типовой файл конфигурации и от чего зависит размер?

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

Можно ли вытащить из .cf только один объект, например отчёт?

Напрямую из файла — нет. Загрузите .cf в пустую базу, затем выгрузите нужный объект вместе с конфигурацией в XML либо перенесите его через сравнение-объединение, отметив в диалоге только требуемый объект и связанные с ним элементы.

Итог

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

Файл .cf — это полное описание прикладного решения: метаданные, код, формы, макеты, роли и интерфейс, но не учётные данные и не пользователи. Работайте с ним через Конфигуратор, для анализа используйте выгрузку в XML, а перед любой загрузкой в рабочую базу делайте резервную копию .dt.