Good — this is exactly the level where people stop guessing and start building correctly.
I’ll keep it consistent, precise, and practical for each validator:
For each:
- What it does
- How it works
- How to use it
- Example
No fluff.
String validators
string: Equal
What it does
Checks if a string is exactly equal to a value.
How it works
- Compares the full string
- Case-sensitive (unless you normalize)
How to use it
Use when the value must match exactly one expected value.
Example
Requirement: Room name must be “Office”
roomName
Validator: Equal → "Office"
string: Not equal
What it does
Checks that a string is not equal to a value.
How it works
- Fails if exact match occurs
How to use it
Use to block forbidden values.
Example
Requirement: Name must not be “Undefined”
Validator: Not equal → "Undefined"
string: Contains
What it does
Checks if a string contains a substring.
How it works
- Searches within the string
How to use it
Use for naming conventions or partial checks.
Example
Requirement: Door name must include “EXT”
Validator: Contains → "EXT"
string: Not contains
What it does
Ensures a substring is not present.
How it works
- Fails if substring is found
How to use it
Use to block unwanted terms.
Example
Requirement: Name must not contain “temp”
Validator: Not contains → "temp"
string: Part of
What it does
Checks if the value is contained within another string.
How it works
- Reverse of “contains”
How to use it
Use when value must be part of a predefined string.
Example
Value: "A"
Check against: "ABC"
Validator: Part of → "ABC"
string: Not part of
What it does
Ensures the value is not contained within another string.
Example
Value: "X" should not be part of "ABC"
string: Empty
What it does
Checks if a string is empty ("")
How it works
- Only checks empty string
- Not
null
How to use it
Use when value must not be filled
Example
Requirement: Comment must be empty
string: Not empty
What it does
Checks that a string has a value.
How it works
- Fails if
""
How to use it
Use for mandatory text fields
Example
Requirement: Mark must be filled
string: Matches
What it does
Validates a string using regex (pattern matching)
How it works
- Applies pattern to string
How to use it
Use for naming conventions or structured codes
Example
Requirement: Code must follow NLRS pattern
Validator: Matches → ^[A-Z]{2}-\d{3}$
Boolean validators
boolean: Is
What it does
Checks if value is true or false
How it works
- Compares boolean value directly
How to use it
Use when parameter must be explicitly true or false
Example
Requirement: IsExternal must be true
Validator: Is → true
boolean: Is not
What it does
Checks that value is not a specific boolean
Example
Requirement: Must not be false
Validator: Is not → false
Null validators
null: Should be null
What it does
Checks that value is not set
How it works
- Passes only if
null
How to use it
Use when parameter should not be filled
Example
Requirement: Temporary field must be empty
null: Should not be null
What it does
Checks that value exists
How it works
- Fails if
null
How to use it
Use for mandatory parameters
Example
Requirement: Fire rating must exist
Float validators
float: Equal / Not equal
What it does
Compares decimal values
How it works
- Direct numeric comparison
How to use it
Use when exact numeric value is required
Example
Requirement: Thickness must be 0.2
Validator: Equal → 0.2
float: Less than / Less than or equal
What it does
Checks upper bounds
Example
Requirement: Height < 3.0
float: Greater than / Greater than or equal
What it does
Checks lower bounds
Example
Requirement: Area ≥ 10.0
Integer validators
Same logic as float, but for whole numbers only
Example
Requirement: Level index ≥ 0
Validator: Greater than or equal → 0
List validators
list: In
What it does
Checks if value exists in a list
How it works
- Exact match required
How to use it
Use for allowed values
Example
Allowed: ["EI30", "EI60"]
Validator: In
list: Not in
What it does
Ensures value is not in list
list: Equals
What it does
Checks full list equality
How it works
- Compares entire array
list: Not equal
Opposite of above
list: Any of the words are contained in the list
What it does
Checks if at least one word matches
Example
Input: "fire door"
List: ["fire", "smoke"] → pass
list: None of the words are contained in the list
What it does
Ensures no overlap
Property validators
Property: should exist
What it does
Checks if property/key exists in filter output
How it works
- Looks at structure, not value
How to use it
Use for missing parameter detection
Example
Check if brandwerendEis exists
Property: should not exist
What it does
Ensures property is absent
How to use it
Use when parameter should not be used
Final note
Validators only evaluate what the Query returns. If the filter does not provide the correct structure or value, the validator will produce misleading results.