Фасет XDTO в 1С: что это и как работать с ограничениями значений

При обмене данными через XML, веб-сервисы и форматы вроде ЭДО или выгрузок в банк 1С опирается на механизм XDTO (XML Data Transfer Objects). Одна из ключевых концепций этого механизма — фасет: ограничение, которое накладывается на значение типа данных. Фасеты отвечают на вопросы вроде «какая максимальная длина строки», «сколько знаков после запятой у числа», «в каком диапазоне лежит дата». Понимание фасетов необходимо, когда обмен ломается с ошибкой «Ошибка проверки данных XDTO» или когда вы создаёте собственные пакеты XDTO для интеграций.

Без фасетов XML-схема была бы просто набором полей без правил. Именно фасеты позволяют платформе автоматически проверять, что ИНН содержит 10 или 12 цифр, что сумма документа имеет не больше двух знаков после запятой, а код валюты соответствует перечисленным значениям. Когда проверка не проходит, 1С выбрасывает исключение ещё до записи или чтения данных — и это защищает базу от некорректных значений из внешних источников.

Что такое фасет и где он живёт в модели XDTO

Механизм XDTO в 1С описывает структуру данных через пакеты XDTO — аналог XML-схем (XSD). Каждый пакет содержит типы значений и типы объектов. Тип значения (например, «ИНН» или «СуммаДокумента») наследуется от базового примитивного типа — string, decimal, dateTime — и уточняется фасетами. Фасет — это свойство типа значения, хранящее ограничение: фиксированное или максимальное значение параметра.

В дереве конфигурации пакеты XDTO находятся в ветке «Общие → XDTO-пакеты». Открыв конкретный тип значения, вы увидите список его фасетов: длина, минимальная и максимальная длина, шаблон, перечисления, общее количество разрядов и так далее. Те же данные доступны программно через объект ФабрикаXDTO и свойства типа значения.

Важно понимать иерархию: базовый тип (string) → тип значения с фасетами (строка длиной 10) → свойство объекта, использующее этот тип. Фасеты наследуются и сужаются: дочерний тип может ужесточить ограничение родителя (например, сократить максимальную длину), но не может его ослабить — это правило XML Schema, которое платформа соблюдает.

Основные виды фасетов и их назначение

Набор доступных фасетов зависит от базового типа. Для строк доступны ограничения длины и шаблоны, для чисел — разрядность и границы диапазона, для дат — границы периода. Ниже перечислены фасеты, с которыми разработчик 1С сталкивается чаще всего.

На практике чаще всего встречаются связки «максимальная длина + шаблон» для идентификаторов и «totalDigits + fractionDigits» для денежных сумм. Например, тип суммы в банковских форматах обычно ограничен 18 разрядами всего и 2 разрядами дробной части — попытка записать сумму с тремя знаками после запятой вызовет ошибку проверки.

Как платформа проверяет значения по фасетам

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

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

Попытка
    ОбъектXDTO.Проверить();
Исключение
    Сообщить("Нарушение фасета: " + ОписаниеОшибки());
КонецПопытки;

Текст ошибки обычно содержит пространство имён пакета, имя типа, имя нарушенного фасета и фактическое значение. Например: «Ошибка проверки данных XDTO: значение '12345678901' не соответствует фасету 'МаксимальнаяДлина' типа 'ИННФЛ'». По этой диагностике можно быстро найти проблемное поле в исходном файле.

Практические сценарии работы с фасетами

Получение фасетов типа программно

Иногда нужно узнать ограничения типа до заполнения данных — например, чтобы обрезать строку до допустимой длины или показать пользователю подсказку. Тип значения XDTO предоставляет коллекцию фасетов, которую можно перебрать или запросить по виду фасета.

ТипЗначения = ФабрикаXDTO.Тип("http://mycompany.ru/exchange", "ИНН");
ФасетДлина = ТипЗначения.Фасеты.Получить(ВидФасетаXDTO.МаксДлина);
Если ФасетДлина <> Неопределено Тогда
    МаксимальнаяДлина = Число(ФасетДлина.Значение);
КонецЕсли;

Создание собственного пакета XDTO

При построении собственного формата обмена фасеты задаются в конфигураторе в свойствах типа значения либо импортируются из готовой XSD-схемы. Рекомендуется опираться на требования принимающей стороны: если банк или контрагент прислал XSD, импортируйте её напрямую через пункт «Импорт XML-схемы» в контекстном меню пакета — фасеты подтянутся автоматически, и вы избежите расхождений в ограничениях.

Обработка ошибок валидации при загрузке

Если входящие файлы периодически содержат «грязные» данные, не стоит отключать проверку полностью. Разумный подход — читать файл, перехватывать исключение, логировать текст ошибки с указанием файла и строки, а затем либо запрашивать исправленный файл у отправителя, либо аккуратно нормализовать значение (обрезать пробелы, округлить сумму) с явной записью в журнал.

Частые проблемы и способы их решения

Самая распространённая ситуация — ошибка «не соответствует фасету» при загрузке файла от внешней системы. Причины обычно три: отправитель использует другую версию схемы, данные содержат лишние пробелы или спецсимволы, либо ограничение в вашем пакете жёстче, чем реальные данные (например, наименование контрагента длиннее 150 символов).

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

Как проверить корректность настройки

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

Когда фасеты не нужны и какие есть альтернативы

Фасеты оправданы, когда формат обмена формализован и контролируется обеими сторонами: ЭДО, банковские выписки, обмен с государственными сервисами, корпоративные интеграции по XSD. Если же вы делаете быстрый разовый обмен или формат нестабилен, жёсткие ограничения создадут больше проблем, чем пользы — каждое отклонение будет ронять загрузку.

Компромиссный вариант — оставить в пакете только базовые типы без жёстких фасетов, а критичные проверки (ИНН, суммы, обязательные поля) реализовать кодом после чтения. Так вы получаете управляемые сообщения об ошибках и возможность частичной загрузки корректных данных вместо полного отказа.

Частые вопросы о фасетах XDTO