Разделить маску ввода кода и настоящую проверку формата

Маска UUU-999 допускает три буквы или цифры в верхнем регистре и три цифры. Правило нашего кода строже: ровно три латинские буквы и три цифры.

Подготовка

1. Создайте отдельную учебную внешнюю обработку с пустой управляемой основной формой. Каждую задачу запускайте в своей копии формы.

2. Не добавляйте вручную реквизит ЗначениеПримера, поле ПолеПримера и команду УчебноеДействие: их создаст код.

3. В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Вставьте весь модуль, включая клиентские и серверные процедуры.

4. Сохраните учебную EPF и откройте через Файл → Открыть в тонком или толстом клиенте Windows. Рабочие данные не читаются и не записываются.

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    Новые = Новый Массив;
    ТипРеквизита = Новый ОписаниеТипов("Строка", , Новый КвалификаторыСтроки(7));
    Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита));
    ЭтаФорма.ИзменитьРеквизиты(Новые);
    ЭтаФорма.ЗначениеПримера = "ABC-123";
    Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
    Поле.Вид = ВидПоляФормы.ПолеВвода;
    Поле.ПутьКДанным = "ЗначениеПримера";
    Поле.Заголовок = "Учебный код товара";
    Поле.Маска = "UUU-999";
    Поле.КнопкаОчистки = Истина;
    Поле.ОтметкаОбязательногоЗаполнения = Истина;
    Поле.Ширина = 14;

    КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
    КомандаДействия.Действие = "УчебноеДействие";
    КомандаДействия.Заголовок = "Проверить учебный код";
    КомандаДействия.Подсказка = "Действие только над данными учебной формы";
    КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
    Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
    Кнопка.ИмяКоманды = КомандаДействия.Имя;
    Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры

&НаКлиенте
Процедура УчебноеДействие(Команда)
    Если Не КодПодходитКонтракту(ЗначениеПримера) Тогда
        Сообщить("Нужны три латинские буквы A–Z, дефис и три цифры, например ABC-123.");
        Возврат;
    КонецЕсли;
    Сообщить("Допустимый учебный код: " + ЗначениеПримера);
КонецПроцедуры

&НаСервереБезКонтекста
Функция КодПодходитКонтракту(Текст)
    Возврат СтрПодобнаПоРегулярномуВыражению(Текст, "^[A-Z]{3}-[0-9]{3}$", Ложь, Ложь);
КонецФункции

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

1. Маска описывает удобство интерактивного ввода: U — алфавитно-цифровой символ с переводом в верхний регистр, 9 — цифра.

2. U допускает также цифры и нелатинские буквы, поэтому маска не соответствует нашему бизнес-правилу полностью.

3. Клиентская команда передаёт фактическую строку в отдельную серверную функцию.

4. Регулярное выражение с якорями проверяет всю строку и только латинские A–Z. Проверка регистрозависима.

5. При несоответствии обработка прекращается; строка не исправляется и не отправляется во внешний сервис.

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

1. ABC-123 проходит проверку.

2. 123-456 подходит маске, но не бизнес-проверке; выводится объяснение.

3. Кириллические АБВ-123 также должны быть отклонены строгим латинским контрактом.

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

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

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

1. Синтаксис Маска 1С не является регулярным выражением.

2. Латинская A и похожая кириллическая А — разные символы; не заменяйте их автоматически без согласованного правила.

3. При импорте через сервер интерактивная маска не применяется, серверная проверка остаётся обязательной.

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