Загрузка данных из XML файлов в 1С:ERP на примере загрузки справочника

В данной статье мы подробно рассмотрим процесс загрузки данных из XML-файлов в 1С:ERP Управление предприятием 2 версии 2.5.20.51. Мы изучим основные механизмы работы с XML-форматами, рассмотрим типовые сценарии использования и разберем практические примеры импорта данных в систему.

Контекст ситуации:

В информационных базах 1С:Предприятия данные можно загружать (импортировать) из внешних источников и выгружать (экспортировать) из информационных баз. Импорт данных в 1С:Предприятие является важной функцией для интеграции с внешними источниками информации. Система предоставляет широкие возможности для работы с различными форматами файлов, включая загрузку и выгрузку данных между информационными базами. Внешние файлы часто становятся источником данных для 1С. Особенно актуальным является импорт информации из популярных форматов: XML, XLS, XLSX, MXL и других. Каждый из этих форматов имеет свои особенности при обработке в системе. В данной статье мы рассмотрим загрузку данных из XML-файлов в программном продукте 1С:ERP Управление предприятием 2 (2.5.20.51). Сами XML-файлы в 1С представляют собой текстовые файлы с разметками, в которых данные организованы по определённой структуре (рис.1).

Рисунок 1 – внутреннее содержание XML-файла

XML-файлы:

XML-файлы занимают особое место среди форматов данных в 1С. Это текстовые документы со специальной разметкой, где информация организована по строгой структуре. Они идеально подходят для обмена данными между различными системами благодаря своей универсальности и читаемости как для человека, так и для машин. Импортировать в систему можно различные справочники, документы, регистры и другие данные, которые позже будут продемонстрированы в процессе открытия обработки. Перейдем к процессу импорта данных из XML-файла в 1С:ERP. В данном случае мы рассмотрим типовую обработку «Выгрузка и загрузка данных XML», которая входит в комплект поставки конфигурации 1С:Конвертация данных второй редакции. Найти ее можно в каталоге шаблонов конфигурации 1С:Конвертация данных 2 или скачать в прикрепленных к статье файлах. Для загрузки данных в систему 1С:ERP должны быть соблюдены следующие условия:

• база-источник (та база, откуда выгружен XML-файл) и база-приёмник (та база, куда загружается XML-файл) должны быть идентичны;

• состав, тип реквизитов, табличных частей, свойства объекта метаданных должны быть одинаковые.

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

Загрузка данных:

Итак, если все условия соблюдены, можно переходить к загрузке данных. Зайдите в информационную базу, куда будут загружаться данные (база-приемник). Важно отметить, если загружать данные будем в рабочую базу, где уже хранится информация, сначала надо создать резервную копию базы, чтобы обезопасить данные. Для импорта данных, как было написано выше, будем использовать обработку «Выгрузка и загрузка данных XML». Она позволяет производить полную или частичную выгрузку данных в формате XML и загружать их в другую информационную базу. Например, у вас есть выгруженный XML-файл, который содержит информацию о справочнике «Организации». Вы хотите перенести данный справочник в новую информационную базу. Конечно, это можно сделать и вручную, но на это уйдет намного больше времени, а также есть шанс допустить ошибку при переносе данных вручную. Приступим к загрузке данных. Обработку «Выгрузка и загрузка данных XML» можно открыть через главное меню «Файл» – Открыть. Или же нажать сочетание клавиш Ctrl+O (рис. 2). Далее указывается путь до файла нашей обработки, которую мы предварительно скачали из каталога шаблонов конфигурации 1С:Конвертация данных 2.

Рисунок 2 – открытие обработки «Выгрузка и загрузка данных XML»

Описание обработки:

Обработка при открытии будет иметь следующий вид. Откроется форма, где есть табличная часть на вкладке «Выгрузка», а также есть возможность открыть вторую вкладку «Загрузка», которую впоследствии мы будем использовать: (рис. 3)

Рисунок 3 – обработка «Выгрузка и загрузка данных XML»

Данная обработка является универсальным инструментом, совместимым с различными конфигурациями 1С. Она позволяет:

• Выгружать данные (полностью или выборочно) в XML-формате;

• Загружать подготовленные файлы в другую базу.

Основные сценарии её применения:

• Обмен справочниками (например, организациями, номенклатурой, контрагентами);

• Перенос документов между разными конфигурациями;

• Резервное копирование данных для восстановления после сбоев.

Таким образом, обработка обеспечивает гибкий и надежный обмен информацией между системами. В интерфейсе обработки представлена таблица с возможностью выбора объектов через флажки. По значку «+» можно выбрать вручную любые объекты, а также найти нужные данные через поиск по сочетанию клавиш «Ctrl+F» (рис. 4).

Рисунок 4 – данные для выгрузки

Справа расположен раздел с заголовком «Выгружать при необходимости». Это означает, что, если какой-либо реквизит в справочнике ссылается на объект, отсутствующий в принимающей базе, система попытается его создать. Например, если номенклатура в исходной базе измеряется в единицах, которых нет в целевой, установка флажка приведет к автоматическому добавлению новой единицы измерения. Если флажок не поставить, вместо значения появится сообщение «Объект не найден» с его идентификатором. Поэтому важно заранее решить, допустимы ли пустые ссылки в данных. В большинстве случаев лучше отметить все флажки, чтобы гарантированно выгрузить связанные объекты (например, банковские счета организаций или привязанные договоры). Это предотвратит потерю данных и ошибки при загрузке.

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

Загрузка данных (продолжение):

Итак, вернемся к загрузке файлов. Перейдем на вкладку «Загрузка», где есть 2 варианта загрузки: «С клиентского компьютера» и «Из файла на сервере» (рис.5).

Рисунок 5 – варианты загрузки данных

В данном случае мы будем использовать второй вариант, поэтому укажем путь файла, который мы загружаем в информационную базу. В открывшемся окне выбираем наш сохраненный XML-файл, нажимаем кнопку «Открыть» и ждем окончания загрузки данных из файла (рис. 6). Если вы выберете «С клиентского компьютера», то сначала нужно будет нажать кнопку «Загрузить данные», а затем выбрать файл загрузки данных в проводнике Windows.

Рисунок 6 – выбор XML-файла в проводнике Windows

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

Рисунок 7 – служебное сообщение об успешности при загрузке

Теперь можно проверить в системе загруженные нами данные. Так как в данном примере была произведена загрузка организаций, перейдем в раздел «НСИ и Администрирование» – «НСИ» – «Организации». Можно увидеть, что данные по организациям перенесены (рис. 8).

Рисунок 8 – импортированный справочник «Организации» в базе-приемнике

Таким образом загрузка данных по справочнику «Организации» была произведена успешно.

Итоги:

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