12 Mar 2015
GPS for HanDBase Plugin – Capture GPS Coordinates in your HanDBase for Android Database
Copying and Modifying the Sample HanDBase Form
You are welcome to use this Form as-is or modify it to meet your needs. Below are instructions for copying this form as-is to another database and some examples of how you might modify it. These instructions are specific to making these changes on your Android Device, assuming you have the Forms add-on there. If you have the HanDBase Professional or Enterprise add-on on your computer and that is where you create and edit forms you’ll first need to synchronize your data to your computer and you can then basically follow these instructions on your computer. See the HanDBase Forms documentation for details.
If you will be doing any of the following on your Android device I recommend you temporarily disable the GPS for HanDBase Plugin first, otherwise the messages that flash on your screen, mentioned above, may continue to appear while you are editing. To do this open the GPS for HanDBase plugin app and then tap the [Enabled] button to disable the plugin.
If you have the HanDBase Forms add-on on your Android Device you can open the DB Properties for the GPS Test database and go to Forms. Then you can select the GPS Data form and Copy icon, the one to the far left on that screen. That will allow you to copy this form to any database you’d like to use it in so you can capture GPS Coordinates there. I’ve included a [Return to Previous Form] button on the form so you can easily go back to a form that has the rest of your data. You would just need to include a button on your Main Form with an action of “Jump to Form”, selecting GPS Data as the form to jump to, to access this screen to get the GPS data.
If you do copy this Form to another database and you either have an existing field where you store GPS data or you add a new one you will need to mofify the Text Field Item and the Paste GPS Coordinates button in the form to have the correct Data Source. Simply select the correct field in your database and the plugin will continue to function properly.
Feel free to modify this form to meet your needs as well. For example, you could change the action of the [Paste GPS Coordinates] button so it first Clears the existing data in the field and then Pastes the new Data. This would allow you to easily update records with new GPS Coordinates.
WARNING: Do NOT change the name of the form. The form name MUST be “GPS Data” for the plugin to work properly.
Creating your own Form to capture GPS Data
You can of course create your own form to capture GPS Data with the GPS for HanDBase Plugin. For it to properly work with the plugin though the form name MUST be “GPS Data”. That’s why I did the sample foem the way I did, so it could be activated from another form, and the GPS data would be the only thing captured/entered on that form. You likely would not want to have you main form be called GPS Data, just to be able to get the GPS data into one field. It’s actually the Form Title that the plugin is looking for, so if you wanted the actual Form Name to be something different, to be consistent with your other forms, you can then change the Form Title to Other and make sure that says GPS Data. At this time, the GPS Data capture can’t just be on a Tab either as that would not change the Form Name/Title.
I will be looking into a way for the user to specify the Form Name in the Settings for the future.

Respond to this post
You must be logged in to post a comment.