„This element is not expected“ (cvc-complex-type.2.4)

Какво значи

SAF-T схемата описва всеки съставен елемент чрез xs:sequence — строга последователност: кои деца се допускат, в какъв ред и колко пъти. Когато валидаторът срещне елемент, който не пасва на очакваното място в последователността, той докладва „this element is not expected“. Кодът на грешката подсказва варианта:

Съобщението винаги носи двете ключови парчета информация: кой елемент е срещнат (тук Description) и кой е очакван (списъкът в къдравите скоби — тук AccountID). Практически това значи едно от две:

• Липсва задължителен елемент. Схемата чака AccountID, а той го няма — затова валидаторът се „спъва“ в следващия елемент и докладва него. Виновникът не е споменатият елемент, а липсващият преди него.
• Елементите са в грешен ред. Всички данни са налице, но софтуерът ги е записал в друга последователност. За xs:sequence разместването е също толкова невалидно, колкото и липсата.

Защо се случва

• Софтуерът пропуска елемент при празна стойност. Ако дадено поле е без съдържание за конкретния запис, някои експорти просто не го записват. За незадължителните елементи това е коректно; за задължителните — генерира тази грешка при всяко срещане.
• Експортът е строен по друга версия на схемата. Ред и състав на елементите се променят между версиите. Файл, генериран по стара версия, се сблъсква с новата последователност.
• Ръчно съставен или „закърпен“ XML. При ръчна намеса е лесно елемент да попадне на грешно ниво — например поле на реда да се озове на нивото на документа.
• Разместване при сглобяване от няколко източника. Когато секциите идват от различни системи, редът на елементите в общия файл зависи от реда на сглобяване, а не от схемата.

Как се поправя

1. Прочетете съобщението докрай: елементът в къдравите скоби е това, което схемата очаква. Съседният ред във файла ще ви покаже дали той липсва, или просто стои по-надолу.
2. Проверете в справочника на елементите дали очакваният елемент е задължителен и какво е мястото му в родителя.
3. Не поправяйте грешките една по една в XML-а. Обикновено една системна причина генерира десетки еднакви грешки — един пропуснат елемент на ниво запис се повтаря за всеки запис. Открийте защо софтуерът го пропуска или размества и поправете на едно място — в настройките или мапинга на експорта.
4. Регенерирайте файла и валидирайте отново. Броят на грешките трябва да падне драстично, ако сте хванали системната причина.

Пример

Опростен пример: схемата изисква в описанието на сметка първо AccountID, после AccountDescription:

<Account>
  <AccountDescription>Клиенти</AccountDescription>
  <AccountID>411</AccountID>
</Account>
<!-- cvc-complex-type.2.4.a: Invalid
     content was found starting with
     element 'AccountDescription'.
     One of '{AccountID}' is expected. -->

<Account>
  <AccountID>411</AccountID>
  <AccountDescription>Клиенти</AccountDescription>
</Account>