Validations

What are the Model Validations?

Model validations are used to check the integrity of the information that an end-user inputs while interacting with a digital process. The implementation of different validations is done by using Webflow components and data items from the Model.

How to Implement Validations

Validation is implemented on a transaction data item associated with different Webflow components, such as Text Input and Radio Question. For example, using validations, you can check if an email address was input according to the email address format or turn a Webflow component into a required field for inputting information.

Validations Usage Example

Figure 1 displays a Webflow with three Text Input components and a Radio Question component. The email information that the user needs to fill out must be checked and validated that it is written correctly according to the address structure of an email. In addition, it is mandatory to select a marital status to proceed with the Webflow:

Figure 1: Webflow Components

Figure 2 displays the Model of the Webflow. The Model contains four transaction data items, The email (1) and the maritalStatus (2) transaction data items need to be implemented with appropriate validations:

Figure 2: The Model

When clicking the Validations tab (3) an Add field appears (4) where all the existing validations are searchable according to their name (see Figure 3):

Figure 3: Validations

For the email transaction data item, the appropriate validation is email_eng () (5) (see Figure 4):

Figure 4: Email Validation

For the maritalStatus data item, the appropriate validation is required_eng () (6) (see Figure 5):

Figure 5: Marital Status Validation

Each added validation can be configured (7) with a custom validation message, instead of a default validation message, which will be displayed when the input information is not valid (see Figure 6):

Figure 6: Validation Configuration

The Edit custom validation message window enables to override the default validation message by checking the checkbox (8) and by entering a new custom message (9) (see Figure 7):

Figure 7: Edit custom validation message

Figure 8 displays the validation messages when the input data is not valid (10) and when the required information is not filled out (11):

Figure 8: Validation Messages

The Validations Screen

(See Figure 9 to Figure 11)

A list of validations in your environments can be found under the Validations screen. To access it, click Build (1) and then Validations (2).

Figure 9: Build -> Validations

The Validations screen is divided into two sections:

• Custom Validations (3) - displays validations that were custom-built for your environment.  
• EasySend Validations (4) - displays built-in EasySend validations.

Figure 10: Validation Screen - Custom and EasySend Validations

Both sections display the following information:

• Id (5) - the name of the validations. The Id is used when adding the validation in the Model screen.
• Message (6) - the text that will appear when the validation is triggered in the digital process. 

• Parameters (7) - the variables the validation needs to function properly. The parameters are used when within the code of the validation.  
• Code (8) - contains the validation's lines of code.

Figure 11: Validations Information

Edit Custom Validation

(See Figure 12 to Figure 16)

You can only edit the validations located under the Custom Validations section. To edit, hover over the desired validation and click the pencil icon (1).

Figure 12: Editing Information

Clicking the pencil icon displays the Edit Validation window that allows you to edit the:

• Id
• Parameters
• Message
• Code

Figure 13: Editing Validation Window

The globe icon appears when multiple languages exist in your environment.

Figure 14: Globe Icon

Clicking the globe icon displays a window that allows you to input a message for each language.

Figure 15: Languages

the code icon (3) allows you to edit the validation code. 

Figure 16: Code Icon

Clicking it displays the Edit code window:  

Figure 17: Edit Code Window

Duplicate a Validation 

(See Figure 18 to Figure 20)

Validations from both sections can be duplicated. To duplicate a validation, hover above it and click the icon (1).

Figure 18: Duplicate Icon

 Clicking the Icon displays the Duplicate Validation window that allows you to edit it.

Figure 19: Duplicate Validation Window

After clicking OK (2), the validation will be added at the bottom of the Custom Validation section (3). 

Figure 20: Added Duplicated Validation

Adding a new Custom Validation 

(See Figure 21 to Figure 23)

To add a new custom validation, click the + New Validation button (1).

Figure 21: + New Validation

 When the Edit Validation window appears, enter all the required data. 

Figure 22: Edit Validation Window

After clicking OK (2), the validation will be added at the bottom of the Custom Validation section (3). 

Figure 23: Added Validation

Validations Screen Deployment 

(See Figure 24)

Initiating a deployment process from the Validations screen is needed when:

• Validations are available to add using the Model screen but they are not functioning properly while using the digital process.
• A custom validation was added.
• A custom validation was edited.
• A validation was duplicated.
• A custom validation was deleted.

To initiate the deployment process:

1. Click the Deploy button (1). 
2. If necessary, select a relevant server.
3. Wait for the deployment process to finish.

Figure 24: Deploy Button

Built-in EasySend Validations

Table 1 describes the built-in EasySend validations. 

Table 1: Validations

How to Videos

To quickly learn how to use validations, watch the following videos:

• Exact Number of Characters: 

• Maximum Number of Characters:

• Email:

• Only Letters:

• Only Numbers:

• Past Date:

• Minimum Number of Characters:

• Required Fields:

• Valid Date:

• Future Date: