Создание поставки конфигурации 1С: полное руководство

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

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

Подготовка хранилища конфигурации

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

Для начала работы откройте конфигуратор и перейдите в меню Администрирование → Хранилище конфигурации → Подключить хранилище. Вам потребуется указать путь к общей папке на сервере или локальном диске, где будет располагаться база хранилища. После подключения необходимо выполнить захват объектов, над которыми вы планируете работать, чтобы зафиксировать их состояние.

Особое внимание следует уделить правам доступа. Убедитесь, что у вашей учетной записи есть права на изменение структуры хранилища и создание новых версий. Ошибки на этом этапе часто приводят к тому, что система не позволяет сохранить изменения или создать точку сохранения.

⚠️ Внимание: Никогда не работайте с хранилищем конфигурации напрямую через проводник Windows, копируя или удаляя файлы. Все операции должны выполняться исключительно через интерфейс конфигуратора 1С, иначе структура хранилища может быть необратимо повреждена.

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

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

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

Ключевым параметром является номер версии. Система предлагает использовать формат мажорной, минорной и патч-версии (например, 1.0.5). Правильная нумерация позволяет пользователю понять масштаб изменений: мажорная версия указывает на глобальные изменения, минорная — на добавление нового функционала, а патч — на исправление ошибок.

Также необходимо указать поставщика. Если вы разрабатываете решение для внешней организации, укажите название вашей компании или ваше ФИО. Это поле будет отображаться в журнале регистрации обновлений у пользователя. Не оставляйте его пустым, так как это усложнит идентификацию источника обновления в будущем.

Параметр	Описание	Рекомендация
Номер версии	Уникальный идентификатор релиза	Соблюдайте последовательность: 1.0.0, 1.0.1, 1.1.0
Поставщик	Автор или организация-разработчик	Указывайте полное наименование для юридической чистоты
Комментарий	Краткое описание изменений	Пишите емко, но информативно для пользователя
Файл поставки	Путь к сохраняемому файлу	Используйте понятные имена файлов без пробелов

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

Выбор объектов для включения в обновление

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

При выборе отдельных объектов система автоматически проанализирует зависимости. Однако разработчику стоит вручную проверить, все ли необходимые справочники, документы и регистры включены в список. Часто бывает так, что новый отчет не работает потому, что забыли добавить общий модуль, от которого он зависит.

• 📁 Справочники и документы: Убедитесь, что новые реквизиты или формы документов включены в поставку, если они менялись.
• 📊 Регистры и отчеты: Проверьте состав полей регистров и алгоритмы расчетов в отчетах, чтобы пользователь получил актуальную логику работы.
• ⚙️ Общие модули: Критически важный элемент. Любое изменение в коде общего модуля должно быть доставлено пользователю, иначе система может выдать ошибку выполнения.

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

⚠️ Внимание: Если вы изменяете структуру регистров накопления (добавляете измерения или ресурсы), убедитесь, что в поставке стоит флаг на перепроведение документов. Без этого данные в регистрах могут рассинхронизироваться с документами.

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

Что делать, если объект не сохраняется в поставку?

Если вы выбрали объект, но он не попал в итоговый файл, проверьте, был ли он действительно изменен по сравнению с предыдущей версией в хранилище. Механизм поставок игнорирует объекты, которые не имеют зафиксированных изменений. Также проверьте права доступа к этому объекту в хранилище.

Процесс выгрузки и тестирование файла

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

Полученный файл необходимо обязательно протестировать перед отправкой заказчику. Создайте копию рабочей базы данных или используйте специально подготовленную тестовую базу. Запустите режим предприятия в обычном режиме и выберите команду Администрирование → Выгрузить конфигурацию, чтобы подготовить базу к обновлению, если это требуется версией платформы.

Затем в конфигураторе тестовой базы выберите Конфигурация → Обновить конфигурацию базы данных и укажите путь к вашему файлу .cfu. Внимательно следите за окном обновления: система покажет список изменяемых объектов и предупредит о возможных потерях данных. Если вы видите предупреждения о удалении данных, остановитесь и перепроверьте состав поставки.

1. Запустить 1С в режиме Конфигуратор
2. Меню: Конфигурация -> Обновить конфигурацию базы данных
3. Выбрать файл .cfu
4. Нажать "Принять изменения"
5. Проверить журнал обновлений

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

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

Процесс установки поставки у пользователя мало чем отличается от тестирования, однако здесь выше цена ошибки. Пользователь должен иметь актуальную резервную копию базы данных перед началом работ. Это золотое правило администрирования 1С, которое спасает от потери данных в случае сбоя.

Пользователь запускает конфигуратор в монопольном режиме. Это обязательное условие: ни один другой пользователь не должен быть подключен к базе в момент обновления. Если база файловая, убедитесь, что все сеансы завершены. Если клиент-серверная, отключите пользователей через консоль администрирования серверов.

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

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

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

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

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

• ❌ Ошибка "Конфликт версий": Решается последовательной установкой всех промежуточных релизов по порядку.
• ❌ Ошибка "Монопольный режим": Необходимо завершить все сеансы пользователей и перезапустить службу 1С, если сеансы не сбрасываются.
• ❌ Ошибка целостности: Требуется выполнение проверки и исправления конфигурации перед обновлением через меню Администрирование.

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

⚠️ Внимание: Интерфейс и названия пунктов меню могут незначительно отличаться в разных версиях платформы 1С:Предприятие (например, 8.2, 8.3, 8.3.20+). Всегда сверяйтесь с актуальной документацией для вашей конкретной версии платформы, если не находите нужный пункт.

Часто задаваемые вопросы (FAQ)

Можно ли создать поставку без использования хранилища конфигурации?

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

В чем разница между файлами .cf, .cfu и .cfe?

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

Что делать, если после обновления перестали работать отчеты?

Скорее всего, в поставку не попали зависимые объекты, такие как общие модули или макеты. Проверьте журнал обновления, чтобы увидеть, какие объекты были изменены. Возможно, потребуется создать новую поставку с включенными зависимостями или восстановить базу из резервной копии.

Как откатить поставку, если она вызвала ошибки?

Механизм поставок не имеет встроенной кнопки "Отменить". Единственный надежный способ отката — восстановление базы данных из резервной копии, сделанной перед обновлением. Поэтому правило создания бэкапа перед установкой любого обновления является критическим.

Можно ли объединить несколько поставок в одну?

Нет, механизм поставок 1С не поддерживает прямое объединение файлов .cfu. Если нужно доставить несколько изменений, лучше создать новую поставку на основе актуального состояния хранилища, включив в неё все необходимые изменения единым релизом.