Структура XML-файла и пример

Примечания о структуре файла XML

  • Система отсекает пробелы в начале имени атрибута.
  • Иногда система отсекает пробелы в начале значений атрибута.
  • Имена всех элементов и атрибутов должны быть записаны в нижнем регистре.
  • Использование неизвестного имени элемента или атрибута приведет к сбою импорта.

В приведенном ниже примере описаны основные аспекты структуры XML-файла.

<?xml version="1.0"?> <xml> <transactions> <transaction date="1196854268" type="wf_import_document_attributes" vaultname="2008 file vault"> <document aliasset="" pdmweid="0" idattribute="Number" id="89-NOAO-4200-1236" idcfgname=""> <configuration name=""> <attribute name="Cost" value="0,44"/> <attribute name="ArticleID" value="A-012-BB"/> </configuration> </document> </transaction> </transactions> </xml>

где:

Элемент XML Описание и атрибуты
<?XML version=«1.0»?> С этого элемента должен начинаться файл.
<XML> Этот элемент необходим для перехода к элементу transactions.
<transactions> Файл содержит только один элемент transactions.
<transaction …> Файл может содержать несколько элементов transaction.
Атрибуты:
дата

Время (в секундах), прошедшее с 12.00 1 января 1970 года. Должно быть целым числом больше 0.
type

Указывает на то, что транзакция содержит данные, подлежащие импорту в файлы или элементы хранилища.

Vaultname

Название хранилища, с которым связана данная транзакция. Правило импорта обрабатывает транзакции с соответствующим именем хранилища.
Aliasset

Набор псевдонимов для поиска дочерних узлов атрибутов. Имена атрибутов в файле XML сопоставлены с переменными, связанными с псевдонимами.

Например, набор псевдонимов, содержащий переменную X2Number с атрибутом NR в файле XML, настроен таким образом, чтобы соответствовать переменной карты данных Number.

Пустое значение сопоставляет переменные карты данных с именами атрибутов в файле XML.
<document …> Содержит критерии для сопоставления значений импорта с файлом или элементом хранилища. Этот элемент соответствует значению переменной или уникальному внутреннему коду файла или элемента.
Атрибуты:
Pdmweid

Сопоставляет транзакцию с внутренним кодом документа DocumentID из таблицы Documents, входящей в файл или элемент базы данных хранилища.

При использовании этого атрибута система игнорирует атрибуты [id], [idattribute] и [idcfgname]. Для применения другого способа сопоставления необходимо обнулить значение или пропустить этот атрибут.

Idattribute

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

Идентификатор

Значение переменной, необходимое для поиска файлов или элементов. Поиск значения осуществляется с использованием имени переменной атрибута idattribute и дополнительной конфигурации Idcfgname в таблице базы данных VariableValue.

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

Idcfgname

Имя конфигурации (при наличии таковой), с которой сопоставляется значение переменной. Если этот атрибут оставлен без значения, при сопоставлении учитываются все конфигурации файла.
<configuration …> Конфигурация карты данных файла, подлежащая обновлению с помощью значений атрибутов. Если этот атрибут оставлен без значения, обновляются все конфигурации.

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

Атрибут:
имя
<attribute …>
Атрибуты:
имя

Имя переменной карты данных, подлежащей обновлению, в виде VariableAlias.Alias (Псевдоним_переменной.Псевдоним) или Variable.VariableName (Переменная.Имя_переменной).
Значение

Значение, необходимое для настройки заданной переменной. Не должно содержать более 1024 символов.