Импорт из XML-файла

Компонент предназначен для импорта таблиц данных из файлов формата XML.

Важно: Для работы узла требуется предварительно создать подключение к XSD-схеме и связать его с входным портом Подключение. Подключение происходит аналогично подключению с БД.

Порты

Вход

  • Управляющие переменные (необязательный порт) — переменными можно задать значения параметров мастера настройки;
  • Подключение к источнику XSD-схемы (обязательный порт) — подключение настроенного ранее Подключения к набору XSD-схем.

Выход

  • Набор данных — импортированная таблица.

Мастер настройки

Шаг 1. Импорт из XML файла

  • Имя файла/URL — задает путь к импортируемому файлу при локальном подключении, либо имя файла при использовании подключения к папке. Кнопка вызывает диалог выбора файла.

    Также в имени файла можно задавать URL-ссылку для получения файла. Поддерживаются протоколы http/https, а также HTTP Basic Authentication (https://login:[email protected]/path/file.xml, http://hostname.com/path/file.xml).

  • Просмотр выбранного файла — область позволяет увидеть содержание выбранного для импорта файла.

Шаг 2. Импортируемые поля

  • Подключение — состояние подключения к XSD-схеме.
  • Пространство имен — позволяет отфильтровать список корневых элементов по пространству имён.
  • Корневой элемент — выбор корневого элемента XSD-схемы, в соответствии с которым данные будут импортироваться. Ниже расположена область, отображающая иерархическую структуру выбранного корневого элемента — в ней следует отметить флагами элементы, которые сформируют поля импортируемой таблицы.
  • Временная зона по умолчанию — значения с типом Дата/Время преобразуются при извлечении из XML по следующему алгоритму:
    • Если значение содержит указание временной зоны, оно преобразуется к текущей временной зоне сервера Loginom.
    • Если значение не содержит указание временной зоны, то:
      • если Временная зона по умолчанию задана, значение преобразуется к текущей временной зоне сервера Loginom в предположении, что имеет временную зону, указанную в параметре Временная зона по умолчанию.
      • если Временная зона по умолчанию не задана, значение остается без изменений.
  • Дублировать единичные значения — если в составе последовательности имеется единичный элемент и вложенная последовательность, значения единичного элемента будут продублированы для каждой строки, образованной из вложенной последовательности.
  • Проверять на строгое соответствие XSD — при установке флага производится валидация XML на строгое соответствие XSD схеме. В противном случае проверка производится в упрощенном, ускоренном режиме. Процесс проверки в упрощенном режиме происходит быстрее, однако не гарантирует корректный разбор данных из XML в случае, если имеются невыявленные ошибки валидации.
  • Генерировать составные метки полей — при наличии данного флага в каждой метке поля будет отражена иерархия относительно корневого элемента. Например, составная метка ROOT|PERSON|ACCES-LEVEL будет сформирована для поля импортированной таблицы, содержащего данные атрибута ACCESS-LEVEL элемента PERSON из корневого элемента ROOT файла. При отсутствии данного флага поле получит название ACCESS-LEVEL.