Примечания о структуре файла 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 |
Описание |
<?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 символов. |