Validation

You can set a validator to already existing attributes but to save it, a value of this attribute in all products MUST match the validation parameters. If they don't, an error message will be displayed.

Introduction

Validators help protect data integrity by ensuring that only data meeting specific conditions is accepted into the system. For example, when dealing with text type attributes, you can use regular expressions (regex). Imagine regex as a pattern filter that checks if the attribute value looks correct; for instance, it verifies that an email address includes an "@" symbol. This helps maintain accuracy and prevent errors.

Different attribute types require different validation rules. A number might need to be within a certain range, whereas an image might need to fall within specific boundaries. Validators thus help maintain consistency across your data fields.

In Ergonode you can set validation to the following attribute types:

Attribute type	Available validators
File	Minimum number of files Maximum number of files Maximum file size Allowed extensions
Gallery	Minimum number of images Maximum number of images Maximum file size Allowed extensions
Image	Maximum file size Allowed extensions
Numeric	Minimum value Maximum value
Price	Minimum value Maximum value
Text	Regular expression (regex) with examples
Textarea	List of banned words (1000 characters limit)
Unit	Minimum value Maximum value

About regex (available in text attribute only)

In the system, you can use some predefined regex patterns, but it's possible to use your own. To use predefined ones click on the "Copy from regex templates".

Regular expressions, or regex, are like super-powered validation tools for text. They use a specific sequence of characters to form a specific pattern. You can think of it as a sophisticated “find,” but with more precision and flexibility. Here's how to use regex for validating:

1. Basic Validation:

   • Suppose you want to validate any three-letter words. You'd use the pattern \b\w{3}\b. In this pattern, \b indicates word boundaries, and \w{3} specifies exactly three word characters.

2. Digits Validation:

   • To validate any sequence of digits in text, use the pattern \d. Here, \d stands for any digit, so this will match any sequence of strings with a single digit in it. like 123, 4aa, or 678aaa9. If you wish to validate a string that ends with a digit use\d$, ex: something1.

3. Email Addresses Validation:

   • If you're validated for email addresses, you might use something like \b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b. This looks for common email structures, checking for alphanumeric characters before and after the "@" symbol.

4. Dates validation:

   • To validate the dates in the format DD/MM/YYYY, you could use \b\d{2}\/\d{2}\/\d{4}\b. Here, \d{2} finds exactly two digits, / is a literal slash, and \d{4} looks for four digits.

5. Flexible Validation:

   • Sometimes, you might want to validate words that start with a certain letter. For example, to find words starting with “a” use \ba\w*\b. This looks for word boundaries (\b), the letter "a," and any number of word characters (\w*).

Regex provides a way to quickly find patterns and extract relevant information from text without manual searching. They might seem complex at first, but with practice, they become incredibly useful for tasks like data validation and text processing. Dive in and explore the endless possibilities they offer!

Included regex patterns

In Ergonode you will find some common regex patterns already included for your convenience.

Here is the list:

• EAN-13

• EAN-8

• URL address

• File Path

• Alphanumeric (without space)

• Alphanumeric (with space)

• Numeric (whole numbers)

• Numeric (dot separated)

• Numeric (comma separated)

To use them click on Copy from regex templates and select one from the list.

Custom regex validation error message

You can set a custom validation error message for your user.

Text attrobute validation tab

The message will be displayed on the validation box

Text attribute validation tab - cutom validation error messag

in the tooltip on the Product catalog (Product grid)

Product catalog - cutom validation error message

in the Category attribute (if the attribute is set to be one)

in the Batch action

and on the product card.