Коллекция компонентов схемы XML, имеющих имя.
Полное описание, параметры и ограничения
КоллекцияИменованныхКомпонентXS (XSNamedComponentMap)
КоллекцияИменованныхКомпонентXS (XSNamedComponentMap)
Доступен, начиная с версии 8.1.
Элементы коллекции:
ОпределениеПростогоТипаXS, ОпределениеСоставногоТипаXS, ОпределениеГруппыАтрибутовXS, ОпределениеГруппыМоделиXS, ОбъявлениеАтрибутаXS, ОбъявлениеЭлементаXS, ОпределениеОграниченияИдентичностиXS, ОпределенияXPathXS, ОбъявлениеНотацииXS
Для объекта доступен обход коллекции посредством оператора Для каждого … Из … Цикл. При обходе выбираются компоненты схемы XML.
Возможно обращение к компоненте схемы XML посредством оператора [...]. В качестве аргумента передается индекс (нумерация с 0).
Методы:
Количество (Count)
Получить (Get)
Описание:
Коллекция компонентов схемы XML, имеющих имя.
Доступность:
Сервер, толстый клиент, внешнее соединение.
См. также:
СхемаXML, свойство ОпределенияТипов
СхемаXML, свойство ОбъявленияАтрибутов
СхемаXML, свойство ОбъявленияЭлементов
СхемаXML, свойство ОбъявленияНотаций
СхемаXML, свойство ОпределенияГруппАтрибутов
СхемаXML, свойство ОпределенияГруппМоделей
СхемаXML, свойство ОпределенияОграниченийИдентичности
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Создать ограничения собственного контракта: скидка, описание и статус
Из шести видов новых фасетов строим восемь действующих ограничений для трёх собственных типов XML Schema. Проверяем не только созданные объекты, но и 13 допустимых и недопустимых входных значений через собственную фабрику XDTO.
Где и как запускать
Полный серверный общий модуль УчебныеОграничения своей новой пустой конфигурации УчебныеФасеты85 и полный отдельный модуль формы. В1С не запускался.
Подготовка
НОВАЯ пустая отдельная учебная база точно 8.5.1.1343. Имя конфигурации УчебныеФасеты85, совместимость Не использовать. Нет бизнес-объектов, расширений, подписок и фоновых заданий; чужие базы и XML не используются.
Создайте общий модуль УчебныеОграничения: Сервер=Да, Вызов сервера=Да, Клиент=Нет, Глобальный=Нет, Привилегированный=Нет. Вставьте полный основной модуль. Создайте свою внешнюю обработку УчебныеФасеты85 с управляемой формой и командой/кнопкой Выполнить, действие Выполнить; отдельный полный модуль формы приведён ниже.
Будущая ручная подготовка: сохранить конфигурацию, Конфигурация → Обновить конфигурацию базы данных (F7), открыть новый собственный клиент и свою обработку. Здесь F7, форма, BSL и XDTO не запускались.
Исходная XML-строка содержит три собственных simpleType без фасетов, только xs:string и xs:decimal. Пространство имён urn:guide:owned-facets — идентификатор, не сетевой адрес. Нет import/include, чтения файлов, настоящей интеграции или изменения метаданных базы.
Процедура ВыполнитьПример() Экспорт
ПроверитьСвойПустойСтенд();
Схема = ПостроитьСвоюИсходнуюСхему();
Скидка = ПолучитьСвоеОпределение(Схема, "Discount");
Описание = ПолучитьСвоеОпределение(Схема, "Description");
Статус = ПолучитьСвоеОпределение(Схема, "Status");
МинимальнаяСкидка = Новый ФасетМинимальногоИсключающегоЗначенияXS;
ПрисоединитьСвойФасет(Скидка, МинимальнаяСкидка, "ФасетМинимальногоИсключающегоЗначенияXS", 0, "0");
МаксимальнаяСкидка = Новый ФасетМаксимальногоИсключающегоЗначенияXS;
ПрисоединитьСвойФасет(Скидка, МаксимальнаяСкидка, "ФасетМаксимальногоИсключающегоЗначенияXS", 1, "1");
МинимальнаяДлина = Новый ФасетМинимальнойДлиныXS;
ПрисоединитьСвойФасет(Описание, МинимальнаяДлина, "ФасетМинимальнойДлиныXS", 3, "3");
МаксимальнаяДлина = Новый ФасетМаксимальнойДлиныXS;
ПрисоединитьСвойФасет(Описание, МаксимальнаяДлина, "ФасетМаксимальнойДлиныXS", 20, "20");
Пробелы = Новый ФасетПробельныхСимволовXS;
ПрисоединитьСвойФасет(Статус, Пробелы, "ФасетПробельныхСимволовXS", ОбработкаПробельныхСимволовXS.Сворачивать, "collapse");
Для Каждого ИмяСтатуса Из СтрРазделить("draft,published,closed", ",") Цикл
ДопустимыйСтатус = Новый ФасетПеречисленияXS;
ПрисоединитьСвойФасет(Статус, ДопустимыйСтатус, "ФасетПеречисленияXS", ИмяСтатуса, ИмяСтатуса);
КонецЦикла;
Если Скидка.Фасеты.Количество() <> 2 Или Описание.Фасеты.Количество() <> 2 Или Статус.Фасеты.Количество() <> 4 Тогда
ВызватьИсключение "Не совпало распределение восьми собственных фасетов";
КонецЕсли;
Скидка.ОбновитьЭлементDOM();
Описание.ОбновитьЭлементDOM();
Статус.ОбновитьЭлементDOM();
Схема.ОбновитьЭлементDOM();
Набор = Новый НаборСхемXML;
Набор.Добавить(Схема);
Если Не Набор.Проверить() Тогда
ВызватьИсключение "Собственная схема должна быть корректна до проверки отдельных значений";
КонецЕсли;
Фабрика = Новый ФабрикаXDTO(Набор);
Случаи = Новый Массив;
Случаи.Добавить(Новый Структура("Имя,Вход,Допустимо,Выход", "Discount", "0", Ложь, Неопределено));
Случаи.Добавить(Новый Структура("Имя,Вход,Допустимо,Выход", "Discount", "0.25", Истина, 0.25));
Случаи.Добавить(Новый Структура("Имя,Вход,Допустимо,Выход", "Discount", "1", Ложь, Неопределено));
Случаи.Добавить(Новый Структура("Имя,Вход,Допустимо,Выход", "Discount", "-0.1", Ложь, Неопределено));
Случаи.Добавить(Новый Структура("Имя,Вход,Допустимо,Выход", "Description", "Аб", Ложь, Неопределено));
Случаи.Добавить(Новый Структура("Имя,Вход,Допустимо,Выход", "Description", "ABC", Истина, "ABC"));
Случаи.Добавить(Новый Структура("Имя,Вход,Допустимо,Выход", "Description", "12345678901234567890", Истина, "12345678901234567890"));
Случаи.Добавить(Новый Структура("Имя,Вход,Допустимо,Выход", "Description", "123456789012345678901", Ложь, Неопределено));
Случаи.Добавить(Новый Структура("Имя,Вход,Допустимо,Выход", "Status", "draft", Истина, "draft"));
Случаи.Добавить(Новый Структура("Имя,Вход,Допустимо,Выход", "Status", " published ", Истина, "published"));
Случаи.Добавить(Новый Структура("Имя,Вход,Допустимо,Выход", "Status", "closed", Истина, "closed"));
Случаи.Добавить(Новый Структура("Имя,Вход,Допустимо,Выход", "Status", "deleted", Ложь, Неопределено));
Случаи.Добавить(Новый Структура("Имя,Вход,Допустимо,Выход", "Status", "PUBLISHED", Ложь, Неопределено));
ПроверитьСвоиСлучаи(Фабрика, Случаи);
КонецПроцедуры
Процедура ПроверитьСвойПустойСтенд()
Если Метаданные.Справочники.Количество() <> 0 Или Метаданные.Документы.Количество() <> 0 Или Метаданные.Перечисления.Количество() <> 0 Или Метаданные.РегистрыСведений.Количество() <> 0 Или Метаданные.РегистрыНакопления.Количество() <> 0 Или Метаданные.РегистрыБухгалтерии.Количество() <> 0 Или Метаданные.РегистрыРасчета.Количество() <> 0 Или Метаданные.ПланыВидовХарактеристик.Количество() <> 0 Или Метаданные.ПланыВидовРасчета.Количество() <> 0 Или Метаданные.ПланыСчетов.Количество() <> 0 Или Метаданные.ПланыОбмена.Количество() <> 0 Или Метаданные.Последовательности.Количество() <> 0 Или Метаданные.БизнесПроцессы.Количество() <> 0 Или Метаданные.Задачи.Количество() <> 0 Или Метаданные.ОбщиеРеквизиты.Количество() <> 0 Или Метаданные.ПодпискиНаСобытия.Количество() <> 0 Или Метаданные.РегламентныеЗадания.Количество() <> 0 Или Метаданные.ВнешниеИсточникиДанных.Количество() <> 0 Тогда
ВызватьИсключение "Нужен только свой новый пустой учебный стенд";
КонецЕсли;
Если Метаданные.ЕстьИзмененияРасширениямиКонфигурации() Тогда
ВызватьИсключение "Свой сеанс не должен изменяться расширениями";
КонецЕсли;
Источники = Новый Массив;
Источники.Добавить(ИсточникРасширенийКонфигурации.БазаДанных);
Источники.Добавить(ИсточникРасширенийКонфигурации.СеансАктивные);
Источники.Добавить(ИсточникРасширенийКонфигурации.СеансОтключенные);
Для Каждого Источник Из Источники Цикл
Расширения = РасширенияКонфигурации.Получить(, Источник);
Если ТипЗнч(Расширения) <> Тип("Массив") Тогда
ВызватьИсключение "Native список расширений должен иметь тип Массив";
КонецЕсли;
Если Расширения.Количество() <> 0 Тогда
ВызватьИсключение "В своём новом стенде нет расширений базы или сеанса";
КонецЕсли;
КонецЦикла;
Если ТранзакцияАктивна() Тогда
ВызватьИсключение "Чужая или вложенная активная транзакция не допускается";
КонецЕсли;
КонецПроцедуры
Функция ПостроитьСвоюИсходнуюСхему()
XSD = "<xs:schema xmlns:xs=""http://www.w3.org/2001/XMLSchema"" targetNamespace=""urn:guide:owned-facets"">
|<xs:simpleType name=""Discount""><xs:restriction base=""xs:decimal""/></xs:simpleType>
|<xs:simpleType name=""Description""><xs:restriction base=""xs:string""/></xs:simpleType>
|<xs:simpleType name=""Status""><xs:restriction base=""xs:string""/></xs:simpleType>
|</xs:schema>";
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(XSD);
Попытка
Построитель = Новый ПостроительDOM;
DOM = Построитель.Прочитать(Чтение);
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();
ПостроительСхемы = Новый ПостроительСхемXML;
Схема = ПостроительСхемы.СоздатьСхемуXML(DOM.ЭлементДокумента);
Если ТипЗнч(Схема) <> Тип("СхемаXML") Или Схема.ПространствоИмен <> "urn:guide:owned-facets" Тогда
ВызватьИсключение "Не построена своя исходная XML-схема";
КонецЕсли;
Возврат Схема;
КонецФункции
Функция ПолучитьСвоеОпределение(Схема, Имя)
Определение = Схема.ОпределенияТипов.Получить(Имя, "urn:guide:owned-facets");
Если ТипЗнч(Определение) <> Тип("ОпределениеПростогоТипаXS") Или Определение.Имя <> Имя Тогда
ВызватьИсключение "Не найден свой исходный простой тип " + Имя;
КонецЕсли;
Если Определение.Фасеты.Количество() <> 0 Тогда
ВызватьИсключение "В исходном собственном типе не должно быть уже заданных фасетов";
КонецЕсли;
Возврат Определение;
КонецФункции
Процедура ПрисоединитьСвойФасет(Определение, Фасет, ОжидаемыйТип, Значение, Лексическое)
Если ТипЗнч(Фасет) <> Тип(ОжидаемыйТип) Тогда
ВызватьИсключение "Не совпал конкретный тип нового собственного фасета";
КонецЕсли;
Определение.Фасеты.Добавить(Фасет);
Фасет.Значение = Значение;
Фасет.ЛексическоеЗначение = Лексическое;
Если ТипЗнч(Фасет.Значение) <> ТипЗнч(Значение) Или Фасет.Значение <> Значение
Или Фасет.ЛексическоеЗначение <> Лексическое Тогда
ВызватьИсключение "Не совпали типизированное и лексическое значения своего фасета";
КонецЕсли;
Если Фасет.ОпределениеПростогоТипа.Имя <> Определение.Имя
Или Фасет.Схема.ПространствоИмен <> "urn:guide:owned-facets" Тогда
ВызватьИсключение "Фасет должен принадлежать только своему определению и своей схеме";
КонецЕсли;
Фасет.ОбновитьЭлементDOM();
КонецПроцедуры
Процедура ПроверитьСвоиСлучаи(Фабрика, Случаи)
Если Случаи.Количество() <> 13 Тогда
ВызватьИсключение "Ожидалось ровно 13 собственных граничных случаев";
КонецЕсли;
Для Каждого Случай Из Случаи Цикл
ТипМодели = Фабрика.Тип("urn:guide:owned-facets", Случай.Имя);
Если ТипЗнч(ТипМодели) <> Тип("ТипЗначенияXDTO") Тогда
ВызватьИсключение "Не получен свой тип значения XDTO " + Случай.Имя;
КонецЕсли;
Допустимо = Ложь;
ЗначениеМодели = Неопределено;
Попытка
ЗначениеМодели = Фабрика.Создать(ТипМодели, Случай.Вход);
Допустимо = Истина;
Исключение
Сообщить(СтрШаблон("Отклонён собственный пример %1: %2", Случай.Имя, Случай.Вход));
КонецПопытки;
Если Допустимо <> Случай.Допустимо Тогда
ВызватьИсключение СтрШаблон("Не совпало ограничение %1 для [%2]", Случай.Имя, Случай.Вход);
КонецЕсли;
Если Допустимо Тогда
Если ТипЗнч(ЗначениеМодели) <> Тип("ЗначениеXDTO")
Или ТипЗнч(ЗначениеМодели.Значение) <> ТипЗнч(Случай.Выход)
Или ЗначениеМодели.Значение <> Случай.Выход Тогда
ВызватьИсключение "Не совпало полное собственное нормализованное значение";
КонецЕсли;
КонецЕсли;
Сообщить(СтрШаблон("%1 [%2]: допустимо=%3", Случай.Имя, Случай.Вход, Допустимо));
КонецЦикла;
КонецПроцедурыУчебныеФасеты85.Форма
Своя внешняя обработка УчебныеФасеты85 → управляемая Форма → Модуль
Полный отдельный модуль своей формы; не выполнялся.
&НаКлиенте
Процедура Выполнить(Команда)
ВыполнитьНаСервере();
Сообщить("Собственная схема и все 13 граничных случаев проверены");
КонецПроцедуры
&НаСервереБезКонтекста
Процедура ВыполнитьНаСервере()
УчебныеОграничения.ВыполнитьПример();
КонецПроцедурыРазбор по шагам
Прочитать собственную строку как DOM и построить СхемаXML. Сразу проверить тип схемы и её пространство имён; получить Discount, Description, Status по имени и тому же URI. У каждого исходного типа должен быть пустой список явных фасетов.
Конструктор создаёт отдельный компонент, но сам по себе не ограничивает данные. ПрисоединитьСвойФасет добавляет его в список именно подготовленного типа, задаёт типизированное и лексическое значения, сверяет их и проверяет владельца. Readonly-свойства Фасеты, Схема и ОпределениеПростогоТипа не присваиваются.
Для Discount создаём два исключающих ограничения 0 и 1. Условие 0 < скидка < 1 относится к доле: 0.25 означает 25 процентов, а не число25. Обе границы недопустимы.
Для Description два компонента задают длины 3 и 20 включительно. Используем короткие простые строки без эмодзи и составных Unicode-символов, чтобы задача не подменялась подсчётом байтов или визуальных знаков.
Для Status фасет пробелов получает настоящее значение enum ОбработкаПробельныхСимволовXS.Сворачивать, лексически collapse. Три отдельных новых ФасетПеречисленияXS задают draft, published, closed. Это перечисление XML-схемы, не менеджер Перечисления конфигурации.
Проверяем распределение восьми фасетов: 2/2/4. Синхронизируем DOM каждого нового компонента, определений и схемы; проверяем набор схем ДО создания фабрики. Фабрика создаётся после добавления ограничений, а не до них.
Только создание значения находится внутри Попытка. Тип модели проверен заранее, а сравнение факта с эталоном — после обработки ошибки. Поэтому исключение собственных проверок не превращается в якобы ожидаемое отклонение входа.
Для всех принятых входов проверяются полный нормализованный результат и его точный тип. Строка с крайними пробелами восстанавливается как published, а скидка0.25 — как число. Все 13 случаев должны совпасть с независимыми эталонами.
Как проверить результат
Будущий результат: 6 входов приняты и 7 отклонены, без исключения о несовпадении. Discount: 0.25 принят; 0, 1, -0.1 отклонены. Description: длины3 и20 приняты, 2 и21 отклонены.
Status: draft, closed и строка с крайними пробелами published приняты; deleted и PUBLISHED отклонены. Нормализованный результат published не содержит крайних пробелов.
Будущий отрицательный контроль: только в вызове для МаксимальнаяДлина замените оба значения 20/"20" на19/"19", не меняя эталон случая с20 символами. Корректная схема будет построена, но положительный случай должен вызвать несовпадение. После опыта восстановите полный исходный модуль.
runtimeVerifiedScenarios=0. Сигнатуры конструкторов, свойства и доступность проверены по установленной справке. Результаты XDTO приведены как ожидаемые: в1С не получены, обратные ссылки владельцев и синхронизация DOM не выполнялись. Пример не отправляет скидки, статусы или описания во внешние системы.
Ожидаемый результат
Шесть разных конструкторов участвуют в одном действующем учебном контракте, проверяемом на всех 13 граничных случаях, а не только в чтении свойств новых пустых объектов.
На что обратить внимание
Новый фасет вне определения типа — ещё не правило проверки. Не пропускайте добавление в Фасеты и не присваивайте readonly-обратные ссылки вручную.
Значение и ЛексическоеЗначение имеют разные типы. У фасета пробелов значение — enum платформы, не строка collapse; у числовых границ в нашей xs:decimal-модели — число, а лексическая запись использует точку.
Свернуть крайние и повторяющиеся XML-пробелы не означает изменить регистр: PUBLISHED не входит в перечисление. Для Description xs:string пробелы этим контрактом не удаляются.
Любая ошибка создания значения будет зафиксирована как отказ, но прежде схема и конкретный тип обязаны пройти подготовительные проверки. Для реального внешнего ввода нужны отдельные диагностика ошибок, ограничения размера и защита XML-парсера; данный урок работает только с собственными постоянными строками.
Схему после построения фабрики не меняем: не рассчитывайте на автоматическое обновление уже построенной модели XDTO. Для другой версии контракта нужен новый проверенный набор и новая фабрика.
Это собственный учебный контракт, не схема Avito и не правила скидок выбранной конфигурации. Нет подтверждения запуска, прав доступа или поведения рабочей базы.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Различить абстрактный головной элемент и конкретный член группы
head нельзя использовать как самостоятельный конкретный элемент. book имеет тот же строковый тип и ссылается на head как член группы подстановки.
Где и как запускать
Полный модуль серверного общего модуля УчебныеЗадачи (флаг Сервер) в учебной базе. Вызовите ВыполнитьПример() из серверного обработчика своей обработки. Вставляйте обе процедуры на уровне модуля.
Подготовка
Выполните каждый полный модуль отдельно на сервере учебной базы. Вызовите ВыполнитьПример(); функция чтения схемы включена ниже в том же модуле.
Схема включена строкой. note — учебное примечание, currency — фиксированная валюта, wrapper содержит ссылки на них. Обмен и рабочие объекты не используются.
Нет DTD, импорта, файлов, сети или записи данных базы. Проверить проверяет XSD, а не XML-экземпляр товара.
Имена и namespace берите из собственной схемы. Не заменяйте их случайным узлом внешнего сервиса.
Процедура ВыполнитьПример() Экспорт
ТекстXSD = "<xs:schema xmlns:xs=""http://www.w3.org/2001/XMLSchema"" xmlns:g=""urn:guide:declarations"" targetNamespace=""urn:guide:declarations"" elementFormDefault=""qualified"" attributeFormDefault=""unqualified""><xs:element name=""note"" type=""xs:string"" default=""Без примечания"" nillable=""true""><xs:annotation><xs:documentation xml:lang=""ru"">Учебное примечание</xs:documentation></xs:annotation></xs:element><xs:attribute name=""currency"" type=""xs:string"" fixed=""RUB""><xs:annotation><xs:documentation xml:lang=""ru"">Учебная валюта</xs:documentation></xs:annotation></xs:attribute><xs:element name=""wrapper""><xs:complexType><xs:sequence><xs:element ref=""g:note""><xs:annotation><xs:documentation>Ссылка на примечание</xs:documentation></xs:annotation></xs:element></xs:sequence><xs:attribute ref=""g:currency"" use=""optional""><xs:annotation><xs:documentation>Использование валюты</xs:documentation></xs:annotation></xs:attribute></xs:complexType></xs:element><xs:element name=""head"" type=""xs:string"" abstract=""true""/><xs:element name=""book"" type=""xs:string"" substitutionGroup=""g:head""/></xs:schema>";
Схема = ПрочитатьСвоюСхему(ТекстXSD);
Набор = Новый НаборСхемXML;
Набор.Добавить(Схема);
Если Не Набор.Проверить() Тогда
ВызватьИсключение "Исходная собственная XSD не прошла проверку";
КонецЕсли;
Головной = Схема.ОбъявленияЭлементов.Получить("head", "urn:guide:declarations");
Книга = Схема.ОбъявленияЭлементов.Получить("book", "urn:guide:declarations");
Если Головной = Неопределено Или Книга = Неопределено Тогда
ВызватьИсключение "Не найдена собственная группа подстановки";
КонецЕсли;
Сообщить(Головной.Абстрактный);
Сообщить(Не Книга.Абстрактный);
Принадлежность = Книга.ПрисоединениеКГруппеПодстановки;
Если Принадлежность = Неопределено Тогда
ВызватьИсключение "У book не указана группа подстановки";
КонецЕсли;
Сообщить(Принадлежность.URIПространстваИмен = "urn:guide:declarations" И Принадлежность.ЛокальноеИмя = "head");
Сообщить(Не Книга.ЭтоОбъявлениеЗациклено());
Сообщить(Головной.ЭтоГлобальноеОбъявление И Книга.ЭтоГлобальноеОбъявление);КонецПроцедуры
Функция ПрочитатьСвоюСхему(ТекстXSD)
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(ТекстXSD);
Попытка
ПостроительДерева = Новый ПостроительDOM;
ДокументСхемы = ПостроительДерева.Прочитать(Чтение);
Чтение.Закрыть();
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
ПостроительСхем = Новый ПостроительСхемXML;
Результат = ПостроительСхем.СоздатьСхемуXML(ДокументСхемы.ЭлементДокумента);
Если Результат = Неопределено Тогда
ВызватьИсключение "Не построена собственная схема";
КонецЕсли;
Возврат Результат;
КонецФункцииРазбор по шагам
В собственной XSD head объявлен abstract=true, book — конкретным глобальным элементом.
ПрисоединениеКГруппеПодстановки содержит QName головного элемента, не ссылку ref и не строку имени.
URI и локальное имя проверяются отдельно. book не превращается в head и сохраняет собственное имя.
ЭтоОбъявлениеЗациклено проверяет объявление, но не валидирует экземпляр XML с фактическими данными.
Как проверить результат
Пять сообщений Истина.
При отдельной стандартной проверке <book xmlns="urn:guide:declarations">Книга</book> проходит; такой же конкретный <head> не проходит из-за abstract=true.
Ожидаемый результат
Абстрактность и членство подстановки показаны на двух конкретных объявлениях.
На что обратить внимание
Правила блокировки и совместимости типов тоже влияют на допустимость подстановок.
Группа подстановки не является выборкой справочника 1С.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.