Veri Doğrulama
Veri Doğrulama Türleri ve Uygulama
Veri doğrulama, çalışsayadaki girilen verilere ilişkin kuralların ayarlanabilme yeteneğidir. Örneğin, bir sütunun TARIH olarak etiketlendiğinden emin olmak için doğrulamayı kullanın ve yalnızca tarihlerin bulunduğu veya başka bir sütunda yalnızca sayıların bulunduğundan emin olun. Aynı zamanda BELİRLİ bir tarih aralığında yalnızca tarihlerin bulunduğundan emin olabilirsiniz. Veri doğrulama ile çalışarak, çalışsayadaki hücrelere neyin girileceğini kontrol edebilirsiniz.
Microsoft Excel, çeşitli farklı veri doğrulama türlerini desteklemektedir. Her tür, bir hücre veya hücre aralığına hangi veri türünün girileceğini kontrol etmek için kullanılır. Aşağıda, aşağıdaki durumların doğrulanma şeklini gösteren kod örnekleri bulunmaktadır:
- Sayıların tam olduğunu, yani onların ondalık kısmının olmadığını doğrulama.
- Ondalık sayıların doğru yapısı takip edildiğini doğrulama. Kod örneği, bir hücre aralığının iki ondalık alanı olması gerektiğini tanımlar.
- Değerlerin belirli bir değer listesine sınırlı olduğunu doğrulama. Liste doğrulama, bir hücre veya hücre aralığına uygulanabilen ayrı bir değer listesi tanımlar.
- Tarihlerin belirli bir aralıkta olmasını sağlama.
- Zamanın belirli bir aralıkta olup olmadığını kontrol etme.
- Bir metnin belirli bir karakter uzunluğunda olup olmadığını kontrol etme.
Microsoft Excel ile Veri Doğrulama
Microsoft Excel kullanarak doğrulamalar oluşturmak için:
- Bir çalışsayfada, doğrulama uygulamak istediğiniz hücreleri seçin.
- Data menüsünden Doğrulama seçeneğini seçin. Doğrulama iletişim kutusu görüntülenecektir.
- Ayarlar sekmesine tıklayın ve ayarları girin.
Python Excel Kütüphanesi Aspose.Cells ile Veri Doğrulaması
Veri doğrulaması, çalışma tablolarına girilen bilgileri doğrulamak için güçlü bir özelliktir. Veri doğrulaması ile geliştiriciler, kullanıcılara bir liste seçeneği sunabilir, veri girişlerini belirli bir tür veya boyuta sınırlayabilir, vb. Python via .NET için Aspose.Cells’te her Worksheet sınıfının bir validations özelliği vardır, bu özellik bir Validation nesneler koleksiyonunu temsil eder. Doğrulama ayarlamak için şu şekilde bazı Validation sınıfın özelliklerini ayarlayın:
- tip - doğrulama tipini temsil eder, bu, ValidationType numaralandırmasındaki önceden tanımlanmış değerlerden birini kullanarak belirtilebilir.
- Operatör - doğrulamada kullanılacak operatörü temsil eder, bu, OperatorType numaralandırmasındaki önceden tanımlanmış değerlerden birini kullanarak belirtilebilir.
- formül1 - veri doğrulamasının ilk kısmı ile ilişkilendirilen değeri veya ifadeyi temsil eder.
- formül2 - veri doğrulamasının ikinci kısmı ile ilişkilendirilen değeri veya ifadeyi temsil eder.
Validation nesnesinin özellikleri yapılandırıldığında, geliştiriciler oluşturulan doğrulamayı kullanarak doğrulanacak hücre aralığı hakkında bilgileri depolamak için CellArea yapısını kullanabilir.
Veri Doğrulama Türleri
ValidationType numaralandırmasının aşağıdaki üyeleri bulunmaktadır:
Üye Adı | Açıklama |
---|---|
ANY_VALUE | Herhangi bir türden bir değeri belirtir. |
WHOLE_NUMBER | Tamsayılar için doğrulama tipini belirtir. |
ONDALIK | Ondalık sayılar için doğrulama tipini belirtir. |
LİSTE | Açılır kutu listesi için doğrulama tipini belirtir. |
DATE | Tarihler için doğrulama tipini belirtir. |
ZAMAN | Zaman için doğrulama tipini belirtir. |
TEXT_LENGTH | Metnin uzunluğu için doğrulama tipini belirtir. |
ÖZEL | Özel doğrulama tipini belirtir. |
Tamsayı Veri Doğrulaması
Bu tür doğrulama ile, kullanıcılar belirli bir aralık içinde yalnızca tamsayılar girebilir. Aşağıdaki kod örnekleri, Tamsayı doğrulama tipini uygulamanın nasıl yapıldığını göstermektedir. Örnek, Microsoft Excel üzerinde oluşturduğumuz aynı veri doğrulamasını Aspose.Cells for Python via .NET kullanarak oluşturur.
from aspose.cells import CellArea, OperatorType, ValidationType, Workbook | |
# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET | |
# Create a workbook object. | |
workbook = Workbook() | |
# Create a worksheet and get the first worksheet. | |
ExcelWorkSheet = workbook.worksheets[0] | |
# Accessing the Validations collection of the worksheet | |
validations = workbook.worksheets[0].validations | |
# Create Cell Area | |
ca = CellArea() | |
ca.start_row = 0 | |
ca.end_row = 0 | |
ca.start_column = 0 | |
ca.end_column = 0 | |
# Creating a Validation object | |
validation = validations[validations.add(ca)] | |
# Setting the validation type to whole number | |
validation.type = ValidationType.WHOLE_NUMBER | |
# Setting the operator for validation to Between | |
validation.operator = OperatorType.BETWEEN | |
# Setting the minimum value for the validation | |
validation.formula1 = "10" | |
# Setting the maximum value for the validation | |
validation.formula2 = "1000" | |
# Applying the validation to a range of cells from A1 to B2 using the | |
# CellArea structure | |
area = CellArea() | |
area.start_row = 0 | |
area.end_row = 1 | |
area.start_column = 0 | |
area.end_column = 1 | |
# Adding the cell area to Validation | |
validation.add_area(area) | |
# Save the workbook. | |
workbook.save("output.out.xls") |
Liste Veri Doğrulaması
Bu tür doğrulama, kullanıcının bir açılır kutu listesinden değerler girmesine izin verir. Bu, veri içeren bir dizi satırın bir listesini sağlar. Örnekte, listedeki kaynağı tutmak için ikinci bir çalışma tablosu eklenir. Kullanıcılar yalnızca listeden değer seçebilir. Doğrulama alanı, birinci çalışma tablosundaki A1:A5 hücre aralığıdır.
Burada önemli olan nokta, Validation.in_cell_drop_down özelliğini true olarak ayarlamanızdır.
from aspose.cells import CellArea, OperatorType, ValidationAlertType, ValidationType, Workbook | |
# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET | |
# Create a workbook object. | |
workbook = Workbook() | |
# Get the first worksheet. | |
worksheet1 = workbook.worksheets[0] | |
# Add a new worksheet and access it. | |
i = workbook.worksheets.add() | |
worksheet2 = workbook.worksheets[i] | |
# Create a range in the second worksheet. | |
range = worksheet2.cells.create_range("E1", "E4") | |
# Name the range. | |
range.name = "MyRange" | |
# Fill different cells with data in the range. | |
worksheet2.cells.get("E1").value = "Blue" | |
worksheet2.cells.get("E2").value = "Red" | |
worksheet2.cells.get("E3").value = "Green" | |
worksheet2.cells.get("E4").value = "Yellow" | |
# Get the validations collection. | |
validations = worksheet1.validations | |
# Create Cell Area | |
ca = CellArea() | |
ca.start_row = 0 | |
ca.end_row = 0 | |
ca.start_column = 0 | |
ca.end_column = 0 | |
# Create a new validation to the validations list. | |
validation = validations[validations.add(ca)] | |
# Set the validation type. | |
validation.type = ValidationType.LIST | |
# Set the operator. | |
validation.operator = OperatorType.NONE | |
# Set the in cell drop down. | |
validation.in_cell_drop_down = True | |
# Set the formula1. | |
validation.formula1 = "=MyRange" | |
# Enable it to show error. | |
validation.show_error = True | |
# Set the alert type severity level. | |
validation.alert_style = ValidationAlertType.STOP | |
# Set the error title. | |
validation.error_title = "Error" | |
# Set the error message. | |
validation.error_message = "Please select a color from the list" | |
# Specify the validation area. | |
area = CellArea() | |
area.start_row = 0 | |
area.end_row = 4 | |
area.start_column = 0 | |
area.end_column = 0 | |
# Add the validation area. | |
validation.add_area(area) | |
# Save the Excel file. | |
workbook.save("output.out.xls") |
Tarih Veri Doğrulaması
Bu tür doğrulama ile, kullanıcılar belirli bir aralıkta veya belirli kriterlere uyan tarih değerlerini doğrulanmış hücrelere girerler. Örnekte, kullanıcının 1970 ila 1999 arasında tarih girmesi kısıtlanmıştır. Burada doğrulama alanı B1 hücresidir.
from aspose.cells import CellArea, OperatorType, ValidationAlertType, ValidationType, Workbook | |
# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET | |
# Create a workbook. | |
workbook = Workbook() | |
# Obtain the cells of the first worksheet. | |
cells = workbook.worksheets[0].cells | |
# Put a string value into the A1 cell. | |
cells.get("A1").put_value("Please enter Date b/w 1/1/1970 and 12/31/1999") | |
# Set row height and column width for the cells. | |
cells.set_row_height(0, float(31)) | |
cells.set_column_width(0, float(35)) | |
# Get the validations collection. | |
validations = workbook.worksheets[0].validations | |
# Create Cell Area | |
ca = CellArea() | |
ca.start_row = 0 | |
ca.end_row = 0 | |
ca.start_column = 0 | |
ca.end_column = 0 | |
# Add a new validation. | |
validation = validations[validations.add(ca)] | |
# Set the data validation type. | |
validation.type = ValidationType.DATE | |
# Set the operator for the data validation | |
validation.operator = OperatorType.BETWEEN | |
# Set the value or expression associated with the data validation. | |
validation.formula1 = "1/1/1970" | |
# The value or expression associated with the second part of the data validation. | |
validation.formula2 = "12/31/1999" | |
# Enable the error. | |
validation.show_error = True | |
# Set the validation alert style. | |
validation.alert_style = ValidationAlertType.STOP | |
# Set the title of the data-validation error dialog box | |
validation.error_title = "Date Error" | |
# Set the data validation error message. | |
validation.error_message = "Enter a Valid Date" | |
# Set and enable the data validation input message. | |
validation.input_message = "Date Validation Type" | |
validation.ignore_blank = True | |
validation.show_input = True | |
# Set a collection of CellArea which contains the data validation settings. | |
cellArea = CellArea() | |
cellArea.start_row = 0 | |
cellArea.end_row = 0 | |
cellArea.start_column = 1 | |
cellArea.end_column = 1 | |
# Add the validation area. | |
validation.add_area(cellArea) | |
# Save the Excel file. | |
workbook.save("output.out.xls") |
Zaman Veri Doğrulaması
Bu tür doğrulama ile, kullanıcılar belirli bir aralıkta veya belirli kriterlere uyan saatleri doğrulanmış hücrelere girebilirler. Örnekte, kullanıcının 09:00 ile 11:30 arasında zaman girmesi kısıtlanmıştır. Burada doğrulama alanı B1 hücresidir.
from aspose.cells import CellArea, OperatorType, ValidationAlertType, ValidationType, Workbook | |
# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET | |
# Create a workbook. | |
workbook = Workbook() | |
# Obtain the cells of the first worksheet. | |
cells = workbook.worksheets[0].cells | |
# Put a string value into A1 cell. | |
cells.get("A1").put_value("Please enter Time b/w 09:00 and 11:30 'o Clock") | |
# Set the row height and column width for the cells. | |
cells.set_row_height(0, float(31)) | |
cells.set_column_width(0, float(35)) | |
# Get the validations collection. | |
validations = workbook.worksheets[0].validations | |
# Create Cell Area | |
ca = CellArea() | |
ca.start_row = 0 | |
ca.end_row = 0 | |
ca.start_column = 0 | |
ca.end_column = 0 | |
# Add a new validation. | |
validation = validations[validations.add(ca)] | |
# Set the data validation type. | |
validation.type = ValidationType.TIME | |
# Set the operator for the data validation. | |
validation.operator = OperatorType.BETWEEN | |
# Set the value or expression associated with the data validation. | |
validation.formula1 = "09:00" | |
# The value or expression associated with the second part of the data validation. | |
validation.formula2 = "11:30" | |
# Enable the error. | |
validation.show_error = True | |
# Set the validation alert style. | |
validation.alert_style = ValidationAlertType.INFORMATION | |
# Set the title of the data-validation error dialog box. | |
validation.error_title = "Time Error" | |
# Set the data validation error message. | |
validation.error_message = "Enter a Valid Time" | |
# Set and enable the data validation input message. | |
validation.input_message = "Time Validation Type" | |
validation.ignore_blank = True | |
validation.show_input = True | |
# Set a collection of CellArea which contains the data validation settings. | |
cellArea = CellArea() | |
cellArea.start_row = 0 | |
cellArea.end_row = 0 | |
cellArea.start_column = 1 | |
cellArea.end_column = 1 | |
# Add the validation area. | |
validation.add_area(cellArea) | |
# Save the Excel file. | |
workbook.save("output.out.xls") |
Metin Uzunluğu Veri Doğrulaması
Bu tür doğrulama ile kullanıcılar, doğrulanan hücrelere belirli bir uzunluktaki metin değerlerini girebilirler. Örnekte, kullanıcıya en fazla 5 karakter içeren dize değerlerini girmesi engellenir. Doğrulama alanı B1 hücresidir.
from aspose.cells import CellArea, OperatorType, ValidationAlertType, ValidationType, Workbook | |
# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET | |
# Create a new workbook. | |
workbook = Workbook() | |
# Obtain the cells of the first worksheet. | |
cells = workbook.worksheets[0].cells | |
# Put a string value into A1 cell. | |
cells.get("A1").put_value("Please enter a string not more than 5 chars") | |
# Set row height and column width for the cell. | |
cells.set_row_height(0, float(31)) | |
cells.set_column_width(0, float(35)) | |
# Get the validations collection. | |
validations = workbook.worksheets[0].validations | |
# Create Cell Area | |
ca = CellArea() | |
ca.start_row = 0 | |
ca.end_row = 0 | |
ca.start_column = 0 | |
ca.end_column = 0 | |
# Add a new validation. | |
validation = validations[validations.add(ca)] | |
# Set the data validation type. | |
validation.type = ValidationType.TEXT_LENGTH | |
# Set the operator for the data validation. | |
validation.operator = OperatorType.LESS_OR_EQUAL | |
# Set the value or expression associated with the data validation. | |
validation.formula1 = "5" | |
# Enable the error. | |
validation.show_error = True | |
# Set the validation alert style. | |
validation.alert_style = ValidationAlertType.WARNING | |
# Set the title of the data-validation error dialog box. | |
validation.error_title = "Text Length Error" | |
# Set the data validation error message. | |
validation.error_message = " Enter a Valid String" | |
# Set and enable the data validation input message. | |
validation.input_message = "TextLength Validation Type" | |
validation.ignore_blank = True | |
validation.show_input = True | |
# Set a collection of CellArea which contains the data validation settings. | |
cellArea = CellArea() | |
cellArea.start_row = 0 | |
cellArea.end_row = 0 | |
cellArea.start_column = 1 | |
cellArea.end_column = 1 | |
# Add the validation area. | |
validation.add_area(cellArea) | |
# Save the Excel file. | |
workbook.save("output.out.xls") |
Veri Doğrulama Kuralları
Veri doğrulamaları uygulandığında, doğrulamanın farklı değerlerle kontrol edilebilir olması sağlanır. Cell.get_validation_value() doğrulama sonucunu almak için kullanılabilir. Aşağıdaki örnek, farklı değerlerle bu özelliği göstermektedir. Test için örnek dosyayı aşağıdaki bağlantıdan indirebilirsiniz:
sampleDataValidationRules.xlsx
from aspose.cells import Workbook | |
# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET | |
# Instantiate the workbook from sample Excel file | |
workbook = Workbook("sample.xlsx") | |
# Access the first worksheet | |
worksheet = workbook.worksheets[0] | |
# Access Cell C1 | |
# Cell C1 has the Decimal Validation applied on it. | |
# It can take only the values Between 10 and 20 | |
cell = worksheet.cells.get("C1") | |
# Enter 3 inside this cell | |
# Since it is not between 10 and 20, it should fail the validation | |
cell.put_value(3) | |
# Check if number 3 satisfies the Data Validation rule applied on this cell | |
print("Is 3 a Valid Value for this Cell: " + str(cell.get_validation_value())) | |
# Enter 15 inside this cell | |
# Since it is between 10 and 20, it should succeed the validation | |
cell.put_value(15) | |
# Check if number 15 satisfies the Data Validation rule applied on this cell | |
print("Is 15 a Valid Value for this Cell: " + str(cell.get_validation_value())) | |
# Enter 30 inside this cell | |
# Since it is not between 10 and 20, it should fail the validation again | |
cell.put_value(30) | |
# Check if number 30 satisfies the Data Validation rule applied on this cell | |
print("Is 30 a Valid Value for this Cell: " + str(cell.get_validation_value())) |
Hücrede doğrulamanın açılır menü olup olmadığını kontrol et
Gördüğümüz gibi bir hücre içinde uygulanabilecek birçok doğrulama türü bulunmaktadır. Doğrulamanın açılır menü olup olmadığını kontrol etmek istiyorsanız, Validation.in_cell_drop_down özelliği bunu test etmek için kullanılabilir. Aşağıdaki örnek kod, bu özelliğin kullanımını göstermektedir. Test için örnek bir dosyayı aşağıdaki bağlantıdan indirebilirsiniz:
from aspose.cells import Workbook | |
# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET | |
book = Workbook("sampleValidation.xlsx") | |
sheet = book.worksheets.get("Sheet1") | |
cells = sheet.cells | |
a2 = cells.get("A2") | |
va2 = a2.get_validation() | |
if va2.in_cell_drop_down: | |
print("A2 is a dropdown") | |
else: | |
print("A2 is NOT a dropdown") | |
b2 = cells.get("B2") | |
vb2 = b2.get_validation() | |
if vb2.in_cell_drop_down: | |
print("B2 is a dropdown") | |
else: | |
print("B2 is NOT a dropdown") | |
c2 = cells.get("C2") | |
vc2 = c2.get_validation() | |
if vc2.in_cell_drop_down: | |
print("C2 is a dropdown") | |
else: | |
print("C2 is NOT a dropdown") |
Mevcut Doğrulama Alanına Hücre Alanı Ekle
Mevcut Validation‘e CellArea eklemek isteyebileceğiniz durumlar olabilir. Yeni alanı eklerken Validation.add_area(cell_area) kullanarak CellArea eklerseniz, Aspose.Cells, yeni alanın zaten var olup olmadığını kontrol etmek için tüm mevcut alanları kontrol eder. Dosyada çok sayıda doğrulama varsa, bu performansı olumsuz etkiler. Bunu aşmak için API, Validation.add_area(cell_area, check_intersection, check_edge) yöntemini sağlar. checkIntersection parametresi, verilen alanın mevcut doğrulama alanlarıyla kesişimini kontrol edip etmeyeceğini belirtir. false ayarlamak diğer alanların kontrolünü devre dışı bırakır. checkEdge parametresi, uygulanan alanların kontrol edilip edilmeyeceğini belirtir. Yeni alanın sol üst alan olması durumunda iç ayarlar yeniden oluşturulur. Yeni alanın sol üst alan olmadığından eminseniz, bu parametreyi false olarak ayarlayabilirsiniz.
Aşağıdaki kod örneği, mevcut Validation‘e yeni CellArea eklemek için Validation.add_area(cell_area, check_intersection, check_edge) yönteminin kullanımını göstermektedir.
from aspose.cells import CellArea, Workbook | |
# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET | |
workbook = Workbook("ValidationsSample.xlsx") | |
# Access first worksheet. | |
worksheet = workbook.worksheets[0] | |
# Accessing the Validations collection of the worksheet | |
validation = worksheet.validations[0] | |
# Create your cell area. | |
cellArea = CellArea.create_cell_area("D5", "E7") | |
# Adding the cell area to Validation | |
validation.add_area(cellArea, False, False) | |
# Save the output workbook. | |
workbook.save("ValidationsSample_out.xlsx") |
Kaynak ve çıktı excel dosyaları referans için ekte sunulmuştur.