К статье
Практический материал

Другое · 5 мин

Как задать маску ввода в 1С

Как задать маску ввода в 1C: свойства формы и программно, примеры шаблонов, допустимые символы, проверка и ошибки для реквизитов документов и справочников.

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

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

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

Задание маски через свойства формы

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

Сравнение вариантов

Через свойства формы

Подходит для фиксированного правила для всех пользователей, проще в поддержке.

Программно

Подходит, когда маска должна меняться по условиям, требует поддержки кода.

Этот способ подходит, когда правило одинаково для всех ролей и не зависит от содержимого других полей. Маска, заданная в свойствах, работает на клиенте и сразу отсекает недопустимые символы при вводе.

Символы шаблона и примеры масок

Шаблон состоит из зарезервированных символов, где каждый знак обозначает тип вводимого элемента. Цифры, буквы, разделители и фиксированные знаки комбинируются в одну строку. Для даты подходит шаблон с точками, для телефона — скобки и дефисы.

1c
Элементы.МоёПоле.МаскаВвода = "99.99.9999";

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

Программное задание маски

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

Контрольные точки

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

Корректное значение
Норма

Принимается и сохраняется

Тревожный признак

Блокируется или искажается

Некорректные символы
Норма

Отсекаются маской

Тревожный признак

Попадают в поле и сохраняются

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

Проверка результата и ограничения

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

Маска не заменяет серверную валидацию: пользователь может скопировать значение или обойти клиентское ограничение. Перед записью данных всегда выполняйте проверку реквизитов в модуле объекта или на сервере.

Типичные ошибки
01
Шаблон не соответствует типу реквизита — поле перестаёт принимать ввод.
02
Изменения не сохранены в конфигурации — маска не применяется у пользователей.

Частые ошибки при настройке

Частая ошибка — использование шаблона, не соответствующего типу реквизита, например числовая маска для строкового поля. Это приводит к тому, что поле не принимает ввод или данные сохраняются некорректно. Другая ошибка — забыть сохранить конфигурацию после изменения свойств формы.

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

Когда маска не подходит и альтернативы

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

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

Итог

Что важно запомнить

Маску задают через свойства формы или программно, выбирают шаблон под тип реквизита, проверяют на тестовой базе и дополняют серверной валидацией.

Нужно ли перезапускать 1С после изменения маски?

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

Работает ли маска в веб-клиенте 1С?

Поддержка зависит от версии платформы и типа клиента, поэтому поведение лучше проверить именно в том клиенте, где работают пользователи.

Можно ли задать разные маски для разных ролей?

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

Защищает ли маска от ошибок при записи данных?

Нет, маска только ограничивает ввод на форме, поэтому перед записью значения всё равно нужна отдельная проверка реквизитов.