MUIbase A relational programmable database Version 4.3 4 January 2021 Steffen Gutmann Copyright c 2021 Steffen Gutmann Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies. i Table of Contents 1 MUIbase Copying Conditions :::::::::::::::::: 1 1.1 License ::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 1 1.2 Donation ::::::::::::::::::::::::::::::::::::::::::::::::::::::: 1 1.3 Mailing List :::::::::::::::::::::::::::::::::::::::::::::::::::: 1 1.4 Disclaimer :::::::::::::::::::::::::::::::::::::::::::::::::::::: 1 1.5 Third Party Material ::::::::::::::::::::::::::::::::::::::::::: 1 1.5.1 Windows, Mac OS and Linux Versions ::::::::::::::::::::: 2 1.5.2 Amiga Version ::::::::::::::::::::::::::::::::::::::::::::: 2 2 Welcome to MUIbase ::::::::::::::::::::::::::: 4 3 Getting Started:::::::::::::::::::::::::::::::::: 5 3.1 Installing MUIbase on Windows :::::::::::::::::::::::::::::::: 5 3.2 Installing MUIbase on Mac OS ::::::::::::::::::::::::::::::::: 5 3.3 Installing MUIbase on Linux :::::::::::::::::::::::::::::::::::: 5 3.4 Installing MUIbase on Amiga ::::::::::::::::::::::::::::::::::: 6 3.5 Updating from a Previous Version :::::::::::::::::::::::::::::: 6 3.6 Starting MUIbase :::::::::::::::::::::::::::::::::::::::::::::: 6 3.7 Quitting MUIbase :::::::::::::::::::::::::::::::::::::::::::::: 7 3.8 Filename Conventions on Windows, Mac OS and Linux ::::::::: 7 4 Tutorial :::::::::::::::::::::::::::::::::::::::::: 9 4.1 How MUIbase Works ::::::::::::::::::::::::::::::::::::::::::: 9 4.2 Starting with a Project, the Structure Editor:::::::::::::::::::: 9 4.3 Adding a Table ::::::::::::::::::::::::::::::::::::::::::::::::: 9 4.4 Adding a Field :::::::::::::::::::::::::::::::::::::::::::::::: 10 4.5 Displaying the Project ::::::::::::::::::::::::::::::::::::::::: 10 4.6 Adding two Reference Fields::::::::::::::::::::::::::::::::::: 11 4.7 Adding Records ::::::::::::::::::::::::::::::::::::::::::::::: 12 4.8 Filter ::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 12 4.9 Queries:::::::::::::::::::::::::::::::::::::::::::::::::::::::: 13 4.10 Adding a Table with a Memo and a Button Field ::::::::::::: 13 4.11 Programming MUIbase to do a Pedigree :::::::::::::::::::::: 14 4.12 Programming MUIbase to List a Person's Children:::::::::::: 15 5 Basic Concepts ::::::::::::::::::::::::::::::::: 18 5.1 Projects ::::::::::::::::::::::::::::::::::::::::::::::::::::::: 18 5.2 Tables::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 18 5.3 Records ::::::::::::::::::::::::::::::::::::::::::::::::::::::: 19 5.4 Fields ::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 19 5.5 Field Types ::::::::::::::::::::::::::::::::::::::::::::::::::: 19 ii MUIbase Copyright c 2021 Steffen Gutmann 5.5.1 String Fields:::::::::::::::::::::::::::::::::::::::::::::: 19 5.5.2 Integer Fields::::::::::::::::::::::::::::::::::::::::::::: 20 5.5.3 Real Fields ::::::::::::::::::::::::::::::::::::::::::::::: 20 5.5.4 Boolean Fields:::::::::::::::::::::::::::::::::::::::::::: 20 5.5.5 Choice Fields ::::::::::::::::::::::::::::::::::::::::::::: 20 5.5.6 Date Fields ::::::::::::::::::::::::::::::::::::::::::::::: 20 5.5.7 Time Fields :::::::::::::::::::::::::::::::::::::::::::::: 20 5.5.8 Memo Fields ::::::::::::::::::::::::::::::::::::::::::::: 21 5.5.9 Reference Fields :::::::::::::::::::::::::::::::::::::::::: 21 5.5.10 Virtual Fields ::::::::::::::::::::::::::::::::::::::::::: 21 5.5.11 Buttons ::::::::::::::::::::::::::::::::::::::::::::::::: 21 5.6 Table of Field Types::::::::::::::::::::::::::::::::::::::::::: 21 5.7 Relationships :::::::::::::::::::::::::::::::::::::::::::::::::: 22 5.7.1 One to one Relationships ::::::::::::::::::::::::::::::::: 23 5.7.2 One to many Relationships ::::::::::::::::::::::::::::::: 23 5.7.3 Many to many Relationships :::::::::::::::::::::::::::::: 23 5.8 User Interface ::::::::::::::::::::::::::::::::::::::::::::::::: 25 5.8.1 Windows ::::::::::::::::::::::::::::::::::::::::::::::::: 25 5.8.2 Masks :::::::::::::::::::::::::::::::::::::::::::::::::::: 25 5.8.3 Panels :::::::::::::::::::::::::::::::::::::::::::::::::::: 26 5.8.4 Field Objects ::::::::::::::::::::::::::::::::::::::::::::: 26 5.8.5 Text Objects ::::::::::::::::::::::::::::::::::::::::::::: 26 5.8.6 Images ::::::::::::::::::::::::::::::::::::::::::::::::::: 26 5.8.7 Space Objects :::::::::::::::::::::::::::::::::::::::::::: 26 5.8.8 Groups ::::::::::::::::::::::::::::::::::::::::::::::::::: 26 5.8.9 Balance Objects :::::::::::::::::::::::::::::::::::::::::: 26 5.8.10 Register Groups ::::::::::::::::::::::::::::::::::::::::: 26 6 Managing Projects ::::::::::::::::::::::::::::: 27 6.1 File Format ::::::::::::::::::::::::::::::::::::::::::::::::::: 27 6.2 Info ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 28 6.3 New Project::::::::::::::::::::::::::::::::::::::::::::::::::: 28 6.4 Clear Project :::::::::::::::::::::::::::::::::::::::::::::::::: 28 6.5 Open Project:::::::::::::::::::::::::::::::::::::::::::::::::: 28 6.6 Save Project::::::::::::::::::::::::::::::::::::::::::::::::::: 28 6.7 Export as SQLite3 Database::::::::::::::::::::::::::::::::::: 29 6.8 Admin and User Mode :::::::::::::::::::::::::::::::::::::::: 29 6.9 Swap Records ::::::::::::::::::::::::::::::::::::::::::::::::: 30 6.10 Close Project::::::::::::::::::::::::::::::::::::::::::::::::: 30 7 Preferences ::::::::::::::::::::::::::::::::::::: 31 7.1 User Settings :::::::::::::::::::::::::::::::::::::::::::::::::: 31 7.1.1 Formats :::::::::::::::::::::::::::::::::::::::::::::::::: 31 7.1.2 External Editor::::::::::::::::::::::::::::::::::::::::::: 31 7.1.3 External Viewer :::::::::::::::::::::::::::::::::::::::::: 32 7.1.4 Extra Buttons in Tab Chain :::::::::::::::::::::::::::::: 32 7.1.5 Advance on Enter :::::::::::::::::::::::::::::::::::::::: 33 iii 7.1.6 Confirm Quit ::::::::::::::::::::::::::::::::::::::::::::: 33 7.1.7 MUI:::::::::::::::::::::::::::::::::::::::::::::::::::::: 33 7.2 Project Settings ::::::::::::::::::::::::::::::::::::::::::::::: 33 7.2.1 Record Memory :::::::::::::::::::::::::::::::::::::::::: 33 7.2.2 Confirm Delete Record ::::::::::::::::::::::::::::::::::: 34 7.2.3 Paths Relative to Project ::::::::::::::::::::::::::::::::: 34 7.2.4 Confirm Auto Reload ::::::::::::::::::::::::::::::::::::: 34 7.2.5 Confirm Save & Reorg :::::::::::::::::::::::::::::::::::: 34 7.2.6 Vacuum After Reorg:::::::::::::::::::::::::::::::::::::: 34 7.2.7 Program Source :::::::::::::::::::::::::::::::::::::::::: 35 7.2.8 Cleanup External Program Source :::::::::::::::::::::::: 35 7.2.9 Program Debug Information :::::::::::::::::::::::::::::: 35 7.2.10 Obsolete Functions :::::::::::::::::::::::::::::::::::::: 35 7.2.11 Sort Trigger Functions ::::::::::::::::::::::::::::::::::: 36 7.2.12 Program Include Directory :::::::::::::::::::::::::::::: 36 7.2.13 Program Output File :::::::::::::::::::::::::::::::::::: 36 7.3 Save as Default :::::::::::::::::::::::::::::::::::::::::::::::: 37 8 Log :::::::::::::::::::::::::::::::::::::::::::::: 38 8.1 Log Table ::::::::::::::::::::::::::::::::::::::::::::::::::::: 38 8.2 Activate Logging :::::::::::::::::::::::::::::::::::::::::::::: 38 8.3 Logging Mode ::::::::::::::::::::::::::::::::::::::::::::::::: 39 8.4 Set Log File ::::::::::::::::::::::::::::::::::::::::::::::::::: 39 8.5 Set Log Label ::::::::::::::::::::::::::::::::::::::::::::::::: 39 8.6 Import Log:::::::::::::::::::::::::::::::::::::::::::::::::::: 39 8.7 Export Log:::::::::::::::::::::::::::::::::::::::::::::::::::: 39 8.8 Clear Log ::::::::::::::::::::::::::::::::::::::::::::::::::::: 40 8.9 Apply Changes :::::::::::::::::::::::::::::::::::::::::::::::: 40 8.10 View Log :::::::::::::::::::::::::::::::::::::::::::::::::::: 40 9 Record-Editing ::::::::::::::::::::::::::::::::: 41 9.1 Active Object ::::::::::::::::::::::::::::::::::::::::::::::::: 41 9.2 Adding Records ::::::::::::::::::::::::::::::::::::::::::::::: 41 9.3 Changing Records ::::::::::::::::::::::::::::::::::::::::::::: 41 9.3.1 String Fields with Pop-up Button ::::::::::::::::::::::::: 41 9.3.2 Entering Integer Values ::::::::::::::::::::::::::::::::::: 42 9.3.3 Entering Boolean Values :::::::::::::::::::::::::::::::::: 42 9.3.4 Entering Choice Values ::::::::::::::::::::::::::::::::::: 42 9.3.5 Entering Date Values ::::::::::::::::::::::::::::::::::::: 42 9.3.6 Entering Time Values::::::::::::::::::::::::::::::::::::: 42 9.3.7 Memo Context Menu ::::::::::::::::::::::::::::::::::::: 42 9.3.8 Select-from-where List Context Menu ::::::::::::::::::::: 43 9.3.9 Entering Reference Values :::::::::::::::::::::::::::::::: 43 9.3.10 Entering NIL Value:::::::::::::::::::::::::::::::::::::: 43 9.4 Deleting Records :::::::::::::::::::::::::::::::::::::::::::::: 43 9.5 Browsing Records ::::::::::::::::::::::::::::::::::::::::::::: 44 9.6 View all Records :::::::::::::::::::::::::::::::::::::::::::::: 44 iv MUIbase Copyright c 2021 Steffen Gutmann 10 Filter::::::::::::::::::::::::::::::::::::::::::: 45 10.1 Record Filter::::::::::::::::::::::::::::::::::::::::::::::::: 45 10.1.1 Filter Expression :::::::::::::::::::::::::::::::::::::::: 45 10.1.2 Changing Filters::::::::::::::::::::::::::::::::::::::::: 45 10.1.3 Filter Examples ::::::::::::::::::::::::::::::::::::::::: 46 10.2 Reference Filter :::::::::::::::::::::::::::::::::::::::::::::: 46 11 Order :::::::::::::::::::::::::::::::::::::::::: 47 11.1 Empty Order::::::::::::::::::::::::::::::::::::::::::::::::: 47 11.2 Order by Fields ::::::::::::::::::::::::::::::::::::::::::::::