Что такое XSD?

Что такое XSD

XSD (XML Schema Definition) — это язык и стандарт для определения структуры, типов данных и правил валидации XML документов. Это не является основным инструментом daily работы modern BA, но знание XSD очень полезно в интеграционных проектах и при работе с enterprise системами.

Основное назначение

XSD служит для описания валидного структуры XML файла. Если вы думаете об XML как о документе, то XSD — это шаблон или схема этого документа. Это похоже на database schema, но для XML.

Аналогия: Если XML — это просто текст с тегами, то XSD — это набор правил, который говорит: "В этом XML файле должны быть вот эти теги, в таком порядке, с такими типами данных, и некоторые теги обязательны, а некоторые опциональны".

Когда используется XSD

Интеграция между системами

• B2B обмен данными (EDI — Electronic Data Interchange)
• Обмен данными между банками, государственными системами
• REST/SOAP API с XML payload

Валидация данных

• Проверка, что входящие данные соответствуют ожиданиям
• Гарантия целостности данных при импорте

Документирование контрактов

• XSD служит контрактом между отправителем и получателем данных
• Оба стороны знают, какую структуру ожидать

Генерация кода

• На основе XSD можно сгенерировать классы Java, C#, Python
• Экономит время разработчиков

Простой пример XML и XSD

Есть XML файл с информацией о пользователе:

<user>
  <name>Иван Иванов</name>
  <email>ivan@example.com</email>
  <age>30</age>
  <active>true</active>
</user>

XSD схема для этого файла будет выглядеть так:

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="user">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="name" type="xs:string" minOccurs="1" maxOccurs="1"/>
        <xs:element name="email" type="xs:string" minOccurs="1" maxOccurs="1"/>
        <xs:element name="age" type="xs:integer" minOccurs="0" maxOccurs="1"/>
        <xs:element name="active" type="xs:boolean" minOccurs="1" maxOccurs="1"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

Этот XSD говорит:

• Есть элемент "user"
• Внутри него последовательно идут поля: name (строка, обязательное), email (строка, обязательное), age (число, опциональное), active (boolean, обязательное)
• Каждый элемент может встречаться только один раз

Ключевые концепции XSD

Типы данных

• xs:string (строка)
• xs:integer (целое число)
• xs:decimal (число с запятой)
• xs:boolean (true/false)
• xs:date (дата)
• xs:dateTime (дата и время)
• xs:email (email адрес)
• Кастомные типы (можно определить свои)

Элементы и атрибуты

• Element — это содержимое тега <tag>content</tag>
• Attribute — это параметр тега <tag attr="value"></tag>

Обязательность

• minOccurs="1" — элемент обязателен
• minOccurs="0" — элемент опционален
• maxOccurs — максимальное количество повторений

Валидация

• Ограничение значений (enumeration)
• Длина строки (minLength, maxLength)
• Числовые диапазоны (minInclusive, maxInclusive)
• Regular expressions для паттернов

Связь XSD с BA работой

Описание контрактов интеграции

• BA должен понимать, какие данные передаются между системами
• XSD помогает документировать эту структуру
• Это часть спецификации интеграционного требования

Validation rules

• BA определяет, какие данные являются валидными
• XSD это воплощает в техническую форму
• Разработчик использует XSD для имплементации валидации

Примеры BA требований

• "Электронный счёт должен быть в формате XML, соответствующем стандарту invoiceXSD.xsd"
• "При импорте пользователей из CRM, система должна валидировать их по предоставленной XSD схеме"

XSD vs JSON Schema

В современных API часто используется JSON вместо XML. JSON Schema — это аналог XSD для JSON документов.

Сравнение:

• XSD — стандарт для XML, более старый и более сложный
• JSON Schema — стандарт для JSON, более современный и проще в использовании
• Функционально похожи: оба описывают структуру и типы данных

Когда BA должен знать XSD

1. Legacy системы — много enterprise систем всё ещё используют XML
2. B2B интеграции — особенно в финансовом и государственном секторе
3. SOAP API — старые веб-сервисы используют XML/SOAP с XSD контрактами
4. EDI — электронный обмен данными в логистике и торговле

Инструменты для работы с XSD

• Online validators — для проверки XML по XSD
• XMLSpy — профессиональный редактор XSD
• VS Code — с расширениями для XML/XSD
• Java tools — xjc (XML Schema Compiler) для генерации кода

В итоге, XSD — это инструмент, который BA встречает в интеграционных и enterprise проектах. Детальное знание XSD не критично для повседневной работы, но понимание концепции очень полезно.