The String Value Matching rule validates that string values in a column meet specific matching patterns like exact match, partial match (starts/ends with), or contain a substring.
This rule is commonly used to:
- Detect inconsistencies in names, codes, or descriptions
- Enforce formatting standards in text fields
Example Usage:
Ensure customer names either start with ‘Dr.’ or ‘Mr.’ and contain the word ‘Smith’, or validate product codes follow a pattern like ‘PC-###’.
Configuration Fields
Rule-Specific Configuration
Field Name | Description | Required | Data Type / Options |
---|
Match Type | Type of string comparison to apply | Yes | Exact Match , Starts and Ends with , Contains |
Start String | Text that the value should start with (applicable if Match Type allows) | No | String |
End String | Text that the value should end with (applicable if Match Type allows) | No | String |
Pattern String | Text pattern the value should contain (applicable if Match Type allows) | No | String |
Case Sensitive | Whether string comparisons should be case-sensitive | Yes | true / 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 ) |
ID | Customer | Country |
---|
1 | Fallon | Great Britain |
2 | Franklyn Fryer | France |
3 | Kathleen | United States |
4 | Judie Green | France |
5 | John Doe | null |
Sample Configurations
Example 1: Starts and Ends With Check
Configuration Field | Value |
---|
Column | Customer |
Match Type | Starts and Ends with |
Start String | John |
End String | Doe |
Case Sensitive | true |
Operator | GreaterThan |
Threshold Value | 1 |
Is Percentage | false |
Allow Nulls | false |
Check For Match | true |
Explanation:
Validates that more than one customer name starts with John
and ends with Doe
, case-sensitive.
Example 2: Contains Pattern Check
Configuration Field | Value |
---|
Column | Country |
Match Type | Contains |
Pattern String | France |
Case Sensitive | false |
Operator | EqualTo |
Threshold Value | 2 |
Is Percentage | false |
Allow Nulls | true |
Check For Match | true |
Explanation:
Validates that exactly two Country values contain the word France
, case-insensitive.
Sample Output
Column Name | Rule Name | Success Count | Failure Count | Null Count | Within Threshold |
---|
Customer | String Value Matching | 1 | 4 | 0 | No |
Country | String Value Matching | 3 | 2 | - | Yes |