Экспорт и импорт инфоблоков в Битрикс: инструкция для CSV и XML

В 1С-Битрикс инфоблок можно выгрузить и загрузить штатными инструментами в CSV или XML. CSV удобен для табличного редактирования элементов и массового обновления отдельных полей. XML подходит для переноса структуры инфоблока вместе со свойствами, разделами и изображениями. Главная опасность импорта — неверное сопоставление элементов и действие над записями, которых нет в файле. Поэтому до запуска сделайте резервную копию, проведите пробный импорт на копии сайта и проверьте внешние коды, обязательные поля, пути к файлам и выбранный режим удаления.

Коротко: для редактируемой таблицы выбирайте CSV, для переноса инфоблока между проектами — XML. Не запускайте первый импорт сразу на рабочем сайте. Сначала выгрузите небольшой образец, зафиксируйте количество разделов и элементов, импортируйте в тестовый инфоблок и сравните результат.

Когда нужен экспорт или импорт инфоблока

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

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

CSV и XML: какой формат выбрать

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

Что проверить перед началом

1. Создайте полную резервную копию файлов и базы данных.
2. Зафиксируйте версию платформы, редакцию и установленные обновления.
3. Запишите ID, символьный и внешний код исходного инфоблока.
4. Посчитайте разделы, активные и неактивные элементы.
5. Сохраните список свойств: код, тип, множественность и обязательность.
6. Проверьте связи с другими инфоблоками, торговыми предложениями и файлами.
7. Подготовьте тестовый сайт или отдельный пустой инфоблок.

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

Как экспортировать инфоблок в CSV

Откройте административный раздел Контент → Инфоблоки → Экспорт → CSV. На первом шаге выберите тип и нужный инфоблок. Затем задайте разделитель, отметьте наличие заголовков и выберите поля для выгрузки. Штатная документация требует включить хотя бы «Внешний код» или «Название»: эти значения используются для последующего сопоставления.

1. Выберите инфоблок и перейдите к параметрам.
2. Укажите разделитель, который корректно откроется в вашем редакторе.
3. Добавьте внешний код, название и только необходимые поля.
4. Задайте путь к выходному файлу относительно корня сайта.
5. Проверьте имя: существующий файл по тому же пути будет перезаписан.
6. Запустите выгрузку и скачайте результат после завершения.

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

Как подготовить CSV к импорту

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

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

XML_ID;NAME;ACTIVE;PROPERTY_ARTICLE
item-001;Тестовый товар;Y;A-001
item-002;Второй товар;N;A-002

Как импортировать CSV в инфоблок

Перейдите в Контент → Инфоблоки → Импорт → CSV, выберите файл и целевой инфоблок. На шаге формата задайте разделитель и наличие заголовков. В предварительном просмотре должно быть видно правильное число колонок. Затем сопоставьте каждую колонку с полем или свойством.

1. Выберите файл и тестовый инфоблок.
2. Проверьте разделитель по образцу данных.
3. Сопоставьте внешний код или название.
4. Назначьте остальные поля и свойства, лишние колонки пропустите.
5. Укажите путь к картинкам и файлам свойств, если они используются.
6. Для отсутствующих в файле элементов на первом тесте выберите «не трогать».
7. Задайте длительность шага и запустите загрузку.

Значение шага «0» означает выполнение за один проход. На крупной выборке это может упереться в лимиты времени и памяти, поэтому безопаснее использовать пошаговую обработку. Конкретное значение зависит от сервера и объема данных: начните с теста, наблюдайте журнал и не увеличивайте нагрузку вслепую.

Как экспортировать инфоблок в XML

Форма находится в Контент → Инфоблоки → Экспорт → XML. Укажите путь к XML-файлу, тип и инфоблок, длительность шага, а также статусы разделов и элементов, которые нужно включить. XML-выгрузка предназначена для структурированного переноса и включает свойства и изображения.

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

Как импортировать XML

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

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

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

Как переносить связанные инфоблоки

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

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

Что делать с изображениями и файлами

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

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

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

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

Как откатить неудачный импорт

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

Обратный импорт прежней CSV-выгрузки не всегда возвращает исходное состояние: в ней может не быть удаленных связей, настроек, файлов и служебных значений. Не обещайте откат, пока не выполнен тест восстановления. Для сложной миграции можно привлечь специалистов из категории интеграторов 1С-Битрикс.

Когда штатного мастера недостаточно

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

Для подбора расширений и вспомогательных решений посмотрите сервисы для Битрикс, а сведения о самой платформе доступны в карточке 1С-Битрикс. Перед установкой модуля проверьте совместимость с вашей редакцией, версией PHP и сценарием обмена.

Частые ошибки

1. Импорт сразу в рабочий блок. Ошибка сопоставления затрагивает реальные данные.
2. Сопоставление по изменяемому названию. Возникают дубли или обновляются не те элементы.
3. Режим удаления для неполного файла. Записи, не попавшие в выгрузку, исчезают.
4. Потеря папки изображений XML. Структура переносится без исходных файлов.
5. Неверный разделитель CSV. Вся строка попадает в одну колонку или разбивается внутри текста.
6. Пропуск обязательных полей. Элементы не создаются либо получают некорректные значения.
7. Отсутствие контрольных чисел. Частичную загрузку замечают уже пользователи.

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

Можно ли импортировать XML в существующий инфоблок?

Да. Если система находит инфоблок по внешнему коду, существующие элементы обновляются, новые добавляются. Поведение отсутствующих в файле элементов зависит от выбранной настройки.

Что лучше для переноса свойств: CSV или XML?

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

Почему после импорта появились дубли?

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

Можно ли считать экспорт резервной копией?

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

Вывод

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