Описание формата обмена данными

<< Click to Display Table of Contents >>

Navigation:  Раздел 8 Обмен данными >

Описание формата обмена данными

Navigation: Раздел 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"?>

<DATA DBVERSION="1789">

  <CONSTANTS>

   ...

  </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"

В качестве разделителя дробной части используется точка.

 

hmtoggle_plus1

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