Veri Doğrulama

Microsoft Excel, elektronik tablo verilerini otomatik filtreleme veya doğrulama konularında bazı iyi özellikler sunar.

Veri doğrulama, çalışma sayfasına girilen verilere ilişkin kurallar belirleme yeteneğidir.

Veri Doğrulama Türleri ve Uygulama

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 ondalık kısmın olmadığını doğrulayın.
• Ondalık sayıların doğru yapısını takip ettiğini doğrulayın. Kod örneği, belirli bir aralıkta hücrelerin iki ondalık basamağa sahip olması gerektiğini tanımlar.
• Değerlerin belirli bir değerler listesine sınırlı olduğunu doğrulayın.
• Tarihlerin belirli bir aralıkta olmasını doğrulayın.
• Zamanın belirli bir aralıkta olduğunu doğrulayın.
• Bir metnin belirli bir karakter uzunluğunda olduğunu doğrulayın.

Microsoft Excel ile Veri Doğrulama

Microsoft Excel kullanarak doğrulamalar oluşturmak için:

1. Bir çalışsayfada, doğrulama uygulamak istediğiniz hücreleri seçin.

2. Veri menüsünden, Doğrulama‘yı seçin. Doğrulama iletişim kutusu görüntülenir.

3. Ayarlar sekmesini tıklayın ve aşağıda gösterildiği gibi ayarları girin. 

   Veri doğrulama ayarları

Aspose.Cells ile Veri Doğrulama

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. Aspose.Cells’de her Worksheet sınıfı, bir Validations öğesine sahiptir, bu da bir Validation nesneler koleksiyonunu temsil eder. Doğrulama ayarını yapmak için Validation nesnesinin bazı özelliklerini ayarlayın:

• Type: Doğrulama türünü temsil eder, bu da ValidationType numaralandırmasındaki önceden tanımlanmış değerlerden biri kullanılarak belirtilebilir.
• Operator: doğrulamada kullanılacak olan operatörü temsil eder. Bu, önceden tanımlanmış değerlerden birini kullanarak OperatorType numaralandırmasında belirtilebilir.
• Formula1: veri doğrulamanın ilk kısmıyla ilişkili değeri veya ifadeyi temsil eder.
• Formula2: veri doğrulamanın ikinci kısmıyla ilişkili 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 bilgi depolamak için CellArea yapısını kullanabilirler.

Veri Doğrulama Türleri

Veri doğrulama, her hücreye işletme kurallarını yerleştirmenize olanak tanır, böylece yanlış girişler hata mesajlarına neden olur. İş kuralları, bir işletmenin nasıl çalıştığını belirleyen politika ve prosedürlerdir. Aspose.Cells, tüm önemli veri doğrulama türlerini destekler.

ValidationType numaralandırmasının aşağıdaki üyeleri bulunmaktadır:

Üye Adı	Açıklama
ANY_VALUE	Her türden bir değeri belirtir.
WHOLE_NUMBER	Tüm sayılar için doğrulama tipini belirtir.
DECIMAL	Ondalık sayılar için doğrulama türünü belirtir.
LIST	Açılır liste için doğrulama türünü belirtir.
DATE	Tarihler için doğrulama türünü belirtir.
TIME	Saatler için doğrulama türünü belirtir.
TEXT_LENGTH	Metnin uzunluğu için doğrulama tipini belirtir.
CUSTOM	Özel doğrulama türünü belirtir.

Programlama Örneği: Tamsayı Veri Doğrulaması

Bu doğrulama türüyle, kullanıcılar belirli bir aralıkta sadece tam sayıları geçerli hücrelere girebilir. Aşağıdaki kod örnekleri, WHOLE_NUMBER doğrulama türünün nasıl uygulanacağını gösterir. Örnek, Microsoft Excel kullanılarak oluşturan aynı veri doğrulamasını Aspose.Cells kullanarak oluşturur.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(WholeNumberDataValidation.class) + "data/";

// Instantiating an Workbook object
Workbook workbook = new Workbook();
WorksheetCollection worksheets = workbook.getWorksheets();

// Accessing the Validations collection of the worksheet
Worksheet worksheet = worksheets.get(0);

// Applying the validation to a range of cells from A1 to B2 using the
// CellArea structure
CellArea area = new CellArea();
area.StartRow = 0;
area.StartColumn = 0;
area.EndRow = 1;
area.EndColumn = 1;

ValidationCollection validations = worksheet.getValidations();

// Creating a Validation object
int index = validations.add(area);
Validation validation = validations.get(index);

// Setting the validation type to whole number
validation.setType(ValidationType.WHOLE_NUMBER);

// Setting the operator for validation to Between
validation.setOperator(OperatorType.BETWEEN);

// Setting the minimum value for the validation
validation.setFormula1("10");

// Setting the maximum value for the validation
validation.setFormula2("1000");

// Saving the Excel file
workbook.save(dataDir + "WNDValidation_out.xls");

// Print message
System.out.println("Process completed successfully");

Programlama Örneği: Ondalık Sayı Veri Doğrulaması

Bu tür doğrulama ile kullanıcı, ondalık sayıları doğrulanmış hücrelere girebilir. Örnekte, kullanıcı yalnızca ondalık değer girmesi için kısıtlanmıştır ve doğrulama alanı A1:A10’dur.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(DecimalDataValidation.class) + "data/";

// Create a workbook object.
Workbook workbook = new Workbook();

// Create a worksheet and get the first worksheet.
Worksheet ExcelWorkSheet = workbook.getWorksheets().get(0);

// Specify the validation area of cells.
CellArea area = new CellArea();
area.StartRow = 0;
area.StartColumn = 0;
area.EndRow = 9;
area.EndColumn = 0;

// Obtain the existing Validations collection.
ValidationCollection validations = ExcelWorkSheet.getValidations();

// Create a validation object adding to the collection list.
int index = validations.add(area);
Validation validation = validations.get(index);

// Set the validation type.
validation.setType(ValidationType.DECIMAL);

// Specify the operator.
validation.setOperator(OperatorType.BETWEEN);

// Set the lower and upper limits.
validation.setFormula1("10");
validation.setFormula2("1000");

// Set the error message.
validation.setErrorMessage("Please enter a valid integer or decimal number");

// Save the workbook.
workbook.save(dataDir + "DDValidation_out.xls");

// Print message
System.out.println("Process completed successfully");

Programlama Örneği: Liste Veri Doğrulaması

Bu tür doğrulama, kullanıcının bir açılır listeden değer girmesine olanak tanır. Bir liste sağlar: veri içeren bir dizi satır. Kullanıcılar yalnızca listeden değer seçebilir. İlk çalışma sayfasındaki doğrulama alanı A1:A5 hücre aralığıdır.

Burada önemli olan nokta, Validation.setInCellDropDown özelliğini true olarak ayarlamanızdır.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(ListDataValidation.class) + "data/";

// Create a workbook object.
Workbook workbook = new Workbook();

// Get the first worksheet.
Worksheet ExcelWorkSheet = workbook.getWorksheets().get(0);

// Add a new worksheet and access it.
int sheetIndex = workbook.getWorksheets().add();
Worksheet worksheet2 = workbook.getWorksheets().get(sheetIndex);

// Create a range with name in the second worksheet.
Range range = worksheet2.getCells().createRange(0, 4, 4, 4);
range.setName("MyRange");

// Fill different cells with data in the range.
range.get(0, 0).setValue("Blue");
range.get(1, 0).setValue("Red");
range.get(2, 0).setValue("Green");
range.get(3, 0).setValue("Yellow");

// Specify the validation area of cells.
CellArea area = new CellArea();
area.StartRow = 0;
area.StartColumn = 0;
area.EndRow = 4;
area.EndColumn = 0;

// Obtain the existing Validations collection.
ValidationCollection validations = ExcelWorkSheet.getValidations();

// Create a validation object adding to the collection list.
int index = validations.add(area);
Validation validation = validations.get(index);

// Set the validation type.
validation.setType(ValidationType.LIST);

// Set the in cell drop down.
validation.setInCellDropDown(true);

// Set the formula1.
validation.setFormula1("=MyRange");

// Enable it to show error.
validation.setShowError(true);

// Set the alert type severity level.
validation.setAlertStyle(ValidationAlertType.STOP);

// Set the error title.
validation.setErrorTitle("Error");

// Set the error message.
validation.setErrorMessage("Please select a color from the list");

// Save the excel file.
workbook.save(dataDir + "LDValidation_out.xls");

// Print message
System.out.println("Process completed successfully");

Programlama Örneği: 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.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(DateDataValidation.class) + "data/";

// Create a workbook.
Workbook workbook = new Workbook();

// Obtain the cells of the first worksheet.
Cells cells = workbook.getWorksheets().get(0).getCells();

// Put a string value into the A1 cell.
cells.get("A1").setValue("Please enter Date b/w 1/1/1970 and 12/31/1999");

// Wrap the text.
Style style = cells.get("A1").getStyle();
style.setTextWrapped(true);
cells.get("A1").setStyle(style);

// Set row height and column width for the cells.
cells.setRowHeight(0, 31);
cells.setColumnWidth(0, 35);

// Set a collection of CellArea which contains the data validation
// settings.
CellArea area = new CellArea();

area.StartRow = 0;
area.StartColumn = 1;
area.EndRow = 0;
area.EndColumn = 1;

// Get the validations collection.
ValidationCollection validations = workbook.getWorksheets().get(0).getValidations();

// Add a new validation.
int i = validations.add(area);
Validation validation = validations.get(i);

// Set the data validation type.
validation.setType(ValidationType.DATE);

// Set the operator for the data validation
validation.setOperator(OperatorType.BETWEEN);

// Set the value or expression associated with the data validation.
validation.setFormula1("1/1/1970");

// The value or expression associated with the second part of the data
// validation.
validation.setFormula2("12/31/1999");

// Enable the error.
validation.setShowError(true);

// Set the validation alert style.
validation.setAlertStyle(ValidationAlertType.STOP);

// Set the title of the data-validation error dialog box
validation.setErrorTitle("Date Error");

// Set the data validation error message.
validation.setErrorMessage("Enter a Valid Date");

// Set and enable the data validation input message.
validation.setInputMessage("Date Validation Type");
validation.setIgnoreBlank(true);
validation.setShowInput(true);

// Save the excel file.
workbook.save(dataDir + "DDValidation_out.xls", FileFormatType.EXCEL_97_TO_2003);

// Print message
System.out.println("Process completed successfully");

Programlama Örnekleri: 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.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(TimeDataValidation.class) + "data/";

// Create a workbook.
Workbook workbook = new Workbook();

// Obtain the cells of the first worksheet.
Cells cells = workbook.getWorksheets().get(0).getCells();

// Put a string value into A1 cell.
cells.get("A1").setValue("Please enter Time b/w 09:00 and 11:30 'o Clock");

// Wrap the text.
Style style = cells.get("A1").getStyle();
style.setTextWrapped(true);
cells.get("A1").setStyle(style);

// Set row height and column width for the cells.
cells.setRowHeight(0, 31);
cells.setColumnWidth(0, 35);

// Set a collection of CellArea which contains the data validation
// settings.
CellArea area = new CellArea();

area.StartRow = 0;
area.StartColumn = 1;
area.EndRow = 0;
area.EndColumn = 1;

// Get the validations collection.
ValidationCollection validations = workbook.getWorksheets().get(0).getValidations();

// Add a new validation.
int i = validations.add(area);
Validation validation = validations.get(i);

// Set the data validation type.
validation.setType(ValidationType.TIME);

// Set the operator for the data validation
validation.setOperator(OperatorType.BETWEEN);

// Set the value or expression associated with the data validation.
validation.setFormula1("09:00");

// The value or expression associated with the second part of the data
// validation.
validation.setFormula2("11:30");

// Enable the error.
validation.setShowError(true);

// Set the validation alert style.
validation.setAlertStyle(ValidationAlertType.INFORMATION);

// Set the title of the data-validation error dialog box.
validation.setErrorTitle("Time Error");

// Set the data validation error message.
validation.setErrorMessage("Enter a Valid Time");

// Set and enable the data validation input message.
validation.setInputMessage("Time Validation Type");
validation.setIgnoreBlank(true);
validation.setShowInput(true);

// Save the excel file.
workbook.save(dataDir + "TDValidation_out.xls", FileFormatType.EXCEL_97_TO_2003);

// Print message
System.out.println("Process completed successfully");

Programlama Örnekleri: 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.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(TextLengthDataValidation.class) + "data/";

// Create a new workbook.
Workbook workbook = new Workbook();

// Obtain the cells of the first worksheet.
Cells cells = workbook.getWorksheets().get(0).getCells();

// Put a string value into A1 cell.
cells.get("A1").setValue("Please enter a string not more than 5 chars");

// Wrap the text.
Style style = cells.get("A1").getStyle();
style.setTextWrapped(true);
cells.get("A1").setStyle(style);

// Set row height and column width for the cells.
cells.setRowHeight(0, 31);
cells.setColumnWidth(0, 35);

// Set a collection of CellArea which contains the data validation
// settings.
CellArea area = new CellArea();

area.StartRow = 0;
area.StartColumn = 1;
area.EndRow = 0;
area.EndColumn = 1;

// Get the validations collection.
ValidationCollection validations = workbook.getWorksheets().get(0).getValidations();

// Add a new validation.
int i = validations.add(area);
Validation validation = validations.get(i);

// Set the data validation type.
validation.setType(ValidationType.TEXT_LENGTH);

// Set the operator for the data validation.
validation.setOperator(OperatorType.LESS_OR_EQUAL);

// Set the value or expression associated with the data validation.
validation.setFormula1("5");

// Enable the error.
validation.setShowError(true);

// Set the validation alert style.
validation.setAlertStyle(ValidationAlertType.WARNING);

// Set the title of the data-validation error dialog box.
validation.setErrorTitle("Text Length Error");

// Set the data validation error message.
validation.setErrorMessage(" Enter a Valid String");

// Set and enable the data validation input message.
validation.setInputMessage("TextLength Validation Type");
validation.setIgnoreBlank(true);
validation.setShowInput(true);

// Save the excel file.
workbook.save(dataDir + "TLDValidation_out.xls", FileFormatType.EXCEL_97_TO_2003);

// Print message
System.out.println("Process completed successfully");

Veri Doğrulama Kuralları

Veri doğrulamaları uygulandığında, doğrulama sonucu farklı değerler atayarak kontrol edilebilir. Cell.GetValidationValue() kullanılarak doğrulama sonucu alınabilir. Aşağıdaki örnek, bu özelliği farklı değerlerle gösterir. Test amacıyla aşağıdaki bağlantıdan örnek dosya indirilebilir:

SampleDataValidationRules.xlsx

Örnek Kod

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// Instantiate the workbook from sample Excel file
Workbook workbook = new Workbook(srcDir + "sampleDataValidationRules.xlsx");

// Access the first worksheet
Worksheet worksheet = workbook.getWorksheets().get(0);

/*
 * Access Cell C1. Cell C1 has the Decimal Validation applied on it.It can take only the values Between 10 and 20
 */
Cell cell = worksheet.getCells().get("C1");

// Enter 3 inside this cell. Since it is not between 10 and 20, it should fail the validation
cell.putValue(3);

// Check if number 3 satisfies the Data Validation rule applied on this cell
System.out.println("Is 3 a Valid Value for this Cell: " + cell.getValidationValue());

// Enter 15 inside this cell. Since it is between 10 and 20, it should succeed the validation
cell.putValue(15);

// Check if number 15 satisfies the Data Validation rule applied on this cell
System.out.println("Is 15 a Valid Value for this Cell: " + cell.getValidationValue());

// Enter 30 inside this cell. Since it is not between 10 and 20, it should fail the validation again
cell.putValue(30);

// Check if number 30 satisfies the Data Validation rule applied on this cell
System.out.println("Is 30 a Valid Value for this Cell: " + cell.getValidationValue());

// Enter large number 12345678901 inside this cell
// Since it is not between 1 and 999999999999, it should pass the validation again
Cell cell2 = worksheet.getCells().get("D1");
cell2.putValue(12345678901l);

// Check if number 12345678901 satisfies the Data Validation rule applied on this cell
System.out.println("Is 12345678901 a Valid Value for this Cell: " + cell2.getValidationValue());

Bir hücredeki doğrulamanın açılır kutu olup olmadığını kontrol et

Gördüğümüz gibi hücre içinde uygulanabilir birçok doğrulama türü bulunmaktadır. Bir doğrulamanın açılır kutu olup olmadığını kontrol etmek istiyorsanız, Validation.InCellDropDown özelliği buna test etmek için kullanılabilir. Aşağıdaki örnek kod bu özelliğin kullanımını göstermektedir. Test için deneme dosyasını aşağıdaki bağlantıdan indirebilirsiniz:

sampleDataValidationRules.xlsx

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
Workbook book = new Workbook(srcDir + "sampleValidation.xlsx");
Worksheet sheet = book.getWorksheets().get("Sheet1");
Cells cells  = sheet.getCells();
Cell a2 = cells.get("A2");
Validation va2 = a2.getValidation();
if(va2.getInCellDropDown()) {
    System.out.println("A2 is a dropdown");
} else {
    System.out.println("A2 is NOT a dropdown");
}
Cell b2 = cells.get("B2");
Validation vb2 = b2.getValidation();
if(vb2.getInCellDropDown()) {
    System.out.println("B2 is a dropdown");
} else {
    System.out.println("B2 is NOT a dropdown");
}
Cell c2 = cells.get("C2");
Validation vc2 = c2.getValidation();
if(vc2.getInCellDropDown()) {
    System.out.println("C2 is a dropdown");
} else {
    System.out.println("C2 is NOT a dropdown");
}

Mevcut Doğrulama Alanına Hücre Alanı Ekle

Mevcut Validation öğesine CellArea eklemek isteyebileceğiniz durumlar olabilir. Bunun için, Validation.AddArea(CellArea) kullanılır. Aspose.Cells, yeni alanın zaten var olup olmadığını görmek için tüm mevcut alanları kontrol eder. Eğer dosyada çok sayıda doğrulama varsa, bu performans düşüşüne neden olabilir. Bunun önüne geçmek için API, Validation.AddAreaCellArea cellArea, bool checkIntersection, bool checkEdge) metodunu sağlar. checkIntersection parametresi, verilen alanın mevcut doğrulama alanlarıyla kesişip kesişmediğini kontrol edip etmeyeceğini gösterir. false olarak ayarlanması, diğer alanların kontrol edilmesini devre dışı bırakır. checkEdge parametresi, uygulanan alanların kontrol edilip edilmeyeceğini gösterir. Yeni alan üst-sol köşe alanı olursa, dahili ayarlar yeniden oluşturulur. Yeni alanın üst-sol köşe alanı olmayacağından emin değilseniz, bu parametreyi false olarak ayarlayabilirsiniz.

Aşağıdaki kod örneği, Validation.AddAreaCellArea cellArea, bool checkIntersection, bool checkEdge) metodunun, yeni CellArea eklemek için kullanılmasını göstermektedir.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the directories.
String sourceDir = Utils.Get_SourceDirectory();
String outputDir = Utils.Get_OutputDirectory();

Workbook workbook = new Workbook(sourceDir + "ValidationsSample.xlsx");

// Access first worksheet.
Worksheet worksheet = workbook.getWorksheets().get(0);

// Accessing the Validations collection of the worksheet
Validation validation = worksheet.getValidations().get(0);

// Create your cell area.
CellArea cellArea = CellArea.createCellArea("D5", "E7");

// Adding the cell area to Validation
validation.addArea(cellArea, false, false);

// Save the output workbook.
workbook.save(outputDir + "ValidationsSample_out.xlsx");

Kaynak ve çıktı excel dosyaları referans için ekte sunulmuştur.

Kaynak Dosyası

Çıktı Dosyası

Gelişmiş Konular

• ODS Dosyalarında Hücre Doğrulamasını Al
• Bir Hücreye Uygulanan Doğrulamayı Al
• Hücre Değerinin Veri Doğrulama Kurallarını Karşıladığını Doğrulama