MacroHard's Minimalist Manual for BFI001 Project

Table of Contents:



MacroHard Minimalist Manual Development Team



Table of Contents:

    Ryan McKay

Functional Contents:

    Jason Archibald

Main Window:

    Soon Poh-Oon

Customer Information Interface:

    Ryan McKay

Order Information Interface:

    Jason Archibald

Product List Interface:

    Joon-Sae Park

Route List Interface:

    Chuck Pugh

Editor:

    Soon Poh-Oon

Final Editors:

    Elijh Ooi
    Premilla Jeyaraj

Screen Snapshots:

    Elijh Ooi
    Jeff Rouse

HTML:

    Ryan McKay
    Jason Archibald
    Jeff Rouse


Minimal Manual Functional Table of Contents:


Main Window


Open the Main Window:

  • When the application is opened, the window will be shown automatically to the users.

Go to the Administration Window:

  • The Administration button is disabled, this phase has NOT been developed and is reserved for future enhancement. In other words, the users cannot access this button, and when it is clicked nothing will happen.

Go to the Customer/Order Information Window:

  • Press the Customer/Order Information button.
  • The Customer Information Window will be opened, from there the Order Information Window can be invoked by pressing the New Order button or the Edit Order button.

Go to the Route List Window:

  • Press the Route List button.

Go to the Product List Window:

  • Press the Product List button.

Exit the Application:

  • Press the Exit button.
  • The application will be closed.


Order Information Window


Open the Order Information Window:

  • From the Customer Information window, select a customer according to the criteria outlined in the Customer Information Window pages found in the BFI001 User Manual.
  • Note: An order can only be placed if a customer has been previously specified.
  • Press the New Order button to open the Order Information window containing a predicted order for the customer that has been specified.
    OR
  • Select a previous order from the Order box near the bottom of the window by double clicking on the relevant order. Another way to accomplish this would be to select a previous order with only a single mouse click, and then click on the Edit Order button. This will open the Order Information Window, listing the information pertaining to the selected previous order.

View Previous Orders:

  • The Customer Information window is open. If it is not, please refer to material regarding the operation of the Customer Information window for further details.
  • Press Here to go to the Customer Information window section.
  • Select a customer according to the criteria outlined in the Customer Information window manual pages. Note: An order can only be viewed if a customer has been previously specified.
  • In the Orders table near the bottom of the Customer Information window list all of the previous and current orders pertaining to a customer previously located through a search.
  • Double click on any order that you wish to view.
    OR
  • Select an order you wish to view by clicking on it once with the mouse. Now press the Edit Order button.
  • The Order Information Window now appears, displaying the information contained within chosen order. Note: orders that have been delivered cannot be edited, except for the next-order date and the amount paid. Those that have not been delivered can be edited.

Place a new (predicted) Order:

  • Placing a new order (using the last order as a template)

From the Customer Information Window:

  • The Customer Information window is open. If it is not, please refer to material regarding the operation of the Customer Information window.
  • Press Here to go to the Customer Information window section.
  • Select a customer according to the criteria outlined in the Customer Information window manual pages. Note: An order can only be placed if a customer has been previously specified.
  • Press the New Order button.
  • The Order Information Window will open up, displaying the predicted order in the order form. The predicted order is based on the most recent order placed by the customer.

From the Order Information Window:

  • The Order Information window is open. If it is not, please see "OPEN THE ORDER INFORMATION WINDOW" section documented earlier.
  • Press the New Order button. Note: At this point, whatever information shown on the window is irrelevant, as we are going to create a new order based on the predicted information. Any changes that have been made on the window up to this point will be saved in the database.
  • A new form is now shown on the Order Information window, with its own unique Order Identification number. The Date Ordered Field, Company Name field, and ID# will be filled in automatically by the system, and will be linked to the customer specified earlier. The order form itself is filled in with the predicted information based on the last order placed by the customer.
  • Now you are set to fill in your new order with products. Please see the upcoming section "ADDING PRODUCTS TO AN ORDER" to accomplish this task.

Note:

  • As a new predicted order is created through one of the above methods, it is automatically saved in the database. To delete a predicted order, please see the section titled "DELETING AN ORDER".

Deleting an Order:

  • Press the Delete Order button.
  • A message will appear in a dialog box asking you to confirm if you would really like to delete the order or not.
  • If you are sure that you want the order completely deleted, click on the OK button. Note: When OK is pressed, the order is deleted permanently from the system.
  • Otherwise, click on the Cancel button, and you will be returned to the Order Information window without deleting the current order.

Print an Order:

  • The printing of an order is essentially the generation of an invoice listing all of the products contained in the order, as well as their quantities, prices, discounts and totals according to how they appear in the Order Information window.
  • Press the Print button.
  • The current order is generated in the form of an invoice through your printer.

Adding Products to an Order:

  • When the predicted order misses a product we need for the current order, we can add the product to the order.

Using Product List Window to Add Products:

  • Press the Product List button. This opens up the Product List window, displaying all of the products available.
  • Any products listed here can be added to the current order by double clicking with the mouse on the product to add. OR
  • Select the item to add with the mouse, and then press the Add to Order button. Items will be added to the order form on the Order Information window.

Entering Products Directly:

  • Select the next available (blank) Product Name field on the order form, and enter a valid product name.
    OR
  • Select the next available Product ID, and enter a valid product number. Note: It is important to enter only valid information in these fields. Otherwise the system will provide a dialogue box informing the user that some problem was found with the input.
  • The system fills in the remainder of the information related to the product across the current row in the order table.

Deleting Products From an Order:

  • Select an item from the order by clicking on it once with the mouse. Now it will appear in a highlighted state.
  • Press the Delete key on the keyboard to delete this item from the current order. The deletion will be confirmed, but if you make a deletion and change your mind, you can still cancel all changes to the order by clicking on the Cancel button.

Marking an Order as Delivered:

  • Press the Delivered Today button to indicate that the order was delivered today
    OR
  • Enter the date of delivery (which must be less than or equal to today's date).
  • After the order has been saved, it will no longer be possible to change order details (although the next-order date and the amount paid can still be modified). The user will be asked to confirm the delivery before the order is saved.

Setting Next Order Date:

  • When the Order Information window is first opened up on a new order, the Next Order Date field will be blank.
  • Enter a date of the format DD-MM-YY into the field
  • This order will then appear as a projected order on the Route List five days before the date entered. Note: This order will appear as a projected order only. If you wish to set an actual order, please see "PLACE A PREDICTED ORDER" documented above.
  • If no date is entered, the system will compute a date based on previous order information pertaining to the user. Note: it is important to enter the date in an acceptable format, otherwise the system will reject your entry. Did you enter a date greater than the current date?

Completing an Order:

  • Press the Done button.
  • The Order Information window will close, and all changes made to it will be saved in the database.

Canceling Changes Made to an Order:

  • Press the Cancel button.
  • This will close the window, and return all changes made to the state in which they existed when you initially opened the window.

Exit the Order Information Window:

  • Press the Done button.
  • The Order Information window will close, and all changes made to it will be saved in the database.

Obtaining On-line Help:

  • Press the Help button. This will bring up a help window containing information pertaining to this window.


Route List Window


Open the Route List Window:

  • From the Main window, click on the button labeled Route List
  • A new window will come up with all of the orders that have to be delivered on the current day. This list includes all of the orders that have to be delivered, and all of the prospective customers that must be visited on the current day.
  • The Route list is presented in the order in which all of the customers will be visited. For example, if John Doe from Toshiba appears first on the list, then he would be visited first on that day, by the salesperson.
  • The order information is summarized on this window, stating the Sector in which the Company is located, Order #, Company Name, Company ID, Company Contact's Name, Phone #, Type of visit, and whether the visit is still active (i.e. whether they will be in fact visited).

Exit the Route List Window:

  • To exit the window, move the mouse pointer on the window to the lower right hand side of the window to the Done button. Place the mouse pointer over top of the Done button and click the left mouse button.
  • The Route List Window will disappear and you will be returned to the Main window.

Edit a Customer's Information:

  • When a customer's information is incorrect, for example the company has relocated, and you wish to update their address, highlight that particular customer's name on the Route list with the mouse pointer
  • move the mouse pointer over top of that customer found on the list, and click the left mouse button, all of that line of the customer will be highlighted.
  • Then move the mouse pointer over top of the Edit Customer button and click the left mouse button. A new window will appear, The Customer Information Window, and the fields containing customer information can be edited.
  • Press Here to go to the Customer Information window section.

To Return From Customer Information Window to Route List Window:

  • Move the mouse pointer to the lower right hand side of the window to the Done button, click the left mouse button. The Customer Information window will disappear and you will be returned to the Route List window updated with all of the changes you made.

Remove/Replace a Customer Entry on the Route List:

  • The purpose of the Active field for each customer on the list is to prevent printing that customer's order if it is not desired by the salesperson. Initially upon entering the Route List Window for the first time on a particular day, all of the fields will be marked as active.
  • To toggle the Active field between active and inactive, simply move the mouse pointer over top of the particular customer you want to toggle, and click the left mouse button. The 'X' in the box will either appear or disappear.

Print the Route List:

  • Move the mouse pointer to the top left hand side of the Route List window, placing the pointer over top of the Print button, and click the left mouse button. A new window will appear called the Print Box, where you can specify exactly what to print.

Note:

  • The active field pertaining to each customer on the Route List Window is used to specify exactly what customers to print out. Initially, upon entering that window for the first time on a particular day, all of the Active fields will be marked with an 'X'. This means that all of the customers on the list are marked to be printed. To unmark a customer, simply move the mouse pointer to the corresponding Active field and click the mouse button. The 'X' will disappear and the Active box will be empty. Now that customer will not be printed out.

Problems - Troubleshooting:

  • THERE ARE NO CUSTOMERS ON THE ROUTE LIST
    • There are no customers to be visited that day.
  • THE EDIT CUSTOMER BUTTON DOES NOTHING
    • There is no customer highlighted to edit.
    • Solution: highlight the customer you wish to edit and then press the Edit Customer button.


Print Box Window


Cancel Printing:

  • If you do not wish to print out any thing at this time, then move the mouse pointer to the Cancel button at the bottom of the window and click the left mouse button. The Print Box will disappear and you will be returned to the Route List Window.

Select One of the Reports to be Printed:

  • If there is a check mark in the box at the left of the report's name, the report is already selected for printing.
  • Otherwise, move the mouse pointer to the check box at the left of the report's name and click in it with the left mouse button. This will put a check mark in that box. This means that the report is now marked for printing.

Note:

  • Multiple reports may be selected for printing in this way before the Done button is pressed.

Deselect one of the Reports to be Printed:

  • If there is no check mark in the box at the left of the report's name, the report is not selected for printing.
  • Otherwise, move the mouse pointer to the check box at the left of the report's name and click in it with the left mouse button. This will remove the check mark, and the report will not be printed.

To Print:

  • After all of the reports that you wish to print are selected, and the reports you do not want to print are deselected, then move the mouse pointer to the bottom of the window, over the Done button, and click the left mouse button. This will send all of the information to the printer, and the Print Box window will disappear and you will be returned to the Route List Window.

Problems - Troubleshooting:

  • NOTHING IS BEING PRINTED OUT AFTER PRESSING DONE.
    • There are no reports selected for printing.
      Solution: Select the desired reports you wish to print, then press the Done button.
  • ALL OF THE CUSTOMERS IN THE ROUTE LIST WINDOW ARE MARKED AS INACTIVE (NONE ARE APPEARING ON THE PRINTOUT).
      Solution: Return to the Route List Window by pressing the Cancel button and mark the customers you wish to print, then press the Print button.
  • THERE IS AN ERROR WITH THE PRINTING DEVICE.
      Solution: Correct the printing device problem and then try to print it again.


Product List Window


Open the Product List Window:

  • From the Main window, click on the button labeled Product List
  • A new window will come up with all the products currently being sold by BCI. Each line of the product list will contain a product name, a unique product id, a type identifier, and a price.

Exit the Product List Window:

  • To exit the window, press the Done button.
  • Exiting can also be accomplished by pressing the Cancel button. Although any added orders will be lost. (Refer to adding an order)
  • Exiting the window will return control to the calling window, which is either of the main window, or the order information window.

Obtaining On-line Help:

  • Press the Help button. This will bring up a help window with information pertaining to the product list.

Edit a Product:

  • This function cannot be done in salesman mode. This is reserved for administration mode.

Print the Product List

  • Press the Print button. A new window will appear called the Print Box, where you can specify the number of copies to be printed. The printed document will consist of what is currently in the product list. (The contents of the product list can be changed by doing a filter, which is described later.) Press Cancel or Done as appropriate.
  • Press Here to go to the Print Box window section.

Searching for a Particular Product:

  • Press the Search button. A new window will appear called the Search window, where you can specify search parameters. Enter the product id number or the product name in their respective fields. Press Done. The product list window will now have that product at the top of the product list. Pressing Cancel will remove the search window without any changes to the product list.

Filtering:

  • Press the Filter button. A new window will appear called the Filter window, where you can specify filter parameters, which will be used to modify the products that appear in the product list.
  • Choosing the types of products to appear in the list is done by moving the various types between the two type boxes with the left and right arrow buttons.
  • To remove a type click on a product type in the left list and then press the right arrow.
  • To add a type click on a product type in the right list and the press the left arrow.
  • Adding or removing all types can be accomplish by pressing the double left and double right arrows, respectively.
  • Choosing the price range can be done by choosing a minimum or maximum value, or both, and entering the values into the associated fields. When all the filters have been set, press Done, and the product list window will be updated with the new information. Canceling the filter operation can be done by pressing Cancel.

Adding a Product to an Order:

  • Adding an order is only enabled when the product list window has been entered via the order information window. To add a product to the current order, double click on a product, or single click on a product and then press Add to Order. Pressing Cancel will remove all the added orders from the current order.


Customer Information Window


Open the Customer Information Window:

  • From the Main window press the Customer/Order Information button. This will take you to the Customer Information window.

Searching for a Previously Created Customer:

  • Press the Search button on the top of the window. You will then be taken to the search window from which you can step through all the customers or you can enter the customer information in a list box and the system will complete the rest of the customer's name for you. You may search by the ID, Company Name, Contact Person or Phone Number,
  • When finished press the Ok button to return to the Customer Information window. The system will then display the selected customers information on the Customer Information window.

Creating a new Customer:

  • Press the New button on the on the top left hand side of the Customer Information window. The system will automatically save any changes to the current customer record and then clear the fields so you can enter the new customer.
  • When you exit the window by pressing the Done button the information will be saved.
    Or
  • When you choose another function of the Customer Information window, by pressing any other button, the information will be saved, with the exception of the Cancel, and Undo buttons.

Deleting a Customer:

  • With the customers information currently displayed on the Customer Information window press the Delete button at the top of the window and the information will be deleted.
  • Note: You will be brought to a dialog box asking you to confirm the deletion of the customer.

Print Customer Information:

  • To print the customer information simply press the Print button on the top of the Customer Information window.
  • You will then come to a dialog box asking you the format of the printout which you desire. They are:
    • Customer Information Report - shows all information about the customer except order information.
    • Customer Order Summary Report - show summary infomation about the customer and their most recent orders.
    • You are also able to select both for a complete report.
  • For information about the Print Box window press here .
  • Press Ok on the bottom of the Print Box window and the report will be printed.

Creating a New Order:

  • Select a customer by one of the means previously mentioned.
  • Press the New Order button.
  • You will be taken to the Order Information window where you can create a new order. Press Here to go to the section on the Order Information window.
  • When finished press the Done button on the Order Information Window and you will return to the Customer Information window.

Edit a Previously Created Order:

  • Select a customer whose order you wish to edit by a means previously mentioned.
  • Select the order from the order list.
  • Press the Edit Order button (or double-click on the selected order).
  • You will be taken to the Order Information window where you can edit a order. Press Here to go to the section on the Order Information window.
  • When finished press the Done button on the Order Information Window and you will return to the Customer Information window.

Canceling Changes Made to Customer Information:

  • Press the Cancel button.
  • This will close the window, and return all changes made to the state in which they existed when you initially opened the window.
    Or
  • To cancel changes without exiting the window press the Undo button. It will have the same effect as the Cancel button without exiting the window.

Obtaining Further On-Line Help:

  • Press the Help button. This will bring up a help window containg information pertaining to this window.

Exit the Customer Information Window:

  • When you are finished manking changes to the customers information press the Done button.
  • This will close the Customer Information window, and all changes made to it will be saved in the database.

Undoing changes to an entry field:

  • At any time, you can undo the changes made to the field you are currently in by pressing the key, or by selecting "Undo Current Field" from the Edit menu.


  • To go back to the start of this document press HERE.
  • To go to Customer Group #1's annotations for this document press HERE.
  • Press HERE to return to Supplier Group #1's Home Page.

Last updated 2 Apr 96
by Ryan McKay, Web Page coordinator for Supplier Group #1.