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

ПроверкаXml

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

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

Сравнение ссылочное

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

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

Примеры​

метод ПроверитьДокументXml(ДокументXml: Файл)
    // поиск схемы по внешним зависимостям xsi
    попытка
        Проверка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, по умолчанию 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 - если при проверке возникла ошибка

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

Объект​

ВСтроку, ПолучитьТип, Представление

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