ФасетМинимальнойДлиныXS.Фиксированный

Свойства · Fixed

Тип: Булево. Содержит признак ограничения значения данного фасета. Истина - значение фасета не может быть изменено в типах-потомках типа, владельца данного фасета.

Полное описание, параметры и ограничения

ФасетМинимальнойДлиныXS.Фиксированный (XSMinLengthFacet.Fixed)

ФасетМинимальнойДлиныXS (XSMinLengthFacet)

Фиксированный (Fixed)

Доступен, начиная с версии 8.1.

Использование:
Чтение и запись.
Описание:
Тип: Булево.
Содержит признак ограничения значения данного фасета.
Истина - значение фасета не может быть изменено в типах-потомках типа, владельца данного фасета.
Доступность:

Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.

Использование в версии:

Доступен, начиная с версии 8.1.

Методическая информация

Практические примеры

Проверить минимальную и максимальную длину описания товара

Учебное описание должно иметь от 3 до 20 символов. Проверяем обе границы, слишком короткий и слишком длинный текст.

Где и как запускать

Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.

Подготовка

  1. Полностью вставьте код в серверную учебную процедуру. Короткие строки не содержат эмодзи или составных Unicode-символов.

  2. Диапазон 3–20 нужен только для упражнения, не для загрузки в реальный сервис.

XSD = "<xs:schema xmlns:xs=""http://www.w3.org/2001/XMLSchema""
| xmlns:g=""urn:guide:limits"" targetNamespace=""urn:guide:limits"">
| <xs:simpleType name=""Price""><xs:restriction base=""xs:decimal"">
|  <xs:minInclusive value=""0""/><xs:maxInclusive value=""9999.99""/>
|  <xs:totalDigits value=""6""/><xs:fractionDigits value=""2""/>
| </xs:restriction></xs:simpleType>
| <xs:simpleType name=""Discount""><xs:restriction base=""xs:decimal"">
|  <xs:minExclusive value=""0""/><xs:maxExclusive value=""1""/>
| </xs:restriction></xs:simpleType>
| <xs:simpleType name=""Status""><xs:restriction base=""xs:string"">
|  <xs:whiteSpace value=""collapse""/>
|  <xs:enumeration value=""draft""/><xs:enumeration value=""published""/>
|  <xs:enumeration value=""closed""/>
| </xs:restriction></xs:simpleType>
| <xs:simpleType name=""Description""><xs:restriction base=""xs:string"">
|  <xs:minLength value=""3""/><xs:maxLength value=""20""/>
| </xs:restriction></xs:simpleType>
|</xs:schema>";
Чтение = Новый ЧтениеXML;
Чтение.УстановитьСтроку(XSD);
Попытка
    Документ = Новый ПостроительDOM;
    DOM = Документ.Прочитать(Чтение);
    Чтение.Закрыть();
Исключение
    Чтение.Закрыть();
    ВызватьИсключение;
КонецПопытки;
Построитель = Новый ПостроительСхемXML;
Схема = Построитель.СоздатьСхемуXML(DOM.ЭлементДокумента);
Если Схема = Неопределено Тогда
    ВызватьИсключение "Не построена собственная схема ограничений";
КонецЕсли;
Набор = Новый НаборСхемXML;
Набор.Добавить(Схема);
Если Не Набор.Проверить() Тогда
    ВызватьИсключение "Не прошла проверка собственной схемы";
КонецЕсли;
Фабрика = Новый ФабрикаXDTO(Набор);

Определение = Схема.ОпределенияТипов.Получить("Description", "urn:guide:limits");
ТипМодели = Фабрика.Тип("urn:guide:limits", "Description");
Сообщить(Определение.Фасеты.Количество() = 2);

Для Каждого Фасет Из Определение.Фасеты Цикл
    Сообщить(Строка(Фасет.ТипКомпоненты) + ": " + Фасет.ЛексическоеЗначение);
    Сообщить("Типизированное значение: " + Строка(Фасет.Значение));
    Сообщить("Фиксирован в потомках: " + Строка(Фасет.Фиксированный));
    Сообщить(Фасет.ОпределениеПростогоТипа.Имя = Определение.Имя);
    Сообщить(Фасет.Контейнер <> Неопределено);
    Сообщить(Фасет.КорневойКонтейнер <> Неопределено);
    Сообщить(Фасет.Схема.ПространствоИмен = "urn:guide:limits");
    Сообщить(Фасет.Аннотация = Неопределено);
    Сообщить(Фасет.Компоненты.Количество() = 0);
    Фасет.ОбновитьЭлементDOM();
    Сообщить("XML-тег ограничения: " + Фасет.ЭлементDOM.ИмяЭлемента);
    КопияФасета = Фасет.КлонироватьКомпоненту(Истина);
    Сообщить(ТипЗнч(КопияФасета) = ТипЗнч(Фасет));
    Сообщить(КопияФасета.ЛексическоеЗначение = Фасет.ЛексическоеЗначение);
    Сообщить(Не Фасет.Содержит(КопияФасета));
КонецЦикла;

Случаи = Новый Массив;
Случаи.Добавить(Новый Структура("Текст,Ожидается", "Аб", Ложь));
Случаи.Добавить(Новый Структура("Текст,Ожидается", "ABC", Истина));
Случаи.Добавить(Новый Структура("Текст,Ожидается", "12345678901234567890", Истина));
Случаи.Добавить(Новый Структура("Текст,Ожидается", "123456789012345678901", Ложь));

Для Каждого Случай Из Случаи Цикл
    Допустимо = Ложь;
    Попытка
        ЗначениеМодели = Фабрика.Создать(ТипМодели, Случай.Текст);
        Допустимо = Истина;
    Исключение
        Сообщить("Отклонено: " + Случай.Текст + "; "
            + КраткоеПредставлениеОшибки(ИнформацияОбОшибке()));
    КонецПопытки;
    Если Допустимо <> Случай.Ожидается Тогда
        ВызватьИсключение "Не совпал результат проверки значения: " + Случай.Текст;
    КонецЕсли;
    Сообщить(СтрШаблон("%1: допустимо = %2", Случай.Текст, Допустимо));
КонецЦикла;

Разбор по шагам

  1. minLength и maxLength дают два разных компонента ограничения, а не одну произвольную проверку в комментарии.

  2. Лексические значения 3/20 читаются как строки; типизированные Значение фасетов — числа.

  3. Обе длины границ включены: строка из трёх и из двадцати символов допустима.

  4. Проверка выполняется при создании ЗначениеXDTO. Отклонённый текст не обрезается автоматически.

  5. Чтение владельцев и XML-тегов позволяет увидеть связь бизнес-ограничения с исходной схемой.

Как проверить результат

  1. Найдены два фасета со значениями 3 и 20.

  2. Два символа и 21 символ отклоняются; 3 и 20 символов принимаются.

Ожидаемый результат

Границы длины описания проверены на четырёх конкретных строках без потери данных и неявного обрезания.

На что обратить внимание

  1. Длина строки, размер UTF-8 в байтах и число визуально воспринимаемых знаков могут различаться.

  2. Этот тип не удаляет разметку, не экранирует HTML и не проверяет смысл описания.

  3. Пробелы для xs:string не удаляются этим контрактом: пустоту бизнес-поля при необходимости проверяйте отдельно.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.