Собрать новое объявление из собственных компонентов

Учебные задачи

Создаём нотацию, аннотацию, документацию и appinfo конструкторами. Присоединяем их к собственной схеме и проверяем владельцев.

Где и как запускать

Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.

Подготовка

  1. Каждый фрагмент выполните отдельно на сервере учебной базы. Полная собственная XSD с urn:guide:product и нотацией BookImage включена в код.

  2. Это xs:notation внутри XSD, не узел НотацияDOM из DTD. В коде нет DOCTYPE, внешних сущностей, импорта схемы, чтения файла или сетевого запроса.

  3. public и system — вымышленные собственные URN. Объявление метки не загружает изображение и не подтверждает существование файла.

  4. Проверить у НаборСхемXML проверяет схему, не XML-экземпляр товара. Изменения относятся только к собственной модели в памяти.

XSD = "<xs:schema xmlns:xs=""http://www.w3.org/2001/XMLSchema""
| xmlns:g=""urn:guide:product"" targetNamespace=""urn:guide:product""
| elementFormDefault=""qualified"" version=""1.0"" xml:lang=""ru"">
| <xs:annotation><xs:documentation>Учебный товар, не контракт внешнего API</xs:documentation></xs:annotation>
| <xs:simpleType name=""Sku""><xs:restriction base=""xs:string"">
|  <xs:length value=""4""/><xs:pattern value=""[A-Z][0-9]{3}""/>
| </xs:restriction></xs:simpleType>
| <xs:complexType name=""Product""><xs:sequence>
|  <xs:element name=""name"" type=""xs:string""/>
|  <xs:element name=""quantity"" type=""xs:nonNegativeInteger""/>
|  <xs:element name=""note"" type=""xs:string"" minOccurs=""0""/>
| </xs:sequence><xs:attribute name=""code"" type=""g:Sku"" use=""required""/>
| </xs:complexType>
| <xs:element name=""product"" type=""g:Product""/>
| <xs:notation name=""BookImage"" public=""urn:guide:book-image:public"" system=""urn:guide:book-image:system"">
|  <xs:annotation><xs:documentation source=""urn:guide:notation-note"" xml:lang=""ru"">Учебная метка изображения, не загрузка картинки</xs:documentation></xs:annotation>
| </xs:notation>
|</xs:schema>";
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(XSD);
Попытка
    ЧтениеДерева = Новый ПостроительDOM;
    ДокументСхемы = ЧтениеДерева.Прочитать(Чтение);
    Чтение.Закрыть();
Исключение
    Чтение.Закрыть();
    ВызватьИсключение;
КонецПопытки;
Построитель = Новый ПостроительСхемXML;
Схема = Построитель.СоздатьСхемуXML(ДокументСхемы.ЭлементДокумента);
Если Схема = Неопределено Тогда
    ВызватьИсключение "Не удалось построить учебную схему";
КонецЕсли;
Набор = Новый НаборСхемXML;
Набор.Добавить(Схема);
Если Не Набор.Проверить() Тогда
    ВызватьИсключение "Учебная XSD не прошла проверку";
КонецЕсли;
Если Схема.ОбъявленияНотаций.Количество() <> 1 Тогда
    ВызватьИсключение "Ожидалась одна собственная нотация";
КонецЕсли;
Нотация = Схема.ОбъявленияНотаций.Получить(0);
Если ТипЗнч(Нотация) <> Тип("ОбъявлениеНотацииXS") Или Нотация.Имя <> "BookImage" Тогда
    ВызватьИсключение "Не найдена собственная BookImage";
КонецЕсли;
Аннотация = Нотация.Аннотация;
Если Аннотация = Неопределено Тогда
    ВызватьИсключение "У BookImage нет собственной аннотации";
КонецЕсли;
Если Аннотация.Документация.Количество() <> 1 Тогда
    ВызватьИсключение "Ожидалась одна собственная документация нотации";
КонецЕсли;
Документация = Аннотация.Документация.Получить(0);
НоваяНотация = Новый ОбъявлениеНотацииXS;
НоваяНотация.Имя = "BookImageExtra";
НоваяНотация.ПубличныйИдентификатор = "urn:guide:book-image:extra:public";
НоваяНотация.СистемныйИдентификатор = "urn:guide:book-image:extra:system";
НоваяАннотация = Новый АннотацияXS;
НоваяДокументация = Новый ДокументацияXS;
НоваяДокументация.Источник = "urn:guide:notation-note:extra";
НоваяДокументация.Язык = "ru";
НоваяИнформация = Новый ИнформацияДляПриложенияXS;
НоваяИнформация.Источник = "urn:guide:application-note:extra";
НоваяАннотация.Состав.Добавить(НоваяДокументация);
НоваяАннотация.Состав.Добавить(НоваяИнформация);
НоваяНотация.Аннотация = НоваяАннотация;
Схема.Содержимое.Добавить(НоваяНотация);
Схема.ОбновитьЭлементDOM();
Сообщить(Схема.ОбъявленияНотаций.Количество() = 2);
Сообщить(НоваяАннотация.Документация.Количество() = 1);
Сообщить(НоваяАннотация.ИнформацияДляПриложения.Количество() = 1);
Сообщить(НоваяДокументация.Контейнер = НоваяАннотация);
Сообщить(НоваяИнформация.Контейнер = НоваяАннотация);
Сообщить(НоваяНотация.Содержит(НоваяАннотация));
Сообщить(НоваяАннотация.Содержит(НоваяДокументация));
Сообщить(НоваяДокументация.ЭлементDOM.ПолучитьАтрибут("source") = "urn:guide:notation-note:extra");
Сообщить(НоваяИнформация.ЭлементDOM.ПолучитьАтрибут("source") = "urn:guide:application-note:extra");
Если Не Набор.Проверить() Тогда
    ВызватьИсключение "Собственная схема с новыми компонентами не прошла проверку";
КонецЕсли;
Схема.Содержимое.Удалить(НоваяНотация);
Сообщить(Схема.ОбъявленияНотаций.Количество() = 1);
Сообщить(Нотация.Имя = "BookImage");

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

  1. Четыре конструктора создают отдельные объекты: до присоединения они не являются частью схемы.

  2. Документация и appinfo добавляются в изменяемый Состав аннотации. Два readonly-списка отражают соответствующие виды компонентов.

  3. Аннотация назначается новому объявлению, затем объявление добавляется в собственное Содержимое схемы.

  4. Обновление DOM выполняется после построения связей. source — метка происхождения, не запрос по адресу.

  5. Проверяем владельцев и принадлежность, затем удаляем только новую нотацию вместе с её собственным поддеревом.

  6. Новые documentation/appinfo здесь содержат метки источников, без текста правил валидации; исходная документация BookImage сохраняется.

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

  1. Одиннадцать сообщений Истина; глобальные нотации 1→2→1.

  2. У новой аннотации по одному documentation и appinfo. После удаления нового поддерева остаётся исходная BookImage.

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

Конструкторы показаны в полном цикле сборки, присоединения и безопасного удаления своих компонентов.

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

  1. Не используйте НоваяНотация и её дочерние объекты после удаления из схемы.

  2. Аннотация и служебные source не заменяют ограничения типов или проверку XML-экземпляра.

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

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.