Validate location

As the name suggests, this condition is used to validate the active location of the user filling the form against a pre defined Geo-Fence. Learn more about Geo-Fence Field

What is the use case?

Whenever you want users to not submit the form if the active location is outside a predefined Geo-Fence area. Let's understand this with an example.

Attendance use case

• A project is being conducted on ground. A geo-fence area is defined at the project location.

• Now the On-field construction workers come to work and they need to mark their attendance at the project location.

• If the active location of the user is outside the defined geo-fence then the attendance shouldn't be marked and a proper message is shown to the user

This can be achieved using Validate location.

Over which type of field is it applied?

The user creating the form applies this condition over a location type of field.

The user clicks on Select Fields to get list of all location type of fields that exists in the form being created.

How do I set the area for validation of location?

The area for validation is set using the Geofence type of field. The user sets the area perimeter using the Geofence field.

How do I set this up?

Let's understand it in steps:

1. Create a Project details form for recording the details of the project and set this form as a master form.
2. In the Project details form, create a Geofence field.
3. Create a submission with Construction site perimeter as a value for the Geofence field in the Project details form.

4. Create another form Attendance form with the Geofence field and a location field in it along with other required fields and set the Project details form as a master form to the Attendance form.
5. Map the Geofence field of Attendance form with the Geofence field of the Project details form.
6. While creating the submission for the Attendance form, the Geofence field of Attendance form will have the Geo fence field value which is there in the submission created for the Project details form (this form being the master form and geofence fields are mapped).
7. In the Attendance form, now we can set the condition Validate location on the location field and use the Geo fence field for deciding the area to be considered for location validation.

In the above image,

1. Location is the field over which Validate location logic will be applied. So by our example, Location field of Attendance form will be this field.

2. Copied Geo fence is the Geofence field with which the location has to be validated. In our example, it is the Geo fence field of the Attendance form whose value is mapped with the Geo fence field of the Project details form.

3. Error message that should be shown to the user filling up the form in case the location validation fails.

Can I allow the user to submit the form even if the location validation fails?

Yes you can. While setting up the condition, Validate location the user can choose to allow the user filling up the form to create successful submission even if the validation fails.

The user can set some condition as well to implement Validate location using Enter validation condition input box shown in the below image.

The user has to give the error message that should be shown in case the validation fails.