Разработка и Конфигурация · 10 мин
Что такое багаж в 1С и как с ним работать
Что такое багаж в конфигураторе 1С, как переносить объекты метаданных между конфигурациями, типичные ошибки и безопасный порядок действий.
«Багаж» в 1С — это служебный механизм конфигуратора, который появляется при перетаскивании объектов метаданных между двумя открытыми окнами конфигураций. Когда разработчик перетаскивает, например, справочник или документ из одной базы в другую, платформа предлагает поместить объект «в багаж» — временное хранилище, из которого объект затем переносится в целевую конфигурацию вместе со связанными зависимостями.
Механизм нужен для копирования объектов метаданных (справочников, документов, отчётов, обработок, перечислений, общих модулей и других) между разными информационными базами без выгрузки конфигурации в файл целиком. Это удобно, когда нужно перенести одну доработку из тестовой базы в рабочую или собрать новую конфигурацию из фрагментов нескольких решений.
Важно понимать: багаж переносит только структуру метаданных — описание объекта, его реквизиты, формы, макеты и модули. Данные самих таблиц (элементы справочников, проведённые документы) через багаж не перемещаются. Для переноса данных используются другие инструменты: обработки выгрузки/загрузки, конвертация данных, универсальный обмен XML.
Где находится багаж и как он появляется
Багаж не имеет отдельной кнопки в меню — он возникает в момент перетаскивания. Чтобы увидеть механизм в действии, нужно открыть два конфигуратора: один с исходной базой, второй с целевой. В обоих открывают окно конфигурации (дерево метаданных) и перетаскивают объект мышью из одного окна в другое.
При перетаскивании платформа выводит диалог с вариантами действий. Один из них — поместить объект в багаж. После этого объект считается «упакованным»: платформа запоминает его состав и при вставке в целевую конфигурацию предлагает перенести также связанные объекты, от которых он зависит — подсистемы, определяемые типы, критерии отбора, общие реквизиты.
Что именно переносится через багаж
Через багаж можно копировать практически любые объекты дерева метаданных: справочники, документы, журналы документов, перечисления, отчёты, обработки, регистры сведений и накопления, планы видов характеристик, общие модули, роли, интерфейсы. Вместе с объектом переносятся его реквизиты, табличные части, формы, макеты, команды и код модулей.
Ключевая особенность — обработка ссылок на другие объекты. Если у переносимого документа есть реквизит типа «СправочникСсылка.Контрагенты», а такого справочника в целевой конфигурации нет, платформа предложит добавить его в багаж либо оставить неразрешённую ссылку. Неразрешённые ссылки приводят к ошибкам при обновлении конфигурации базы данных, поэтому их нужно устранять до сохранения.
Не переносятся через багаж: данные таблиц, пользователи и их настройки, хранилище конфигурации, расширения, настройки прав доступа конкретной базы. Также с осторожностью стоит переносить объекты, тесно связанные с подсистемами типовых конфигураций — например, объекты БСП (библиотеки стандартных подсистем), которые зависят от десятков общих модулей.
Реквизиты, табличные части, измерения, ресурсы объекта
Вместе с кодом модулей форм
Нужна выгрузка через обработки или конвертацию
Платформа предлагает добавить зависимости в багаж
Пошаговый порядок переноса объекта
Ниже — безопасная последовательность для переноса, например, внешней обработки или нового справочника из тестовой базы в рабочую. Перед началом обязательно сделайте выгрузку целевой базы (файл .dt) — это единственная гарантия отката при ошибке.
- 1Сделайте выгрузку целевой информационной базы в файл .dt через конфигуратор
- 2Откройте конфигуратор исходной базы и конфигуратор целевой базы, в обоих откройте окно конфигурации
- 3В исходной базе найдите нужный объект в дереве метаданных и перетащите его мышью в окно целевой конфигурации
- 4В появившемся диалоге выберите помещение объекта в багаж и подтвердите перенос
- 5Проверьте список связанных объектов: отметьте только те зависимости, которых действительно нет в целевой базе
- 6Выполните «Конфигурация — Проверка конфигурации» и устраните ошибки неразрешённых ссылок
- 7Обновите конфигурацию базы данных (F7), приняв изменения структуры
- 8Откройте базу в режиме предприятия и проверьте работу перенесённого объекта
Если объект большой и зависимостей много, переносите его частями: сначала общие модули и перечисления, затем справочники, потом документы и отчёты. Так проще локализовать ошибку, если после обновления что-то перестанет работать.
Контроль зависимостей и проверка результата
Главный риск при работе с багажом — «хвост» зависимостей. Перенося один документ, можно незаметно притащить в рабочую базу десяток общих модулей, которые перекроют существующие или создадут конфликт имён. Поэтому список связанных объектов в диалоге нужно читать внимательно и снимать отметки с объектов, которые уже есть в целевой конфигурации.
После переноса обязательна проверка конфигурации (меню «Конфигурация — Проверка конфигурации») с включённой проверкой логической целостности. Ошибки вида «неразрешимая ссылка» означают, что объект ссылается на метаданные, которых нет в базе. Их нужно либо донести через багаж, либо заменить тип реквизита.
Как проверить результат переноса
Нет ошибок неразрешённых ссылок
Ошибки вида «объект не обнаружен» — нужно донести зависимости
Реструктуризация проходит без сообщений о потере данных
Предупреждения об удалении реквизитов или таблиц
Объект открывается, формы и кнопки работают
Ошибки при открытии формы, отсутствуют процедуры в модулях
У нужных ролей есть права на новый объект
Пользователи не видят объект — нужно настроить роли
Типичные ошибки при работе с багажом
Отдельная ошибка — попытка перенести объект между конфигурациями, работающими в разных режимах совместимости. Если исходная база использует более новую версию платформы и её возможности (например, новые типы или свойства), в старой целевой базе объект может не встать или работать некорректно. Проверяйте версию платформы и режим совместимости обеих баз заранее.
Ограничения и риски
Багаж не подходит для массового переноса: десятки объектов с перекрёстными ссылками проще и надёжнее переносить через сравнение/объединение конфигураций или через выгрузку конфигурации в файлы. Также багаж бессилен, если конфигурация находится на поддержке с запретом изменений — сначала нужно снять объект с поддержки или включить возможность изменения.
Ещё одно ограничение: багаж работает только внутри одного сеанса работы с двумя открытыми конфигураторами. Если закрыть окна, содержимое багажа теряется — это временный буфер, а не файл проекта.
Альтернативы багажу
Выбор инструмента зависит от задачи: разовый перенос одного объекта, синхронизация версий конфигурации или перенос данных — это разные сценарии с разными инструментами.
Чем заменить багаж
Подходит для переноса групп объектов и контролируемого обновления доработанной конфигурации; требует файла .cf исходной конфигурации
Подходит для версионирования и переноса всей структуры; избыточна для одного объекта
Подходит для добавления новых объектов без изменения типовой; не трогает основную конфигурацию, но имеет ограничения по типам объектов
Подходят для переноса данных таблиц, которых багаж не переносит; требуют совпадения структуры метаданных
Как выбрать действие
FAQ
Багаж — это то же самое, что буфер обмена Windows?
Нет. Багаж — внутренний механизм конфигуратора, который хранит не текст, а описание объекта метаданных со связями. Он существует только в рамках сеанса работы с двумя открытыми конфигурациями и очищается при их закрытии.
Перенесутся ли данные справочника вместе с его структурой?
Нет. Через багаж переносится только описание метаданных: реквизиты, формы, модули, макеты. Для переноса элементов справочника используйте обработки выгрузки/загрузки данных, например универсальный обмен данными в формате XML.
Что делать, если после переноса объект не виден пользователям?
Скорее всего, не настроены права. Проверьте роли: у нужной роли должны быть установлены права на просмотр, чтение и добавление нового объекта. Также убедитесь, что объект включён в нужные подсистемы, чтобы он отображался в интерфейсе.
Можно ли перенести объект из новой версии платформы в старую?
Технически диалог переноса может сработать, но объект, использующий возможности новой платформы или режима совместимости, в старой базе будет работать с ошибками или не обновится. Перед переносом сверьте версии платформы и режимы совместимости обеих конфигураций.
Чем опасен перенос объектов с совпадающими именами?
Если в целевой конфигурации уже есть объект с таким именем, он будет перезаписан переносимым. Все его реквизиты, формы и код заменятся, а данные, завязанные на удалённые реквизиты, могут быть потеряны при реструктуризации. Перед переносом проверьте дерево метаданных целевой базы на совпадения имён.
Как отменить перенос, если что-то пошло не так?
Если конфигурация базы данных ещё не обновлена, достаточно закрыть конфигуратор без сохранения. Если обновление выполнено, восстановите базу из выгрузки .dt, сделанной перед переносом. Именно поэтому выгрузка — обязательный первый шаг.
Что важно запомнить
Багаж — временный буфер конфигуратора для переноса структуры объектов между двумя открытыми базами. Перед работой делайте выгрузку .dt, контролируйте зависимости и совпадения имён, после переноса проверяйте конфигурацию и права. Данные таблиц переносите отдельными инструментами.