// -------------------------------------------------------------------
//
// -----------------------------------------------------
//  copyright 2003 by voxeo corporation. (see LGPL.txt)
// -----------------------------------------------------
//
//  v2.0 Coded in VoiceXML, and ColdFusion
//  v2.0 Coded by Matthew henry
//
// -------------------------------------------------------------------
//
//  CityLocater allows a caller to get the zipcode for a city,
//  or to get the city associated with a zipcode.
//
//  An Access database of all zipcodes is included.
//  
//  The caller is asked to say the name of a state or a zipcode.
//  If the caller say a zipcode, the database is checked and
//  the caller is given the name of the city and state.
//  If the caller says a state, then they are asked to say the
//  name of a city, and are given the zipcode for the city.
//  In either case, if there are multiple matches, the caller
//  is told how many matches there are and asked if they
//  want to hear all of them.
//
//  The caller can say "quit" at the main menu to end the application.
//  
//  This application uses ColdFusion, from Allaire, to dynamically 
//  generate VoiceXML and GSL (Grammar Specification Language).
//
// -------------------------------------------------------------------
//
//          Server Requirements
//
//  To properly run this application, the server it is installed on 
//  must be accessible from the internet. ColdFusion Server must also 
//  be installed on the server. Modifications to this application can 
//  be done with any text editor.
//
// -------------------------------------------------------------------
//
//          Quick Start Instructions Overview
//
//  1. Unzip the vcfmCityLocater.zip package
//  2. Add "USPostalCodes.mdb" as an ODBC Data Source named "ZIP"
//  3. Provision a voxeo community phone number for the application
//  4. Call the voxeo community phone number 
//
//
//          Quick Start Instructions Details
//
//  1. Unzip the vcfmCityLocater.zip package
//
//      a. Create a folder (or directory) on your server which 
//         will hold the application files
//
//      b. Copy the zip file into the folder
//
//      c. Unzip the contents if the zip file into the folder
//
//      d. Confirm the contents of the folder from the list below
//
//
//  2. Add "USPostalCodes.mdb" as an ODBC Data Source named "ZIP"
//
//      a. Check with your system administrator to see how to get this done
//
//
//  3. Provision a voxeo community phone number for the application
//
//      a. Point your browser to the voxeo community page:
//         http://community.voxeo.com/
//
//      b. Click on the "account login" button
//
//      c. Create an account if you do not already have one by
//         pressing the "you can get one here" link
//
//      d. If you have an account, press the "log in here" link
//
//      e. After log in, you should be on the "Welcome" page
//
//      f. Press the "application manager" tab
//
//      g. Fill in the url mapping form:
//
//          select Phone markup type: - Set it to "VoiceXML"
//
//          URL of your app: - Point it to your City.cfm file
//
//      h. Press the "Update" button
//
//      i. A new number should appear with the URL
//
//      j. Test the URL link by clicking on it
//
//      k. You should see an XML file that starts with the 
//         following 2 lines:
//
//   <?xml version="1.0" encoding="UTF-8" ?>
//   <!-- copyright 2003 by voxeo corporation. (see LGPL.txt) -->
//
//
//  4. Call the voxeo community phone number
//
//      a. Say the name of a state
//
//      b. Say the name of a city in the state
//
//      c. Say a zipcode
//
// -------------------------------------------------------------------
//
//  The entire suite contains 6 files plus an audio folder:
//
// -------------------------------------------------------------------
//
//  readme.txt          - This file
//
//  City.cfm            - ColdFusion application to generate VoiceXML documents
//
//  City.gsl            - Static GSL (Grammar Specification Language) file
//
//  CityGSL.cfm         - ColdFusion application to generate GSL city list
//
//  LGPL.txt            - GNU Lesser General Public License
//
//  USPostalCodes.mdb   - Access database of all zipcodes
//
//  Audio               - Folder containing 24 audio .wav files
//
// -------------------------------------------------------------------
//
//  Audio Files
//
// -------------------------------------------------------------------
//
//  File Name           -   Text of audio
//  ---------               -------------
//
//  Greeting.wav        -   Welcome to the voxeo city and zipcode locater.
//
//  MainMenu.wav        -
//                          Select from the following choices:
//                          If you know the zipcode, 
//                          and want to know the city, 
//                          say the 5 digit zipcode.
//                          If you know the city and state, 
//                          and want to know the zipcode, 
//                          say the state name.
//                          To end this call, say quit.
//
//  TheZipcode.wav      -   The zipcode...
//
//  IsIn.wav            -   is in...
//
//  City.wav            -   the city of...
//
//  County.wav          -   the county of...
//
//  State.wav           -   and the state of...
//
//  ThereAre.wav        -   There are...
//
//  MatchesZip.wav      -   matches for that zipcode.
//
//  MatchesCity.wav     -   matches for that city and state.
//
//  WouldHear.wav       -   Would you like to hear all of them?
//
//  ZipNotFound.wav     -   That zipcode is not in our database.
//
//  SayCity.wav         -   Please say the name of the city.
//
//  ZipCity.wav         -   The zipcode for the city of...
//
//  TheseZipCity.wav    -   These zipcodes are associated with the city of...
//
//  InState.wav         -   in the state of...
//
//  Is.wav              -   is...
//
//  CityNotFound.wav    -   That city is not in our database.
//
//  TryAnother.wav      -   You may try another one.
//
//  LocateAnother.wav   -   You may now locate another one.
//
//  Disconnect.wav      -   Thank you for calling the voxeo city and zipcode locater, goodbye.
//
//  NoInput.wav         -   I did not hear what you said.
//
//  NoMatch.wav         -   I did not understand what you said.
//
//  Help.wav            -   I'm sorry you are having trouble.
//
// -------------------------------------------------------------------

