ISALPHANUMERIC

This function checks characters in a string-type value. When you use the ISALPHANUMERIC() function to check characters in a string, you can fetch the string from an attribute or element. If it finds that the string contains only alphanumeric characters, it returns the true Boolean value. If it finds that the string contains only alphabets or numeric characters, it returns the false Boolean value.

When you want to use the ISALPHANUMERIC function, you can implement it in a business rule or in other algorithm-based conditions. Before discussing the steps to implement the ISALPHANUMERIC() function, let’s discuss where you can use this function while developing an application in the vDesigner module.

You can best use the ISALPHANUMERIC function to apply a validation. This validation will check if the user entered alphanumeric characters in the input field. If the user enters only alphabets or numeric characters, the application will display an error message. To implement this functional scenario, assume you have an application page.

On this application page, you have the PAN Number input field and an ADD push button, in addition to other input fields.

If the user enters only alphabets or numeric characters in the PAN Number field and then clicks the Add button to submit the data, the application will display the error message. You can implement this functional scenario as follows:

First, create a business rule that contains the condition that will check if the user entered alphanumeric characters in the field.

The following section describes how to implement the ISALPHANUMERIC function in a business rule.

Implementing ISALPHANUMERIC Function in Business Rule

To implement the ISALPHANUMERIC function in the business rule:

1. On the vDesigner module’s dashboard, see the left navigation panel.

2. Put the mouse pointer on the left panel to expand it.
3. In the left panel, click Business Rules to display the Business Rules page.
4. On the Business Rules page, click Create Business Rule to display the Create New page.
5. On the Create New page, in the middle panel, in the Name box, enter the new business rule’s name (for example, Check Alphanumeric).
6. In the right panel, see the IF block.
7. Under the IF block, click in the When box to display the Search box and a group of tabs.
8. Under the Search box, scroll right through the list of tabs and then click the Functions tab.
9. In the Search box, enter static to display the STATIC function.
10. In the list, select the STATIC function to display it with the value and String or castTo parameters.
11. In the STATIC function, click the value parameter and then enter false in the place of the value parameter.

12. In the STATIC function, click the seond parameter (for example, castTo or String) to display a context menu.

13. In the context menu, click Boolean to select it.
14. In the IF block, click the middle box, and then select the equal to (==) operator to compare two expressions in the business rule.

15. In the IF block, click the right box to display the Search box and a group of tabs.
16. Under the Search box, scroll right through the list of tabs and then click the Functions tab.
17. In the Search box, enter isalphanumeric to display the ISALPHANUMERIC function.

18. In the list, select the ISALPHANUMERIC function to display it with the string parameter.

19. In the ISALPHANUMERIC function, click the string parameter and then do the following:

Case1:- (If you want to check a value in the element)

20. Under the Search box, click the Element tab.
21. In the Search box, enter the element’s reference name to display it in the smart selector.

22. In the list, the select the element’s reference name (for example, InputField_PAN).

Case2:- (If you want to check a value in the attribute)

23. Under the Search box, click the Attribute tab.
24. In the Search box, enter the attribute’s name to display it in the smart selector.
25. In the list, select the attribute’s name.

26. After you select the element or attribute, click Create to create the business rule and define the condition in the business rule.

When the user’s action (the user does not enter the alphanumeric value) satisfies the condition in the business rule, the ISALPHANUMERIC function returns the false Boolean value.

Configuring Task Group

After you create a business rule and define the condition to check if the user entered alphanumeric characters in the PAN Number field, you need to configure a task in the task group. This configured task will display an error message if the user does not enter the alphanumeric value in the PAN Number field, which automatically satisfies the condition in the business rule.

To configure the task in the task group:

1. On the vDesigner module’s dashboard, see the left navigation panel.

2. Put the mouse pointer on the left panel to expand it.
3. In the left panel, click Task Groups to display the Task Groups page.
4. On the Task Groups page, either click Create Task Group to create a new task group or double-click the name (for example, Chk_Alphanumeric_Tskgp) of the existing task group to open the <<task group name >> page.

Note:- To know more about creating a new task group, click here.

5. On the <<task group name>> page, under the Task tab, search and find the Display Message task.
6. After you find the Display Message task, drag it to the Execution panel.

7. Under the Display Message task, in the Select Message box, click the application tree icon () to display the Message Library panel.
8. In the Message Library panel, either click Create New to create a new message or click the existing message to select it.

Note:- To create and configure a new message, see the post, Creating a New Message.

9. After you select the message, click Select to map it to the currently selected Display Message task.

10. In the Business Rule box, click the application tree icon () to display the Business Rules panel.
11. In the Business Rules panel, search and find the business rule to map it to the Display Message task.

12. After you find the business rule, click it to select it and then click Select to map it to the Display Message task.

13. After you successfully map the message and business rule to the Display Message task, click Save in the right panel to configure the Display Message task in the Chk_Alphanumeric_Tskgp task group.

After you configure the Display Message task in the task group, you can link the task group to the Add button on the application page.

Linking Task Group to Add Button

After you implement the ISALPHANUMERIC() function in the business rule and map the business rule to the Display Message task in the Chk_Alphanumeric_Tskgp task group, you need to link the task group to the Add button.

After you link the Chk_Alphanumeric_Tskgp task group to the Add button, you successfully apply the ISALPHANUMERIC() function to check and validate the value in the PAN Number field.

If the end-user enters alphanumeric characters in the PAN Number field and then clicks the Add button, the ISALPHANUMERIC() function returns the true Boolean value. As a result of this user action, the application will not display the error message to the user and will perform another intended function.

If the end-user does not enter alphanumeric characters in the PAN Number field and then clicks the Add button, the ISALPHANUMERIC() function returns the false Boolean value. As a result of this user action, the application will display the error message to the user.

To link the task group to the Add button:

1. On the vDesigner module’s dashboard, on the related application page, find the element (for example, Add button) to link it to the Chk_Alphanumeric_Tskgp task group.
2. Click the element (for example, Add button) to display its property panel.

3. In the Button panel, click the Events icon () to display the list of events.
4. In the list of events, find the onClick event.
5. To the right of the onClick event, click the plus icon () to display the Event Configuration page.
6. On the Event Configuration page, in the Task Group panel, search and find the task group (for example, Chk_Alphanumeric_Tskgp).

6. After you find the task group (for example, Chk_Alphanumeric_Tskgp), drag it to the Execution panel.
7. After you drag the task to the Execution panel, it displays the task or the list of tasks that you configured in the task group.

8. In the right panel, click Save to link the task group to the Add button.

The End Result

Case1:- If the end-user enters alphanumeric characters in the PAN Number field and then clicks the Add button, the ISALPHANUMERIC() function returns the true Boolean value. As a result of this user action, the application will not display the error message to the user and will perform another intended function.

Case2:- If the end-user does not enter alphanumeric characters in the PAN Number field and then clicks the Add button, the ISALPHANUMERIC() function returns the false Boolean value. As a result of this user action, the application will display the error message to the user.