Validation

4min

Validating fields (text or other) is crucial for ensuring that data entered by users meets specific criteria or formats and for maintaining data integrity and security. 
In  you can use regular expressions (regex) for text validation. They allow for pattern matching and can enforce complex rules for text fields such as email addresses, phone numbers, usernames, passwords, and more. When applied to text validation, regex can be used to check if the input text matches the desired format. If it is not valid, an invalid message is displayed. 
In  you combine a JSONata expression﻿ with a Regex expressions﻿ to create a validation pattern and provide a message if the pattern does not match. 
Creating the validation expression:
Valid email address
﻿
Invalid email address
﻿
JSONata expression - [email protected] 
Regex expression -  /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/
Validation message - not an email
Combine the three above to validate an email address in the text-field component.
YAML
- type: component.text-field
          instanceId: email
          options:
            label: Email
            errorText: =$contains(@ctx.components.email.state.value, /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/) ? '' :'not an email'
        
- type: component.text-field
          instanceId: email
          options:
            label: Email
            errorText: =$contains(@ctx.components.email.state.value, /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/) ? '' :'not an email'
        
﻿
Regex and JSONata Expression examples
Here are some common validation expressions to create and use for text field validation.
Validation
Expected result
﻿Phone number﻿﻿
+271234556789
﻿Email﻿﻿
[email protected]
﻿Credit Card﻿﻿
Typically 13-16 digits, with spaces or dashes optional, and includes checks for Visa, MasterCard, American Express, and Discover. 1111-1111-1111-1111 or 1111 1111 1111 1111
﻿ZIP/Postal code (US)﻿﻿
5-digit codes, e.g. 10036
﻿Social Security Number (US)﻿﻿
XXX-XX-XXXX
﻿National Insurance (UK)﻿﻿
AA123456C
﻿US Date (DD/MM/YYYY)﻿﻿
23/07/2024 
﻿Date (MM/DD/YYYY)﻿﻿
03/28/2023
﻿Date (DD Month YYYY)﻿﻿
25 July 2024
﻿Date (yyyy/mm/dd)﻿﻿
2024/08/30
﻿Decimal﻿﻿
111,25
﻿Time (H:MM AM/PM)﻿﻿
12:15 AM or 08:45 PM
﻿Date (MM:SS or HH:MM)﻿﻿
08:10
﻿Time in 24-hour format﻿﻿
01:00
﻿URL﻿﻿
example.com or https://example.com
﻿ISBN﻿﻿
978-1-4302-1998-9
﻿Strict alpha numeric﻿﻿
JohnSmith
﻿Alpha numeric with spaces﻿﻿
John Smith
﻿Numbers and spaces only﻿﻿
56575 76 6
See Also
﻿Regex expressions﻿﻿
﻿Expressions﻿﻿
﻿Expressions - cheatsheet﻿﻿
﻿Expression-examples﻿﻿
﻿

Validation	Expected result
Phone number	+271234556789
Email	[email protected]
Credit Card	Typically 13-16 digits, with spaces or dashes optional, and includes checks for Visa, MasterCard, American Express, and Discover. 1111-1111-1111-1111 or 1111 1111 1111 1111
ZIP/Postal code (US)	5-digit codes, e.g. 10036
Social Security Number (US)	XXX-XX-XXXX
National Insurance (UK)	AA123456C
US Date (DD/MM/YYYY)	23/07/2024
Date (MM/DD/YYYY)	03/28/2023
Date (DD Month YYYY)	25 July 2024
Date (yyyy/mm/dd)	2024/08/30
Decimal	111,25
Time (H:MM AM/PM)	12:15 AM or 08:45 PM
Date (MM:SS or HH:MM)	08:10
Time in 24-hour format	01:00
URL	example.com or https://example.com
ISBN	978-1-4302-1998-9
Strict alpha numeric	JohnSmith
Alpha numeric with spaces	John Smith
Numbers and spaces only	56575 76 6

Updated 05 Aug 2024

Did this page help you?

State

Additional functionality