Search for a Borrower

Search for a Borrower

Interface Definitions

• Called by Remove Borrower and Update Borrower.
• Calls no other modules.

Inputs from the user:

• ID number of the person being sought
• Name of the person being sought
• Any Borrower information fields can be filled in. A list of all the possible matches appears on the bottom of the screen - the search is complete when only one match remains, or the Librarian selects a borrower from the match list.
• A radio button with the options "short" and "long", indicating the level of detail displayed for each match.

Outputs to the user:

If Successful:

• A list of all successful matches will be displayed. Level of detail will be according to their specification of "view all" or "stripped down".

If "long" was chosen, then all information in each matching borrower's record is displayed.

• Name
• Address
• Phone
• ID
• Books Borrowed
• Outstanding Fines

If "short" was chosen, only essential information from each match is displayed, i.e.:

• Name
• ID
• Outstanding fines

Data Abstractions

• Accesses the Borrower data store.

Design

• A dialog box with input for Name and ID, and a radio button allowing "short" or "long" listing of matches. Text-Boxes for all the possible data fields that can be entered, and a window on the bottom third of the screen to display all possible matches.

Sub-Modules

• None.

Error Handling

Search Unsuccessful:

• The list of matches would remain empty.

Syntax Errors in ID or name:

• User is informed of a syntax error.
• The proper format for data entry is explained. The user can then edit their old input and search again, or abort.

Imports

• Reads the Borrower data store.

Exports

• Does not export anything to other functions.
• Does not alter any data store.

Pseudocode/Visual Basic Code

Search for Borrower

search screen appears

if (cancel) then exit search
if (search) then
   if (id incorrect syntax) then 
	errorbox "Id number is of incorrect form.  It must be an integer."
	return to text box to be edited
   else (syntax is correct) then
	if (long version) then
		clear listbox
		if all search fields are empty then do not populate list box
		if (at least one search field is nonempty) then
			find all borrowers which match all of the nonempty fields
		end if
		if the search is successful then
			populate listbox with the name, address, phone, id, books  borrowed,outstanding fines displayed
				of each matching entry
		end if
		if the search is unsuccessful then
			listbox remains blank
		end if
	end if
	if (short version) then
		clear listbox
		if all search fields are empty then do not populate list box
		if (at least one search field is nonempty) then
			find all borrowers which match all of the nonempty fields
		end if
		if the search is successful then
			populate listbox with the name, id and outstanding fines 
				of each matching entry
		end if
		if the search is unsuccessful then
			listbox remains blank
		end if
	end if
   end if
end if

Back to the Borrower Functions Index