Раздел 8 Обмен данными > Описание формата обмена данными

Обмен данными между МУ и ЦБД происходит при помощи передачи файлов обмена данными. Файлы обмена данными представляют собой XML-файлы.

Формат XML-файлов обмена данными:

Первая строка XML-файла описания данных называется объявлением XML – это строка, указывающая версию XML. Также здесь может быть указана кодировка символов.

Далее следует корневой тэг DATA.

Атрибуты:

•	DBVERSION – строка, содержащая версию локальной БД. Примечание: если значение этого атрибута не совпадает с текущей версией локальной БД, то обмен будет невозможен.

•	KILLALL – логический признак, обозначающий следует ли очистить данные из базы данных перед загрузкой. Атрибут необязателен.

•	DATASOURCENAME - строка, с именем источника данных, должно приходить в файле загрузки в МУ. Атрибут необязателен.

•	"DATASOURCEVERSION" - строка, с версией источника данных, должно приходить в файле загрузки в МУ. Атрибут необязателен.

•	"PLATFORMVERSION" - строка, с версией платформы "Агент Плюс 2.0", передается при выгрузке данных из МУ.

•	"CONFIGNAME" - строка, с именем конфигурации, передается при выгрузке данных из МУ.

•	"CONFIGVERSION" - строка, с версией конфигурации, передается при выгрузке данных из МУ.

Внутри тэга DATA описывается состав загружаемых/выгружаемых объектов. Тэг DATA может содержать следующие вложенные тэги:

•	Тэг CONSTANTS – задает объект "Константы";

•	Тэг CATALOGS – задает объект "Справочники";

•	Тэг DOCUMENTS – задает объект "Документы";

•	Тэг NUMERATORS – задает объект "Нумераторы";

•	Тэг PICTURES – задает объекты "Картинка".

Внутри тэгов CONSTANTS, CATALOGS, DOCUMENTS, NUMERATORS, PICTURES содержатся специальные тэги, описывающие состав объектов, см. подразделы "Константы", "Справочники", "Документы", "Нумераторы", "Картинка".

Пример:

<?xml version="1.0" encoding="utf-16"?>

...

</CONSTANTS>

</DATA>

Примечание:

При выгрузке данных в файл выгрузки попадают только те объекты, которые были созданы или изменены в приложении на МУ.

Формат описания значений

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

Типы значений и варианты их представления (как они должны выглядеть в файлах обмена данными) приводятся в таблице ниже:

Таблица. Список типов значений

Тип значения	Примеры представления
GUID	"3935BEAE-9F40-4BA5-BA9E-03F860CC1750" "3343E400-1577-4DDE-9A82-BF1E53267FD6" Идентификатор GUID имеет строго определенную структуру. Он состоит из 5 групп символов. Первая группа состоит из 8 символов, вторая – из 4 символов, третья – из 4 символов, четвертая – из 4 символов, пятая группа – из 12 символов. Не допускаются пробелы перед идентификатором и после идентификатора, указание разделителей "-" между символами в приведенных выше позициях обязательно. Фигурные скобки перед и после идентификатора недопустимы (принятое обозначение для идентификаторов в OLE). Допустимые символы в идентификаторе: от "0" до "9" и от "A" до "F" (или от "a" до "f").
Строка	"Сидоров А.В." Произвольная строка.
ДатаВремя	"2011-06-03T14:43:35" В примере указана дата и время: 3 июня 2011 года, 14 часов 43 минуты 35 секунд. Дата и время отделяются латинской буквой "T".
Число	"100" "12.56" В качестве разделителя дробной части используется точка.

Пример файла обмена данными:

<?xml version="1.0" encoding="utf-16"?>

</ELEMENTS>

</KILLEDS>

</CONSTANTS>

</ELEMENTS>

</KILLEDS>

</GROUP>

</ELEMENTS>

</KILLEDS>

</GROUP>

</GROUPS>

</ELEMENTS>

</KILLEDS>

</CATALOG>

</GROUPS>

</ELEMENTS>

</KILLEDS>

</CATALOG>

</CATALOGS>

</TABLE>

</TABLES>

</ITEM>

</TABLE>

</TABLES>

</ITEM>

</ELEMENTS>

</KILLEDS>

</DOCUMENT>

</DOCUMENTS>

</DATA>