СписокXDTO.Вставить

Создать список трёх товаров по собственной схеме XDTO

Повторяющееся свойство item выдаёт СписокXDTO. Добавить/Вставить принимают типизированные элементы XDTO, а не произвольные строки.

Подготовка

1. В собственной отдельной конфигурации УчебнаяКонфигурацияСинтаксиса создайте серверный общий модуль УчебныеКоллекцииXDTO с флагом Сервер. Вставьте полный код выбранного урока.

2. Из серверной команды собственной учебной обработки вызовите УчебныеКоллекцииXDTO.ВыполнитьПример(). Метаданные справочников и документы не нужны.

3. В код встроена маленькая собственная XSD: Order содержит повторяющиеся строки item, Note — смешанный текст с числовыми элементами amount. Не подменяйте схему или XML данными неизвестного сервиса.

4. URI urn:guide:collections — идентификатор пространства имён, не адрес сервера. Схема не содержит import/include, DTD или внешних ссылок.

5. Все объекты и XML создаются в памяти. Нет файлов, сети, выполнения внешнего кода, записи базы или изменений пакетов XDTO конфигурации.

Процедура ВыполнитьПример() Экспорт
    XSD = "<xs:schema xmlns:xs=""http://www.w3.org/2001/XMLSchema"" xmlns:g=""urn:guide:collections"" targetNamespace=""urn:guide:collections"" elementFormDefault=""qualified"">
    |<xs:complexType name=""Order""><xs:sequence><xs:element name=""item"" type=""xs:string"" minOccurs=""0"" maxOccurs=""unbounded""/></xs:sequence></xs:complexType>
    |<xs:complexType name=""Note"" mixed=""true""><xs:sequence><xs:element name=""amount"" type=""xs:decimal"" minOccurs=""0"" maxOccurs=""unbounded""/></xs:sequence></xs:complexType>
    |<xs:element name=""order"" type=""g:Order""/><xs:element name=""note"" type=""g:Note""/>
    |</xs:schema>";
    ЧтениеСхемы = Новый ЧтениеXML;
    ЧтениеСхемы.УстановитьСтроку(XSD);
    Попытка
        Дерево = Новый ПостроительDOM;
        ДокументСхемы = Дерево.Прочитать(ЧтениеСхемы);
    Исключение
        ОшибкаСхемы = ОписаниеОшибки();
        Попытка
            ЧтениеСхемы.Закрыть();
        Исключение
            ВызватьИсключение ОшибкаСхемы + Символы.ПС + "Закрытие: " + ОписаниеОшибки();
        КонецПопытки;
        ВызватьИсключение ОшибкаСхемы;
    КонецПопытки;
    ЧтениеСхемы.Закрыть();
    ПостроительСхем = Новый ПостроительСхемXML;
    Схема = ПостроительСхем.СоздатьСхемуXML(ДокументСхемы.ЭлементДокумента);
    Если Схема = Неопределено Тогда
        ВызватьИсключение "Не построена собственная схема коллекций";
    КонецЕсли;
    НаборСхем = Новый НаборСхемXML;
    НаборСхем.Добавить(Схема);
    Если НЕ НаборСхем.Проверить() Тогда
        ВызватьИсключение "Собственная схема не прошла проверку";
    КонецЕсли;
    Фабрика = Новый ФабрикаXDTO(НаборСхем);
    ТипЗаказа = Фабрика.Тип("urn:guide:collections", "Order");
    Если ТипЗаказа = Неопределено Тогда
        ВызватьИсключение "В собственной фабрике не найден Order";
    КонецЕсли;
    Заказ = Фабрика.Создать(ТипЗаказа);
    СвойствоТоваров = Заказ.Свойства().Получить("item");
    Если СвойствоТоваров = Неопределено Тогда
        ВызватьИсключение "Не найдено собственное повторяющееся свойство item";
    КонецЕсли;
    Товары = Заказ.ПолучитьСписок(СвойствоТоваров);
    Если Товары = Неопределено Тогда
        ВызватьИсключение "Не получен список собственного заказа";
    КонецЕсли;
    Книга = Товары.Добавить(Фабрика.Создать(СвойствоТоваров.Тип, "Книга"));
    Товары.Добавить(Фабрика.Создать(СвойствоТоваров.Тип, "Коробка"));
    Ручка = Товары.Вставить(1, Фабрика.Создать(СвойствоТоваров.Тип, "Ручка"));
    Заказ.Проверить();
    Сообщить(Товары.Количество() = 3);
    Сообщить(Товары.Владелец = Заказ);
    Сообщить(Товары.ВладеющееСвойство = СвойствоТоваров);
    Сообщить(Товары.Получить(0) = "Книга");
    Сообщить(Товары.Получить(1) = "Ручка");
    Сообщить(Товары.Получить(2) = "Коробка");
    Сообщить(Книга.Значение = "Книга");
    Сообщить(Ручка.Значение = "Ручка");
    Сообщить(Товары.ПолучитьXDTO(1).Значение = "Ручка");
КонецПроцедуры

Разбор по шагам

1. Построить собственную XSD и фабрику, создать Order. Получить описатель повторяющегося item и его список.

2. Создавать каждое строковое значение через Фабрика.Создать с типом именно свойства item.

3. Добавить Книгу и Коробку, вставить Ручку между ними по индексу 1. Возвращённые элементы действительно относятся к созданному списку.

4. Проверить модель целиком. Получить выдаёт простое значение, ПолучитьXDTO — обёртку с типом и свойством Значение.

5. Прочитать два владельческих свойства списка: родительский объект и описатель item. Не присваивать их.

Как проверить результат

1. Девять булевых сообщений Истина. Порядок списка Книга, Ручка, Коробка.

2. Список получен из реальной собственной модели, не создан несуществующим конструктором.

Ожидаемый результат

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

На что обратить внимание

1. У СписокXDTO нет конструктора. Повторяемость задаётся maxOccurs в схеме, не массивом неизвестного типа.

2. Владелец и ВладеющееСвойство только для чтения. Для другого владельца создавайте его собственный список.

3. Эти элементы не являются ссылками на товары 1С и не создают записи справочника.

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