Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

You can capture the location where your form was filled in by turning on ' Geo location feature. will always know A forms knows it's current location and will submit that information when the form is completed. This .   uses the HTML5 GeoLocation api.  The geo api is well supported on tablet, phone and recent laptop/desktop browser versions. This feature works on a desktop or any GPS capable mobile device.

When the form loads in the browser, it will ask for the location. All browsers will show a pop up asking the user's permission to use their location, unless permission was Always granted or refused in a previous session. The user must give permissions permission for Geo location to proceed. Here is an example of the request in Internet Explorer 9:

...

The Geo Location feature works in conjunction with rules that use the the form.positionUpdated identifier. You can set up the rule to execute every time the position is updated. See Business Rules for examples of rules that will do this.

You can also collect additional information associated with your location. For example, a section of a Police Incident Report, shown in the image, captures the location where the form was filled in plus the address information associated with it. The last position update will be in the submission metadata of your form or flow but it is NOT automatically added to the XML Document.  You must create controls (perhaps hidden) and rules to add the location information to the form XML document.  The Position Address section of the Police Incident Report form controls has controls and rules to show longitude, latitude, accuracy and/or errors plus the address information.

...

Latitude and Longitude display the coordinates of the user location. Accuracy represents the radius of a circle representing the The accuracy of the location in meters is represented by the value in the Accuracy field - a low Accuracy value means the position is more precise. You can display a position error code and the text description of error message in your form if desired. Error message codes can be 1, 2 or 3:

...

You can also turn on/off/modify the feature by clicking on a form activity in a flow which will display the form Properties panel. The Loc Timeout is the value in seconds that must pass before the Timeout error codes/messages will appear on your form when the location information cannot be retreivedlocation finder in the browser times out. To capture additional information based on the location via a Business Rule or to embed a Google map in your form. you need a connection to google.com and you must check the Detailed Loc. checkbox on the Properties Panel. The map will only display in use mode. 

Image Modified

 

Setup Key/Saved Fields

...