Перейти к основному содержимому

Сложный импорт

Назначение​

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

Кому полезно​

Тем, кто принимает составные выгрузки партнёров: несколько сущностей в одном пакете, вложенные разделы, повторно используемый контракт импорта.

Где в UI​

Алгоритмы → Новый алгоритм → тип «Алгоритм сложного импорта» → форма настроек с деревом/аккордеоном элементов импорта и целевыми сущностями.

Понятия​

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

Сценарии​

Создать сложный импорт​

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

Обновить контракт​

  1. Откройте алгоритм.
  2. Измените структуру или сопоставление только в затронутых элементах.
  3. Сохраните и снова прогоните на контрольном файле.
  4. Сообщите потребителям данных, если изменились целевые таблицы или набор столбцов.

Чем отличается от обычной загрузки​

Обычная загрузкаСложный импорт
ФайлОдин плоский наборСоставная или вложенная структура
НастройкаСопоставление колонокДерево элементов и несколько целей
Когда выбиратьCSV/XML «одна таблица»Пакет с несколькими сущностями

Подробнее про простые варианты — в загрузке данных.

Ограничения и ошибки​

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

Что дальше​