Маски в 1С: как настроить формат ввода данных правильно

Работа с масками в 1С:Предприятие — это один из ключевых навыков, который упрощает ввод данных, снижает количество ошибок и ускоряет обработку информации. Маски позволяют задать строгий формат для полей ввода: будь то даты в формате ДД.ММ.ГГГГ, номера телефонов с разделителями или уникальные идентификаторы документов. Без правильной настройки масок пользователи могут вводить данные в произвольном виде, что приводит к сбоям в отчётах, ошибкам при обмене данными и дополнительным затратам времени на исправление.

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

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

Что такое маска в 1С и зачем она нужна

Маска в 1С:Предприятие — это шаблон, который определяет, какие символы и в каком порядке пользователь может вводить в поле. Она работает как фильтр: запрещает ввод недопустимых знаков и автоматически форматирует данные по заданному образцу. Например, маска для номера телефона может выглядеть как +7 (###) ###-##-##, где # обозначает цифру.

Основные задачи масок:

• 📅 Стандартизация ввода — все пользователи вводят данные в одном формате (например, даты всегда как ДД.ММ.ГГГГ).
• 🔍 Проверка корректности — исключает ошибки при ручном вводе (например, буквы в поле для чисел).
• ⚡ Ускорение работы — пользователю не нужно думать о формате, система подсказывает его автоматически.
• 🔗 Совместимость с обменом данными — правильно оформленные данные легче экспортировать в другие системы.

Без масок поле для ввода ИНН может содержать 10, 12 или даже 15 символов, включать пробелы или тире. С маской ############ (12 цифр) система гарантирует, что пользователь введёт только корректный идентификатор. Это особенно важно для регламентированной отчётности, где ошибка в одном символе может привести к отказу в приёме документов.

⚠️ Внимание: Маски не заменяют полноценную валидацию данных! Они только ограничивают ввод, но не проверяют логическую корректность. Например, маска для даты не проверит, существует ли введённая дата (типа 31.02.2023). Для этого нужны дополнительные проверки в модуле объекта.

Типы масок в 1С: какие бывают и где применяются

В 1С:Предприятие 8 маски можно разделить на два основных типа по способу создания:

1. Маски ввода — настраиваются в свойствах реквизита или поля формы. Работают на уровне интерфейса и ограничивают ввод пользователя.
2. Маски форматирования — применяются программно (например, для вывода данных в отчётах) и не влияют на ввод.

По назначению маски делятся на:

Маски для даты и времени часто используют встроенные форматы платформы (например, ДФ — дата полная, ВФ — время полное). Для строк и чисел применяют произвольные шаблоны с символами-заменителями:

• # — цифра (0-9),
• A — буква (а-я, A-Z),
• ? — любой символ,
• \ — экранирование (например, \. для точки).

Как создать маску в конфигураторе 1С

Самый простой способ добавить маску — настроить её в свойствах реквизита или элемента формы. Рассмотрим процесс на примере обычной формы:

1. Откройте конфигуратор и перейдите в раздел Объекты → [Ваш объект] → Формы.
2. Выберите форму (например, форму документа) и откройте её в режиме редактирования.
3. Кликните на поле, для которого нужна маска (например, поле НомерТелефона).
4. В палитре свойств найдите параметр Маска и введите шаблон, например:

   +7 (###) ###-##-##

5. Сохраните изменения и обновлите конфигурацию базы данных.

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

Убедитесь, что шаблон соответствует реальным данным|

Протестируйте ввод корректных и некорректных значений|

Проверьте отображение маски в 1С:Предприятии (не только в конфигураторе)|

Сохраните резервную копию конфигурации перед изменениями

-->

Если маска не работает, проверьте:

• 🔹 Правильно ли указаны символы-заменители (#, A, ?).
• 🔹 Нет ли конфликтов с другими настройками поля (например, с свойством Режим ввода).
• 🔹 Обновлена ли конфигурация базы после изменений.

⚠️ Внимание: В управляемых формах маски, заданные в свойствах реквизита объекта, могут не работать, если поле на форме имеет собственный шаблон. Всегда проверяйте приоритетность настроек!

Программное создание масок на встроенном языке

Иногда маски нужно настраивать динамически — например, если формат зависит от условий (тип документа, страна клиента и т.д.). В таких случаях используют встроенный язык 1С.

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

Процедура УстановитьМаскуТелефона(ЭлементФормы)
Если НЕ ЗначениеЗаполнено(ЭлементФормы) Тогда
Возврат;
КонецЕсли;

// Определяем маску в зависимости от кода страны
Если Левое(ЭлементФормы.Значение, 2) ="+7" Тогда
ЭлементФормы.Маска ="+7 (###) ###-##-##";
ИначеЕсли Левое(ЭлементФормы.Значение, 2) ="+1" Тогда
ЭлементФормы.Маска ="+1 (###) ###-####";
Иначе
ЭлементФормы.Маска ="";
КонецЕсли;
КонецПроцедуры

Этот код можно разместить в модуле формы (например, в обработчике события ПриИзменении для поля телефона). Таким образом, маска будет подстраиваться под введённые пользователем данные.

Для проверки корректности введённого значения используйте функцию СоответствуетМаске:

Если НЕ СоответствуетМаске(Значение,"+7 (###) ###-##-##") Тогда
Сообщить("Некорректный формат номера телефона!");
Возврат Ложь;
КонецЕсли;

Процедура НомерТелефонаПриИзменении(Элемент)
Если НЕ СоответствуетМаске(Элемент.Значение,"+7 (###) ###-##-##") Тогда
Элемент.ПроверкаЗаполнения = Ложь;
Элемент.Подсказка ="Формат: +7 (XXX) XXX-XX-XX";
Иначе
Элемент.ПроверкаЗаполнения = Истина;
КонецЕсли;
КонецПроцедуры

Распространённые ошибки при работе с масками

Даже опытные разработчики иногда сталкиваются с проблемами при настройке масок. Вот самые частые ошибки и способы их исправления:

1. Маска не применяется к полю
   Проверьте, не переопределён ли шаблон в свойствах элемента формы. В управляемых формах приоритет имеют настройки элемента, а не реквизита.
2. Пользователь может ввести лишние символы
   Убедитесь, что в маске указаны все обязательные разделители (скобки, тире, пробелы). Например, для телефона +7###-###-##-## позволит ввод без пробелов, а +7 (###) ###-##-## — нет.
3. Маска сбрасывается после обновления формы
   Если маска задаётся программно, разместите код в обработчике ПриСозданииНаСервере или ПриОткрытии, а не в ПриАктивизацииСтроки.
4. Не работают символы-заменители
   Помните, что # — только цифры, A — только буквы, а ? — любой символ. Для букв в верхнем регистре используйте &.

Ещё одна типичная проблема — конфликт масок с регулярными выражениями. Если вы используете оба метода проверки, убедитесь, что они не противоречат друг другу. Например, маска ############ для ИНН допускает 12 цифр, а регулярное выражение ^\d{10,12}$ — от 10 до 12. В таком случае ИНН из 10 цифр пройдёт проверку регуляркой, но не пройдёт по маске.

Маски для сложных форматов: ИНН, СНИЛС, банковские счета

Некоторые данные требуют особого подхода из-за строгих правил форматирования. Рассмотрим примеры масок для распространённых форматов:

ИНН (10 или 12 цифр):

Маска ="##########;############"; // Разрешаем 10 или 12 цифр через точку с запятой

СНИЛС (XXX-XXX-XXX XX):

Маска ="###-###-### ##";

Банковский счёт (20 цифр):

Маска ="####################";

Серия и номер паспорта (XX XX XXXXXX):

Маска ="&& && ######"; // && — две заглавные буквы

Для проверки контрольных цифр (например, в СНИЛС или ИНН) маски недостаточно — нужны дополнительные алгоритмы. Пример проверки контрольной суммы для СНИЛС:

Функция ПроверитьСНИЛС(Значение)
Если НЕ СоответствуетМаске(Значение,"###-###-### ##") Тогда
Возврат Ложь;
КонецЕсли;

// Удаляем разделители
Значение = СтрЗаменить(Значение,"-","");
Значение = СтрЗаменить(Значение,"","");

// Проверяем контрольное число (последние 2 цифры)
Сумма = 0;
Для Индекс = 1 По 9 Цикл
Цифра = Сред(Значение, Индекс, 1);
Сумма = Сумма + Число(Цифра) * (10 - Индекс);
КонецЦикла;

КонтрольноеЧисло = Правое(Значение, 2);
Если Сумма = 100 Или Сумма = 101 Тогда
Ожидаемое ="00";
ИначеЕсли Сумма < 100 Тогда
Ожидаемое = Строка(Сумма);
Иначе
Ожидаемое = Строка(Сумма % 101);
Если СтрочнаяДлина(Ожидаемое) = 1 Тогда
Ожидаемое ="0" + Ожидаемое;
КонецЕсли;
КонецЕсли;

Возврат Ожидаемое = КонтрольноеЧисло;
КонецФункции

⚠️ Внимание: Форматы реквизитов (например, ИНН или СНИЛС) могут меняться с обновлением законодательства. Всегда сверяйте актуальные требования с официальными источниками (на сайте ФНС или ПФР).

Маски в отчётах и печатных формах

Маски применяются не только для ввода, но и для вывода данных — например, в отчётах или печатных формах. Здесь они помогают привести данные к единому виду перед показов пользователю или экспортом.

Пример форматирования даты в отчёте:

Текст = Формат(ТекущаяДата,"ДФ='dd MMMM yyyy г.'"); //"01 января 2023 г."

Для числовых значений:

Текст = Формат(СуммаДокумента,"ЧФ=',0.00'; ЧРД='руб.'"); //"1 234,56 руб."

В печатных формах маски настраиваются через свойства полей или программно в модуле формы. Например, чтобы номер телефона всегда отображался в формате +7 (XXX) XXX-XX-XX, даже если в базе он хранится как 79XXXXXXXX, используйте:

Процедура ПриПодготовкеДанных(Объект, ДанныеФормы, СтандартнаяОбработка)
СтандартнаяОбработка = Ложь;

// Форматируем телефон
Если ЗначениеЗаполнено(Объект.Телефон) Тогда
Телефон = Объект.Телефон;
Если СтрочнаяДлина(Телефон) = 11 И Левое(Телефон, 1) ="7" Тогда
ДанныеФормы.Параметры.Телефон = Формат(Телефон,"+7 (###) ###-##-##");
КонецЕсли;
КонецЕсли;
КонецПроцедуры

Для табличных документов (например, Excel-отчётов) маски задаются через свойства колонок или ячеек. Например:

Таблица.Колонки.Добавить("ДатаДокумента");
Таблица.Колонки[0].Формат ="ДФ='ДД.ММ.ГГГГ'";

FAQ: Частые вопросы по маскам в 1С

Маска ="&&-######";

Маска ="&&";

Процедура СерияПаспортаПриИзменении(Элемент)
Элемент.Значение = ВРег(Элемент.Значение);
КонецПроцедуры

Процедура ЦенаПриИзменении(Элемент)
Если Элемент.Значение < 0 Тогда
Сообщить("Цена не может быть отрицательной!");
Элемент.Значение = 0;
КонецЕсли;
КонецПроцедуры

Если НЕ РегВыражение("^[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}$", Элемент.Значение, Истина) Тогда
Сообщить("Некорректный email!");
КонецЕсли;