RequiredValidator

Description

Widgets that have this feature in use are required to have an entry.

If there is no entry, Screen validation will fail if it is activated and user won’t be able to proceed with an action conditioned by validation.

Attributes

Attribute	Description
message	Defines message to be displayed when validation fails Can be @string
gn:minRequiredItems	Defines minimum amount of items in widget: (milestone 101) Valid target: GnMediaAction Can be hardcoded integer not negative and bigger than 0
MINREQUIREDErrMsg	Defines error message for minimum required items fail: (milestone 101)
labelTextResourceId	Defines label resource which will be added to validator string at location of reserved token ${labelTextResourceId} Can be hardcoded, but not recommended, use @string @string

Reserved tokens

In @string resources that are used for validator messages it's possible to use special tokens (reserved words). Token will be replaced by actual value during runtime of ginstr app.

For RequiredValidator

• ${labelTextResourceId} - will be replaced by the content of the labelTextResourceId validator attribute in final message, only if that attribute exists

Validator signatures

Check required value

[name:RequiredValidator],[message=validatorMessage]]

Example

@string/screen13_falseCeiling1stFixRequiredValidatorMessage - validator message

⤷ [name:RequiredValidator],[message=@string/screen13_falseCeiling1stFixRequiredValidatorMessage]

Can be used on widgets

• GnEditText - Validation will fail if length is 0
• GnDropDown - Validation will fail if no item is selected
• GnDropDownSelection - Validation will fail if no item is selected
• GnMediaAction - Validation will fail if no media is taken
• GnCaptureSignature - Validation will fail if no signature is taken
• GnPhoneNumber - Validation will fail if no phone number is stored
• GnEmail - Validation will fail if no email is stored
• GnRadioGroup - Validation will fail if no radio button is selected