THIS IS THE README FILE FOR A SAMPLE UNIFACE DEVELOPMENT ENVIRONMENT
WHICH INCORPORATES A MENU & SECURITY SYSTEM.

Copyright A J MARSTON 1999-2002

This is obtained from http://www.marston-home.demon.co.uk/Tony/unifacestuff.html
on the 'Building Blocks' link.

Associated documentation in PDF format is also available from this site.

NOTE: As from 2nd January 2002 the Menu System User Guide is available as a series of HTML files instead of a single PDF file. These can be downloaded from my 'Building Blocks' page and unzipped into the htmlhelp\menu directory. These files can then be used as the online help by adding the line 'menu_htmlhelp=htmlhelp\menu\' into the [logicals] section of the assignment file.

LICENCE TO USE:
---------------

This is contained in file 'menu license.txt' which is based upon the contents of
file 'General Public License.txt' as issued by the Open Software Foundation.

--------------------------------------------------------------------------------------------

Instructions:
-------------

1) Unzip the MarstonMenuDemo.zip file to produce the following folder structure:

   - DEMO
   -- DOL
   -- DTD
   -- EXP
   -- FRM
   -- HTMLHELP
   ---- MENU/
   -- IMAGES
   -- PRO
   -- SQL
   -- TXT
   ---- MENU
   ---- XAMPLE

2) Adjust the shortcuts/links in the DEMO folder to point to your UNIFACE directory.

3) Build a new solid database using 'uid' for the user and 'pwd' for the password. Alternatively you may create a new repository using any database of your choice.

4) Run IDF and import the following files from the EXP subdirectory:

   everything.exp
   
5) Analyse application models MENU, INF and XAMPLE. (command line='/con')

6) Compile central objects (command line='/cen')

7) Compile signatures (command line='/sig')

8) Compile application start-up shell (command line='/app')

9a) Compile all menu forms (command line='/frm m*')

9b) Compile all xample forms (command line='/frm x*')

10) Compile all services (command line='/svc')

11) Compile all dtd's (command line='/dtd')

12) Create DOL file (command line='/dol')

13) Create URR file (command line='/urr')

14) Create audit tables from audit_hdr.sql, audit_dtl.sql and v_audit_log.sql

15) My software uses custom widgets and widget fonts which are defined in the usys8403.ini file. You should either point to this fle or copy the custom widget definitions (and associated font definitions) into your own .ini file.

16) Run the application, double-click on the 'Welcome' screen.

17) First time only - when the file box appears select 'Menu_data.txt' and answer 'yes' to the message. This will load initial data into the menu database. When the file box appears for a second time select 'cancel'.

18) The logon screen will appear. Logon using the following:

    user id  = DEMO
    password = password

    Alternative user id's are 'AJM', 'MGR', 'MANAGER', 'DEV', 'ENQUIRY', 'EXAMPLE', 'USER1', 'USER2, 'USER3'. All passwords are initially set to 'password'.

19) The main menu will appear with the following options:

    CONTROL menu
    Xample menu

20) To load data into the Xample database select 'Xample menu', 'Xample secondary menu', 'Reload data from txt file'. When the file box appears select 'Xample_Data.txt' and answer 'yes' to the message. When the file box appears for a second time select 'cancel'.

21) You are now free to roam around the system.
    - All items under the CONTROL menu will allow you to view or change the contents of the menu database.
    - All items under the Xample menu will allow you to view or change the contents of the xample database. The data is meaningless, but each form has been built from one of the component templates in order to demonstrate how it functions. A guide to the contents of the xample system is to be found in the DOC subdirectory.

Enjoy!

Tony Marston

mailto: tony@marston-home.demon.co.uk
http://www.tonymarston.net/