Пример рекурсивной выгрузки иерархической структуры в XDTO

Что такое XDTO?

Ну, полагаю, тут мало людей, кто не знает, что это такое. Но т.к. я постоянно вижу выгрузку в тот же CML, реализованную от незнания через обычную запись XML, куда гонятся узлы и атрибуты, то я думаю, что XDTO просто стращно звучит для многих. Упростим выражение до примитивов, чтобы и ежу было понятно.

Итак, XDTO — это, можно сказать, и есть объектная модель XML. Да, понятнее не стало, но я уже включаю тяжелую артилерию — наглядные пособия с картинками.

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

1. Создадим пакет XDTO

Для этого открываем конфигуратор и жамкаем правой кнопкой на XDTO-пакеты (в общих). Дальше нажимаем «Добавить»:

Да, вот так все просто. Кстати, пакет можно импортировать из файла XSD. Дальше надо прописать пакету какое-нибудь имя и это долбанное «URI пространства имен» (это любые символы, какие вам заблагорассудятся, но они потом будут использованы, так что креативчика поубавьте, чтобы не писать три страницы). Наш пакет пустой — он предмет простой (с). Давайте усложним — добавим Тип значений и пару Типов объектов:

Я, как видите, занялся идеей выгружать иерархическую структуру предприятия (кстати, ее потом сюда — в XDTO-пакет — можно будет загрузить и обойти). Поэтому я добавил Тип «УникальныйИдентификатор» и два Типа объектов — Классификатор и Подразделение. В классификаторе я определяю первичный контейнер для данных, а подразделение будет субконтейнером. В принципе, полагаю, можно обойтись и одним Подразделением, но так обычно не бывает и иерархический элемент воткнут в какой-то внешний контейнер.

Для Классификатора и Подразделения и создаю три свойства: Ид (с типом «УникальныйИдентификатор», который определен в пакете), Наименование и Подразделения с субконтейнером «Подразделение». Для свойства «Подразделение» я указываю тип «Подразделение» и прописываю минимальное и максимальное количество (0 и -1 соответственно). Это нужно для того, чтобы мы, во-первых, могли указать, что у данного подразделения нет подчиненных, а, во-вторых, могли бы указать любое количество подчиненных подразделений.

Так, с пакетом все.

2. Напишем код выгрузки

Создали пакеты, сохранили конфигурацию и создали внешнюю обработочку, да? Тогда давайте приступим к наполнению ее кодом.

Для того, чтобы получить наш пакет и начать с ним работать, нам надо получить какой-либо тип и создать на его основе XDTO-объект. В синтаксис-помощнике нет ни одного примера, поэтому тут придется показывать. Первая часть марлезонского балета выглядит как-то так:

Пакет = ФабрикаXDTO.Пакеты.Получить("sample-my-package");

Классификатор = ФабрикаXDTO.Создать(Пакет.Получить("Классификатор"));
Классификатор.Ид = ""+ (Новый УникальныйИдентификатор);
Классификатор.Наименование = "Организационная структура";

Видите, как просто! Получаем пакет из базовой фаблики по имени URI, чтоб ему пусто было. Никак не могу понять, кто эту хрень придумал, ну да ладно — не в этом суть. Главное — мы получили пакет, из которого теперь можем дергать свойства и создавать объекты XDTO. Дальше в коде мы получили на основании типа объекта «Классификатор» соответствующий объект XDTO. Дальше заполняем поля. А вот с иерархией все сложнее. Для простого случая можно сделать так:

Подразделения = ФабрикаXDTO.Создать(Пакет.Получить("Классификатор").Свойства.Получить("Подразделения").Тип);
Подразделение = ФабрикаXDTO.Создать(Пакет.Получить("Подразделение"));
Подразделение.Ид = ""+Выборка.УИН;
Подразделение.Наименование = Выборка.Наименование;
Подразделения.Подразделение.Добавить(Подразделение);

Тут мы добавили первый элемент в список подразделений. Чтобы подразделения попали в выгрузку, нам надо поместить объект «Подразделения» в Классификатор:

Классификатор.Подразделения = Подразделения;

В итоге мы получим только такой вот файл, если выгрузим это в XML:

<?xml version="1.0" encoding="UTF-8"?>
<Классификатор xmlns="sample-my-package" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Ид>1ea4a653-d292-4769-8ef7-91db4293f9b8</Ид>
<Наименование>Организационная структура</Наименование>
<Подразделения>
<Подразделение>
<Ид>6f87e821-722c-11df-b336-0011955cba6b</Ид>
<Наименование>Бухгалтерия</Наименование>
</Подразделение>
</Подразделения>
</Классификатор>

Для того, чтобы все отработало без лишних действий, напишем рекурсивную функцию, которая будет возвращать контейнер «Подразделения» Каталога:

Классификатор.Подразделения = ВыгрузитьРекурсивно(Пакет, "СтруктураПредприятия");

Далее сама функция:

Функция ВыгрузитьРекурсивно(Пакет, Справочник, Родитель = Неопределено)

Если Родитель = Неопределено Тогда
Уровень = ФабрикаXDTO.Создать(Пакет.Получить("Классификатор").Свойства.Получить("Подразделения").Тип);
Иначе
Уровень = ФабрикаXDTO.Создать(Пакет.Получить("Подразделение").Свойства.Получить("Подразделения").Тип);
КонецЕсли;
ЕстьОбъекты = Ложь;

Для Каждого Выборка ИЗ ПолучитьМассивЗначений(Справочник, Родитель) Цикл
ЕстьОбъекты = Истина;
Подразделение = ФабрикаXDTO.Создать(Пакет.Получить("Подразделение"));
Подразделение.Ид = ""+Выборка.УИН;
Подразделение.Наименование = Выборка.Наименование;
ПодразделенияУровня = ВыгрузитьРекурсивно(Пакет, Справочник, Выборка.Ссылка);
Если НЕ ПодразделенияУровня = Неопределено Тогда
Подразделение.Подразделения = ПодразделенияУровня;
КонецЕсли;
Уровень.Подразделение.Добавить(Подразделение);
КонецЦикла;

Возврат ?(ЕстьОбъекты, Уровень, Неопределено);
КонецФункции

Т.к. я решил все сделать на клиенте, то моей функции приходится дергать функцию с сервера, чтобы возвратился текущий уровень для указанного справочника.

В итоге вот такой файлик получился при выгрузке из демоторговли:

<?xml version="1.0" encoding="UTF-8"?>
<Классификатор xmlns="sample-my-package" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Ид>1ea4a653-d292-4769-8ef7-91db4293f9b8</Ид>
<Наименование>Организационная структура</Наименование>
<Подразделения>
<Подразделение>
<Ид>6f87e821-722c-11df-b336-0011955cba6b</Ид>
<Наименование>Бухгалтерия</Наименование>
</Подразделение>
<Подразделение>
<Ид>c37c8fa9-7ae7-11df-b33a-0011955cba6b</Ид>
<Наименование>Касса</Наименование>
</Подразделение>
<Подразделение>
<Ид>163cab6d-35ae-11e0-aefc-0015e9b8c48d</Ид>
<Наименование>Ларек "Розница"</Наименование>
</Подразделение>
<Подразделение>
<Ид>93961168-ed19-11e2-802e-0015e9b8c48d</Ид>
<Наименование>Магазин "Бытовая техника"</Наименование>
</Подразделение>
<Подразделение>
<Ид>163cab59-35ae-11e0-aefc-0015e9b8c48d</Ид>
<Наименование>Магазин "Продукты"</Наименование>
</Подразделение>
<Подразделение>
<Ид>163cab5a-35ae-11e0-aefc-0015e9b8c48d</Ид>
<Наименование>Магазин "Электротовары"</Наименование>
</Подразделение>
<Подразделение>
<Ид>a4212b47-730a-11df-b338-0011955cba6b</Ид>
<Наименование>Магазины (НТТ)</Наименование>
<Подразделения>
<Подразделение>
<Ид>163cab6d-35ae-11e0-aefc-0015e9b8c48d</Ид>
<Наименование>Ларек "Розница"</Наименование>
</Подразделение>
<Подразделение>
<Ид>93961168-ed19-11e2-802e-0015e9b8c48d</Ид>
<Наименование>Магазин "Бытовая техника"</Наименование>
</Подразделение>
<Подразделение>
<Ид>163cab59-35ae-11e0-aefc-0015e9b8c48d</Ид>
<Наименование>Магазин "Продукты"</Наименование>
</Подразделение>
<Подразделение>
<Ид>163cab5a-35ae-11e0-aefc-0015e9b8c48d</Ид>
<Наименование>Магазин "Электротовары"</Наименование>
</Подразделение>
</Подразделения>
</Подразделение>
<Подразделение>
<Ид>9e5ddc14-175a-11e2-bfa2-0015e9b8c48d</Ид>
<Наименование>Отдел доставки</Наименование>
</Подразделение>
<Подразделение>
<Ид>4d9d0772-7ab1-11df-b33a-0011955cba6b</Ид>
<Наименование>Отдел закупок</Наименование>
</Подразделение>
<Подразделение>
<Ид>51ed67e2-7220-11df-b336-0011955cba6b</Ид>
<Наименование>Отдел логистики</Наименование>
</Подразделение>
<Подразделение>
<Ид>51ed67a5-7220-11df-b336-0011955cba6b</Ид>
<Наименование>Отдел маркетинга</Наименование>
</Подразделение>
<Подразделение>
<Ид>be8a7643-f8df-11e2-802f-0015e9b8c48d</Ид>
<Наименование>Отдел оптовых продаж</Наименование>
</Подразделение>
<Подразделение>
<Ид>51ed67e1-7220-11df-b336-0011955cba6b</Ид>
<Наименование>Отдел продаж</Наименование>
<Подразделения>
<Подразделение>
<Ид>be8a7643-f8df-11e2-802f-0015e9b8c48d</Ид>
<Наименование>Отдел оптовых продаж</Наименование>
</Подразделение>
<Подразделение>
<Ид>6f87e81f-722c-11df-b336-0011955cba6b</Ид>
<Наименование>Отдел работы с дилерами</Наименование>
</Подразделение>
<Подразделение>
<Ид>6f87e820-722c-11df-b336-0011955cba6b</Ид>
<Наименование>Отдел работы с дистрибьюторами</Наименование>
</Подразделение>
<Подразделение>
<Ид>be8a7644-f8df-11e2-802f-0015e9b8c48d</Ид>
<Наименование>Отдел розничных продаж</Наименование>
</Подразделение>
<Подразделение>
<Ид>49278eed-7ef4-11df-866e-00d0d0817f92</Ид>
<Наименование>Торговые представители</Наименование>
</Подразделение>
</Подразделения>
</Подразделение>
<Подразделение>
<Ид>6f87e81f-722c-11df-b336-0011955cba6b</Ид>
<Наименование>Отдел работы с дилерами</Наименование>
</Подразделение>
<Подразделение>
<Ид>6f87e820-722c-11df-b336-0011955cba6b</Ид>
<Наименование>Отдел работы с дистрибьюторами</Наименование>
</Подразделение>
<Подразделение>
<Ид>be8a7644-f8df-11e2-802f-0015e9b8c48d</Ид>
<Наименование>Отдел розничных продаж</Наименование>
</Подразделение>
<Подразделение>
<Ид>6f87e81d-722c-11df-b336-0011955cba6b</Ид>
<Наименование>Сервисная служба</Наименование>
</Подразделение>
<Подразделение>
<Ид>1418c674-7307-11df-b338-0011955cba6b</Ид>
<Наименование>Склад мебели</Наименование>
</Подразделение>
<Подразделение>
<Ид>6f87e81e-722c-11df-b336-0011955cba6b</Ид>
<Наименование>Склады</Наименование>
<Подразделения>
<Подразделение>
<Ид>1418c674-7307-11df-b338-0011955cba6b</Ид>
<Наименование>Склад мебели</Наименование>
</Подразделение>
<Подразделение>
<Ид>1418c675-7307-11df-b338-0011955cba6b</Ид>
<Наименование>Торговый зал</Наименование>
</Подразделение>
<Подразделение>
<Ид>1418c673-7307-11df-b338-0011955cba6b</Ид>
<Наименование>Центральный склад</Наименование>
</Подразделение>
</Подразделения>
</Подразделение>
<Подразделение>
<Ид>49278eed-7ef4-11df-866e-00d0d0817f92</Ид>
<Наименование>Торговые представители</Наименование>
</Подразделение>
<Подразделение>
<Ид>1418c675-7307-11df-b338-0011955cba6b</Ид>
<Наименование>Торговый зал</Наименование>
</Подразделение>
<Подразделение>
<Ид>1418c673-7307-11df-b338-0011955cba6b</Ид>
<Наименование>Центральный склад</Наименование>
</Подразделение>
</Подразделения>
</Классификатор>

Вообще, ничего не жалко для народа — выкладываю свою наработку за недорого, если кто все же не понял, что и как.