Syntax highlighting of docs/howto-xsd

= Схемы документов =

== XML и XSD ==

Оригинальные документы ЕИС, доступ к которым предоставляется через API, имеют формат [[ https://ru.wikipedia.org/wiki/XML | XML ]]. Документы хранятся на публичном FTP-сервере [[ ftp://ftp.zakupki.gov.ru ]].

При работе с XML-документами зачастую можно быстро найти информацию. Если в документе извещения имеем поле `INN`, вложенное в поле `responsibleOrganization`, то по логике можно догадаться, что это ИНН ответственной организации.

Но бывает, что наименование поля не отражает полный смысл его содержания. Также возможно требуется найти определенные данные в документе, но в текущем документе это поле отсутствует. Для понимания какие поля должны быть в документе, их описание и типы, нам необходимо отталкиваться от структуры документа.

Структура XML-документов описывается через файл схемы [[ https://en.wikipedia.org/wiki/XML_Schema_(W3C) | XSD ]]. Схемы документов публикуются на официальном сайте ЕИС в разделе [[ https://zakupki.gov.ru/epz/main/public/document/view.html?searchString=&sectionId=362&strictEqual=false | технической документации ]]. Архив со схемами документов  по 44-ФЗ и ПП РФ 615 называется ''Схемы XX.Y интеграция Z''.

{{docs/howto-xsd/xsd-pic1.png|Архив схем по 44-ФЗ на странице документации|height=400}}

Схемы документов по 223-ФЗ  расположены на странице [[ https://zakupki.gov.ru/epz/main/public/document/view.html?searchString=&sectionId=386&strictEqual=false ]] , имя архива ''Интеграционные схемы XX.Y''

== Просмотр XSD-схемы ==

XSD-схема определяет структуру соответствующего XML-документа. Технически файл схемы очень похож на XML и содержит описание полей и типов полей документа. 

Для просмотра XSD-схемы рекомендуется использоваться специальный просмотрщик, например [[ http://regis.cosnier.free.fr/?page=XSDDiagram&nomenu | XSD Diagram ]].

Порядок работы:

 1. Скачиваем архив схем и распаковываем его
 1. Открываем XSD Diagram и там через "File -> Open..." открываем соответствующую схему: для 44-ФЗ и ПП РФ 615 все схемы приведены в файле ''fcsIntegration.xsd''; для 223-ФЗ ''purchase.xsd, contract.xsd, purchasePlan.xsd''
 1. Находим в списке типов (справа) нужный нам тип документа, например ''Извещение о проведении электронного аукциона epNotificationEF2020'' и перетаскиваем строку на основное поле диаграммы.

{{docs/howto-xsd/xsd-pic2.png|Интерфейс XSD Diagram|height=400}}