Что такое XML
В условной интеграции обе команды получили правильный XML. Одна считала сумму ценой за штуку, другая – итогом за всю поставку: теги согласовали, смысл пока оставили на потом.
XML (Extensible Markup Language) – это текстовый язык разметки для представления структурированных данных. В XML-документе элементы, атрибуты и их вложенность описывают состав данных, а правила конкретного обмена определяют значение этой структуры.
Что находится внутри файла XML
Документ обычно удобно представить как дерево. Есть корневой элемент, внутри него – дочерние элементы, текст и атрибуты. Названия выбирает автор формата в рамках правил XML. Поэтому язык можно использовать для заказов, настроек, справочников и других предметных данных.
Учебный фрагмент: <order id="A1"><total currency="RUB">1500</total></order>.
Здесь order – корневой элемент, id – его атрибут, total – вложенный элемент, currency – атрибут суммы, а 1500 – текстовое значение. Но сами имена не сообщают, включены ли налоги, за какой период рассчитана сумма и каким является заказ. Это определяет договоренность о формате.
Расширение .xml помогает распознать предполагаемый вид файла, но не гарантирует правильность содержимого. Текст можно открыть редактором, а для программной обработки используют XML-парсер. Приложение должно понимать не только синтаксис, но и конкретную структуру обмена.
Синтаксис и схема проверяют разные вещи
Корректно сформированный XML соблюдает правила записи: вложенность элементов, закрытие конструкций, оформление атрибутов и другие требования. Например, открытый элемент нельзя закрыть в произвольном месте, нарушив структуру. Регистр имен важен: Order и order – разные имена.
Соответствие схеме – дополнительный уровень. XSD может описывать допустимые элементы, их порядок, количество, типы значений и ограничения. Документ способен быть синтаксически правильным, но не соответствовать нужной схеме: например, в нем нет обязательного поля или вместо даты передан произвольный текст.
Схема тоже не отвечает на все бизнес-вопросы. Значение может подходить по типу и диапазону, но относиться к несуществующему заказу или уже завершенной операции. После технической проверки нужны проверки предметного смысла.
Почему два правильных документа не всегда совместимы
У одной системы название поля означает внутренний номер, у другой – внешний. Одна передает время с часовым поясом, другая подразумевает локальное. Если это не согласовано, формальное чтение пройдет успешно, а результат окажется неправильным.
В обмене фиксируют версию формата, значение полей, обязательность, единицы измерения и способ обработки отсутствующих данных. Пустой элемент, отсутствие элемента и нулевое значение не стоит без объяснения считать одним состоянием. Для конкретного поля между ними может быть принципиальная разница.
Пространства имен помогают различать одинаковые имена из разных словарей. Их идентификатор похож на адрес, но не обязан быть ссылкой, по которой программа скачивает описание. При работе важно учитывать пространство имен, а не только видимую короткую часть названия элемента.
XML, HTML, JSON и таблицы
HTML прежде всего описывает структуру веб-страниц с известными браузеру элементами. XML позволяет определить собственную предметную разметку. Переименование текстового документа в .html не создает автоматически удобный интерфейс для его редактирования.
JSON представляет данные через объекты, массивы и значения, а XML использует элементы, атрибуты и текст. Оба встречаются в интеграциях. Выбор зависит от договоренности сторон, существующих инструментов и требований: универсального победителя для любых данных нет.
Табличная выгрузка удобна для строк однотипных записей, но сложную вложенную структуру приходится отдельно согласовывать. XML может выразить ее явно, однако за это платят более подробной записью и необходимостью соблюдать формат. Читаемость для программы и удобство ручного просмотра – разные критерии.
Типичные ошибки обмена
- Неверная вложенность или незакрытый элемент
- Несогласованная кодировка и испорченные символы
- Обычный текст со специальными символами без нужного экранирования
- Неправильный тип, единица измерения или часовой пояс
- Игнорирование пространства имен или версии формата
- Повторная обработка того же документа как новой операции
В тексте XML некоторые символы требуется записывать специальным образом. Например, амперсанд не всегда можно вставить буквально. Ручная сборка строки из пользовательского ввода легко создает ошибку; надежнее применять инструменты, которые корректно формируют документ.
Сравнивать результат обмена полезно по структуре и значениям с учетом правил формата. Косметические различия записи не всегда означают изменение данных. И наоборот, почти одинаковые строки могут отличаться критичным идентификатором.
Как принимать документ безопасно
Для недоверенных входных данных нужно контролировать размер, глубину и доступные возможности парсера. Обработка внешних сущностей при небезопасной настройке способна привести к нежелательным обращениям к файлам или сети. Такие возможности ограничивают согласно задачам и документации выбранного инструмента.
Проверку проводят слоями: удалось ли прочитать документ, соответствует ли он ожидаемой схеме, допустимы ли бизнес-значения, не обработана ли операция раньше. Ошибка должна помогать найти проблему по безопасному идентификатору, а не складывать все чувствительное содержимое в общий журнал.
XML хорошо передает структуру. Чтобы передать правильный смысл, сторонам все равно нужно договориться. Даже идеально закрытые теги не закрывают вопрос о том, что именно вы отправили.
modal1 content
modal2 content
Спасибо!
Форма успешно отправлена
Наши специалисты скоро свяжутся с вами
Ошибка!
Данные не отправлены
Проверьте правильность заполнения и повторите попытку
Обсудить проект
Оставьте заявку и получите индивидуальное решение по вашей задаче с этапами и сроками производства
Получите бесплатно анализ бизнес-процессов
Проведем бесплатно анализ бизес-процессов, выявим узкие места и разработаем кастомное решение для улучшения показтелей
Купить лицензию
Оставьте заявку и получите индивидуальное решение по вашей задаче с этапами и сроками производства
Ищите опытную команду интеграторов
Проанализируем задачи, составим тех. задание и предложим решение.
Live-демонстрация портала
Продемонстрируем работу портала в реальном времени, ответим на все вопросы
Пригласить на участие в тендере
Пришлем информацию с кейсами по вашей отрасли
Выберите свой город