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

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

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

Порты

Вход

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

Выход

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

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

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

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

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

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

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

Примеры значений:

2026-02-27T08:15:30Z — указана временная зона нулевого меридиана, UTC;

2026-02-27T11:15:30+03:00 — указана временная зона +03:00 (часовой пояс Москвы);

2026-02-27T11:15:30 — временная зона не указана.

Значения с типом Дата/Время преобразуются при извлечении из XML по следующему алгоритму:
- если значение импортируемого XML-элемента содержит указание временной зоны, оно преобразуется к текущей временной зоне сервера Loginom;
- eсли значение элемента не содержит указание временной зоны, то:
  - если Временная зона по умолчанию задана, импортируемое значение даты/время трактуется как значение с временной зоной, указанной в параметре Временная зона по умолчанию, и преобразуется к текущей временной зоне сервера Loginom;
  - если Временная зона по умолчанию не задана, значение остается без изменений.

Шаг 3. Описание узла

На данном этапе мастера настройки узла доступен выбор режима формирования метки узла:

Автоматическая метка — метка генерируется системой на основе имени(имён) файла(ов) или управляющей переменной.

Для узла автоматическая метка формируется по следующим правилам:

если задано имя импортируемого файла, то в метку пишется имя файла без пути;
если имя импортируемого файла задано управляющей переменной, то в метку пишется имя этой переменной.

Автоматически сформированная метка обновляется при изменении настроек импорта и отображается в сценарии без возможности редактирования напрямую. При необходимости можно принудительно обновить её через контекстное меню метки узла.

Пользовательская метка задаётся вручную и не меняется автоматически. В этом режиме можно ввести любое текстовое описание. Рядом с полем ввода отображается значок обновления, который становится активным, если текущая пользовательская метка отличается от метки компонента по умолчанию. Нажатие на значок обновления восстанавливает метку компонента по умолчанию.

Режим формирования метки можно изменить как в мастере настройки узла (через выпадающий список на третьем шаге мастера настройки), так и через контекстное меню метки узла в сценарии (правой кнопкой мыши по метке узла).

У скопированного или клонированного узла сохраняется режим формирования метки.

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

На этом шаге также можно задать описание узла на вкладке Заметка(markdown). При задании описания можно использовать синтаксис markdown, а результат верстки посмотреть на вкладке Предпросмотр. Описание команд панели инструментов приведено в статье Заметки.