Проверка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 - если при проверке возникла ошибка