What is a Validation Error and how to correct it

Issue

Users may occasionally encounter a Validation Error while completing a submission. When this happens, the error prevents the user from moving forward, ultimately blocking completion of the submission.
 

This error commonly appears because the system expects user input to satisfy validation rules. This happens when the field is missing a value. 

Common Causes:

• A field has no value and is not editable.
• A field is set as Required and its settings are set to "Mobile Visible = Off." This prevents the user from entering a value because the field is hidden.
• A required field is dependent on Reference Data, and the referenced value is blank. If the field is not editable or is hidden, the user will be unable to enter a value.

Solution

To correct this, you will need to edit the form to ensure the required data can be captured properly. The resolution will depend on what the root issue is.

• Make the field editable to allow the users to enter a value
• Make the field visible on mobile devices so users can enter the required value.
• Remove the “Required” setting from the field, if gathering that information is not strictly necessary.

Step by Step:

1. Log in to the Builder
   • Go to your GoCanvas account and open the App Builder.
2. Locate the form with the issue
   • Open the app where users are experiencing the Validation Error.
3. Find the problematic field
   • Identify the field flagged by the validation error.
   • Look for fields that are set as Required but have Mobile Visible = Off, or fields that rely on Reference Data with potentially blank values.
4. Adjust field settings
   • If the field should still be collected from users:
     • Turn Mobile Visible = On so the field displays to the user during submission.
   • If the data is not critical:
     • Turn off the Required setting to prevent the error.
5. Check Reference Data (if applicable)
   • If the affected field uses dependent Reference Data, open the data source file and confirm that no required values are left blank.
   • Update the file if necessary and re-upload it to GoCanvas.
6. Save the form
   • Once you make changes, save the form in the Builder.
7. Publish the updated form
   • Click Publish to Device(s) so the corrected version is available to your users.
8. Test the form
   • Perform a test submission using the updated form to confirm that the validation error is resolved.