Alpha.Community

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

Валидация данных

Компоненты валидации данных в Alpha.HMI предназначены для проверки различных типов данных на соответствие заданным условиям и ограничениям. Эти компоненты помогают гарантировать, что вводимые пользователем данные соответствуют определённым критериям.

Компоненты валидации из юнита Базовые:

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

Проверка ввода целого числа

Компонент Проверка ввода целого числа используется в случаях, когда необходимо убедиться, что введённое пользователем число находится в определённом диапазоне. Например, чтобы проверить, что введённое пользователем значение давления находится в допустимом диапазоне от 0 до 200 бар.

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

Компонент Проверка ввода целого числа расположен в юните Базовые Библиотеки компонентов. Экземпляр этого типа не отображается на форме и виден только в области Структура объекта.

Подробнее о свойствах, методах и событиях компонента Проверка ввода целого числа.

Проверка ввода беззнакового целого числа

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

Компонент помогает автоматически отсеивать недопустимые отрицательные значения.

Компонент Проверка ввода беззнакового целого числа расположен в юните Базовые Библиотеки компонентов. Экземпляр этого типа не отображается на форме и виден только в области Структура объекта.

Подробнее о свойствах, методах и событиях компонента Проверка ввода целого числа.

Проверка ввода числа с плавающей запятой

Компонент Проверка ввода числа с плавающей запятой используется в проектах автоматизации, где важно контролировать точность до определённого числа знаков после запятой. Например, чтобы убедиться, что температура, введённая пользователем, находится в диапазоне от -50.0 до 50.0 градусов Цельсия.

Компонент Проверка ввода числа с плавающей запятой учитывает текущий системный разделитель дробной части (точка, запятая или другой символ, заданный в настройках системы). Число должно быть записано с использованием именно этого символа. Если разделитель в числе отличается от системного, проверка завершится с ошибкой (значение свойства Результат проверки будет равно 0).

Компонент Проверка ввода числа с плавающей запятой расположен в юните Базовые Библиотеки компонентов. Экземпляр этого типа не отображается на форме и виден только в области Структура объекта.

Подробнее о свойствах, методах и событиях компонента Проверка ввода числа с плавающей запятой.

Проверка ввода регулярного выражения

Компонент Проверка ввода регулярного выражения используется для проверки форматов строк, таких как идентификаторы оборудования, номера партий продукции, коды ошибок и другие данные, где важен определённый формат. Например, чтобы убедиться, что идентификатор устройства, вводимый пользователем, соответствует заданному шаблону DEV-XXXX-YYYY, где X и Y — цифры.

Компонент проверяет, соответствует ли введённая строка одному из двух регулярных выражений: частично верному выражению или полностью верному выражению.

Компонент Проверка ввода регулярного выражения расположен в юните Базовые Библиотеки компонентов. Экземпляр этого типа не отображается на форме и виден только в области Структура объекта.

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

Как настроить валидацию данных (Демо-проект)

Далее кратко описан небольшой пример (скачать его можно здесь) использования компонентов валидации для соответствия вводимых данных определенным критериям в проекте Alpha.HMI (проект сделан на языке Alpha.Om).

Проект содержит примеры настройки валидации для различных типов данных:

Валидация целых чисел

Для проверки целочисленных значений на соответствие заданным условиям выполните следующие действия:

  1. Добавьте на форму текстовое поле, в которое можно будет выводить результат валидации.

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

  3. Чтобы выполнить валидацию сразу после открытия экранной формы в рантайме, используйте обработчик события Opened и пропишите в нем следующий код:

    IntegerValidation_1.Input = "15"; // Передаем значение, которое следует валидировать 
    Text_1.Text = Str.ToString(IntegerValidation_1.Result); // Получаем результат валидации и выводим в текстовое поле

Если требуется реакция на каждую смену результата валидации, то воспользуйтесь специальным событием ResultChanged.

Валидация целых беззнаковых чисел

Для настройки валидации беззнаковых целых чисел выполните следующие действия:

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

  2. Чтобы выполнить валидацию сразу после открытия экранной формы в рантайме, используйте обработчик события Opened и пропишите в нем следующий код:

    UnsignedIntegerValidation_1.Input = "500"; // Передаем значение, которое следует валидировать 
    Text_1.Text = Str.ToString(UnsignedIntegerValidation_1.Result); // Получаем результат валидации и выводим в текстовое поле

Если требуется реакция на каждую смену результата валидации, то воспользуйтесь специальным событием ResultChanged.

Валидация чисел с плавающей запятой

Для проверки чисел с плавающей запятой на соответствие заданным условиям выполните следующие действия:

  1. Определите условия валидации: добавьте на рабочую область компонент библиотеки Проверка ввода числа с плавающей запятой и укажите значения свойств Число знаков после запятой, Нижняя граница, Верхняя граница.

  2. Чтобы выполнить валидацию сразу после открытия экранной формы в рантайме, используйте обработчик события Opened и пропишите в нем следующий код:

    FloatValidation_1.Input = "55,9"; // Передаем значение, которое следует валидировать 
    Text_1.Text = Str.ToString(FloatValidation_1.Result); // Получаем результат валидации и выводим в текстовое поле

Если требуется реакция на каждую смену результата валидации, то воспользуйтесь специальным событием ResultChanged.

Валидация по регулярным выражениям

Для проверки строк на соответствие регулярному выражению выполните следующие действия:

  1. Определите условия валидации: добавьте на рабочую область компонент библиотеки Проверка ввода регулярного выражения и укажите значения свойств Частично верное выражение и Верное выражение. В примере ниже представлено регулярное выражение, которое проверяет, соответствует ли идентификатор устройства формату DEV-XXXX-YYYY, где X и Y являются цифрами.

  2. Чтобы выполнить валидацию сразу после открытия экранной формы в рантайме, используйте обработчик события Opened и пропишите в нем следующий код:

    RegexValidation_1.Input = "DEV-1234-5678"; // Передаем значение, которое следует валидировать 
    Text_1.Text = Str.ToString(RegexValidation_1.Result); // Получаем результат валидации и выводим в текстовое поле

Если требуется реакция на каждую смену результата валидации, то воспользуйтесь специальным событием ResultChanged.