Валидация данных
Типы проверки данных и выполнение
Проверка данных - это возможность устанавливать правила, касающиеся ввода данных на листе таблицы. Например, использовать проверку для обеспечения того, что столбец с подписью DATE содержит только даты, или что другой столбец содержит только числа. Вы даже можете обеспечить, что столбец с подписью DATE содержит только даты в определенном диапазоне. С помощью проверки данных вы можете контролировать то, что вводится в ячейки на листе таблицы.
Microsoft Excel поддерживает ряд различных типов проверки данных. Каждый тип используется для контроля типа данных, вводимого в ячейку или диапазон ячеек. Ниже приведены фрагменты кода, иллюстрирующие проверку, что:
- Числа являются целыми, то есть у них нет десятичной части.
- Десятичные числа соответствуют правильной структуре. Приведенный пример кода определяет, что диапазон ячеек должен иметь два десятичных знака.
- Значения ограничены списком значений. Проверка списка определяет отдельный список значений, которые можно применить к ячейке или диапазону ячеек.
- Даты находятся в определенном диапазоне.
- Время находится в определенном диапазоне.
- Текст имеет определенную длину.
Проверка данных в Microsoft Excel
Для создания проверок с помощью Microsoft Excel:
- В листе выберите ячейки, к которым вы хотите применить проверку.
- Из меню Данные выберите Проверку. Диалоговое окно проверки будет отображено.
- Нажмите вкладку Настройки и введите настройки.
Проверка данных с использованием библиотеки Aspose.Cells для Python Excel
Проверка данных - мощная функция для проверки введенной информации в таблицы. С помощью проверки данных разработчики могут предоставлять пользователям список выбора, ограничивать ввод данных определенного типа или размера и т. д. В Aspose.Cells для Python via .NET, у каждого объекта Worksheet есть свойство validations, которое представляет собой коллекцию объектов Validation. Чтобы настроить проверку, задайте некоторые свойства класса Validation следующим образом:
- type – представляет тип проверки, который можно указать, используя одно из предопределенных значений в перечислении ValidationType.
- Оператор – представляет оператор, который следует использовать в проверке, который можно указать, используя одно из предопределенных значений в перечислении OperatorType.
- formula1 – представляет значение или выражение, связанное с первой частью проверки данных.
- formula2 – представляет значение или выражение, связанное со второй частью проверки данных.
Когда свойства объекта Validation были настроены, разработчики могут использовать структуру CellArea, чтобы хранить информацию о диапазоне ячеек, который будет проверен с использованием созданной проверки.
Типы проверки данных
Перечисление ValidationType имеет следующие члены:
| Название элемента | Описание |
|---|---|
| ANY_VALUE | Обозначает значение любого типа. |
| WHOLE_NUMBER | Обозначает тип проверки для целых чисел. |
| DECIMAL | Обозначает тип проверки для десятичных чисел. |
| LIST | Обозначает тип проверки для выпадающего списка. |
| DATE | Обозначает тип проверки для дат. |
| TIME | Обозначает тип проверки для времени. |
| TEXT_LENGTH | Обозначает тип проверки для длины текста. |
| ПОЛЬЗОВАТЕЛЬСКИЙ | Обозначает тип пользовательской проверки. |
Проверка данных на целые числа
С этим типом проверки пользователи могут вводить только целые числа в указанном диапазоне в проверяемые ячейки. Приведены примеры кода, показывающие, как реализовать тип проверки на целые числа. В примере создается такая же проверка данных, используя Aspose.Cells для Python via .NET, которую мы создали с помощью Microsoft Excel выше.
Проверка данных на список
Этот тип проверки позволяет пользователю вводить значения из выпадающего списка. Он предоставляет список: серию строк, содержащих данные. В примере во втором рабочем листе добавляется список источников. Пользователи могут выбирать значения только из списка. Область проверки - это диапазон ячеек A1:A5 на первом рабочем листе.
Здесь важно установить свойство Validation.in_cell_drop_down на true.
Проверка данных на дату
С этим типом проверки пользователи вводят значения дат в указанном диапазоне или отвечающие определенным критериям в проверяемые ячейки. В примере пользователь ограничен вводом дат с 1970 по 1999 год. Здесь область проверки – ячейка B1.
Проверка данных на время
С этим типом проверки пользователи могут вводить время в указанном диапазоне, или соответствующее некоторым критериям, в проверяемые ячейки. В примере пользователь ограничен вводом времени с 09:00 по 11:30 утра. Здесь область проверки – ячейка B1.
Проверка данных на длину текста
С помощью этого типа проверки пользователи могут вводить текстовые значения заданной длины в проверяемые ячейки. В примере пользователь ограничен вводом строковых значений не более 5 символов. Область проверки - это ячейка B1.
Правила проверки данных
При реализации проверки данных можно проверить проверку, присвоив разные значения в ячейки. Cell.get_validation_value() можно использовать для получения результатов проверки. В следующем примере демонстрируется это функция с разными значениями. Образец файла можно загрузить по следующей ссылке для тестирования:
sampleDataValidationRules.xlsx
Проверить, если проверка в ячейке выпадающая
Как мы видели, существует множество типов проверок, которые могут быть реализованы в ячейке. Если вы хотите проверить, является ли проверка выпадающей или нет, свойство Validation.in_cell_drop_down можно использовать для этого теста. В следующем примере кода демонстрируется использование этого свойства. Образец файла для тестирования можно загрузить по следующей ссылке:
Добавить CellArea к существующей Validation
Может возникнуть случаи, когда вы хотите добавить CellArea к существующему Validation. Когда вы добавляете CellArea при помощи Validation.add_area(cell_area), Aspose.Cells проверяет все существующие области, чтобы увидеть, существует ли новая область уже. Если в файле большое количество проверок, это замедляет работу. Для преодоления этого API предоставляет метод Validation.add_area(cell_area, check_intersection, check_edge). Параметр checkIntersection указывает, следует ли проверять пересечение данной области с существующими областями проверок. Установка его в false отключит проверку других областей. Параметр checkEdge указывает, следует ли проверять примененные области. Если новая область становится верхним левым углом, внутренние настройки перестраиваются. Если вы уверены, что новая область не является верхним левым углом, вы можете установить этот параметр в false.
Следующий фрагмент кода демонстрирует использование метода Validation.add_area(cell_area, check_intersection, check_edge) для добавления нового CellArea к существующему Validation.
Исходный и выходной файлы Excel прикреплены для справки.