(Example) How to use a Validation Mask in a Form Control

Prerequisites

• This example uses the Travel Reimbursement app from the AgilePoint NX App Store.

  For more information, refer to How to Get the App

Good to Know

• Travel Reimbursement is an app that requests reimbursement for your official travel expenses. This app provides a Travel Reimbursement form to enter the details of the travel.

  For the use case in this example, configure a validation mask in the Travel Reimbursement form to make sure the value entered in the email address field is in valid email address format.

How to Start

1. Click Manage.

   
   
   

2. In the Manage Center, click App Builder > eForms Settings.

   
   
   

3. On the eForms Settings screen, click Validation Mask.

   
   
   

4. On the Validation Mask screen, click Add Validation Mask.

   
   
   

Procedure

1. On the Add Validation Mask screen, in the Name field, enter EmailAddress.

   
   
   

2. In the Value field, enter this value:

   /^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$/.

   
   
   

3. Click Save.

   The Validation Mask screen shows the EmailAddress validation mask.

   
   
   

How to Start

1. Click App Builder.

   
   
   

2. On the App Builder Home screen, click All Apps.

   
   
   

3. On the All Apps screen, on the Travel Reimbursement app, click Edit .

   
   
   

4. On the App Details screen, hover over the Travel Reimbursement Form, and click Edit .

   
   
   

Procedure

1. On the Travel Reimbursement form, put your cursor over the Email form control, and the form control toolbar shows.

   
   
   

2. Click Edit Properties .

   
   
   

3. On the Field Settings - Text Box screen, click the Advanced tab.

   
   
   

4. On the Advanced tab, in the Validation Mask list, select EmailAddress.

   
   
   

   When you select the Validation Mask field, the Validation Format field completes by default based on the selected validation mask.

   
   
   

5. On the Configure tab, in the Text Box Validation Message field, enter Enter the ${L} in valid email address format.

   
   
   

6. Click Close.

Procedure

1. Click Preview > PC Browser .

   
   
   

   The Travel Reimbursement form opens in a new browser tab.

   
   
   

2. On the Travel Reimbursement form, in the Email field, enter an email address that is not in valid email address format.

   
   
   

3. Enter an email address that is in valid email address format. No error shows.

   
   
   

Next, save, check in, and publish the process-based app.

For more information, refer to (Example) Save, Check In, and Publish a Process-Based App.

Next, run the app.

For more information, refer to My Apps screen

Good to Know

• This procedure is optional. It is provided so you can test the example with an out-of-the-box app.
• This is part of the Background and Setup procedures, but many users preferred this step to appear after the example, not before it.

Get the App

1. Click App Store.

   
   
   

2. Click Filter

   
   
   

3. In the CATEGORY section, click Finance.

   
   
   

4. Click the Travel Reimbursement app.

   
   
   

5. On the Travel Reimbursement screen, click Add.

   
   
   

6. On the Trust App screen, click Trust it.
7. Click Return to site.