Перейти к основному содержимому

ПроверкаXml

Стд::Xml::Проверка::ПроверкаXml Тип-одиночка

Объект-одиночка для проверки документа XML по схеме.

Сравнение

Ссылочное

Иерархия типа​

Базовые типы: Объект, Одиночка

Примеры​

Общие примеры

метод ПроверитьДокументXmlСоСсылкойXsi(ДокументXml: Файл) 
    попытка
        // документ xml содержит ссылку xsi на схему,
        // поэтому в методе проверки схема не указывается.
        ПроверкаXml.ПроверитьДоПервойОшибки(ДокументXml)
    поймать И: ИсключениеПроверкиXml
        // обработка ошибки
    ;
;
 
метод ПроверитьДокументXml(ДокументXml: Файл, Схема: Файл)
    // схема передается в метод проверки как файл.
    знч РезультатПроверки = ПроверкаXml.Проверить(ДокументXml, Схема)
     
    для ОшибкаПроверки из РезультатПроверки
        ЗаписатьОшибку(ОшибкаПроверки.Сообщение, ОшибкаПроверки.НомерКолонкиXml,
            ОшибкаПроверки.НомерСтрокиXml)
    ;
;

метод ЗаписатьОшибку(ОписаниеОшибки: Строка, КолонкаXml: Число, СтрокаXml: Число)
    // запись ошибки в ЖС
;

Методы​

Проверить​

Проверить(
Источник: Файл|ПотокЧтения,
Схема: Файл|ПотокЧтения|? = Неопределено
): ЧитаемыйМассив<ОшибкаПроверкиXml>
Выполнить полную проверку документа, результат проверки возвращается как массив ошибок.

  • Источник - файл или поток чтения документа XML
  • Схема - файл или поток чтения схемы XML, по умолчанию Undefined

Если Схема не определена, то ожидается, что в источнике используется ссылка на схему (атрибут xsi:schemaLocation или xsi:noNamespaceSchemaLocation).

Разрешение зависимостей по пути в xsi:schemaLocation или xsi:noNamespaceSchemaLocation источника и xs:include или xs:import Схемы зависит от переданного типа параметра:

  • Файл - относительный или абсолютный путь
  • ПотокЧтения - только абсолютный путь

В xsi-ссылках абсолютный путь к файлу схемы должен иметь префикс file:/// .

Также в качестве xsi-ссылки на схему можно использовать URN ресурса проекта в формате urn:1c-element:resource:{полное имя проекта, разделитель "-"}:{путь ресурса в проекте}.

Пример: urn:1c-element:resource:Dev-App-Основной:папка1/папка2/схема.xsd, где Dev - имя разработчика, App - имя проекта, Основной - имя подсистемы, папка1/папка2/схема.xsd - путь к файлу схемы в ресурсах проекта.

Если документ XML содержит xsi-ссылки и одновременно передается Схема, то проверка выполняется только по Схема.

Исключения​

ИсключениеПроверкиXml - если при проверке возникла ошибка инициализации схемы.

ПроверитьДоПервойОшибки​

ПроверитьДоПервойОшибки(
Источник: Файл|ПотокЧтения,
Схема: Файл|ПотокЧтения|? = Неопределено)
Выполнить проверку документа до первой ошибки, будет выброшено ИсключениеПроверкиXml.

  • Источник - файл или поток чтения документа XML
  • Схема - файл или поток чтения схемы XML, по умолчанию Undefined

Если Схема не определена, то ожидается, что в источнике используется ссылка на схему (атрибут xsi:schemaLocation или xsi:noNamespaceSchemaLocation).

Разрешение зависимостей по пути в xsi:schemaLocation или xsi:noNamespaceSchemaLocation источника и xs:include или xs:import Схемы зависит от переданного типа параметра:

  • Файл - относительный или абсолютный путь
  • ПотокЧтения - только абсолютный путь

В xsi-ссылках абсолютный путь к файлу схемы должен иметь префикс file:/// .

Также в качестве xsi-ссылки на схему можно использовать URN ресурса проекта в формате urn:1c-element:resource:{полное имя проекта, разделитель "-"}:{путь ресурса в проекте}.

Пример: urn:1c-element:resource:Dev-App-Основной:папка1/папка2/схема.xsd, где Dev - имя разработчика, App - имя проекта, Основной - имя подсистемы, папка1/папка2/схема.xsd - путь к файлу схемы в ресурсах проекта.

Если документ XML содержит xsi-ссылки и одновременно передается Схема, то проверка выполняется только по Схема.

Исключения​

ИсключениеПроверкиXml - если при проверке возникла ошибка инициализации схемы или документ xml не соответствует схеме.

Список унаследованных методов​

Объект​

ВСтроку

ПолучитьТип

Представление

Последнее обновление