Probe House Software presents Probe House E x p e n s e M a n a g e r v 2 . 0 William Wong, Feb 1995 Probe House Software * Introduction * The Concept of PHEM * Installation * The Menu Bar * Transaction Report Generator * Account Report / Category Report Generator * Budget Report and Budget List * How to Find/Search for a particular transaction * Account List & Category List and Merge * Transaction Entry * The Report Toolbar * Calendar Window * Reindex, System Info and Configure Window * The GUI and Key shortcuts. * Creating a New Book. * Development, History, acknowledgement, address PHEM is freeware - you can freely use and distribute it. If you like it, please let me know as it is a booster for software developer. Donations and gifts are welcome. Introducting PHEM ================= The Probe House Expense Manager or PHEM is an application for the management of your daily expense. It can also be used as a limited home financial package. Some of the features are: DESKTOP * Fully supports the desktop, with 3D look and feel, * The graphical environment integrates the desktop and automates the way you work. * Multiple windows for reports and data entries. * Window icon style toolbar. * Iconification supported. * Hotkey shortcut for commnly used functions. TRANSACTIONS * Number of transactions limited only by memory available. * A maximum of 60 accounts and 60 categories giving a total of over 300 combinations. * Sort transactions by accounts, categories or date. * Calculate expense automatically in display windows. * Edit any transactions any time. * Search any transactions. GRAPHS * Pie and bar charts. * Graphs for account, categories and date groups. * Graphs are self-scaling to fit windows. REPORTS * All reports are generated by report generator. * Detailed transactions for specified date range, account type or category type. * Reports produced on-screen and can be printed or saved on disk. * Budget reports can be generated for any accounts and categories. GENERAL * On-line help with ST Guide. * Speedo GDOS support. * Can be freely distributed. * Mono and colour, ST/STe/Mega/TT and Falcon. The concept =========== Accounts are created for credit cards, petty cash and anything else that is major enough to be tracked. In general, money flows out from these so-called accounts. Next there are categories. These are used to categorise the type of expenditure. Examples are Lunch, Dinner, Petrol, Diskettes etc. In general, these are the stuff that money is used on. Actually the line between accounts and category in PHEM is blurred. There is no stopping from creating a Lunch account. However, by keeping the ccounts where money flows out from, a Budget can be kept. A transaction is when money flow out from an account for a particular category. In PHEM, the date, amount of money and an comment are attached to a transaction. The comment can be anything that descript the transaction further ( example: Petrol @ 1.10/gallon ). PHEM keeps the set of accounts, category and transaction as a book. It can then produce reports and charts of any accounts, category or transaction. This way the expense are tracked. A budget can be kept for any accounts and category. Budget are calculated in a monthly basis. The Budget Report shows how much is left in the allocation for that particular month. Installating PHEM ==================== 3 Easy Installation steps ------------------------- 1/ Just unlzh the archive into any directory. 2/ Move the PHEM.HYP hypertext help file to your hypertext directory. 3/ Double click on the PHEM icon to run it. Installing as a Application --------------------------- PHEM can be installed as an application for the .ACT files.In doing so you can run PHEM by double clicking on the .ACT file. Just make sure the default directory is the PHEM's home directory so that it can find the resource file. Installing as a desktop icon application ---------------------------------------- PHEM can be installed as a desktop icon. In doing so you can just drag a .ACT file on to it. Just make sure the default directory is the PHEM's home directory so that it can find the resource file. The Menu Bar ============ The menu bar consist of the following * PHEM for accessories and about. * File for file operations. * Report for reoprt and searching operations. * List for account, category and transactions operations. * Entry for entering transactions. * Special for other special operations. * PHEM Selecting this menu title gives access to the desk accessories and also the About dialog. * File selecting this menu title gives you access to Open Book - Read into memory an already created Book. Save Book - Save the book on to disk with the original name. Save as - Save the book on to disk, asking for a new name. File Info - Shows the name, creation and last modified date of the current file. A short description can also be entered in this dialog. Import - Any comma delimited text data file can be read in. The order of the data is critical, they are 1st: year eg 1994 2nd: month in months eg 1 ( for January ) 3rd: date 4th: the account name 5th: the category name 6th: the comment 7th: amount Example: 1994, 12, 8, Cash, Lunch, Soup, 1.65 Quit - You guessed it! Quits PHEM. * Report This dropdown menu provide access to the reporting tools. Transaction - Calls up the Transaction Report Generator. Account - Calls up the Account Report Generator. Category - Calls up the Category Report Generator. Budget - Displays the Budget Report. Find - Calls up the Find/Search Dialog. * List This dropdown menu provide access to the account manipulation tools. Account - Calls up the Account List. Category - Calls up the Category List. Budget - Displays the Budget List. Merge - Calls up the Merge Window for either account or category. * Entry This dropdown menu provide access to the transaction entry tool. Transaction - Calls up the Transaction Entry dialog. * Special System Info - Display information for the system. The memory indicates unfragmentated memory for the program to allocate. Calendar - Calls up the Calendar Window. Reindex - This sorts and reindex both the accounts and categories list to alphabetical order. Configuration - Calls up the Configure Window. Transaction Report Generator ============================ The Transaction report Generator determines the type of information and format that appears in the report. Accounts and categories selection Any accounts or categories can be selected to be included in the report. They are selected in the account and category box. - To scroll up or down the list, use the up and down arrow buttons. - To select an entry, click on it to hilite it. - To unselect a selected entry, click on it again. - To select all the entries, press on the ALL button. ( Note that ALL button will turn to a NONE button) - To unselect all, press on the NONE button. Sorting The report can be sorted by date, account or category. Chose by selecting the proper radio button. Date range The start and end of report date can be changed by clicking on the particular date. A Calendar Window will appear for the selection of the dates. Subtotal / Summary / Details This defines the type of report you want. If subtotal or summary is selected, the groupings will be according to the sorting method selected. Display button This will execute the form and the result will be displayed in the Reprt Window. Account / Category Report Generator =================================== The Account / Category report Generator will generate a subtotal report for the selected class type. Class entry selection Any accounts / categories can be selected to be included in the report. They are selected in the account and category box. - To scroll up or down the list, use the up and down arrow buttons. - To select an entry, click on it to hilite it. - To unselect a selected entry, click on it again. - To select all the entries, press on the ALL button. ( Note that ALL button will turn to a NONE button) - To unselect all, press on the NONE button. Date range The start and end of report date can be changed by clicking on the particular date. A Calendar Window will appear for the selection of the dates. Display button This will execute the form and the result will be displayed in the Reprt Window. Budget Report ============= The budget for four consequtive months are displayed in a window. The delta column shows the sum of the 4 months result. This gives a simple quarterly result of the budget. Any budget results that is negative will be printed out in red. The budget for a account or category for a particular month is calculate by subtrating from it's allocated amount, the expenses incurred on that account or category for that month. The allocated amount is entered via the Budget List tool. Changing month/year of the budget To change the month, click on the month popup button. To change the year, click on the year popup button. Filing The report can be filed to a disk by clicking on the disk icon. A fileselector will popup for the pathname. The report is saved in ASCII format. Printing The report can be printed out on to the printer by clicking on the printer icon. Find/Search ============ To find for a particular string in the comment field, use the Find dialog. The results of the find will display in a report window. Wildcards are used to match occurance of string. The * is to match a sequence of characters while the ? is to match a single character. e.g "abcdefghi" is the comment field *ghi will find the above field. ??c??f* will find the above field. *dh* will not find the above field. *def will not find the above field. Account / Category List ======================= The Account / Category window This window displays a list of all the entry in accounts or categories. Selecting an account / category entry To select a name to work on, click on the name. The entry will now be hilited. You can use one of the icon on the window toolbar on it. Selecting several entries to work on at one time is possible. Add icon (Keyboard shortcut - Insert key) Pressing this icon will insert a new entry into the list. A dialog for entering the new entry will appear. Delete icon (Keyboard shortcut - Delete key) Pressing this icon will delete the selected entries of the list. WARNING: Any transaction that reference this name will have it's name listed as "* UNKNOWN *" in the reports. Modify icon (Keyboard shortcut - Retrun key) Pressing this icon will modify the selected entries of the list. A dialog for modifying the entry will appear. Budget List =========== The budget list for four conseqcutive months are displayed in a window. Entering budget data To make an entry into the budget list for a particular account or category, double click on the line that account or category is on. A dialog will appear for entry of the 4 months. Modifying an entry To modify an entry into the budget list for a particular account or category, double click on the line that account or category is on. A dialog will appear for with data of the 4 months to be modified. Changing month/year of the budget To change the month, click on the month popup button. To change the year, click on the year popup button. A increment and decrement popup will appear. Filing The listing as displayed can be filed to a disk by clicking on the disk icon. A fileselector will popup for the pathname. The list is saved in ASCII format. Printing The list can be printed out on to the printer by clicking on the printer icon. Merging Accounts or categories ============================== This function is to facilitate the combining of different accounts together and the combining of different categories together. This may be neccesary because a name on the list may need to be deleted. Selecting the FROM entry Use the POPUP BUTTON to choose the name to combine from. Selecting the TO entry Use the POPUP BUTTON to choose the name to combine to. MERGE IT button This will move all transactions with the FROM name to the TO name. Transaction Entry ================= The transaction window allows entries of transactions into the book. The follwoing information is required: Account, Category, Date, and Amount. Entering a transaction 1/ Use the account POPUP BUTTON to select the correct account. 2/ Use the category POPUP BUTTON to select the correct category. 3/ Click on the date to select correct date via the Calendar Window. 4/ Enter the amount. 5/ Enter a comment ( this is optional ). 6/ Click the ADD button to add to the transaction list. The Modify Transaction Window is a Transaction Window without the recuring tickbox. Recuring entries For recuring entries, tick on the recuring tickbox. A recuring entry dialog will appear where the following info is required: The start date of the recurance via the Calendar Window. The end date of the recurance via the Calendar window. The frequency of the recurrance - daily, weekly or monthly. Report Window Toolbar ===================== Transactions that satisfy the criteria of Report Generator form are displayed in a Report window. The Report window contains a Toolbar. This Toolbar gives access to the Graph, Deleting, Exporting, Saving and Printing of the transactions displayed in the window. To enter a new transaction Keyboar short cut - Insert To select a transaction, just single click on it. Modifying a transaction 1/ Double click on the transaction to be modified. 2/ A modify window will appear, this window is exactly the same as a Transaction Entry window, it however does not have a recurring tickbox. 3/ Modify as required. 4/ Click on the MODIFY button to update the transaction. 5/ The Report window will be updated to reflect the changes. Deleting a transaction Keyboard shortcut - Delete 1/ Select the transacions to be deleted. 2/ Click on the DELETE icon, the window will be updated. 3/ A range of transaction can be selected and deleted in one step. WARNING: Deleting a transaction remove the transaction permanently. It cannot be recovered. Graphing the results Clicking on the Graph button will provide a graph for the transactions in the window. Both subtotal and summary results can be graphed. There is a choice between Bar Chart and a Pie Chart. Exporting the results The transactions of the Report window can be exported out in comma delimited format. The format is similar to Import format. Filing the result This files to disk the text of the window for use possibly in a word processor. Printing the result This will printout the text of the window on a printer connected to the printer port. Graphic Window ============== Well, this is the graphic window. You cannot do much about it, possibly GDOS printout capability in next release. Creating a New Book ==================== A new book can be created by starting up the program a fresh and begin entering the accounts, categories and entries. Once a book is loaded, a new book will not be able to be created. When this happens, just quit the current session and start up a new session. That was easy !! Calendar Window =============== This small window display the current month. To change the month, use the month POPUP button. To change the year, use the year POPUP button. An increment and decrement popup will appear. To set the date 1/ Select the desired date by single clicking on it. 2/ click on the button. or 1/ Double clicking on the desired date. NOTE: Only one date can be set at any one tine. Reindexing ========== This reindexes the transactions witn the accounts and categories entries. The account and category lists are also sorted by this command. System Info =========== Provides some information on the current system. The Configure Window ==================== This tool allows changing the colour and fills of the dialogs and the desktop. Changing any item will take effect immediately. If SpeedoGDOS is installed, the font and font size of the report windows can be changed. Ticking the "Print using GDOS" will output SpeedoGDOS fonts to the printer. Note that you must have previously installed a GDOS printer device driver. The GUI ======= PHEM uses an advance GUI for the ST/STE/TT and Falcon. The following tries to give an overview of the interface. Iconification All windows can be iconified in all TOS version. For those TOS which support iconification use the button for it. For other TOS, to iconify a window, click the RIGHT mouse button on the window title bar. Hot Keys Hot keys are keyboard shortcut for common functions. Menus: Hot keys are display at the end of the menu item. ^ means control eg ^S means control-S  means altrenate eg T means alternate-T Forms: Hot keys are highlited by colour and/or underlined. To activate press the Alternate key with the highlited character. Windows: The Account List, Category List have Hot keys (shortcuts) for the following: Insert = enter a new entry. Delete = removes the selected entries. Return = modify the selected entries. The Report Windows have the Hot keys (shortcuts) for the following: Delete = removes the selected entries. Window management Windows can be manipulated by hot keys. ESC : Maximise / restore size a window. Shift-ESC : Close a window that does not have edit fields in it. Shift-Tab : Iconify a window. Control-Tab: Cycle windows. Development, History, acknowledgement, address ============================================== This program was developed on a 4Mb Tos 2.05 Mega STE with 170Mb HDD. Currently I am using a TV, my monitor is back home. I am not shipping my monitor for this. So if the screen looks funny, please feedback to me. Software tools and package use: Program : Pure C, Pure Debugger and GUI provided by BIG 1.88. Hypertext: Pure C (editor), ST-Guide and HCP History Ver 1.0: Released to the public as freeware. Ver 2.0: Released to the public as freeware. - Budget capability. - SpeedoGDOS support. - Icons in toolbar. - Regroup menu items to be more logical. - Retouch some dialogs to improve functionality. - Configurable Look & Feel for desktop. - Fixed calendar completion dialog bug. Feedback Please send feedback of any types to: Internet : wongck@lobby.ti.com Mail : William Wong Blk 148, Potong Pasir Ave 1, #04-63, S(1335), Republic of Singapore. William Wong This address valid till 2600 Preston Road, April 1995 Apt 1009, Plano, Texas 75093 USA Acknowledgement Borland Germany for the excellent Pure C and Pure debugger. Claude Attard for the cool BIG libraries. Holger Weets for the great ST-Guide and HCP software. My students for the interpretation.