Hello, Thank you for opening this page.
This tutorial will show you how to use "ValidationHelper" through the simplest use case.
There are two things to do.
- Define validation rules in this app.
- Call validation action where you want to verify.
For example, there is the following entity.
Micropost entity has three attributes.
Id attribute is identifier of this entity.
Content attribute has text that length is less than or equal to 140.
UserId attribute has
All three attributes are mandatory.
In validation, I would like to confirm the following two points.
Contenthas text that length 1~140.
- User of
Now let's get started.
1. Define validation rules in this app¶
First of all, open the ValidationHelper app (https://<YOUR_SERVER>/ValidationHelper/).
Then, the entity search screen is displayed, so search for the entity for which you want to set validation rules.
This time I want to define a validation rule for the "Micropost" entity, so search for "Micropost".
Open the details page for "Micropost" entity. This page shows the attributes that "Micropost" entity has and provides links to add a validation rule to each attribute.
I have set the validation rules as follows:
- Content: Min = 1, Max = 140
- UserId: Presence
2. Call validation action where you want to verify¶
Open the screen I want to verify in Service Studio. (The screen below was created by scaffolding.)
Open the action you want to validate. This time I would like to validate with the
The processing of the
Save button is as follows.
Validation must be done before saving to the database. So this time I will validate before
CreateOrUpdateMicropost. "ValidationHelper" provides an action named
VH_IsValidEntity for validation, so add this action before
VH_IsValidEntity is very easy and you specify two parameters.
Parameter 1 :
Specify the variable to be validated. The data type of the variable must be an entity. Variables also need to be converted to object types using the "ToObject" function. In this case, specify
Parameter 2 :
If you specify
True, an exception will occur when validation fails. The exception that occurs here is caught by the handler in this screen action and a feedback message is displayed. The error message is formatted just right for display in a feedback message.
That's all for how to use it.
Let's check the execution result.
Open the details screen of "Micropost" and enter 141 characters in "Content". Nothing is specified for "UserId".
When I clicked the "Save" button, verification was performed and two errors occurred.
Now empty the content, set User to "Administrator" and click Save.
It has been verified as expected.
That's all for the tutorial.
There are other types of validation available with "ValidationHelper" besides those used in this tutorial. See Reference for more information.