Datavalidering

Microsoft Excel erbjuder bra funktioner för att automatiskt filtrera eller validera arbetsbladdata. Aspose.Cells stöder fullt ut Microsoft Excels data validerings- och autofilterfunktioner. Denna artikel förklarar hur man använder funktionerna i Microsoft Excel och hur man kodar dem med Aspose.Cells for Node.js via C++.

Datavalideringstyper och utförande

Datavalidering är förmågan att ställa regler om data som skrivs in på ett arbetsblad. Använd till exempel validering för att säkerställa att en kolumn märkt DATUM endast innehåller datum, eller att en annan kolumn endast innehåller siffror. Du skulle även kunna säkerställa att en kolumn märkt DATUM endast innehåller datum inom ett visst intervall. Med datavalidering kan du kontrollera vad som skrivs in i celler på arbetsbladet.

Microsoft Excel stöder ett antal olika typer av datavalidering. Varje typ används för att styra vilken typ av data som skrivs in i en cell eller cellområde. Nedan illustrerar kodsnuttar hur man validerar att:

• Siffror är hela, det vill säga att de inte har en decimaldel.
• Decimaltal följer rätt struktur. Kodexemplet definierar att en rad celler ska ha två decimaler.
• Värden är begränsade till en lista med värden. Listvalidering definierar en separat lista med värden som kan tillämpas på en cell eller cellområde.
• Datum ligger inom ett specifikt intervall.
• En tid ligger inom ett specifikt intervall.
• En text är inom en given teckenlängd.

Datavalidering med Microsoft Excel

För att skapa valideringar med Microsoft Excel:

1. I ett kalkylblad, välj de celler till vilka du vill applicera validering.
2. Från menyn Data, välj Validering. Valideringsdialogen visas.
3. Klicka på fliken Inställningar och ange inställningar.

Datavalidering med Aspose.Cells for Node.js via C++

Datavalidering är en kraftfull funktion för att validera information som matas in i kalkylblad. Med datavalidering kan utvecklare tillhandahålla användare med en lista över val, begränsa datamatare till en specifik typ eller storlek, osv.
I Aspose.Cells for Node.js via C++ har varje Worksheet klass en getValidations() metod som representerar en samling av Validation objekt. För att ställa in valideringen, ställ in några av egenskaperna hos klassen Validation enligt följande:

• Typ – representerar valideringstypen, som kan specificeras genom att använda ett av de fördefinierade värdena i enum ValidationType.
• Operator – representerar operatorn som ska användas i valideringen, som kan specificeras genom att använda ett av de fördefinierade värdena i enum OperatorType.
• Formel1 - representerar värdet eller uttrycket associerat med den första delen av datavalideringen.
• Formel2 - representerar värdet eller uttrycket associerat med den andra delen av datavalideringen.

När egenskaperna för Validation objektet har konfigurerats, kan utvecklare använda strukturen CellArea för att lagra information om cellområdet som ska valideras med hjälp av den skapade valideringen.

Typer av Datavalidering

Enum ValidationType har följande medlemmar:

Medlemsnamn	Beskrivning
AnyValue	Betecknar ett värde av valfri typ.
WholeNumber	Betecknar valideringstyp för heltal.
Decimal	Betecknar valideringstyp för decimaltal.
List	Betecknar valideringstyp för nedrullningslistan.
Date	Betecknar valideringstyp för datum.
Time	Betecknar valideringstyp för tid.
TextLength	Betecknar valideringstyp för längden av text.
Custom	Betecknar anpassad valideringstyp.

Heltalsdatavalidering

Med denna typ av validering kan användare bara ange heltal inom ett specificerat intervall i de validerade cellerna. Följande kodexempel visar hur man implementerar WholeNumber-typ av validering. Exemplet skapar samma data validering med Aspose.Cells for Node.js via C++ som vi skapade med Microsoft Excel ovan.

const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");

// Create directory if it is not already present.
const fs = require("fs");
if (!fs.existsSync(dataDir)) {
    fs.mkdirSync(dataDir);
}

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

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

// Accessing the Validations collection of the worksheet
const validations = workbook.getWorksheets().get(0).getValidations();

// Create Cell Area
const ca = new AsposeCells.CellArea();
ca.startRow = 0;
ca.endRow = 0;
ca.startColumn = 0;
ca.endColumn = 0;

// Creating a Validation object
const validation = validations.get(validations.add(ca));

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

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

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

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

// Applying the validation to a range of cells from A1 to B2 using the
// CellArea structure
const area = new AsposeCells.CellArea();
area.startRow = 0;
area.endRow = 1;
area.startColumn = 0;
area.endColumn = 1;

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

// Save the workbook.
workbook.save(path.join(dataDir, "output.out.xls"));

Listvalidering

Denna typ av validering tillåter användaren att mata in värden från en nedrullningslista. Det tillhandahåller en lista: en serie rader som innehåller data. I exemplet läggs ett andra kalkylblad till för att hålla listkällan. Användare kan endast välja värden från listan. Valideringsområdet är cellområdet A1:A5 i det första kalkylbladet.

Det är viktigt här att du ställer in egenskapen Validation.setInCellDropDown(boolean) på true.

const AsposeCells = require("aspose.cells.node");
const path = require("path");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");

// Create directory if it is not already present.
const fs = require("fs");
if (!fs.existsSync(dataDir)) {
    fs.mkdirSync(dataDir);
}

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

// Get the first worksheet.
let worksheet1 = workbook.getWorksheets().get(0);

// Add a new worksheet and access it.
let i = workbook.getWorksheets().add();
let worksheet2 = workbook.getWorksheets().get(i);

// Create a range in the second worksheet.
let range = worksheet2.getCells().createRange("E1", "E4");

// Name the range.
range.setName("MyRange");

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

// Get the validations collection.
let validations = worksheet1.getValidations();

// Create Cell Area
let ca = new AsposeCells.CellArea();
ca.startRow = 0;
ca.endRow = 0;
ca.startColumn = 0;
ca.endColumn = 0;

// Create a new validation to the validations list.
let validation = validations.get(validations.add(ca));

// Set the validation type.
validation.setType(AsposeCells.ValidationType.List);

// Set the operator.
validation.setOperator(AsposeCells.OperatorType.None);

// 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(AsposeCells.ValidationAlertType.Stop);

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

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

// Specify the validation area.
let area = new AsposeCells.CellArea();
area.startRow = 0;
area.endRow = 4;
area.startColumn = 0;
area.endColumn = 0;

// Add the validation area.
validation.addArea(area);

// Save the Excel file.
workbook.save(path.join(dataDir, "output.out.xls"));

Datumdata validering

Med denna typ av validering anger användare datumvärden inom ett angivet intervall eller enligt specifika kriterier i de validerade cellerna. I exemplet är användaren begränsad att ange datum mellan 1970 och 1999. Här är valideringsområdet cell B1.

const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");

// Create directory if it is not already present.
const fs = require("fs");
if (!fs.existsSync(dataDir)) {
    fs.mkdirSync(dataDir);
}

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

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

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

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

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

// Create Cell Area
let ca = new AsposeCells.CellArea();
ca.startRow = 0;
ca.endRow = 0;
ca.startColumn = 0;
ca.endColumn = 0;

// Add a new validation.
let validation = validations.get(validations.add(ca));

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

// Set the operator for the data validation
validation.setOperator(AsposeCells.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(AsposeCells.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);

// Set a collection of CellArea which contains the data validation settings.
let cellArea = new AsposeCells.CellArea();
cellArea.startRow = 0;
cellArea.endRow = 0;
cellArea.startColumn = 1;
cellArea.endColumn = 1;

// Add the validation area.
validation.addArea(cellArea);

// Save the Excel file.
workbook.save(path.join(dataDir, "output.out.xls"));

Tidsdata validering

Med denna typ av validering kan användare ange tider inom ett angivet intervall eller enligt vissa kriterier i de validerade cellerna. I exemplet är användaren begränsad att ange tider mellan 09:00 och 11:30 förmiddag. Här är valideringsområdet cell B1.

const AsposeCells = require("aspose.cells.node");
const path = require("path");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");

// Create directory if it is not already present.
if (!require("fs").existsSync(dataDir)) {
    require("fs").mkdirSync(dataDir);
}

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

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

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

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

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

// Create Cell Area
const ca = new AsposeCells.CellArea();
ca.startRow = 0;
ca.endRow = 0;
ca.startColumn = 0;
ca.endColumn = 0;

// Add a new validation.
const validation = validations.get(validations.add(ca));

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

// Set the operator for the data validation.
validation.setOperator(AsposeCells.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(AsposeCells.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);

// Set a collection of CellArea which contains the data validation settings.
const cellArea = new AsposeCells.CellArea();
cellArea.startRow = 0;
cellArea.endRow = 0;
cellArea.startColumn = 1;
cellArea.endColumn = 1;

// Add the validation area.
validation.addArea(cellArea);

// Save the Excel file.
workbook.save(path.join(dataDir, "output.out.xls"));

Textlängd data validering

Med denna typ av validering kan användare ange textvärden av en angiven längd i de validerade cellerna. I exemplet är användaren begränsad att ange strängvärden med högst 5 tecken. Valideringsområdet är cell B1.

const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");

// Create directory if it is not already present.
if (!require("fs").existsSync(dataDir)) {
    require("fs").mkdirSync(dataDir);
}

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

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

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

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

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

// Create Cell Area
const ca = new AsposeCells.CellArea();
ca.startRow = 0;
ca.endRow = 0;
ca.startColumn = 0;
ca.endColumn = 0;

// Add a new validation.
const validation = validations.get(validations.add(ca));

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

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

// 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(AsposeCells.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);

// Set a collection of CellArea which contains the data validation settings.
const cellArea = new AsposeCells.CellArea();
cellArea.startRow = 0;
cellArea.endRow = 0;
cellArea.startColumn = 1;
cellArea.endColumn = 1;

// Add the validation area.
validation.addArea(cellArea);

// Save the Excel file.
workbook.save(path.join(dataDir, "output.out.xls"));

Data valideringsregler

När datavalideringar implementeras kan valideringen kontrolleras genom att tilldela olika värden i cellerna. Cell.getValidationValue() kan användas för att hämta valideringsresultatet. Följande exempel visar den här funktionen med olika värden. Exempelfilen kan hämtas via länken nedan för testning:

sampleDataValidationRules.xlsx

const AsposeCells = require("aspose.cells.node");
const path = require("path");
// The path to the documents directory.
const dataDir = path.join(__dirname, "data");

// Instantiate the workbook from sample Excel file
const workbook = new AsposeCells.Workbook(dataDir + "sample.xlsx");

// Access the first worksheet
const 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
const 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
console.log("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
console.log("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
console.log("Is 30 a Valid Value for this Cell: " + cell.getValidationValue());

Kontrollera om valideringen i cellen är rullgardinsmeny

Som vi har sett finns det många typer av valideringar som kan implementeras inom en cell. Om du vill kontrollera om valideringen är en rullgardinslista, kan Validation.getInCellDropDown()-metoden användas för att testa detta. Följande exempel visar användningen av denna egenskap. En testfil kan laddas ner via länken nedan:

sampleValidation.xlsx

const AsposeCells = require("aspose.cells.node");
const path = require("path");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");

const workbook = new AsposeCells.Workbook(dataDir + "sampleValidation.xlsx");
const sheet = workbook.getWorksheets().get("Sheet1");
const cells = sheet.getCells();

const checkDropDown = (cell, cellRef) => {
    const validation = cell.getValidation();
    if (validation.getInCellDropDown()) {
        console.log(`${cellRef} is a dropdown`);
    } else {
        console.log(`${cellRef} is NOT a dropdown`);
    }
};

checkDropDown(cells.get("A2"), "A2");
checkDropDown(cells.get("B2"), "B2");
checkDropDown(cells.get("C2"), "C2");

Lägg till CellArea till befintlig validering

Det kan finnas situationer där du vill lägga till CellArea till befintliga Validation. När du lägger till CellArea med Validation.addArea(CellArea) kontrollerar Aspose.Cells alla befintliga områden för att se om det nya området redan finns. Om filen har många valideringar kan detta påverka prestandan. För att lösa detta finns metoden Validation.addArea(CellArea, boolean, boolean). Parametern checkIntersection anger om korsningen mellan ett givet område och befintliga valideringsområden ska kontrolleras. Att sätta den till false kommer att inaktivera kontroll av andra områden. Parametern checkEdge indikerar om de tillämpade områdena ska kontrolleras. Om det nya området blir det övre vänstra området, byggs interna inställningar om. Om du är säker på att det nya området inte är det övre vänstra, kan du ange denna parameter som false.

Följande kodsnutt visar användningen av Validation.addArea(CellArea, boolean, boolean)-metoden för att lägga till en ny CellArea till befintliga Validation.

const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const sourceDir = path.join(__dirname, "data");
const outputDir = path.join(__dirname, "output");

const workbook = new AsposeCells.Workbook(path.join(sourceDir, "ValidationsSample.xlsx"));

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

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

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

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

// Save the output workbook.
workbook.save(path.join(outputDir, "ValidationsSample_out.xlsx"));

Käll- och utdataexcelfilerna är bilagda som referens.

Källfil

Utdatafil

Fortsatta ämnen

• Hämta cellvalidering i ODS-filer
• Få validering som tillämpas på en cell
• Verifiera att cellvärdet uppfyller datavalideringsreglerna