«ГлоL9;кая куL9;здра штеL9;ко будлануL9;ла боL9;кра и курдяL9;чит бокрёнка»
(первая ассоциация, пришедшая в голову
после прочтения «мана» о XDTO-пакетах)
Приветствую, многоуважаемый all!
После долгого молчания, вызванного тем, что я сейчас больше читаю, чем пишу (чукча читатель, а не писатель), я решил поделиться с вами небольшим обзором, в котором хочу рассказать о том, что я узнал о XDTO-пакетах и обо всем, что с ними связано. Сразу скажу, что в интернете есть документация на эту тему и вообще гугл никто не отменял, но, на мой взгляд, ее как-то маловато. Пусть будет еще. Итак.
С чего начинается?..
С чего начинаются XDTO-пакеты для неискушенного разработчика? Для меня они начались с вопроса: «А что это еще за хренотень в дереве метаданных?» И еще я знал, что это что-то про xml. Но мы начнем не с этого. А с объекта ФабрикаXDTO. Как можно догадаться из названия, это фабрика объектов (XDTO расшифровывается как XML Data Transfer Objects).
Небольшое лирическое отступление. Лучше понять, что такое «фабрика объектов», можно из замечательной книги «Приемы объектно-ориентированного проектирования. Паттерны проектирования» в частности, в разделе о шаблоне «Абстрактная фабрика», или «Фабричный метод». Книга, хочу заметить, действительно стоящая, но мозголомная, скорее формата «справочник», а не «учебник». Вдобавок все, что там написано, сложно применимо к 1С. Когда-нибудь я разозлюсь и напишу здоровенную статью о шаблонах (привет, kote!), а то досадно, что некоторые 1С-программистов даже считать не собираются. Инструмент не должен стоять на пути человека к вершинам профессионализма. Но пока не об этом.
Итак, говоря простым языком, фабрика объектов — это некое «устройство», умеющее принять на входе описание объекта и сгенерировать по этому описанию объект определенного типа, «пригодный к употреблению». Или несколько. То есть это в прямом смысле фабрика: загрузили «чертеж», и она пошла штамповать «продукцию» по «чертежу» (для дотошных: «сырье» в этом случае ваше процессорное время, электричество и т.д.).
Тут я просто вынужден послать вас ознакомиться с хорошей статьёй о простых типах в XDTO с диска ИТС. Если бы это было целесообразно, я бы всю ее скопипастил сюда, но зачем? И все же один пример я оттуда возьму. Для наглядности.
Вот так в статье описывается работа с объектом «Структура»:
структурныйТип = ФабрикаXDTO.Тип("http://www.1c.ru/demos/products", "Номенклатура");
номенклатура = ФабрикаXDTO.Создать(структурныйТип);
номенклатура.Наименование = "Ботинки женские";
номенклатура.ЗакупочнаяЦена = 1000;
Для этого примера я бы нарисовал такую диаграмму:
Обратите внимание, что объект «структурныйТип» (т.н. «чертеж») тоже был создан фабрикой, на основании «загадочных» строчек. Рассмотрим, что же это за строчки. Про метод «Тип» объекта «ФабрикаXDTO» синтакс-помощник пишет:
Синтаксис: Тип(< URIПространстваИмен>, < Имя>) Возвращаемое значение: Тип: ТипЗначенияXDTO; ТипОбъектаXDTO; Неопределено. Описание: Получение типа XDTO.
Не слишком информативно. Тем не менее понятно, что на основании какого-то пространства имен и имени типа метод «Тип» создает нам необходимый «чертёж». Про пространства имен можно почитать, например, в статье «Коротко о пространствах имен (XML Namespaces)», или терзайте жужл запросом «xmlns». Вкратце же скажу, что это некая область, в которой вы можете определить свои xml-теги, и они будут означать именно то, что вы в них закладывали при определении. Например, тег < table> в пространстве имен, определяющем HTML-документ, означает описание таблицы, а в вашем собственном он может означать, например, блок описания стола. Чтобы их не путать и нужны пространства имен.
Тут есть очень важный момент, который сначала вводит в заблуждение. Название пространства имен напоминает адрес страницы в интернете, и сразу же хочется посмотреть, что там такое по этому адресу. Так вот. Технически название может быть любым, но разработчики договорились, что все будут использовать в качестве названия пространства имен URL, по которому в интернете находится страница с описанием этого пространства имен, понятным человеку. К тому же так обеспечивается уникальность названий пространств имен, поскольку в интернете не может быть двух страниц с одинаковым адресом. И «ФабрикаXDTO» при генерации типа XDTO, конечно же, не лезет в интернет ни за какими данными. К сожалению, не все соблюдают правило о публикации человеческих описаний (сволочи!), и уж тем более нехорошо использовать адреса на чужих доменах (как в примере). Мало ли какую информацию фирма 1С воткнет со временем на страницу http://www.1c.ru/demos/products. Это может вводить в заблуждение, поэтому в production-коде я настойчиво рекомендую использовать собственные домены и писать описания. Коллеги разработчики, давайте заботиться друг о друге.
Все же XDTO-пакеты
Поскольку мы выяснили, что данные о пространстве имен берутся не из интернета, возникает вполне резонный вопрос: откуда же тогда, черт побери?! И вот тут мы подходим к тому самому разделу «XDTO-пакеты» в дереве метаданных в конфигураторе. Внимательный читатель, наверное, заметил (если еще не забыл после моих лирических отступлений), что в примере мы использовали объект «ФабрикаXDTO», нигде его не создавая. Все верно, в глобальном контексте 1С есть такой объект (я бы сказал «синглтон»), который знает о куче разных пространств имен, уже описанных в конфигураторе и вообще в платформе. То есть для того, чтобы наш пример заработал, нам необходимо создать примерно такой XDTO-пакет:
То есть мы создали тип объекта «Номенклатура», в который добавили два свойства: «Наименование» и «ЗакупочнаяЦена». Обратите внимание, что при создании пакета мы задали ему то пространство имен, которое в дальнейшем будем использовать при создании объекта «структурныйТип». Если вы посмотрите конструктор свойств, то можете увидеть там много интересного. Например, для моего свойства «Наименование» я использовал тип «string (http://www.w3.org/2001/XMLSchema)». Запомните это пространство имен. В нем описаны все базовые типы, которые вы можете использовать в своих объектах, такие как «string», «int» и так далее. После того как мы добавили пакет, объект «ФабрикаXDTO» знает о нашем пространстве имен и описанных в нем типах.
Нужно помнить, что пространства имен, описанные в разделе дерева метаданных «XDTO-пакеты», доступны только на сервере. При попытке обратиться к ним из клиентского кода (так же как и при других ошибках) метод «Тип» вернет «Неопределено». Этот момент несколько раздражает при отладке, мне кажется, что лучше бы оно ругалось чем-нибудь вроде «Тип не найден», но «маємо те, що маємо».
В своих объектах вы можете использовать и собственные типы из вашего пространства имен. Например, давайте добавим единицы измерения:
В качестве типа для свойства «ЕдИзм» я установил тип «ЕдиницаИзмерения (http://www.1c.ru/demos/products1)», просто выбрав его из дерева определенных в конфигурации типов.
А вот код, который создает этот объект:
структурныйТип = ФабрикаXDTO.Тип("http://www.1c.ru/demos/products1", "Номенклатура1");
номенклатура = ФабрикаXDTO.Создать(структурныйТип);
номенклатура.Наименование = "Ботинки женские";
номенклатура.ЗакупочнаяЦена = 1000;
единицаТип = ФабрикаXDTO.Тип("http://www.1c.ru/demos/products1", "ЕдиницаИзмерения");
единица = ФабрикаXDTO.Создать(единицаТип); единица.Наименование = "шт.";
единица.Коэффициент = 1.5;
номенклатура.ЕдИзм = единица;
Надеюсь, принцип понятен. Можете самостоятельно поиграться со свойствами, типами, объектами и прочим. Там есть куда «потыкать пальцем» и чего попробовать. А я тем временем продолжу.
Сериализировали-сериализировали
Что полезного мы уже можем извлечь из того, что знаем? Во-первых, объекты XDTO прекрасно сериализуются (XML же, как вы помните).
Дополним код вот таким фрагментом:
ИмяФайла = "D:Tempstruct.xml";
МойXML = Новый ЗаписьXML;
ПараметрыЗаписиXML = Новый ПараметрыЗаписиXML("UTF-8", "1.0", Ложь);
МойXML.ОткрытьФайл(ИмяФайла, ПараметрыЗаписиXML);
МойXML.ЗаписатьОбъявлениеXML();
ФабрикаXDTO.ЗаписатьXML(МойXML, номенклатура);
МойXML.Закрыть();
На выходе мы получим вот такой файл:
< Номенклатура1 xmlns="http://www.1c.ru/demos/products1" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> < Наименование>Ботинки женские< Наименование> < ЗакупочнаяЦена>1000< ЗакупочнаяЦена> < ЕдИзм> < Наименование>шт.< Наименование> < Коэффициент>1.5< Коэффициент> < ЕдИзм> < Номенклатура1>
Теперь вы можете послать его друзьям по электронной почте, если, конечно, их интересуют женские ботинки. =)
Но поскольку объекты сериализуются, то они так же замечательно и десериализуются.
Давайте попробуем:
структурныйТип = ФабрикаXDTO.Тип("http://www.1c.ru/demos/products1", "Номенклатура1");
ИмяФайла = "D:Tempstruct.xml";
МойXML = Новый ЧтениеXML;
МойXML.ОткрытьФайл(ИмяФайла);
номенклатура = ФабрикаXDTO.ПрочитатьXML(МойXML, структурныйТип);
МойXML.Закрыть();
Сообщить(номенклатура.ЕдИзм.Наименование);
Вы когда-нибудь разбирали xml-файлы построчно, вылавливая значки «больше»-«меньше» бесконечными «Найти» и «Сред/Лев/Прав»? А пользовались ли вы замечательным объектом «ЧтениеXML» для разбора файла по тегам, которые потом приходилось разгребать вручную в какую-нибудь структуру? Теперь, если у вас правильно описаны XDTO-пакеты и типы в них, вы можете загружать xml сразу в объект и дальше работать с ним как с объектом. На мой взгляд, это замечательно и удобно.
К тому же при загрузке xml-файла происходит его валидация на соответствие типу, и в случае ошибки метод вызывает исключение. Поэтому, конечно же, правильный код по загрузке xml будет такой:
Попытка номенклатура = ФабрикаXDTO.ПрочитатьXML(МойXML, структурныйТип);
Исключение Сообщить(ОписаниеОшибки()); // еще какая-нибудь обработка исключения
Возврат;
КонецПопытки;
Что еще полезного можно получить из XDTO-пакетов? А вот что! Также мы можем очень просто выгружать объекты метаданных. В конфигурации есть пространство имен, в котором есть все типы XDTO присутствующих в конфигурации метаданных.
Добавим справочник «Клиенты», создадим в нем один элемент и напишем такой код:
// Получим объект СпрКлиенты = Справочники.Клиенты;
Выборка = СпрКлиенты.Выбрать();
Пока Выборка.Следующий() Цикл
КлиентОбъект = Выборка.ПолучитьОбъект();
Прервать;
КонецЦикла;
// Создадим ОбъектXDTO
клиентыТип = ФабрикаXDTO.Тип("http://v8.1c.ru/8.1/data/enterprise/current-config", "CatalogObject.Клиенты");
клиент = ФабрикаXDTO.Создать(клиентыТип);
// Заполним ОбъектXDTO и сохраним его
ЗаполнитьЗначенияСвойств(клиент,КлиентОбъект);
ИмяФайла = "D:Tempсlient.xml";
МойXML = Новый ЗаписьXML;
ПараметрыЗаписиXML = Новый ПараметрыЗаписиXML("UTF-8", "1.0", Ложь);
МойXML.ОткрытьФайл(ИмяФайла, ПараметрыЗаписиXML);
МойXML.ЗаписатьОбъявлениеXML();
ФабрикаXDTO.ЗаписатьXML(МойXML, клиент);
МойXML.Закрыть();
В первой части кода, там, где мы получаем объект, ничего интересного не происходит, мы просто получаем объект (весьма коряво, надо отметить, но для примера пойдёт).
Зато обратите внимание на пространство имен и имя объекта в строчке, где создается объект «клиентыТип». В пространстве имен «http://v8.1c.ru/8.1/data/enterprise/current-config» должны быть описаны все объекты метаданных конфигурации, в чем вы можете убедиться, если посмотрите его в конструкторе XDTO-пакетов. Дальше уже знакомая процедура — сохранение объекта в XML.
Вот что получилось у меня:
< ?xml version="1.0" encoding="UTF-8" ?> < CatalogObject.Клиенты xmlns="http://v8.1c.ru/8.1/data/enterprise/current-config" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> < Ref>b0fc4df2-0a54-11e1-8797-ac728931524e< /Ref> < DeletionMark>false< /DeletionMark> < Code>000000001< /Code> < Description>Тестовый клиент 1< /Description> < ТипКлиента>непоняно< /ТипКлиента> < /CatalogObject.Клиенты>
Как видите, тут есть все реквизиты, включая стандартные («Наименование», «Код»), а также ссылка («Ref») и пометка на удаление («DeletionMark»).
Естественно, этот файл также можно загрузить обратно в объект. Код, надеюсь, вы уже можете написать сами.
В помощь юному падавану-сериализатору в 1С есть объект «СериализаторXDTO». Он также представлен как «синглтон», доступный в глобальном контексте, и как отдельный тип. В принципе, строки:
// Создадим ОбъектXDTO
клиентыТип = ФабрикаXDTO.Тип("http://v8.1c.ru/8.1/data/enterprise/current-config", "CatalogObject.Клиенты");
клиент = ФабрикаXDTO.Создать(клиентыТип);
// Заполним ОбъектXDTO
ЗаполнитьЗначенияСвойств(клиент,КлиентОбъект);
можно смело заменить на:
// Создадим ОбъектXDTO и заполним его
клиент = СериализаторXDTO.ЗаписатьXDTO(КлиентОбъект);
Код получился короче и работает более корректно. Например, если в справочнике «Клиенты» определены табличные части, то «ЗаполнитьЗначенияСвойств» с их заполнением не справится. А сериализатор — запросто. Теперь, когда (я надеюсь) вы понимаете основные принципы работы XDTO-пакетов, вы запросто разберетесь с тем, что еще можно делать с сериализатором. Да пребудет с вами сила синтакс-помощника. А я продолжу.
XDTO-пакет? Не нужен!
К этому моменту вы, наверное, задаете себе (а заодно и мне) вопрос: «Хорошо, ну вот у меня есть описанный в конфигурации тип в XDTO-пакете, есть xml, и все вроде бы хорошо. А что делать, если мне пришел какой-то новый xml, в другом формате, а я хочу работать с ним как с объектом? Опять конфигуратор открывать и описывать там тип?»
Конечно, без описания типа вам не обойтись. Но конфигуратор для этого не нужен. И тут нужно рассмотреть такую замечательную вещь, как xml schemа. XML-cхема — это как раз и есть описание типа, представленное (внимание!) в формате xml.
Давайте сделаем какой-нибудь небольшой XDTO-пакет, что-нибудь вроде этого:
А теперь нажмите на кнопку «Экспорт XML-схемы…» (выглядит как ящик с листиком бумаги и стрелочкой) и сохраните схему в файл address.xsd
У меня получилось вот что:
< xs:schema xmlns:tns="http://www.1c.ru/demos/products2" xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.1c.ru/demos/products2" attributeFormDefault="unqualified" elementFormDefault="qualified"> < xs:complexType name="КлассификаторАдреса"> < xs:sequence> < xs:element name="Город" type="xs:string"/> < xs:element name="Улица" type="xs:string"/> < xs:element name="НомерДома" type="xs:int"/> < xs:element name="НомерКвартиры" type="xs:int"/> < /xs:sequence> < /xs:complexType> < /xs:schema>
Теперь удалите этот пакет из конфигурации, будто его и не было. Попробуем прочитать схему и создать по ней объект.
Вот код, который это делает:
ФайлыXSD = Новый Массив();
ФайлыXSD.Добавить("D:Tempadderss.xsd");
МояФабрикаXDTO = СоздатьФабрикуXDTO(ФайлыXSD);
адресТип = МояФабрикаXDTO.Тип("http://www.1c.ru/demos/products2", "КлассификаторАдреса");
адрес = МояФабрикаXDTO.Создать(адресТип);
адрес.Город = "Ленинград";
адрес.Улица = "3-я улица Строителей";
адрес.НомерДома = 25;
адрес.НомерКвартиры = 12;
ИмяФайла = "D:Tempaddress.xml";
МойXML = Новый ЗаписьXML;
ПараметрыЗаписиXML = Новый ПараметрыЗаписиXML("UTF-8", "1.0", Ложь);
МойXML.ОткрытьФайл(ИмяФайла, ПараметрыЗаписиXML);
МойXML.ЗаписатьОбъявлениеXML();
МояФабрикаXDTO.ЗаписатьXML(МойXML, адрес);
МойXML.Закрыть();
Здесь мы для разнообразия не стали использовать глобальный объект «ФабрикаXDTO», а создали собственный функцией «СоздатьФабрикуXDTO». Если вы посмотрите в отладчике на нашу фабрику («МояФабрикаXDTO»), то увидите, что в коллекции пакетов у нее всего два пакета: «http://www.w3.org/2001/XMLSchema» и «http://www.1c.ru/demos/products2», в отличие от «синглтона» «ФабрикаXDTO», где их существенно больше. В качестве бонуса мы получили то, что этот код может быть полностью исполнен на клиенте, так как не зависит от метаданных конфигурации.
На выходе я получил xml-файл, в который был сериализован мой объект:
< ?xml version="1.0" encoding="UTF-8" ?> < КлассификаторАдреса xmlns="http://www.1c.ru/demos/products2" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> < Город>Ленинград< /Город> < Улица>3-я улица Строителей< /Улица> < НомерДома>25< /НомерДома> < НомерКвартиры>12< /НомерКвартиры> < /КлассификаторАдреса>
Как вы видите, я поработал с объектом и сериализовал его без участия метаданных конфигурации. Таким образом, передавая вместе с xml-файлом также и XML-схему, вы можете быть уверенным, что тот, кто должен его получить, сможет разобраться, что с ним делать, а главное, как.
Пример десериализации приводить не буду, оставляю вам как самостоятельное упражнение.
Напоследок скажу, что можно выгрузить XML-схему всей вашей конфигурации, кликнув правой кнопкой по узлу «XDTO-пакеты». Результат получается поучительный, посмотрите.
Еще: если у вас есть xml-файл, с ним хочется поработать как с объектом, а XML-схему прислать никто не удосужился, вы можете воспользоваться замечательным инструментом xsd.exe из .NET Framework. (У себя я нашел его в папке «C:Program FilesMicrosoft SDKsWindowsv6.0Ain».) Пользоваться им очень просто: даете ему на вход xml, на выходе получаете xsd. Вообще-то этот xsd не всегда (или вообще никогда?) является файлом сразу же «готовым к употреблению» в 1С, но все равно это существенная помощь в создании XML-схемы.
Как видите, все оказалось достаточно просто.
На этом всё
Несмотря на то что статья оказалась неожиданно длинной, нельзя сказать, что все, что здесь описано, претендует на полноту. Пытливый исследователь XML-мира с легкостью напишет целую книгу по каждому абзацу этого небольшого обзора и еще ворох по тому, о чем здесь не сказано. Например, о том, что «вся эта кухня» тесно связана с web-сервисами. Тема обширна, так что дерзайте. Также я могу в чем-то заблуждаться, поэтому пишите комментарии — буду исправлять. Давайте учиться вместе.
А я желаю вам хорошего дня и хорошего кода. До новых встреч.
Прилагаю к статье dt-шник с примерами.
UPD.: Добавлено небольшое дополнение «XDTO-пакеты. Неименованные типы».
UPD.2: На инфостарте появились еще две прекрасные статьи об XDTO, так что если что-то не понятно из моей, обязательно посмотрите их: XDTO — это просто и XDTO — это просто, часть 2
Related Posts
Получение логина и пароля техподдержки 1С из базы
Класс для вывода отчета в Excel
Счет-фактура для УПП
Библиотека классов для создания внешней компоненты 1С на C#- Акт об оказании услуг (со скидками) — внешняя печатная форма для Управление торговлей 11.1.10.86
Прайс-лист с артикулом в отдельной колонке
Спасибо! Все ясно и толково описано!
100 балов!
Спасибо! 200 балов!
А как быть когда к XML хранится и схема данных и сами данные? Как с таким XML работать? Самый простой пример таких файлов — файлы обменов XML
Все доходчиво и понятно. Когда первый раз увидел объект XDTO возникла такая же ассоциация: Что это за зверь такой? Спасибо автору
Отличная публикация! Must read для всех 1С:Специалистов.
p.s.
Новичкам начинать разбираться с шаблонами проектирования рекомендую не с «Приемы объектно-ориентированного проектирования. Паттерны проектирования», а с отличной .
Еслиб также еще по вэб-сервисам пройтись…
Спасибо за положительные отзывы, это вдохновляет писать еще.
(4) К сожалению, вот так сразу я не отвечу на этот вопрос. Самый очевидный ответ — разбирать на части, но может быть там есть какие-то хитрости или готовые объекты/шаблоны к разбору? Не знаю. У меня в планах есть (тс-с, никому ни слова!) написать продолжение к этой статье, с углублением в подробности, может быть ответ сам «всплывет» там? Вообщем, следите за обновлениями.
(7) Всему свое время. Может быть и до них дойдет. А, с другой стороны, почему бы вам самому не сделать этого? А мы с удовольствием почитаем. =)
(8)
Огромное Вам спасибо, несколько раз подходил к этой теме и после первой попытки оставлял, не пробился через нечеловеческий язык описания предмета. После прочтения статьи появилась ясность в мыслях.
Большое спасибо, статейка получилась довольно интиресной и подталкивающей дальше разбираться с XML )
п.с.
А по вэб-сервисам пройтись действительно не помишало бы…
Спасибо за ликбез!
Молодец, толково расписал! Спасибо!
Спасибо! Хоть кто-то нормальный языком объяснил что такое XDTO.
Мне понравился ваш стиль изложения. Браво.
Очень ненавящево и хочется дочитать есть моменты для улыбки, странно что в вашем такие статьи редкость, но все равно подписался
Спаибо, хорошая статья!
Спасибо. Помогло.
(0) Браво… Талантливо преподнесено. Браво.
Спасибо, как говорят стэндап-комики, «вы отличная публика».
(14) Благодарю. Увы, не всегда есть время писать статьи, потому и редкость.
(8) Отличная статья 100+. Крайне полезная, отлично уловили про трудности с XML, после прочтения статьи буду делать по нормальному, спасибо.
Спасибо за толковую статью. Совсем недавно надо было сделать веб-сервис и столкнулся с проблемой очень скудной документации по этой теме, благо хоть была демо конфигурация с примерами….
Я как раз в данный момент читаю «Технологии интеграции» Хрусталевой. Нормальная книга, но вот конкретно про XDTO там написано мало 🙁 Так что спасибо автору за своевременную статью. Написано достаточно подробно и самое главное доступно
Спасибо большое, очень понятно и доступно, будем юзать.
Статья отличная, доходчиво и понятно, спасибо автору !
Статья хорошая, о вот интересно кто нибудь использует этого зверя на практике в рабочих конфигурациях, а не просто примеры разобрали и все?
(24) При использовании Web-сервисов не получится не использовать XDTO.
А не используют их в большей степени из-за того, что многим проще
изобрести свой велосипедсвой способ сериализации объектов в XML.Благодаря автору статьи, очень надеюсь, таких будет еще немного меньше.
Статья отличная!
Надеюсь на такую же статью по Web-сервисам!
Статья отличная!
Раньше этого зверя обходил стороной…
Теперь постараюсь разобраться.
Спасибо! Хороший материал.
спасибо.все понятно,хотя читал мимоходом
Эх! Если бы мне эту статью год назад… А то я все волосы на голове вырвал пока написал обмен документами между 1С: Розница и 1С: Управление производственным предприятием через XDTO 🙂
Не понимаю почему сама 1С не использует эту технологию для обмена. Сериализация больших объектов (например документы с десятками тысяч строк) происходит практически мгновенно, десериализация тоже очень быстрая.
(25)
«При использовании Web-сервисов не получится не использовать XDTO»
Это не соответствует действительности. Не вводите народ в заблуждение.
Попробовал выполнить СериализаторXDTO.ЗаписатьXDTO(СправочникОбъект), возвращаемое значение имеет тип ЗначениеXDTO, а не ОбъектXDTO, при последующем сохранении в файл XML выгружается только GUID объекта. В справке указано следующее условие «Для типа записываемого значения должно быть преобразование в XDTO», что это значит ?
(32) Проверьте тип переменной «СправочникОбъект». То, что вы описываете совершенно правильно для тех случаев, когда вы пытаетесь сериализовать ссылку.
Что касается справки, думаю там пропущено слово «возможно»: «Для типа записываемого значения должно быть возможно преобразование в XDTO».
Для объектов конфигурации во встроенной фабрике «ФабрикаXDTO» оно всегда возможно, потому как в конфигурации всегда есть схема описания объектов метаданных в XDTO.
(33) Да, спасибо, так получилось, но реквизиты ссылочного типа выгружаются все равно как GUID. Еще недопустимы незаполненные реквизиты имеющие тип перечисление.
(34) Ну, тут ничего не сделаешь. Так и задумано. Ссылка — это GUID.
Кстати, для интересующихся, есть .
(31) Поясните.
(37)
А чего тут пояснять? При использовании web-сервисов не обязательно использовать XDTO. Этой ветки в конфигураторе могло вообще не быть, и тем не менее веб-сервис работал бы.
(38) Все равно не понятно, что вы имеете в виду. С простыми типами все понятно, а с объектами чуть посложнее как быть? Сериализовать вручную?
(36) а как же рекомендации по оформлению схем XML: «Схема XML не должна содержать анонимных типов» ?
(40) Не должна — не создавайте! =)
С другой стороны, на практике такие типы встречаются часто. Не всегда именно от тебя зависит какой будет схема. И надо же как-то с ними работать.
Статья (и с дополнением) очень доступно описывает саму XDTO-технологию. Но чего, по-моему, не хватает в ней — так это обрисовать области (и границы, и условия) ее применения в 1С. По легкому намеку в конце статьи подумалось, что уважаемый zfilin именно на реализации web-сервисов накопил свой опыт. В (30) речь шла уже об обмене данными между разными конфигурациями. Голоса из клана 1С поминают еще обмен с «не 1С»-системами… Но всё это возможно и без XDTO, да наверное, и вообще без XML…
Так когда же стоит браться за XDTO, а когда не стоит?
(42) gaglo, Вы меня разоблачили! Я специально не хотел затрагивать какую-то конкретную область применения XDTO именно из-за того, что практически в любом применении можно без XDTO обойтись. Сериализация это всего-лишь способ представления данных, поэтому какой именно механизм применять для получения нужного представления (XDTO или собственный или еще какой-нибудь) — не важно. В статье же не хотелось отвлекаться на такие подробности, а хотелось как-раз наоборот сосредоточиться на самом XDTO.
Что же касается самого вопроса — «Так когда же стоит браться за XDTO, а когда не стоит?»
Я бы сказал так. Если вы имеете дело с xml или с необходимостью передавать объекты как текст (сериализовывать их) то следует попробовать или хотя бы вдумчиво оценить возможность использовать XDTO. Это может существенно облегчить работу с вашими данными и объектами.
Но не стоит выключать голову, так как, возможно, именно ваша задача не имеет простого решения на XDTO-XML из-за ограниченности функционала XDTO или, собственно принципов XML. Все нужно критически оценивать.
Увы, вопрос «хорош ли XML вообще и в каких случаях» существенно шире рамок этой статьи. Лично я считаю, что в некоторых случаях применение xml исключительно вредно (например в сериализации простых табличных данных или массивов), но есть и другие мнения. И целые холивары.
(43) Вот уж чего не хотелось, так это разоблачать! «Тут разоблачать нечего, и так всё ясно.» (С)
И тем более холивары про блеск и нищету XML заводить ;-] ( их уже было…)
Однако! Не согласен я с мыслью «какой именно механизм применять для … — не важно«. По-моему, так важно: один механизм легче, другой гибче, а третий я хорошо знаю и вообще к нему привык. И опять приходится включать голову — и выбирать.
Большое спасибо за описание этого механизма; видно, придётся действительно пробовать его использовать; тогда только и станет ясен вкус и цвет граблей…
(44) Добавлю к (43) один формальный критерий выбора: XDTO однозначно следует рассматривать в качестве основного средства сериализации данных 1С, когда речь идет о реализации интеграции 1С с системами, средства разработки которых (или сами системы) имеют инструментальную поддержку XDTO, а именно, умеют на основе схемы XDTO или WSDL (если речь идет о web-сервисах) автоматически генерировать описания классов на языке, используемым этой системой разработки. Сокращает трудозатраты на разработку в разы.
Статья отличная!
Надеюсь на такую же статью по Web-сервисам!
присоединяюсь. спасибо
Наконец то хоть что-то стало понятно!
(44) Имелось ввиду «не важно для конечного результата». Для разработчика, разумеется, это исключительно важно.
(45) Согласен конечно же так.
(49) Э-э-э?
Спасибо автору за статью, «доступно и всерьез», что называется. «Черный ящик» XDTO для меня ракрыт. Да здравствует Интеграция!
(42) Вот, кстати, только сегодня я совершенно случайно натолкнулся на еще одну область применения XDTO. Оказалось, что очень удобно сериализовать настройки КомпоновщикаНастроек СКД, чтобы куда-то их сохранить, а потом вновь открыть эти же настройки. Даже как-то стыдно стало, что не упомянул такую удобную вещь.
Супер, автор держи плюс!
Очень интересная статья. Только есть вопрос. У меня есть файлик формата xml и есть его схема xsd. Как можно быстро проверить соответствует ли данный файлик формата xml его схеме xsd ?
В таком объекте, как «Msxml2.DOMDocument.4.0» есть метод «validate».
Использовать очень просто — создается объект «Msxml2.DOMDocument.4.0», создается объект «Msxml2.XMLSchemaCache.4.0», загружается схема, связывается с объектом, загружается xml в объект и делается валидация. Вот тут очень хороший пример:
var xmlDoc = new ActiveXObject(«Msxml2.DOMDocument.4.0»); var xsdCache = new ActiveXObject(«Msxml2.XMLSchemaCache.4.0»); xsdCache.add(«», «example.xsd»); xmlDoc.async = false; xmlDoc.schemas = xsdCache; xmlDoc.load(«example.xml»); var err = xmlDoc.validate(); if (err.errorCode == 0){ WScript.Echo(«Document is valid»); }else{ WScript.Echo(«Validation error:» + err.reason); }Показать
Что же касается 1С-объектов, вроде ФабрикаXDTO, вот так с первого взгляда я отдельно метода «validate» не нашел. Можно попробовать загрузить xml в заранее подготовленную ФабрикуXDTO (с загруженной в нее схемой) при помощи «ФабрикаXDTO.ПрочитатьXML». При загрузке оно его валидирует и выдаст исключение, если что не так (об этом есть в статье).
Если можно еще проще, поделитесь, с удовольствием пополню свою коллекцию методов.
Спасибо за статью.
Никак не мог понять как при работе с web-сервисами передавать несколько значений. Теперь стало все проясняться.
Очень понятно для начинающего. но где бы найти как заполнять сложные xdto пакеты. очень надо
а кстати вопрос такой. как заполнить в пакете xdto значение если оно типа null… какой тип указать в пакете?
(58) Давайте с примером, а-то что-то я так сходу не врубаюсь.
Не совсем понимаю, как создавать конструктором фабрику на основании схемы или пакета. Откуда взять саму схему или пакет? Т.е. концепцию-то я понимаю, а вот правильного захода с использованием имеющихся объектов и их методов да свойств пока не нащупал. Примеров опять же нету. Буду очень благодарен, если подскажете, как.
СпасибоЮ Разъяснил четко и доходчиво. Это тема для меня была просто темный лес.
спасибо автору — очень доходчиво
Не совсем понимаю, как создавать конструктором фабрику на основании схемы или пакета. Откуда взять саму схему или пакет? Т.е. концепцию-то я понимаю, а вот правильного захода с использованием имеющихся объектов и их методов да свойств пока не нащупал. Примеров опять же нету. Буду очень благодарен, если подскажете, как.
Вот и меня интересует подробный, да и ряд других вопросов.
Товарищи, ну что ж вы. Пример-то был:
ФайлыXSD = Новый Массив();
ФайлыXSD.Добавить(«D:Tempadderss.xsd»);
МояФабрикаXDTO = СоздатьФабрикуXDTO(ФайлыXSD);
Создание на основании схемы из файла. Откуда взять схему или пакет, если есть только xml, вопрос риторический. Попробовать создать самому вручную или с помощью xsd.exe, опять-таки. Или стребовать оттуда, где вы взяли xml.
Спасибо, порлезная обработка и статья.
Спасибо! Отличная статья.
(59) да все уже разобрался. просто поставил фильтр чтобы такие значения ненужные не записывались в пакет в принципе
(67) Или так. =)
Всё это хорошо, но как сделать из 1С 8 xml с таким содержанием в начале:
———————————————————————————
<?xml version=»1.0″ encoding=»UTF-8″?>
<ED_Container xmlns=»urn:customs.ru:Information:ExchangeDocuments:ED_Container:5.0.3″ xmlns:CategoryCust=»urn:customs.ru:Categories:3.0.0″ xmlns:cat_ru=»urn:customs.ru:CommonAggregateTypes:5.0.3″ xmlns:clt_ru=»urn:customs.ru:CommonLeafTypes:5.0.3″ xmlns:xsi=»http://www.w3.org/2001/XMLSchema-instance» DocumentModeID=»1006058E»>
———————————————————————————
Сразу хочу сказать, что это сделано из сторонней программы, то есть не из 1С. У меня такое ощущение, что каким, то образом умудрились засунуть несколько пространственных имён или я что-то не понимаю?
Большое спасибо! Буду пробовать.
Интересная статья. Еще хотелось бы разабраться с типами, что означает в типе item, подтипы, например items и другие?
(72) tata12-01, Вы, видимо, не совсем поняли самое начало. Ветка «Типы объектов» содержит сложные типы, в отличие от ветки «Типы значений» и, в вашем случае, сложный тип item содержит свойство items (или, еще можно сказать поле items), которое само в свою очередь может быть какого-либо типа.
Т.е. все «подтипы», как вы их назвали (и что не верно) это те свойства, к которым вы можете обращаться у объекта типа item «через точку». Например, так:
Почитайте про ООП что-нибудь, будет понятнее.
НоваяЗаписьXML = Новый ЗаписьXML;
НоваяЗаписьXML.ОткрытьФайл(ДиалогСохраненияФайла.ПолноеИмяФайла);
НоваяЗаписьXML.ЗаписатьОбъявлениеXML();
НоваяЗаписьXML.ЗаписатьНачалоЭлемента(«ФайлОбмена»);
URI = «http://www.sample-package.org»;
ТипОбъектаXDTOСоздаваемого = ФабрикаXDTO.Тип(URI, «DocumentObject.ПриходнаяНакладная»);
НовыйОбъектXDTO = ФабрикаXDTO.Создать(ТипОбъектаXDTOСоздаваемого);
СсылкаДок = ФабрикаXDTO.Создать(ФабрикаXDTO.Тип(URI, «DocumentRef.ПриходнаяНакладная»), Док.УникальныйИдентификатор());
НовыйОбъектXDTO.ref = СсылкаДок;
НовыйОбъектXDTO.Date = Док.Дата;
НовыйОбъектXDTO.number = Док.Номер;
Контрагент = ФабрикаXDTO.Создать(ФабрикаXDTO.Тип(URI, «CatalogObject.Контрагенты»));
Контрагент.Ref = ФабрикаXDTO.Создать(ФабрикаXDTO.Тип(URI, «CatalogRef.Контрагенты»),Док.Контрагент.УникальныйИдентификатор());
Контрагент.Code = Док.Контрагент.Код;
Контрагент.Description = Док.Контрагент.Наименование;
ФабрикаXDTO.ЗаписатьXML(НоваяЗаписьXML, Контрагент,,,,НазначениеТипаXML.Явное);
НовыйОбъектXDTO.Контрагент = Контрагент.Ref;
ФабрикаXDTO.ЗаписатьXML(НоваяЗаписьXML, НовыйОбъектXDTO,,,,НазначениеТипаXML.Явное);
НоваяЗаписьXML.ЗаписатьКонецЭлемента();
НоваяЗаписьXML.Закрыть();
делал XDTO обмен для одной организации, использовал план обмена (самодельный)..он фиксировал изменения..а когда нужно было делать обмен, выполнялась процедура, которая перебирала изменения текущего узла созданного плана обмена и записывала в пакет, и тут же передавался этот в центральную базу, там записывался пакет с изменениями уже для меня, ну и соответственно принимались отправленные..всего в обмене участвовали 3 базы и одна центральная, которая собирала общую информацию и регистрировала их в плане обмена для передачи в другие базы
В процедуре ОбъектСервер():
КлиентыТип = ФабрикаXDTO.Тип("", "CatalogObject.Клиенты");
Клиент = ФабрикаXDTO.Создать(КлиентыТип);
// Заполним ОбъектXDTO
ЗаполнитьЗначенияСвойств(Клиент, КлиентОбъект);
переменная Клиент не содержит строк табличной части, так, после записи (ФабрикаXDTO.ЗаписатьXML(МойXML, клиент)), содержимое файла client.xml:
Показать полностью
<Description>Тестовый клиент 1</Description><ТипКлиента>непоняно</ТипКлиента></CatalogObj
В объекте КлиентОбъект (из приложенной демо базы) есть не пустая табличная часть.
Если вызывать СериализаторXDTO.ЗаписатьXDTO(КлиентОбъект), то табличные части появляются и в объекте XDTO и в файле.
(76) Guran, Все правильно. Функцию ЗаполнитьЗначенияСвойств я использовал для примера. Она не работает с табличными частями.
В действительности лучше использовать СериализаторXDTO. Об этом есть в статье.
Если вам по какой-либо причине необходимо использовать именно ЗаполнитьЗначенияСвойств, табличные части придется заполнять вручную. Цикл, и все такое.
Странно что 1С до сих пор так и не использует XDTO сериализацию для обмена между различными конфигурациями 1С. Через конвертацию данных получается очень медленно.
Меня лично напрягает то что как только внесеш изменения в одну из конфигураций — надо выгружать XSD схему и загружать ее в базу приемник чтобы при чтении не возникла ошибка чтения. Было бы удобнее если бы ошибку при десериализации можно было проигнорировать.
Огромнейшее спасибо за статью!
В наследство досталась база с веб-сервисами, и как ни крути не мог понять, что за «зверь» это «пространство имен» и прочее. Теперь все на своих «полочках».
Можно выделить несколько задач, для решения которых используется механизм XDTO:
● обмен данными между конфигурациями системы «1С:Предприятие» с разными схемами данных;
● обмен данными на основе схем XML, не привязанных к той или иной конфигурации (например, обмен с информационными системами, построенными не на основе системы «1С:Предприятие»);
● организация работы с Web-сервисами. Механизм XDTO позволяет описывать типы параметров и возвращаемых значений Web-сервисов, а также манипулировать передаваемыми и возвращаемыми данными.
Механизм XDTO обладает следующими ключевыми свойствами:
● обеспечивает работу с XML,
● привычная модель работы с данными.
В настоящее время обмен данными с различными программными платформами и системами реализуется с использованием XML: XML-документы служат для представления данных, а схема XML используется для описания форматов и структур данных. Механизм XDTO позволяет создавать требуемые для обмена схемы XML и формировать XML-документы, удовлетворяющие этим схемам.
В то же время использование механизма XDTO позволяет выполнять эти действия в привычной для большинства разработчиков системы «1С:Предприятие» манере.
Разработчик имеет дело с типами и объектами данных, объекты данных содержат свойства, свойствам присваиваются значения и т. д. При манипулировании данными с помощью XDTO разработчик максимально изолирован от подробностей, связанных с тем, как эти данные представлены в XML. Конечно, совсем избавиться от этих подробностей невозможно, но важно, что они проявляются только там, где это действительно нужно.
Отличная статья. Как раз попалась пара задач загрузки XML документов из не1С систем. Скормил их в xsd.exe, получил схемы, закинул в макеты, документы прочитались влет. дальше только номенклатуру нашел по идентификаторам и все!
Отличная статья. Как раз для один-эснигов 🙂
Я эту тему просек еще в далеком 2006 когда впервые увидел этот объект метаданных. И с тех пор для меня любая интеграция 1с с каким либо сайтом делается в два счета через web-сервис.
А «невьезжание» многих в этот объект обусловлено тем, что 1С никакой документации по этому вопросу не публиковало.
А 1С документацию не публиковало, ссылаясь на то что это разработка не их (пакеты XDTO) и поэтому они не будут документировать. И что вся документация по этому вопросу уже написана.
И они абсолютно правы. Вот только «не свою» разработку не надо было называть «своим» названием XDTO.
Этот метод уже дааааааавным-давно применяется в web-мире. И называется SOAP — протокол. И пакеты соответственно
SOAP — пакетами.
Вот и смотрите документацию на эту тему.
P.S. СОВЕТ Если Вам придется интегрировать 1С с каким либо сайтом, а сайт будут разрабатывать сторонние программисты, то никогда(!) не говорите им «обмен с вашим сайтом будем производить XDTO пакетами». После такой фразы web-программист морщит лоб и пытается понять что это за зверь такой.
Изъясняйтесь проще. Скажите что обмен будет по SOAP протоколу, SOAP-пакетами через web-сервис. Вот тогда любой web-программер поймет Вас с полуслова.
P.P.S ЕЩЕ БОЛЕЕ ВАЖНЫЙ СОВЕТ В наш век интернет технологий помимо 1С нужно еще хоть чуточку интересоваться сетевыми и web-технологиями. Иначе вы так и останетесь «локальным один-эснигом», который только и может что проводки подкорректировать, да какую нибудь хитрую обработку сварганить. А сейчас намного выше ценяться специалисты которые один программный продукт могут связать с другим в онлайновом режиме.
(82) bzmax, Спасибо за интересный комментарий. Про SOAP в курсе, так как в 1С пришел (ну, в том числе) из PHP.
Постараюсь следовать вашим советам и не стать «локальным один-эснигом».
(81) Tangram, Рад, что теории есть применение на практике. Спасибо за отзыв.
(83)
На здоровье. хорошего совета никогда не жалко.
Но вот то, что нашел время и доступно это все описал — за это громадный респект!!!
У самого знаний куча, да вот как то не удосужился хоть одну статейку написать.
Потому как ленивый очень 🙂 Наверно потому и пошел в программисты, что бы за меня все компьютер считал :))
P.S. Кстати в «пятом пыхе» (PHP5) есть замечательный модуль парселки этих самых пакетов (soap/xdto).
И этот модуль великолепно производить серилизацию/десерилизацию.
Помню долго, очень долго смеялись с другом (Делали проект электронной очереди с регистрацией из интернета.)
Я ваял со стороны 1С, а друг со стороны Web на «пятом-пыхе». Тогда мы первый раз решили попробовать эти пресловутые пакеты. И когда делали испытательные коннекты, друг звонил мне по телефону и страшным голосом говорил -«Оффигеть тут мне какой то странный тип данных передается!!» на мой вопрос «какой?» он ответил -«Тип данных Справочник.Клиенты !!!» Откуда ему бедняге было знать что помимо типов integer, varchar, decimal и т.д. еще бывают и такие типы «Справочник.Номенклатура», «Документ.ЧекККМ» и т.п. 🙂
(85) bzmax, =)))
Отличная статья!
А вот ответьте пожалуйста — замечательно и удобно это конечно плюс, а по скорости чтения как?
Перерыла кучу статей, публикаций про XDTO, где бы понятным языком было описание, примеры. Ваша статья сразу все по полочкам раставляет и описание, и примеры. У меня сразу вопрос появился, до этого я еще структуру xml файла изучала и его методы. И там был такой пример: сначала записывался элемент справочника в xml-фрагмент (насколько я конечно правильно выражаюсь), из него в текстовый документ. Потом из текстового документа с помощью объекта ЧтениеXML записываем в справочник этот элемент. Вот кусочек кода:
ТекстДок = Новый ТекстовыйДокумент;
ТекстДок.Прочитать(ПутьДляTXT);
ЧтениеXML = Новый ЧтениеXML();
ЧтениеXML.УстановитьСтроку(ТекстДок.ПолучитьТекст());
Если ВозможностьЧтенияXML(ЧтениеXML) Тогда
Об = ПрочитатьXML(ЧтениеXML);
Об.Записать();
КонецЕсли;
И потом я сравнила UID шестнадцатеричный, что был в файле и что получилось при записи объекта в справочник, они получились ОДИНАКОВЫМИ!
И вот попробовала Ваш второй пример выполнить, про клиента, когда мы заполняем из справочника объект XDTO. Я решила попробовать обратную запись из файла xml в базу 1С…когда выполняю кусок кода:
КлиентыТип = ФабрикаXDTO.Тип(«http://v8.1c.ru/8.1/data/enterprise/current-config»,»CatalogObject.Клиенты»);
ЧтениеXML = Новый ЧтениеXML;
ЧтениеXML.ОткрытьФайл(Путь);
Клиент = ФабрикаXDTO.ПрочитатьXML(ЧтениеXML, КлиентыТип);
ЧтениеXML.Закрыть();
Об = Справочники.Клиенты.СоздатьЭлемент();
ЗаполнитьЗначенияСвойств(Об, Клиент);
Об.Записать();
UIDы в справочнике и файле разные…я так понимаю, из-за того, что вызываю метод СоздатьЭлемент, он сразу присваивает новый UID, а как по-другому написать, чтобы были одинаковые?
(88) Kazan, Скорость не замерял, потому не скажу.
(89) anu, Все верно, это от того, что вы создаете новый элемент и он получает в базе новый UID. Вы попробуйте СериализаторXDTO использовать. Потому что ЗаполнитьЗначенияСвойств это совсем ручная работа, для демонстрации самого механизма. Не думаю, что кто-то пользуется этим на практике, когда есть сериализатор.
Если же хочется сделать все руками придется из xml получить UID и принудительно установить его новому элементу через УстановитьСсылкуНового, потому что ЗаполнитьЗначенияСвойств этого не делает (как и, например, не заполняет табличные части).
zfilin, понятно! Спасибо! Только не понятно, в первом случае (с текстовым документом), там одинаковый UID т.к. я тип не указала, а в описании про глобальный метод ПрочитатьXML написано —> «Если тип не указан, то будет произведена попытка определения типа значения непосредственно из представления XML», т.е. 2 варианта либо тип записывается в xml, либо конфигуратор его как-то определяет. До сериализатора я еще не дошла! Буду дальше изучать!
Разобрался. Спасибо.
(92) Не за что. =) Удачи в борьбе с XML. =)
недавно решал задачку — из пакета обмена 1С-ки выпилить некоторые изменения.
Пакет размером 10 Гб. Пытался использовать XML DOM и получал краш с нехваткой памяти.
Чтение через xdto не осилил — не понял как описать схему.
Ну а если не умеешь головой, то работай руками — парсил через чтениеxml и копировал данные в записьxml.
Хотелось бы всё же узнать как у XDTO с последовательным чтением огромных узлов? типа таких:
<data>
… — тут ~10 млн объектов
</data>
(94) Jogeedae, На больших объемах данных не пробовал, если будете писать статью «Большие объемы данных XDTO и XML», скиньте ссылочку. Самому интересно.
(94) Jogeedae, вам бы XPATH помог.
разобрался
Хорошая статья. С XML работаю уже довольно давно, но всё в «ручном режиме» — ЧтениеXML, ЗаписьXML. Разобраться с XDTO никак руки не доходили. Теперь полработы сделано:)
Может кто-нибудь напишет статью, посвященную обмену между базами разных конфигураций на основе xdto. когда объект1 из База1 надо «запихать» в объект2 Базы2