Как исправить ошибку «Ошибка проверки данных XDTO: Структура объекта не соответствует типу» в 1С?

При настройке обмена данными в 1С, особенно если вы используете обмены через брокеры, формат Enterprise Data (помогут готовые правила обмена EnterpriseData для нетиповых реквизитов) или собственные XDTO-пакеты через расширения конфигурации, разработчики часто сталкиваются с ошибкой валидации структуры. Сообщение «Структура объекта не соответствует типу: Отсутствует обязательное свойство» говорит о том, что система ожидает наличие определенного поля в XML-файле, но не находит его или не может сопоставить с описанием в схеме. Разберем подробно, как диагностировать и устранить эту проблему на разных уровнях: от опечаток в коде до тонких настроек свойств в XDTO-пакете.

Анализ причин возникновения ошибки валидации

Первым шагом проанализируем ситуацию, описанную в сообщениях форума. Проблема часто возникает при добавлении новых документов или справочников в обмен через расширения. Валидатор XDTO строго следует правилам, описанным в пакете, и любое отклонение (даже в одну букву) приводит к фатальной ошибке загрузки данных. Основные причины включают:

1. Опечатки в именах свойств: Различие в именовании реквизитов в коде 1С и в описании XDTO-пакета.
2. Несоответствие обязательности полей: В схеме свойство помечено как обязательное (минимальное количество = 1), а в выгружаемых данных оно отсутствует.
3. Регистрозависимость: XDTO чувствителен к регистру (например, ДатаДокумента и датадокумента — это разные свойства).
4. Некорректные символы в данных: Наличие латиницы вместо кириллицы в ключевых реквизитах или невидимых управляющих символов.

Решение 1: Проверка имен свойств и устранение опечаток

Рассмотрим конкретный пример из практики. В коде формирования правил конвертации объектов (ПКО) часто допускаются ошибки при программном добавлении свойств. Проанализируем фрагмент кода, который вызвал затруднение:

Процедура ДобавитьПКО_Документ_Фасовка_Получение(ПравилаКонвертации) 
    ПравилоКонвертации = ОбменДаннымиXDTOСервер.ИнициализироватьПравилоКонвертацииОбъекта(ПравилаКонвертации);
    // ... настройки заголовка правила ...
    
    СвойстваТЧ = ДобавитьПКТЧ(ПравилаКонвертации, "Запасы", "");
    ДобавитьПКС(СвойстваТЧ, "ЕденицаИзмеренияТовара", "", 1, "Справочник_ЕдиницыИзмерения"); 
    ДобавитьПКС(СвойстваТЧ, "КоличествоТовара", "", );
КонецПроцедуры

Внимательно посмотрим на строку добавления свойства ЕденицаИзмеренияТовара. Здесь допущена классическая орфографическая ошибка. Если в XDTO-пакете свойство называется ЕдиницаИзмеренияТовара (через «и»), то валидатор выдаст ошибку «Отсутствует обязательное свойство», так как он ищет «Единицу», а получает «Еденицу».

Совет: Всегда копируйте имена свойств непосредственно из дерева свойств XDTO-пакета в конфигураторе, чтобы избежать подобных ошибок.

Решение 2: Настройка минимального количества и признака Nillable

Если данные могут отсутствовать по бизнес-логике, необходимо правильно настроить свойства в XDTO-пакете. Выясним разницу между параметрами, влияющими на валидацию:

1. Минимальное количество (minOccurs): Если установить значение 0, свойство становится необязательным. Это означает, что в XML-файле тег может отсутствовать полностью. Это самый простой способ «победить» ошибку валидации, если поле не является критически важным.
2. Возможно пустое (nillable): Если установить Истина, тег в XML должен присутствовать обязательно, но он может иметь атрибут xsi:nil="true". Это используется, когда важно передать сам факт отсутствия значения (аналог NULL в базах данных).

Разберем, как это применить. Откроем пакет XDTO, найдем нужный тип объекта и в свойствах элемента установим Минимальное количество = 0. Это позволит системе игнорировать отсутствие данных при загрузке и не прерывать процесс обмена ошибкой.

Решение 3: Борьба с невидимыми символами и раскладкой

Иногда визуально данные выглядят верно, но ошибка сохраняется. Рассмотрим ситуацию с «похожими» буквами. В практике 1С часто встречаются проблемы, когда в номере счета или наименовании вместо русской «К» стоит английская «K». Для XDTO-сериализатора, если свойство является частью уникального ключа или перечисления, это разные значения.

Также проанализируем проблему непечатных символов. В строки могут попасть:

• Неразрывные пробелы (nbsp).
• Символы табуляции.
• Переносы строк внутри полей, где они не предусмотрены схемой.

В таких случаях рекомендуется использовать функцию СокрЛП() и очистку строк от спецсимволов перед выгрузкой в XDTO-объект.

Программная отладка структуры XDTO

Чтобы точно выяснить, на каком этапе происходит сбой, воспользуемся методами программной проверки. Чтобы визуально сопоставить эталонный файл с тем, что генерирует ваша база, используйте инструмент для сравнения XML-документов. В платформе 1С объект ОбъектXDTO имеет встроенный метод Проверить(). Рассмотрим, как применить его для диагностики:

// Предположим, у нас есть сформированный объект XDTO перед отправкой
Попытка
    ДанныеОбъектаXDTO.Проверить();
Исключение
    // Если проверка не прошла, мы можем получить детальное описание
    Сообщить("Ошибка валидации: " + КраткоеПредставлениеОшибки(ИнформацияОбОшибке()));
    // Здесь можно проанализировать структуру через дерево свойств
КонецПопытки

Метод Проверить() возвращает Истина, если структура соответствует схеме. Если возвращается Ложь, это сигнал о том, что обязательные поля не заполнены или типы данных не соответствуют описанным в пакете (например, передана строка вместо числа).

Особенности работы с XDTO в расширениях

При использовании расширений для изменения обмена данными важно помнить о приоритетах. Если конфигурации-источники и приемники различаются, эффективным решением станет адаптивная выгрузка и загрузка данных XML (поможет универсальный перенос данных между измененными конфигурациями), которая позволяет нивелировать разницу в структурах. Если же вы добавили изменения в XDTO-пакет внутри расширения, убедитесь, что:

1. Пространство имен (Namespace) совпадает с тем, которое используется в правилах обмена.
2. После изменения пакета в расширении обновлен кэш. Платформа 1С агрессивно кэширует схемы XDTO. Иногда требуется перезапуск сервера 1С или повторное применение расширения для того, чтобы изменения в minOccurs вступили в силу.
3. Проверьте порядок следования свойств (Sequence). В XDTO по умолчанию свойства должны идти строго в том порядке, в котором они определены в схеме. Если вы в коде ПКО добавляете свойства в одном порядке, а в пакете они описаны в другом, валидатор может выдать ошибку «Отсутствует обязательное свойство», просто потому что встретил другое свойство раньше ожидаемого.

Таким образом, для устранения ошибки несоответствия типа в XDTO необходимо действовать последовательно: проверить корректность написания имен свойств в коде и схеме, убедиться в правильности типов данных и, при необходимости, снизить строгость валидации, установив Минимальное количество = 0 в свойствах пакета.