BabelKit Perl Source Code Setup

Read the Overview and the Code Table Setup pages first.

The BabelKit Perl source code is in the perl directory:       - BabelKit module definition.       - Setup for  - BabelKit Translation Utility.     - Database connection setup.        - BabelKit Demo page.
    regression.test   - Regression testing.
    Makefile.PL       - Makefile setup. requires the module. The Translation Utility and the Demo page need the module.

1. Database Schema and Core Record Loading

Read and follow directions for Code Table Setup.

Load and test the bk_code table schema definition as well as the core data records. If you want to run the demo load the demo data records as well.

2. Database Connection Setup

Customize the file to open a database handle to your database. If your application setup has already opened a database handle, use that handle instead of opening a new one. The handle should be set up to autocommit. is used by, and by regression.test.

3. Installation

Copy the file into a directory on your Perl include path. Or do the makefile thing:
    $ perl Makefile.PL
    $ make
    $ make test
    # make install

Run regression.test on the basic BabelKit class functions. This will fail unless you have completed the above steps!

4. BabelKit Translation Utility Setup

You may wish to customize the file to your situation:
  • Require and open a BabelKit handle.
  • Set the $perm_add, $perm_upd and $perm_del global variables. These let the user add, update and delete codes.
  • Define the bka_sess_url() function. Customize this if you are carrying session identifiers in your urls.
  • Require and call the bka_admin_main() function.
It is fine to make multiple copies of to set up different permissions for different classes of users.

5. Demo Page Setup

In order for the demo page to function, you will need to load the demo data records.