Как создать файл поставки конфигурации в 1С

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

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

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

Что такое файл поставки и чем он отличается от выгрузки конфигурации

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

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

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

Подготовка конфигурации перед созданием поставки

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

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

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

Настройка комплекта поставки

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

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

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

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

Формирование файла поставки

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

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

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

Проверка готового дистрибутива

Формирование файла без ошибок ещё не гарантирует работоспособность дистрибутива. Обязательная проверка — развёртывание поставки на чистой информационной базе. Создайте новую пустую базу без конфигурации, зайдите в конфигуратор и выполните «Конфигурация → Загрузить конфигурацию из файла», указав сформированный .cf.

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

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

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

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

Загрузка .cf в чистую базу

Норма

Конфигурация загружается и обновляется без ошибок

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

Ошибки загрузки или реструктуризации

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

Норма

Основные формы открываются, документы проводятся

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

Ошибки обращения к отсутствующим объектам

Состав каталога поставки

Норма

Все дополнительные файлы и описание присутствуют

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

Отсутствуют файлы, заявленные в комплекте

Типичные ошибки при создании файла поставки

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

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

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

Альтернативные способы передачи конфигурации

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

Для командной разработки основным инструментом является хранилище конфигурации, а для современных проектов — выгрузка в файлы XML и система контроля версий (например, Git через EDT). Из таких выгрузок дистрибутив собирается автоматически в рамках сборочных скриптов. Этот подход сложнее в настройке, но устраняет ручные операции и связанные с ними ошибки.

Сравнение вариантов

Файл поставки (.cf через комплект)

Передача клиенту как готового продукта с описанием и дополнительными файлами; требует настройки комплекта

Простая выгрузка в .cf

Быстрый перенос между базами и разработчиками; без описания и дополнительных файлов

Выгрузка в XML + контроль версий

Командная разработка и автоматическая сборка; требует инфраструктуры и навыков

FAQ: частые вопросы о файле поставки в 1С

Чем файл поставки отличается от файла обновления .cfu?

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

Можно ли включить в поставку данные, например заполненные справочники?

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

Конфигуратор не даёт создать файл поставки — в чём причина?

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

Нужно ли снимать конфигурацию с поддержки перед созданием поставки?

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

Как клиент установит полученный файл поставки?

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

Можно ли автоматизировать создание файла поставки?

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