Здесь, знаешь ли, приходится бежать со всех ног, чтобы только остаться на том же месте! Если же хочешь попасть в другое место, тогда нужно бежать по меньшей мере вдвое быстрее! (Королева «Алиса в зазеркалье»)
Доброго тебе дня, мой Дорогой Читатель! Проходи, садись поудобнее и приготовься внимать мне. Сейчас я предскажу твое будущее (свет меркнет, громы-молнии, звучит тревожная музыка)! Слушай же мой Читатель, что тебя ждет. Тебе рано или поздно придется столкнуться с XML (яркая молния, оглушительный грохот грома, запах озона).
Если ты разработчик 1С или пишешь на PHP, или С++, неважно, но рано или поздно тебе придется столкнуться с XML. Почему? Потому что это универсально, удобно, повсеместно, модно, круто, кросс-платформенно. XML правильно понимает и Android и Windows и Linux и все. Его используют для обмена информацией (например: электронные отчеты в налоговую, между конфигурациями 1С, для синхронизации с интернет-магазином). Его используют для хранения информации.
Итак, без долгих прелюдий приступим сразу к телу делу. Здесь не будет долгих описаний и определений. Просто несколько примеров. Но если вы собираетесь плотно работать с XML, то настоятельно рекомендую не полениться и почитать про XML и схемы XML (открывайте в Google Chrome, Firefox не совсем корректно работает с этим сайтом). Времени потратите не так много, а жизнь себе облегчите неимоверно.
Проблемой чтения/записи XML я столкнулся в связи с интеграцией с 1С корпоративных сайтов различных фирм, а именно, заказчики хотели чтобы кое-какая информация из 1С попадала на сайт и наоборот, и делалось это с некоторой периодичностью. Обычно это были продажи (информация для менеджеров), заказы (для дилеров) и различные примочки вроде журнала заявок, задач, отчетов и т.д.
СЛУЧАЙ I
Давайте предположим такую задачу, пусть на сайте некоего учебного заведения регистрируются студенты (не важно для чего, может чтобы пройти тестирование, а может чтобы талоны для столовой получить) и захотело руководство, чтобы эти данные попали в 1С в справочник «Студенты» (конфигурация «Учебное заведение 5.5 ). Программист PHP сказал «Бу сделано!» и выдал такой XML файл:
Здесь корневым элементов является элемент «students». Вложенным элементом является «student», где указана основная информация про студента учебного заведения. Элементы «name», «last_name», «sex» имеют тип «Строка», «birth» — «Дата», «level» (курс обучения) — «Число», «this_leader» (это староста группы) — «Булево». Нужно эти данные прочитать и разместить в справочнике «Студенты».
Как прочитать? Можно с помощью объекта «ЧтениеXML», но тогда нужно будет построчно обрабатывать документ. И хорошо если уровней вложенности всего лишь 2-3. А если их 10, и строк 10 тысяч? Тогда можно обработать с помощью «ДокументDOM», который создаст нам некое древовидное представление документа XML. Но тогда нам нужно будет каждый элемент обрабатывать отдельно, нужно будет программно прописывать, какой элемент преобразовывать в какой тип. Это не наш метод. Мой дорогой Читатель конечно же ознакомился с ссылками вверху и имеет представление об XML и его схемах. Давайте же создадим пакет XTDO и прочитаем с его помощью наш XML файл. Для этого я создал новую конфигурацию со следующими объектами:
Создал пакет XDTO «Чтение»:
Определил пространство имен «http://localhost/xdto». Если вы читали про XML и его схемы (ссылка выше) вы должны иметь представление, что такое пространство имен. А если не читали, то это некая уникальная интернет-ссылка (а интернет-ссылки все должны быть уникальными), где я определяю свои типы данных. Т. е. в пространстве имен (URI) »http://localhost/xdto» я определил тип students, который состоит из свойства student, который в свою очередь является сложным объектом и имеет свои свойства. А наф… зачем URI? Да затем, вдруг какой-нибудь чудак тоже определит тип students, что тогда? Конфликт? Разборки? Нет, у него будет другое пространство имен, например »http://tchudakov.net/blablabla». По хорошему, по адресу »http://localhost/xdto» у меня должно быть документация, информация, намек на то, что за схему я описал. Какие типы данных у меня, какие свойства. Мануал, одним словом. Но у меня там ничего нет. И у многих тоже ничего нет. Но Вы, мой дорогой Читатель, не берите пример с меня и таких как я. Если проект серьезный, сделайте документацию и потомки будут вам благодарны.
В этом пакете я описываю схему XML, т. е. это редактор, инструмент для создания схем. Вы даже можете нажать правой кнопкой мыши на пакет и экспортировать схему (файл с расширением .xsd). Для свойств я также указал типы: name, last_name, sex имеют тип string (http://www.w3.org/2001/XMLSchema). Как видите, тип string тоже определен в некоем пространстве имен, а именно его определяли сообща, на конференции w3 создавали стандарт. Свойство birth имеет тип date (http://www.w3.org/2001/XMLSchema), level - integer (http://www.w3.org/2001/XMLSchema), this_leader - boolean (http://www.w3.org/2001/XMLSchema). Как это сделано вы можете посмотреть развернув у себя выгрузку данной конфигурации (ссылка в конце статьи).
Эту же схему можно описать вот так:
А теперь найди 7 отличий. Шучу, отличие только одно, я создал тип type_student и для свойства student определил тип (см. рисунок выше, если слишком мелко, жмакните на него). Это называется явным определением типа. А до этого мы занимались неявным определением типа. Во как! А теперь давайте прочитаем XML и создадим элементы справочника. Для этого я создал обработку «ЧитаемXML», который также можете посмотреть в выгрузке, здесь же приведу только код:
&НаКлиенте Процедура ОдинСтудент(Команда) ОдинСтудентСервер(XML); КонецПроцедуры &НаСервереБезКонтекста Процедура ОдинСтудентСервер(XML) // Получаем тип XDTO и читаем XML лТип = ФабрикаXDTO.Тип("http://localhost/xdto", "students"); лЧтение = Новый ЧтениеXML; лЧтение.УстановитьСтроку(XML); лОбъект = ФабрикаXDTO.ПрочитатьXML(лЧтение, лТип); лДанные = лОбъект.student; // Проверяю, нет ли этого студента в базе лЗапрос = Новый Запрос("ВЫБРАТЬ | Студенты.Ссылка |ИЗ | Справочник.Студенты КАК Студенты |ГДЕ | Студенты.Имя ПОДОБНО ""%"" + &Имя + ""%"" | И Студенты.Фамилия ПОДОБНО ""%"" + &Фамилия + ""%"" | И Студенты.ДатаРождения = &ДатаРождения"); лЗапрос.УстановитьПараметр("Имя", лДанные.name); лЗапрос.УстановитьПараметр("Фамилия", лДанные.last_name); лЗапрос.УстановитьПараметр("ДатаРождения", лДанные.birth); лРезультат = лЗапрос.Выполнить(); // Если нет, создаю новый элемент Если лРезультат.Пустой() Тогда лСпр = Справочники.Студенты.СоздатьЭлемент(); // Иначе редактирую имеющийся Иначе лВыборка = лРезультат.Выбрать(); Пока лВыборка.Следующий() Цикл лСпр = лВыборка.Ссылка.ПолучитьОбъект(); Прервать; КонецЦикла; КонецЕсли; // Заполняю данными, заметьте, никакого преобразования не требуется лСпр.Имя = лДанные.name; лСпр.Фамилия = лДанные.last_name; лСпр.ДатаРождения = лДанные.birth; лСпр.Пол = лДанные.sex; лСпр.Курс = лДанные.level; лСпр.ЭтоСтароста = лДанные.this_leader; лСпр.Записать(); КонецПроцедуры // ПрочитатьИЗаписатьСервер()
Вы можете видеть, что код очень прост, и никакого преобразования элементов прочитанного XML не требуется, это делает уже ФабрикаXDTO. Ну что же, запустим нашу обработку и проверим, появится ли новый элемент в справочнике «Студенты». Ошибка!
Дело здесь вот в чем, в XML мы не указали name spaces (пространство имен), давайте возьмем XML, который я привел выше и добавим:
xmlns=»http://localhost/xdto» xmlns:xs=»http://www.w3.org/2001/XMLSchema» xmlns:xsi=»http://www.w3.org/2001/XMLSchema-instance» — вот что мы добавили и все заработало. Скачайте выгрузку базы данных (ссылка ниже), распакуйте у себя и попробуйте прочитать XML. Попробуйте изменить данные в XML, поэкспериментируйте.
СЛУЧАЙ II
Предположим что в XML у нас не один студент, а несколько (скорее всего так и будет):
Обратите внимание на комментарий , очень удобный редактор XML, а главное бесплатный. Если попробуете его прочитать с помощью схемы, которую мы сделали, вы получите ошибку, и это правильно, в схеме мы не указывали, что элементов student может быть много. Давайте исправим эту ситуацию, я создал новый пакет «ЧтениеСтуденты» и новое пространство имен «http://localhost/xdto/students» и изменил свойство «student»:
Обратите внимание, свойство «Максимальное количество» я изменил на «-1″, это означает, что элементов student может быть неограниченное количество. Если мы установим это свойство равным «3″, то элементов student не может быть больше 3 и т.д. Для обработки этого XML я создал новую процедуру, привожу скрин обработки:
Кнопка «Один студент» эта старая процедура, когда в XML была информация только по одному студенту, кнопка «Много студентов» для обработки информации по неограниченному числу студентов. Не забудьте изменить пространство имен в XML (второй красный кружок на рисунке). Запускаю обработку и все получается! Меняю данные (кроме имени, фамилии и даты рождения, при их изменении создается новый элемент справочника) и созданные элементы редактируются! Ну просто великолепно!
А здесь можете полюбоваться на код. Конечно, нельзя запрос в цикл помещать, по хорошему, нужно все данные получить одним запросом, но оптимизацией не буду заниматься, лень мне:
&НаКлиенте Процедура МногоСтудентов(Команда) МногоСтудентовСервер(XML); КонецПроцедуры &НаСервереБезКонтекста Процедура МногоСтудентовСервер(XML) // Получаем тип XDTO и читаем XML лТип = ФабрикаXDTO.Тип("http://localhost/xdto/many_students", "students"); лЧтение = Новый ЧтениеXML; лЧтение.УстановитьСтроку(XML); лОбъект = ФабрикаXDTO.ПрочитатьXML(лЧтение, лТип); Для Каждого лДанные Из лОбъект.student Цикл // Проверяю, нет ли этого студента в базе лЗапрос = Новый Запрос("ВЫБРАТЬ | Студенты.Ссылка |ИЗ | Справочник.Студенты КАК Студенты |ГДЕ | Студенты.Имя ПОДОБНО ""%"" + &Имя + ""%"" | И Студенты.Фамилия ПОДОБНО ""%"" + &Фамилия + ""%"" | И Студенты.ДатаРождения = &ДатаРождения"); лЗапрос.УстановитьПараметр("Имя", лДанные.name); лЗапрос.УстановитьПараметр("Фамилия", лДанные.last_name); лЗапрос.УстановитьПараметр("ДатаРождения", лДанные.birth); лРезультат = лЗапрос.Выполнить(); // Если нет, создаю новый элемент Если лРезультат.Пустой() Тогда лСпр = Справочники.Студенты.СоздатьЭлемент(); // Иначе редактирую имеющийся Иначе лВыборка = лРезультат.Выбрать(); Пока лВыборка.Следующий() Цикл лСпр = лВыборка.Ссылка.ПолучитьОбъект(); Прервать; КонецЦикла; КонецЕсли; // Заполняю данными, заметьте, никакого преобразования не требуется лСпр.Имя = лДанные.name; лСпр.Фамилия = лДанные.last_name; лСпр.ДатаРождения = лДанные.birth; лСпр.Пол = лДанные.sex; лСпр.Курс = лДанные.level; лСпр.ЭтоСтароста = лДанные.this_leader; лСпр.Записать(); КонецЦикла; КонецПроцедуры // МногоСтудентовСервер()
Если вы заметили, ну конечно вы заметили, никакого преобразования типов делать не пришлось.
СЛУЧАЙ III
Предположим, у нас есть XML, где нет информации по студентам (такой случай тоже нужно предусмотреть, в выгрузках бывает 1 элемент, бывает много, бывает что и ничего). Текст ниже:
Попробуем его прочитать нашей обработкой. Что получили? Фигу!
И правильно! Мы же в фабрике указали что элентов students может быть от одного до бесконечности. А здесь у нас ноль, поэтому и ругается. Давайте исправим этот момент:
Обратили внимание? Ну конечно обратили, я же, блин, красным овалом выделял (жмакайте на скрин, чтобы сделать больше). Минимальное значение я сделал равным нулю, а максимальное значение оставил -1, т. е. неограниченным. Теперь все чики пуки ( не знаю с какого языка это выражение). Можете сами проверить, нажмите на кнопку «Много студентов» в обработке.
СЛУЧАЙ IV
Все! Мы вроде предусмотрели все случаи! Можно идти пить… чай 😉. Но тут нам присылают еще один XML:
Вставляем XML в текстовое поле, жмем «Много студентов». Что получаем? Ошибку! А почему, посмотрите на XML. Появился новый элемент comment (комментарий), который не учтен в нашей фабрике. Что же делать? Можно его включить в нашу схему, но что если опять придет файл уже с другим элементом XML? Этот случай можно обработать следующим образом, открываем в фабрике свойства type_student и свойство «Открытый» устанавливаем «Истина»:
Ну вот и все. Теперь XML у вас прочитается без проблем. Теперь тэг student может содержать кроме заданных любые другие тэги и они буду прочитаны как строковый тип. Т.е. я могу использовать переданный мне элемент comment. Он определился как строковый. Свойство открытый означает, что тип может содержать кроме прописанных любые другие элементы, которые он прочитает как строковый. Все, выдохся. Удачи, везения и чтобы наглости вам не надо было занимать! dt-шка ниже.
