Работа с простыми типами

Книга: Технологии интеграции "1С:Предприятия 8.3""

Назад: Тип ссылки на значение перечисления

Для работы с XML-представлениями значений простых типов предназначены два метода глобального контекста: XMLСтрока() и XMLЗначение().

Метод XMLСтрока() имеет единственный параметр – значение, для которого нужно получить XML-представление. Это значение должно относиться к типу, являющемуся простым с точки зрения XML-сериализации. В противном случае будет вызвано исключение. При нормальном завершении функция возвращает строку, которая может быть использована как текст элемента XML, представляющего значение простого типа.

Метод XMLЗначение() выполняет противоположную задачу. У этого метода два параметра. Первый параметр – тип значения, которое нужно получить из строки, второй параметр – сама строка.

Для преобразования типа данных «1С:Предприятия» в тип данных XML и наоборот предназначены методы XMLТип() и ИзXMLТипа(). Метод XMLТип() имеет один параметр – тип, для которого нужно получить соответствующий тип данных XML. Если соответствующий тип данных XML определен, то метод возвращает значение типа ТипДанныхXML. Если же соответствующего типа данных XML нет, то метод возвращает значение Неопределено.

Метод ИзXMLТипа() имеет два варианта вызова. В первом варианте метод имеет единственный параметр типа ТипДанныхXML. Во втором варианте параметра два: имя типа XML и пространство имен. В обоих случаях метод возвращает соответствующий типу данных XML тип данных «1С:Предприятия», если таковой имеется, или Неопределено в противном случае.

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

Для записи простых типов данных XML можно использовать следующий фрагмент кода (листинг 6.61).

Листинг 6.61. Процедура «ЗаписьПростыхТиповДанных()»

&НаКлиенте

Процедура ЗаписьПростыхТиповДанных(Команда)

АдресДокументаВХранилище = ЗаписьПростыхДанныхXML();

НачатьПолучениеФайлаССервера(АдресДокументаВХранилище);

КонецПроцедуры

В обработчике команды для записи XML-документа вызывается серверная функция ЗаписьПростыхДанныхXML(), в которой производится необходимая обработка данных, затем эти данные записываются во временный файл, который в виде двоичных данных сохраняется во временном хранилище, и адрес этих данных в хранилище возвращается на клиент (листинг 6.62).

Листинг 6.62. Функция «ЗаписьПростыхДанныхXML()»

&НаСервереБезКонтекста

Функция ЗаписьПростыхДанныхXML()

ИмяФайлаXML = КаталогВременныхФайлов() + "temp.xml";

Файл = Новый ЗаписьXML;

Файл.ОткрытьФайл(ИмяФайлаXML);

Файл.ЗаписатьОбъявлениеXML();

Файл.ЗаписатьНачалоЭлемента("Корневой");

// Записать значение типа Число.

// Получить значение "ТипДанныхXML" для числа.

ТипXML = XMLТипЗнч(1000);

// Создать элемент, имя которого совпадает с именем типа XML,

// при этом записать и пространство имен типа XML.