Проверка на соответствие XSD (XML) схеме
Встроенные справочники XSD (XML) схемы
В ПК АРГО реализованы две проверки выгружаемых в XML Документов: логический контроль и проверка сформированного XML файла на соответствие утверждённой XSD схеме. Результат проверки выводится в журнал проверки:
Сообщения в журнале представлены в виде дерева и содержит четыре колонки. В первой колонке отображается тип сообщения (ошибка, предупреждение и т.п.) в виде соответствующего значка и элемент управления раскрытием/закрытием веток дерева. В колонке "Содержание" отображается краткое описание обнаруженной ошибки. Если есть возможность автоматически исправить обнаруженную ошибку или перейти к месту, где допущена ошибка, в колонке "Доп. информация" будет отображена команда с надписью "Исправить". Если в колонке "Доп. информация" доступна команда "Исправить" Вы можете использовать её для исправления ошибки непосредственно из журнала проверки. Колонка "Справка" может содержать ссылку на справочный материал, содержащий подробное описание обнаруженной ошибки или предупреждения. Наличие подобного справочного материала обозначается значком с вопросительным знаком, для его открытия щёлкните левой кнопкой мыши по данному значку.
Иерархия дерева соответствует иерархии места, где обнаружена ошибка. Например, если допущена ошибка в адресе заказчика кадастровых работ, тогда в журнале проверки будет сообщение, о том, что в сведениях о заказчике работ обнаружена ошибка, а в колонке "Доп. информация" будет отображена команда "Исправить", выполнение которой откроет карточку заказчика. Кроме того, данное сообщение будет содержать дочернее сообщение, которое отобразит информацию, что ошибка в адресе и для этого сообщения также будет доступна команда "Исправить", которая откроет непосредственно карточку адреса. И уже само сообщение об ошибке в адресе будет содержать дочерние сообщения, которые будут описывать, какие конкретно ошибки обнаружены в адресе.
Если при выгрузке в XML обнаружены ошибки, Вы следовали инструкциям, описанным в журнале и исправили всё, что смогли, но при повторной выгрузке остаются ошибки, которые Вы не знаете как исправить, обратитесь в техническую поддержку ПК АРГО соблюдая правила обращения в связи с ошибкой при формировании XML документа.
Чтобы было проще понять, что такое проверка на соответствие XSD схеме, необходимо понять, что такое XML файл и XSD схема.
XML файл это текстовый документ, который должен выполняет требования разметки спецификации XML. Данные в XML файле включаются в Элементы и Атрибуты. Если открыть XML файл при помощи программы, которая поддерживает разметку XML (практически все интернет-браузеры поддерживают отображение XML файлов с разметкой), то будет видно, что структура будет в виде дерева. XML файл обязательно должен состоять из одного коренного элемента, который может содержать в себе другие Элементы и Атрибуты. В приведённом ниже примере при помощи Microsoft Edge открыть XML файл технического плана:
Корневым Элементом в данном примере является Элемент "Tp", который содержит в себе Атрибуты "GUID", "Version", "NameSoftware" и "VersionSoftware", а также Элемент "Flat". В свою очередь Элемент "Flat" содержит другие Элементы. Элементы могут содержать другие Элементы и/или Атрибуты или могут содержать данные и/или Атрибуты. Атрибуты могут содержать только данные.
Для того, чтобы установить строгие правила к содержимому XML файлов используют XSD схемы, в которых и описывают эти самые требования. Кроме этого, такие XSD схемы позволяют реализовать проверку на программном уровне соответствия XML файла на соответствие требованиям, описанным в этой XSD схеме. В Схеме может быть задано для Элементов и Атрибутов какой тип данных (число, дата, простой текст и т.п.) допустимы для них. Ограничения могут налагаться и на тип данных в Элементе и Атрибуте, например, для текста можно задать его минимальную и/или максимальную длину количеством символов, ограничить его маской по которой он должен содержать кадастровый номер, СНИЛС и т.п. или другую информацию в строгом формате. Для числа можно установить его максимальную и/или минимальную величину, а также максимальное количество знаков после запятой. При помощи Схемы можно определить какие Элементы и/или Атрибуты обязательно должны быть в XML файле и в каком количестве и порядке, а какие могут быть только в определённых случаях или вообще отсутствовать. Вариантов и возможностей очень много по описанию требований к составу и содержанию XML файла при помощи XSD схем. Именно при помощи XSD схем и описываются требования к содержимому XML файлов Документов. Описание и утверждение таких схем является обязанностью соответствующих ведомств, в нашем случае это, как правило, обязан делать Росреестр.
Проверка XML файла на соответствие XSD схеме является проверкой первого уровня. Она выявляет только ошибки технического характера, такие как наличие обязательных данных, соответствие их установленному типу данных и формату. При этом проверка на соответствие Схеме не выявит такие ошибки как топокорректность контура объекта, соответствие исходных сведений и прочие подобные ошибки, которые могут быть в сформированном Документе. Иными словами, если проверка на соответствие Схеме пройдена успешно, это ещё не значит, что в Документе нет ошибок и он успешно пройдёт, например, кадастровый учёт. Но если Документ не проёл проверку на соответствие Схеме, тогда с вероятностью в 99% он будет возвращён с приостановкой без рассмотрения по причине несоответствия утверждённой Схеме. В исключительных случаях, когда требования Схемы противоречат требованиям нормативных документов, которым он должна соответствовать, такие XML файлы принимаются в работу. Но такие случаи очень редки и о возможности подачи XML файлов с такими противоречиями Схеме необходимо узнавать в принимающих органах.
К сожалению, описание ошибок на соответствие XSD схеме имеют вид, как правило, не понятный для подавляющего числа обычных пользователей. Поэтому в ПК АРГО реализована дополнительная проверка выгружаемых данных в Логическом контроле.
Некоторые значения в XML файле ограничиваются справочниками, например виды разрешённого использования, назначение здания и т.п. Справочник представляет из себя набор допустимы значений и может содержать описание этих значений. Такие справочники являются неотъемлемой частью XML схемы и не могут дополняться пользователем, а указание значения, не предусмотренное справочником, приведёт к несоответствию XML файла схеме.
Логический контроль включает в себя множество алгоритмов, которые определяют корректность указанных данных и выявляет ошибки, которые нельзя выявить проверкой на соответствие требованиям XSD схеме. Так же в Логический контроль входит проверка данных, а так же их наличие и отсутствие, на соответствие Требованиям нормативных документов на стадии заполнения Документов. Такая проверка выражается в подсветках полей и строк с ошибками или возможными ошибками. Подсветка может быть выражена в виде красного или оранжевого фона поля или строки, если данные в окне представляют таблицу, а также в виде красного значка ошибки или оранжевого значка предупреждения, который размещается в левой части поля или строки таблицы:
Кроме того, Логический контроль проверяет выгружаемые в XML данные на их соответствие XSD схеме и выводит описание найденных ошибок в понятном для пользователя виде.