Skip to content
amaneiro edited this page Mar 4, 2013 · 13 revisions

What's it for

NavTableForms is a library to build your own customized forms for gvSIG with all the navigation capabilities of NavTable extension. It's intended for developers using gvsig to craft their own survey form for final users.

With this library, having your own survey forms is as easy as:

  1. Create the visual appareance of your form with Abeille Designer.
  2. Create a gvSIG extension.
  3. Create a class inherit from abstractform and set minor details.
  4. Deploy to your users the new extension!

Some features

  • All convenience from navtable extension: vertical navigation, common actions (save, delete, copy registers, etc).
  • Data validation: the library allows you to set validation rules for every field. See rules available. Contributing new rules is easy and welcome!
  • Domain values: manage to save/retrieve a pair alias-value to/from the datasource, taking the domains from a database (postgres) or from a local file.
  • Widgets on steroids. We package utilities for...
    • JComboBox: autofilling from a domain. While store/retrieve a value, the user is shown an alias of it. Configurable via the metadata defined in the Domain Values.
    • JButtons: dynamic add new funcionalities (as filesLink action) to the south panel of the form.
    • JFormattedTextField: nicely formatting text, ala spreadsheets. See video.
    • JTable: filling automatically from a recordset.
    • JTable: opening an AlphanumericNavTable when the user makes a doble-click on it.
    • And more!

A working example

A working example is available to test some of the capabilities of the library. As it only intends to showcasing the capabilities of the library the form is very simple. Obviously, you can build the forms as complex as you need.

How to test it:

  • Download the example extension zip or tar.gz.
  • Uncompress and copy it to the path where gvSIG store the extensions:
    • Linux:
      PATH_TO_YOUR_INSTALLATION/gvSIG_1.X/bin/gvSIG/extensiones
    • Max:
      PATH_TO_YOUR_INSTALLATION/gvSIG_1.X/bin/gvSIG/extensiones/
    • Windows:
      PATH_TO_YOUR_INSTALLATION\gvSIG_1_X\bin\gvSIG\extensiones</code>
  • Open gvSIG, open a view and load the shapefile example1.shp (stored in data directory inside the example). gvSIG will load it in the TOC as "example1".
  • A new white button will be enabled for you to click in it. It will open the form. Test it at your convenience.

More resources

If you are interested in developing using navtableforms, here some useful resources: