Last updated by azirbes 2 years ago
grails install-plugin address-lookup-zpfour
How to setup the ZP4 HTTP Server
Install ZP4
This guide does not cover installation of the ZP4 software, please refer to Semaphore's web site if you need help installing ZP4 from the DVD-ROM.
The INI file
The following is a sample INI file named
C:HTTPSERVHTTPSERV.ini . You'll need to modify the
clients section to make sure your Grails development and production servers can see this address. You may also want to register the ZP4 server in DNS so you can just call it something like
zp4.intranet.example.com .
[clients]
1=192.168.1.*
2=127.0.0.1[options]
port=80
format=XML[outputs]
1=Certified
2=Address (final)
3=Address line 2 (final)
4=Address leftovers
5=Barcode digits
6=City (final)
7=City (preferred)
8=Urbanization (final)
9=State (final)
10=ZIP (final)
11=Errors (binary)
12=Error numbers (detailed)
13=Error message
The Start-up Command
The following command will start up your HTTPSERV, you can create a shortcut with this command in it and put it in the Startup folder in the Start Menu if you wish. It needs to be run from the
C:ZP4 folder.
C:ZP4HTTPSERV.EXE C:HTTPSERVHTTPSERV.INI
Done!
You should now be able to fire up the ZP HTTP Server. You can test it by opening a web browser to the IP address or DNS name of the server. If it works, you should see a simple submit form.
Tags
If you wish to use the tags (you probably do), you'll need to add the following to the <head> section in your GSP file, or in the template GSP.
<g:javascript library="jquery"/>
<script type="text/javascript" src="${resource(file:'address-lookup-zp4.js', dir:'js', plugin:'address-lookup-zpfour')}" />
Last updated by azirbes 4 months ago
The docs are on github: http://aaronzirbes.github.com/grails-address-lookup-zpfour/
Provides address lookup service and tags so you can easily add address lookups to your web app if you
have a ZP4 HTTPSERV service from Semaphore corp running on your network.
From their website:
ZP4 is a DVD-ROM containing United States addresses, ZIP + 4î codes,
mail carrier route numbers, and other supplemental postal databases
(all maintained by the Postal Serviceââ¢), plus complete automatic
CASS Certifiedâ⢠address correction software for Windows computers.
This plugin assumes you already have a valid ZP4 DVD, and your Grails app
abides by the license agreements: Only accessed by your company, only installed
on one computer, etc…
For details, see:
http://www.semaphorecorp.com/cgi/faq.html#21To purchase ZP4, which is required by this plugin, please visit:
http://www.semaphorecorp.com/cgi/zp4.html
Disclaimer
I, the author have no affiliation with Semaphore corp, other than that I am a
satisfied paying customer. Their DVD is much more affortable than many similar products
available on the market.
Last updated by azirbes 2 years ago
Frequently Asked Question (actually no questions have been asked yet...)
It doesn't work!
All of the following items need to be done before this plugin will work
- purchase and install a current copy of ZP4
- set up the ZP4 HTTP Server
- The ZP4 HTTP Server must be able to receive request from your grails server
- set the ZP4 Server URL location in @Config.groovy@
- install the jquery plugin to use the tag libraries
- put the jquery and javascript references in the html header of the GSP you are using the tag(s) in
- have javascript enabled in your web browser
Last updated by admin 2 years ago
Source
Docs
Issues
Edit Plugin
Close