The String Length Validation rule ensures string values adhere to defined length constraints.
This rule is commonly used to:
- Validate fixed-length identifiers like phone numbers or country codes
- Enforce minimum/maximum length requirements for address fields, codes, etc.
- Ensure consistent data entry standards
Example Usage:
- Verify all country codes are exactly 2 characters long (like “IN”, “US”)
- Ensure phone numbers are between 10-15 digits after trimming
- Validate access tokens have a minimum of 32 characters
Configuration Fields
Rule-Specific Configuration
| Field Name | Description | Required | Data Type / Options |
|---|
| Minimum Length | Minimum allowed length | No | Integer |
| Maximum Length | Maximum allowed length | No | Integer |
| Exact Length | Required exact length | No | Integer |
| Left Trim | Trim whitespace from start of string | No | true / false (default: true) |
| Right Trim | Trim whitespace from end of string | No | true / false (default: true) |
| Consider Whitespace | Include whitespace characters in length calculation | No | true / false (default: false) |
Success Criteria Configuration
This section defines how the rule’s outcome is measured against expected thresholds.
| Field Name | Description | Required | Options / Format |
|---|
| Operator | Comparison operation for the result count | Yes | GreaterThan, LessThan, EqualTo, Between |
| Threshold Value | Value for comparison (single value for most operators) | Conditional | Number |
| Threshold Min | Minimum value (for Between operator) | Conditional | Number |
| Threshold Max | Maximum value (for Between operator) | Conditional | Number |
| Is Percentage | Whether the threshold represents a percentage or count | No | true / false (default: false) |
| Allow Nulls | Should null values be treated as valid | No | true / false (default: false) |
| Check For Match | When false, validates for negation of the condition | No | true / false (default: true) |
| UserID | CountryCode | PhoneNumber |
|---|
| 1 | IN | 9876543210 |
| 2 | US | 11234567890 |
| 3 | UK | 447890123456 |
| 4 | IN | 98765 43210 |
| 5 | null | null |
Sample Configurations
Example 1: Country Code Exact Length
| Configuration Field | Value |
|---|
| Column | CountryCode |
| Exact Length | 2 |
| Operator | GreaterThan |
| Threshold Value | 4 |
| Is Percentage | false |
| Allow Nulls | false |
| Check For Match | true |
Explanation:
Ensures that at least 4 country codes are exactly 2 characters long (e.g., “IN”, “US”).
Example 2: Phone Number Length Range
| Configuration Field | Value |
|---|
| Column | PhoneNumber |
| Minimum Length | 10 |
| Maximum Length | 15 |
| Left Trim | true |
| Right Trim | true |
| Operator | GreaterThan |
| Threshold Value | 4 |
| Is Percentage | false |
| Allow Nulls | false |
| Check For Match | true |
Explanation:
Validates that at least 4 phone numbers have lengths between 10 and 15 characters (after trimming), ensuring basic phone number formatting.
Sample Output
| Column Name | Rule Name | Success Count | Failure Count | Null Count | Within Threshold |
|---|
| CountryCode | String Length Validation | 4 | 0 | 1 | Yes |
| PhoneNumber | String Length Validation | 4 | 0 | 1 | Yes |