Section 2 Software Requirements Specification

Transcription

1 Inventory and Work Order Management System (IWOMS) Software Requirements Specification Peter C. Maroon December 1, 2000 Section 2 Software Requirements Specification Table of Contents Chapter 1 Introduction Purpose Scope of Project Glossary References Overview of Document... 4 Chapter 2 Overall Description System Environment Functional Requirements Definition Create Work Order View Work Order Print Work Order Close Work Order Edit Work Order Add Inventory Record Add Inventory Record Component View Inventory Record Edit Inventory Record Edit Inventory Record Component Transfer Inventory Record Component Delete Inventory Record Component Delete Inventory Record Copy Inventory Record Generate Work Order Statistics Report Generate Library Hours Report Generate Mileage Report Generate Network Address Report Generate Expired Warranty Report Generate Hardware Specifications Report User Interface Specification Non-Functional Requirements System Evolution Chapter 3 Requirements Specification External Interface Requirements... 18

2 3.2 Functional Requirements Create Work Order View Work Order Print Work Order Close Work Order Edit Work Order Add Inventory Record Add Inventory Record Component View Inventory Record Edit Inventory Record Edit Inventory Record Component Transfer Inventory Record Component Delete Inventory Record Component Delete Inventory Record Copy Inventory Record Generate Work Order Statistics Report Generate Library Hours Report Generate Mileage Report Generate Network Address Report Generate Expired Warranty Report Generate Hardware Specifications Report Detailed Non-Functional Requirements Appendix A: Sample User Interface Prototypes A.1 IWOMS Main Menu A.2 Work Orders Module Form A.3 Work Order Form A.4 Inventory Module Form A.5 Inventory Record Form A.6 Reports Module Form Index Chapter 1 Introduction Purpose This document is the software requirements specification. The software requirements specification document is a detailed description explaining exactly what the software is supposed to do and gives the user a general idea about how to use the software. The software requirements specification is designed to aid the user as well as the developer in better understanding the workings of the system Scope of Project The Inventory and Work Order Management System (IWOMS) will be developed for the employees of the Information Technologies (IT) Department at the Scranton Public Library. The Scranton Public Library is a member of the Lackawanna County Library System, which also

3 consists of the Abington Community Library, the Carbondale Public Library, the Dalton Community Library, the Interboro United Districts Library, the North Pocono Public Library, and the Taylor Public Library. The IT Department at the Scranton Public Library maintains a wide-area network with about 100 clients and provides technical support to all member libraries of the Lackawanna County Library System. The IT Department staff includes the Head of Information Technologies, two University of Scranton students, and a volunteer from The University of Scranton. The IT Department will use IWOMS in the following ways: to keep track of open and closed work orders, to maintain an inventory of all computer equipment used by the Lackawanna County Library System, and to generate reports related to work orders and inventory. This system will replace a commercial software package called Track It!. IWOMS will be a significant improvement over the system which is currently in production, a commercial software package called Blue Ocean Track It!. Track It! does not meet all of the needs of the IT Department. Since Track It! can only be run by one computer at a time, access to this software by IT Department staff members is limited. Also, Track It! has forms and fields which request unnecessary data, and it does not provide the ability to easily generate all needed reports. IWOMS will include features which will eliminate the inadequacies of Track It!. IWOMS will have the following system objectives: To make the IT Department employees more efficient by meeting their exact needs. To provide more relevant information about work orders and computer hardware inventory to decision-making personnel Glossary Term Action Form Inventory Component Inventory Module Window Inventory Record IT Staff Member IWOMS IWOMS Client Application IWOMS Database IWOMS Main Menu Managers Network Printer Definition A verb which describes the action to be performed in a work order A box that appears on a display screen to present information or request input Contains information pertaining to an item that is part of an inventory record The window that allows an IWOMS user to carry out functionalities related to inventory Contains information pertaining to a computer or device An employee of the Information Technologies Department at the Scranton Public Library Inventory and Work Order Management System, this system The portion of IWOMS responsible for displaying the user interface and processing application logic A database which stores information pertaining to work orders and inventory records The window that appears when the IWOMS client application is loaded; it gives access to IWOMS s three modules: work orders, inventory, and reports Managers at the Scranton Public Library; primarily, the Library Director and the Business Manager Any printer with network connectivity to which the IWOMS client

4 Object Reports Module Work Order Work Orders Module Window application can print A noun which describes on what an action is going to be performed in a work order The window that allows an IWOMS user to generate reports pertaining to work orders and inventory A description of a task which the Head of IT would like an IT Department staff member to perform The window that allows an IWOMS user to carry out functionalities related to work orders References Overview of Document The software requirements specification document contains several chapters that dissect and elaborate on aspects such as the functionality of the system, what is required for the system to run properly, how the system may change over time, and it gives the user a view, through prototypes, of how the system will look. Chapter 2 will be an overall description of the system. It will include the System Environment, which describes the relationship between the system, its components, and the external environment of the system, the Functional Requirements Definition, which provides a detailed overview of the services provided to the user, the User Interface Specification, which details how the user will interface with the system, the Non- Functional Requirements, which are constraints and standards, and the System Evolution, which identifies requirements that do not need to be implemented at this time. Chapter 3 will cover the Requirements Specification, which lists each functionality of the system in full detail, and the Detailed Non-Functional Requirements, which is a formal listing of the rest of the non-functional requirements. Chapter 2 Overall Description IWOMS will include three modules: a work order module, an inventory module, and a reports module. In this context, work orders are a description of a task which the Head of IT would like an IT Department staff member to perform. The work order module of IWOMS will have two main functionalities: (1) the Head of IT will be able to create work orders and assign them to the appropriate IT Department employee with a certain numbered priority level, and (2) the IT Department staff members will be able to view these work orders and indicate to the department head when the task is complete. The IWOMS inventory module will enable the IT Department to maintain an inventory of all IT-related hardware owned by the Lackawanna County Library System or one of its member libraries. The primary functionalities of the inventory module will be to allow the IT Department to add, edit, and remove inventory records. The reports module of IWOMS will provide information about work orders and the equipment inventory to facilitate the decision-making of appropriate personnel, upon request.

5 2.1 System Environment IWOMS Databas e Query/Maintain Datab ase Use System IWOMS Provide Reports IT Staff Mem ber Print Managers Network Printer (For explanations, see Section 1.3) 2.2 Functional Requirements Definition Create Work Order (For Use Case Realizations, see Design Document, section 5.1) Use Case: Create Work Order Diagram: IT Staff Member Create Work Order IWOMS Database Brief Description The use case Create Work Order is initiated by the Primary User to create a work order in IWOMS. Initial Step-By-Step Description Before this use case can be initiated, the Primary User has already run the IWOMS client application on the computer that he/she is using. 1. The Primary User selects Work Orders from the IWOMS Main Menu. 2. In the Work Orders Module window, the Primary User selects Create. 3. IWOMS prompts the Primary User for work order information. 4. When the Primary User finishes data entry, he/she selects Save on the form.

6 5. IWOMS inserts the work order into the work order list, which is ordered by priority number, on the Work Orders Module window. (For Full Functional Requirements Specification, see ) View Work Order (For Use Case Realizations, see Design Document, section 5.2) Use Case: View Work Order Diagram: IT Staff Mem ber View Work Order IWOMS Database Brief Description The use case View Work Order is initiated by the Primary User to view a work order in IWOMS. Initial Step-By-Step Description Before this use case can be initiated, the Primary User has already run the IWOMS client application on the computer that he/she is using and at least one work order exists. 1. The Primary User selects Work Orders from the IWOMS Main Menu. 2. In the Work Orders Module window, the Primary User selects a work order from a list. 3. The Primary User then selects View/Edit. 4. IWOMS displays information pertaining to the work order. 5. When the Primary User is finished viewing the work order, he/she selects Close on the form. (For Full Functional Requirements Specification, see ) Print Work Order (For Use Case Realizations, see Design Document, section 5.3) Use Case: Print Work Order Diagram: IT Staff Mem ber Print Work Order IWOMS Database Brief Description The use case Print Work Order is initiated by the Primary User to print a work order in IWOMS. Initial Step-By-Step Description Before this use case can be initiated, the Primary User has already run the IWOMS client application on the computer that he/she is using and at least one work order exists. 1. The Primary User selects Work Orders from the IWOMS Main Menu. 2. In the Work Orders Module window, the Primary User selects a work order from a list.

7 3. The Primary User then selects Print. 4. IWOMS prints information pertaining to the work order. (For Full Functional Requirements Specification, see ) Close Work Order (For Use Case Realizations, see Design Document, section 5.4) Use Case: Close Work Order Diagram: IT Staff Me m b er Close Work Order IWOMS Database Brief Description The use case Close Work Order is initiated by the Primary User to indicate that a work order in IWOMS has been completed. Initial Step-By-Step Description Before this use case can be initiated, the Primary User has already run the IWOMS client application on the computer that he/she is using and at least one work order exists. 1. The Primary User selects Work Orders from the IWOMS Main Menu. 2. In the Work Orders Module window, the Primary User selects a work order from a list. 3. The Primary User then selects View/Edit. 4. IWOMS displays information pertaining to the work order. 5. The Primary User changes the Status field to Closed. 6. The Primary User selects Save on the form. (For Full Functional Requirements Specification, see ) Edit Work Order (For Use Case Realizations, see Design Document, section 5.5) Use Case: Edit Work Order Diagram: IT Staf f Memb er Edit Work Order IWOMS Database Brief Description The use case Edit Work Order is initiated by the Primary User to modify information pertaining to a work order in IWOMS. Initial Step-By-Step Description Before this use case can be initiated, the Primary User has already run the IWOMS client application on the computer that he/she is using and at least one work order exists.

8 1. The Primary User selects Work Orders from the IWOMS Main Menu. 2. In the Work Orders Module window, the Primary User selects a work order from a list. 3. The Primary User then selects View/Edit. 4. IWOMS displays information pertaining to the work order. 5. The Primary User makes all necessary changes to the work order. 6. When the Primary User is finished modifying the work order, the Primary User selects Save on the form. (For Full Functional Requirements Specification, see ) Add Inventory Record (For Use Case Realizations, see Design Document, section 5.6) Use Case: Add Inventory Record Diagram: IT Staff Member Add Inventory Record IWOMS Database Brief Description The use case Add Inventory Record is initiated by the Primary User to add a new inventory record in IWOMS. Initial Step-By-Step Description Before this use case can be initiated, the Primary User has already run the IWOMS client application on the computer that he/she is using. 1. The Primary User selects Inventory from the IWOMS Main Menu. 2. In the Inventory Module window, the Primary User selects Add. 3. IWOMS prompts the Primary User for inventory information. 4. When the Primary User finishes data entry, he/she selects Save on the form. 5. IWOMS inserts the inventory record into the inventory list, which is sorted by computer/device name in ascending order, on the Inventory Module window. (For Full Functional Requirements Specification, see ) Add Inventory Record Component (For Use Case Realizations, see Design Document, section 5.7) Use Case: Add Inventory Record Component Diagram:

9 IT Staff Member Add Inventory Record Component IWOMS Database Brief Description The use case Add Inventory Record Component is initiated by the Primary User to add a component to an inventory record in IWOMS. Initial Step-By-Step Description Before this use case can be initiated, the Primary User has already run the IWOMS client application on the computer that he/she is using and at least one inventory record exists. 1. The Primary User selects Inventory from the IWOMS Main Menu. 2. In the Inventory Module window, the Primary User selects an inventory record from a list. 3. The Primary User then selects View/Edit. 4. IWOMS displays a form with the inventory record s information. 5. On the form, the Primary User selects Add Component. 6. IWOMS prompts the Primary User for component information. 7. When the Primary User finishes data entry, he/she selects Save on the form. 8. IWOMS inserts the component into the component list, which is sorted by component name in ascending order, on the inventory record s form. (For Full Functional Requirements Specification, see ) View Inventory Record (For Use Case Realizations, see Design Document, section 5.8) Use Case: View Inventory Record Diagram: IT Staff Mem ber View Inventory Record IWOMS Databas e Brief Description The use case View Inventory Record is initiated by the Primary User to view an inventory record in IWOMS. Initial Step-By-Step Description Before this use case can be initiated, the Primary User has already run the IWOMS client application on the computer that he/she is using and at least one inventory record exists. 1. The Primary User selects Inventory from the IWOMS Main Menu. 2. In the Inventory Module window, the Primary User selects an inventory record from a list.

10 3. The Primary User then selects View/Edit. 4. IWOMS displays the inventory record s information. 5. When the Primary User is finished viewing the inventory record, he/she selects Close on the form. (For Full Functional Requirements Specification, see ) Edit Inventory Record (For Use Case Realizations, see Design Document, section 5.9) Use Case: Edit Inventory Record Diagram: IT Staff Member Edit Inventory Record IWOMS Database Brief Description The use case Edit Inventory Record is initiated by the Primary User to change an inventory record s information in IWOMS. Initial Step-By-Step Description Before this use case can be initiated, the Primary User has already run the IWOMS client application on the computer that he/she is using and at least one inventory record exists. 1. The Primary User selects Inventory from the IWOMS Main Menu. 2. In the Inventory Module window, the Primary User selects an inventory record from a list. 3. The Primary User then selects View/Edit. 4. IWOMS displays the inventory record s information. 5. The Primary User makes all necessary changes to the inventory record. 6. When the Primary User is finished modifying the inventory record, the Primary User selects Save on the form. (For Full Functional Requirements Specification, see ) Edit Inventory Record Component (For Use Case Realizations, see Design Document, section 5.10) Use Case: Edit Inventory Record Component Diagram: IT Staff Member Edit Inventory Record Component IWOMS Database

11 Brief Description The use case Edit Inventory Record Component is initiated by the Primary User to change the information for an inventory record s component in IWOMS. Initial Step-By-Step Description Before this use case can be initiated, the Primary User has already run the IWOMS client application on the computer that he/she is using and at least one inventory record exists with at least one component. 1. The Primary User selects Inventory from the IWOMS Main Menu. 2. In the Inventory Module window, the Primary User selects an inventory record from a list. 3. The Primary User then selects View/Edit. 4. IWOMS displays the inventory record s information. 5. On the form, the Primary User selects a component. 6. The Primary User then selects View/Edit Component. 7. IWOMS displays the component information. 8. The Primary User makes all necessary changes to the component information. 9. When the Primary User is finished modifying the component information, the Primary User selects Save on the form. (For Full Functional Requirements Specification, see ) Transfer Inventory Record Component (For Use Case Realizations, see Design Document, section 5.11) Use Case: Transfer Inventory Record Component Diagram: IT Staff Member Transfer Inventory Record Component IWOMS Database Brief Description The use case Transfer Inventory Record Component is initiated by the Primary User to move an inventory record s component to another inventory record in IWOMS. Initial Step-By-Step Description Before this use case can be initiated, the Primary User has already run the IWOMS client application on the computer that he/she is using and at least one inventory record exists with at least one component. 1. The Primary User selects Inventory from the IWOMS Main Menu. 2. In the Inventory Module window, the Primary User selects an inventory record from a list. 3. The Primary User then selects View/Edit. 4. IWOMS displays the inventory record s information. 5. On the form, the Primary User selects a component. 6. The Primary User then selects Transfer Component.

12 7. IWOMS prompts the Primary User for the computer/device name to which the component will be transferred. 8. IWOMS inserts the component into the component list of the inventory record of both the computer/device where the component did reside and the computer/device to which the component was transferred. (For Full Functional Requirements Specification, see ) Delete Inventory Record Component (For Use Case Realizations, see Design Document, section 5.12) Use Case: Delete Inventory Record Component Diagram: IT Staff Member Delete Inventory Record Component IWOMS Database Brief Description The use case Delete Inventory Record Component is initiated by the Primary User to remove an inventory record s component from IWOMS. Initial Step-By-Step Description Before this use case can be initiated, the Primary User has already run the IWOMS client application on the computer that he/she is using and at least one inventory record exists with at least one component. 1. The Primary User selects Inventory from the IWOMS Main Menu. 2. In the Inventory Module window, the Primary User selects an inventory record from a list. 3. The Primary User then selects View/Edit. 4. IWOMS displays the inventory record s information. 5. On the form, the Primary User selects a component. 6. The Primary User then selects Delete Component. 7. IWOMS removes the component from the component list of the inventory record. (For Full Functional Requirements Specification, see ) Delete Inventory Record (For Use Case Realizations, see Design Document, section 5.13) Use Case: Delete Inventory Record Diagram:

13 IT Staff Me m ber Delete Inventory Record IWOMS Databas e Brief Description The use case Delete Inventory Record is initiated by the Primary User to remove an inventory record from IWOMS. Initial Step-By-Step Description Before this use case can be initiated, the Primary User has already run the IWOMS client application on the computer that he/she is using and at least one inventory record exists. 1. The Primary User selects Inventory from the IWOMS Main Menu. 2. In the Inventory Module window, the Primary User selects an inventory record from a list. 3. The Primary User then selects Delete. 4. IWOMS confirms the removal of this inventory record. 5. IWOMS removes the inventory record. (For Full Functional Requirements Specification, see ) Copy Inventory Record (For Use Case Realizations, see Design Document, section 5.14) Use Case: Copy Inventory Record Diagram: IT Staff Member Copy Inventory Record IWOMS Database Brief Description The use case Copy Inventory Record is initiated by the Primary User to create a copy of an inventory record in IWOMS. Initial Step-By-Step Description Before this use case can be initiated, the Primary User has already run the IWOMS client application on the computer that he/she is using and at least one inventory record exists. 1. The Primary User selects Inventory from the IWOMS Main Menu. 2. In the Inventory Module window, the Primary User selects an inventory record from a list. 3. The Primary User then selects Copy. 4. IWOMS prompts the user for the inventory tag number and name of the computer/device of the new inventory record.

14 5. IWOMS creates the new inventory record and copies the information from the old inventory record to the new one. 6. IWOMS inserts the inventory record into the inventory list, which is sorted by computer/device name in ascending order, on the Inventory Module window. (For Full Functional Requirements Specification, see ) Generate Work Order Statistics Report (For Use Case Realizations, see Design Document, section 5.15) Use Case: Generate Work Order Statistics Report Diagram: IT Staff Mem ber Generate Work Order Statistics Report IWOMS Database Brief Description The use case Generate Work Order Statistics Report is initiated by the Primary User to create a report pertaining to various work order statistics. Initial Step-By-Step Description Before this use case can be initiated, the Primary User has already run the IWOMS client application on the computer that he/she is using and at least one work order exists. 1. The Primary User selects Reports from the IWOMS Main Menu. 2. In the Reports Module window, the Primary User selects Work Order Statistics Report. 3. IWOMS displays a report consisting of the amount of work orders completed by each IT Department staff member, the amount of work orders completed per computer/device, the amount of work orders completed per each resolution type, and the amount of work orders involving each action, each object, or each combination of an action and an object. 4. When the Primary User is finished viewing the report, he/she selects Close on the report. (For Full Functional Requirements Specification, see ) Generate Library Hours Report (For Use Case Realizations, see Design Document, section 5.16) Use Case: Generate Library Hours Report Diagram: IT Staff Mem ber Generate Library Hours Report IWOMS Databas e Brief Description The use case Generate Library Hours Report is initiated by the Primary User to create a report of the amount of hours that the IT Department devoted to each remote library.

15 Initial Step-By-Step Description Before this use case can be initiated, the Primary User has already run the IWOMS client application on the computer that he/she is using and at least one work order pertaining to a remote library exists. 1. The Primary User selects Reports from the IWOMS Main Menu. 2. In the Reports Module window, the Primary User selects Library Hours Report. 3. IWOMS displays a report which gives a list of the number of hours that the IT Department devoted to each remote library. 4. When the Primary User is finished viewing the report, he/she selects Close on the report. (For Full Functional Requirements Specification, see ) Generate Mileage Report (For Use Case Realizations, see Design Document, section 5.17) Use Case: Generate Mileage Report Diagram: IT Staff Member Generate Mileage Report IWOMS Databas e Brief Description The use case Generate Mileage Report is initiated by the Primary User to create a report of the total number of miles for work-related travel that each IT Department staff member has. Initial Step-By-Step Description Before this use case can be initiated, the Primary User has already run the IWOMS client application on the computer that he/she is using and at least one work order pertaining to a remote library exists. 1. The Primary User selects Reports from the IWOMS Main Menu. 2. In the Reports Module window, the Primary User selects Mileage Report. 3. IWOMS displays a report listing the date, the number of miles, and the library visited for each trip and the total number of miles for work-related travel that each IT Department staff member has and a grand total of the number of miles that the IT Department, as a whole, traveled. 4. When the Primary User is finished viewing the report, he/she selects Close on the report. (For Full Functional Requirements Specification, see ) Generate Network Address Report (For Use Case Realizations, see Design Document, section 5.18) Use Case: Generate Network Address Report Diagram:

16 IT Staff Me m ber Generate Network Address Report IWOMS Databas e Brief Description The use case Generate Network Address Report is initiated by the Primary User to create a report of network address information for each computer/device. Initial Step-By-Step Description Before this use case can be initiated, the Primary User has already run the IWOMS client application on the computer that he/she is using and at least one inventory record pertaining to a networked computer/device exists. 1. The Primary User selects Reports from the IWOMS Main Menu. 2. In the Reports Module window, the Primary User selects Network Address Report. 3. IWOMS displays a report consisting of the following, if applicable: computer/device name, network drop location, switch/hub port number, and IP address. 4. When the Primary User is finished viewing the report, he/she selects Close on the report. (For Full Functional Requirements Specification, see ) Generate Expired Warranty Report (For Use Case Realizations, see Design Document, section 5.19) Use Case: Generate Expired Warranty Report Diagram: IT Staff Member Generate Expired Warranty Report IWOMS Databas e Brief Description The use case Generate Expired Warranty Report is initiated by the Primary User to create a report that indicates when the warranty for each computer/device will expire. Initial Step-By-Step Description Before this use case can be initiated, the Primary User has already run the IWOMS client application on the computer that he/she is using and at least one inventory record exists. 1. The Primary User selects Reports from the IWOMS Main Menu. 2. In the Reports Module window, the Primary User selects Expired Warranty Report. 3. IWOMS displays a report listing each computer/device and its warranty expiration in ascending order by date and then by computer/device name. 4. When the Primary User is finished viewing the report, he/she selects Close on the report. (For Full Functional Requirements Specification, see )

17 Generate Hardware Specifications Report (For Use Case Realizations, see Design Document, section 5.20) Use Case: Generate Hardware Specifications Report Diagram: IT Staff Mem ber Genera te Hardware Sp ecifications Report IWOMS Databas e Brief Description The use case Generate Hardware Specifications Report is initiated by the Primary User to create a report of the hardware specifications for each computer/device. Initial Step-By-Step Description Before this use case can be initiated, the Primary User has already run the IWOMS client application on the computer that he/she is using and at least one inventory record pertaining to a computer/device exists. 1. The Primary User selects Reports from the IWOMS Main Menu. 2. In the Reports Module window, the Primary User selects Hardware Specifications Report. 3. IWOMS displays a report indicating the hardware specifications for each computer/device. 4. When the Primary User is finished viewing the report, he/she selects Close on the report. (For Full Functional Requirements Specification, see ) 2.3 User Interface Specification The primary users of IWOMS will be the personnel of the IT Department. The IWOMS client will only require the users to be familiar with the features of a basic Windows application. Since the IT Department staff use many different Windows applications in their job tasks, this requirement will not be a problem. Also, before being hired to work in the IT Department, an employee must already posses experience using Windows applications. There will be two different classes of users, IT Department staff and managers. IT Department staff members will access IWOMS directly via its client application. The IWOMS client application will consist of forms, buttons, text boxes, drop-down lists, radio buttons, message boxes, dialog boxes, and other common Windows features (See Appendix A: Sample User Interface Prototypes). Drop-down lists will facilitate data entry and lessen the likelihood of data entry errors. Users will have the ability to add items to drop-down lists by typing into the drop-down list s text box. Except for the Head of the IT Department, managers will not access the system directly. A manager will request a report from the IT Department and an IT Department employee will then use IWOMS to generate and print that report and give it to the manager. The reports will be properly formatted and organized, and they will be in an appropriate order.

18 IWOMS will display an error message when it detects that input to a field is invalid. It will display a message box indicating which fields are invalid. This will assist a user in correcting his/her mistakes and will prevent the GIGO (garbage in, garbage out) effect. 2.4 Non-Functional Requirements A computer running the IWOMS client application must have one of the following operating systems installed on it: Microsoft Windows 9x, NT 4.0, or 2000 Professional. The server portion of IWOMS requires that the Microsoft SQL Server 7.0 database management system be installed on a server running Microsoft Windows NT Server System Evolution Eventually, the Head of the IT Department would like IWOMS to be Web-based. Staff would be able to submit a work order via a Web form. Upon submission, IWOMS would create the work order and send an notification to the Head of the IT Department. He would then access the work order in IWOMS, revise its description, if necessary, and assign a priority number and an IT Department staff member to it. Also, if IWOMS was Web-based, IT Department staff could access IWOMS remotely, and managers could easily access the Reports Module in IWOMS. 3.1 External Interface Requirements. 3.2 Functional Requirements Chapter 3 Requirements Specification Create Work Order Use Case Name Create Work Order Priority Essential Trigger Precondition IWOMS is loaded. Basic Path The Primary User left-clicks on the Work Orders button on the IWOMS Main Menu IWOMS displays the Work Orders Module window In the Work Orders Module window, the Primary User left-clicks on the Create button IWOMS displays a form called Work Order requesting the Primary User to input work order information When the Primary User finishes data entry, he/she left-clicks on the Save button on the Work Order form IWOMS adds this work order information to the database IWOMS refreshes the work order list on the Work

19 Alternative Paths Postcondition Exception Paths Orders Module window to include this new work order IWOMS returns the Primary User to the Work Orders Module window. In Step 4, if the Primary User does not want to create a work order, he/she left-clicks on the Cancel button. IWOMS returns him/her to the Work Orders Module window. The new work order is added to the database. If the input to a field(s) on the Work Order form is invalid, when the Primary User left-clicks on the Save button (Step 5), IWOMS displays a message box with an error message indicating which field(s) are invalid, and upon the Primary User left-clicking on the Close button on the message box, he/she continues with Step 4 in the Basic Path. Other (For Functional Requirements Definition, see 2.2.1) Use Case Name Priority Trigger Precondition View Work Order View Work Order Essential IWOMS is loaded and at least one work order must exist in the database. Basic Path The Primary User left-clicks on the Work Orders button on the IWOMS Main Menu IWOMS displays the Work Orders Module window In the Work Orders Module window, the Primary User left-clicks on an entry for a work order in the work order list The Primary User then left-clicks on the View/Edit button IWOMS displays a form called Work Order with information pertaining to the work order When the Primary User is finished viewing the work order, he/she left-clicks on the Close button on the Work Order form IWOMS returns the Primary User to the Work Orders Module window. Alternative Paths Prior to Step 3, if the Primary User would like to view a closed work order, he/she left-clicks on the Closed radio button. IWOMS then displays only closed work orders. He/she continues with Step 3. In Step 3, prior to selecting a work order, the Primary User leftclicks on the Filter button, in the subsequent dialog box, selects an IT Department staff member from a drop-down list, and leftclicks on OK. IWOMS then displays only the work orders

20 pertaining to that staff member in the work order list. Postcondition Exception Paths Other (For Functional Requirements Definition, see 2.2.2) Use Case Name Priority Trigger Precondition Print Work Order Print Work Order Desired IWOMS is loaded and at least one work order must exist in the database. Basic Path The Primary User left-clicks on the Work Orders button on the IWOMS Main Menu IWOMS displays the Work Orders Module window In the Work Orders Module window, the Primary User left-clicks on an entry for a work order in the work order list The Primary User then left-clicks on the Print button IWOMS sends a print job with information pertaining to the work order to the network printer. Alternative Paths In Step 3, prior to selecting a work order, the Primary User leftclicks on the Filter button, in the subsequent dialog box, selects an IT Department staff member from a drop-down list, and leftclicks on OK. IWOMS then displays only the work orders pertaining to that staff member in the work order list. Postcondition The work order information is printed. Exception Paths Other (For Functional Requirements Definition, see 2.2.3) Use Case Name Priority Trigger Precondition Close Work Order Close Work Order Essential IWOMS is loaded and at least one work order must exist in the database. Basic Path The Primary User left-clicks on the Work Orders button on the IWOMS Main Menu IWOMS displays the Work Orders Module window In the Work Orders Module window, the Primary User left-clicks on an entry for a work order in the work order list The Primary User then left-clicks on the View/Edit button IWOMS displays a form called Work Order with

21 Alternative Paths information pertaining to the work order The Primary User selects Closed from a drop-down list in the Status field The Primary User left-clicks on the Save button on the Work Order form IWOMS updates this work order in the database IWOMS refreshes the work order list on the Work Orders Module window to exclude this closed work order IWOMS returns the Primary User to the Work Orders Module window. In Step 3, prior to selecting a work order, the Primary User leftclicks on the Filter button, in the subsequent dialog box, selects an IT Department staff member from a drop-down list, and leftclicks on OK. IWOMS then displays only the work orders pertaining to that staff member in the work order list. In Step 5, if the Primary User does not want to close a work order, he/she left-clicks on the Cancel button. IWOMS returns him/her to the Work Orders Module window. Postcondition The work order is updated in the database. Exception Paths Other (For Functional Requirements Definition, see 2.2.4) Use Case Name Priority Trigger Precondition Edit Work Order Edit Work Order Desired IWOMS is loaded and at least one work order must exist in the database. Basic Path The Primary User left-clicks on the Work Orders button on the IWOMS Main Menu IWOMS displays the Work Orders Module window In the Work Orders Module window, the Primary User left-clicks on an entry for a work order in the work order list The Primary User then left-clicks on the View/Edit button IWOMS displays a form called Work Order with information pertaining to the work order The Primary User modifies all of the fields that he/she needs to The Primary User left-clicks on the Save button on the Work Order form IWOMS updates this work order in the database.

22 Alternative Paths IWOMS returns the Primary User to the Work Orders Module window. In Step 3, prior to selecting a work order, the Primary User leftclicks on the Filter button, in the subsequent dialog box, selects an IT Department staff member from a drop-down list, and leftclicks on OK. IWOMS then displays only the work orders pertaining to that staff member in the work order list. Postcondition Exception Paths In Step 5, if the Primary User does not want to edit a work order, he/she left-clicks on the Cancel button. IWOMS returns him/her to the Work Orders Module window. The work order is updated in the database. If the input to an edited field(s) on the Work Order form is invalid, when the Primary User left-clicks on the Save button (Step 7), IWOMS displays a message box with an error message indicating which field(s) are invalid, and upon the Primary User left-clicking on the Close button on the message box, he/she continues with Step 5 in the Basic Path. Other (For Functional Requirements Definition, see 2.2.5) Add Inventory Record Use Case Name Add Inventory Record Priority Essential Trigger Precondition IWOMS is loaded. Basic Path The Primary User left-clicks on the Inventory button on the IWOMS Main Menu IWOMS displays the Inventory Module window In the Inventory Module window, the Primary User left-clicks on the Add button IWOMS displays a form called Inventory Record requesting the Primary User to input inventory information When the Primary User finishes data entry, he/she left-clicks on the Save button on the Inventory form IWOMS adds this inventory information to the database IWOMS refreshes the inventory list on the Inventory Module window to include this new inventory record IWOMS returns the Primary User to the Inventory Module window. Alternative Paths In Step 4, if the Primary User does not want to create an inventory record, he/she left-clicks on the Cancel button. IWOMS returns him/her to the Inventory Module window. Postcondition The new inventory record is added to the database.

23 Exception Paths If the input to a field(s) on the Inventory Record form is invalid, when the Primary User left-clicks on the Save button (Step 5), IWOMS displays a message box with an error message indicating which field(s) are invalid, and upon the Primary User left-clicking on the Close button on the message box, he/she continues with Step 4 in the Basic Path. Other (For Functional Requirements Definition, see 2.2.6) Use Case Name Priority Trigger Precondition Add Inventory Record Component Add Inventory Record Component Essential IWOMS is loaded and at least one inventory record must exist in the database. Basic Path The Primary User left-clicks on the Inventory button on the IWOMS Main Menu IWOMS displays the Inventory Module window In the Inventory Module window, the Primary User left-clicks on an entry for an inventory record in the inventory list The Primary User then left-clicks on the View/Edit button IWOMS displays a form called Inventory Record with the inventory record s information The Primary User left-clicks on the Add Component button IWOMS displays a form called Inventory Record Component requesting the Primary User to input inventory record component information When the Primary User finishes data entry, he/she left-clicks on the Save button on the Inventory Record Component form IWOMS adds this inventory record component information to the database IWOMS refreshes the component list on the Inventory Record form to include this new component IWOMS returns the Primary User to the Inventory Record form. Alternative Paths Postcondition Exception Paths In Step 7, if the Primary User does not want to add an inventory record component, he/she left-clicks on the Cancel button. IWOMS returns him/her to the Inventory Record form. The new inventory record component is added to the database. If the input to a field(s) on the Inventory Record Component form is invalid, when the Primary User left-clicks on the Save button (Step 8), IWOMS displays a message box with an error

24 message indicating which field(s) are invalid, and upon the Primary User left-clicking on the Close button on the message box, he/she continues with Step 7 in the Basic Path. Other (For Functional Requirements Definition, see 2.2.7) Use Case Name Priority Trigger Precondition View Inventory Record View Inventory Record Essential IWOMS is loaded and at least one inventory record must exist in the database. Basic Path The Primary User left-clicks on the Inventory button on the IWOMS Main Menu IWOMS displays the Inventory Module window In the Inventory Module window, the Primary User left-clicks on an entry for an inventory record in the inventory list The Primary User then left-clicks on the View/Edit button IWOMS displays a form called Inventory Record with the inventory record s information When the Primary User is finished viewing the inventory record, he/she left-clicks on the Close button on the Inventory Record form IWOMS returns the Primary User to the Inventory Module window. Alternative Paths Postcondition Exception Paths Other (For Functional Requirements Definition, see 2.2.8) Use Case Name Priority Trigger Precondition Edit Inventory Record Edit Inventory Record Essential IWOMS is loaded and at least one inventory record must exist in the database. Basic Path The Primary User left-clicks on the Inventory button on the IWOMS Main Menu IWOMS displays the Inventory Module window In the Inventory Module window, the Primary User left-clicks on an entry for an inventory record in the inventory list The Primary User then left-clicks on the View/Edit

25 Alternative Paths Postcondition Exception Paths button IWOMS displays a form called Inventory Record with the inventory record s information The Primary User modifies all of the fields that he/she needs to The Primary User left-clicks on the Save button on the Inventory Record form IWOMS updates this inventory record in the database IWOMS returns the Primary User to the Inventory Module window. In Step 5, if the Primary User does not want to edit an inventory record, he/she left-clicks on the Cancel button. IWOMS returns him/her to the Inventory Module window. The inventory record is updated in the database. If the input to an edited field(s) on the Inventory Record form is invalid, when the Primary User left-clicks on the Save button (Step 7), IWOMS displays a message box with an error message indicating which field(s) are invalid, and upon the Primary User left-clicking on the Close button on the message box, he/she continues with Step 5 in the Basic Path. Other (For Functional Requirements Definition, see 2.2.9) Use Case Name Priority Trigger Precondition Edit Inventory Record Component Edit Inventory Record Component Essential IWOMS is loaded and at least one inventory record with at least one component must exist in the database. Basic Path The Primary User left-clicks on the Inventory button on the IWOMS Main Menu IWOMS displays the Inventory Module window In the Inventory Module window, the Primary User left-clicks on an entry for an inventory record in the inventory list The Primary User then left-clicks on the View/Edit button IWOMS displays a form called Inventory Record with the inventory record s information The Primary User left-clicks on an entry for a component in the component list The Primary User then left-clicks on the View/Edit Component button IWOMS displays a form called Inventory Record Component with inventory record component

26 Alternative Paths Postcondition Exception Paths information The Primary User modifies all of the fields that he/she needs to The Primary User left-clicks on the Save button on the Inventory Record Component form IWOMS updates this inventory record component information in the database IWOMS refreshes the component list on the Inventory Record form to reflect any changes IWOMS returns the Primary User to the Inventory Record form. In Step 8, if the Primary User does not want to edit an inventory record component, he/she left-clicks on the Cancel button. IWOMS returns him/her to the Inventory Record form. The inventory record component is updated in the database. If the input to a field(s) on the Inventory Record Component form is invalid, when the Primary User left-clicks on the Save button (Step 10), IWOMS displays a message box with an error message indicating which field(s) are invalid, and upon the Primary User left-clicking on the Close button on the message box, he/she continues with Step 8 in the Basic Path. Other (For Functional Requirements Definition, see ) Use Case Name Priority Trigger Precondition Transfer Inventory Record Component Transfer Inventory Record Component Desired IWOMS is loaded and at least one inventory record with at least one component must exist in the database. Basic Path The Primary User left-clicks on the Inventory button on the IWOMS Main Menu IWOMS displays the Inventory Module window In the Inventory Module window, the Primary User left-clicks on an entry for an inventory record in the inventory list The Primary User then left-clicks on the View/Edit button IWOMS displays a form called Inventory Record with the inventory record s information The Primary User left-clicks on an entry for a component in the component list The Primary User then left-clicks on the Transfer Component button IWOMS displays a dialog box requesting the Primary User to select the computer/device name to

27 which the component will be transferred from a dropdown list The Primary User then left-clicks on OK IWOMS moves this inventory record component to another record in the database IWOMS refreshes the component list on the Inventory Record form of both the computer/device where the component did reside and the computer/device to which the component was transferred to reflect the transfer IWOMS returns the Primary User to the Inventory Record form. Alternative Paths In Step 8, if the Primary User does not want to transfer an inventory record component, he/she left-clicks on the Cancel button. IWOMS returns him/her to the Inventory Record form. Postcondition The inventory record component is moved to another record in the database. Exception Paths Other (For Functional Requirements Definition, see ) Use Case Name Priority Trigger Precondition Delete Inventory Record Component Delete Inventory Record Component Desired IWOMS is loaded and at least one inventory record with at least one component must exist in the database. Basic Path The Primary User left-clicks on the Inventory button on the IWOMS Main Menu IWOMS displays the Inventory Module window In the Inventory Module window, the Primary User left-clicks on an entry for an inventory record in the inventory list The Primary User then left-clicks on the View/Edit button IWOMS displays a form called Inventory Record with the inventory record s information The Primary User left-clicks on an entry for a component in the component list The Primary User then left-clicks on the Delete Component button IWOMS displays a message box confirming the deletion The Primary User left-clicks on the Yes button IWOMS deletes this inventory record component from the database.

28 IWOMS refreshes the component list on the Inventory Record form to reflect the deletion IWOMS returns the Primary User to the Inventory Record form. Alternative Paths In Step 8, if the Primary User does not want to delete an inventory record component, he/she left-clicks on the No button. IWOMS returns him/her to the Inventory Record form. Postcondition The inventory record component is deleted from the database. Exception Paths Other (For Functional Requirements Definition, see ) Use Case Name Priority Trigger Precondition Delete Inventory Record Delete Inventory Record Desired IWOMS is loaded and at least one inventory record must exist in the database. Basic Path The Primary User left-clicks on the Inventory button on the IWOMS Main Menu IWOMS displays the Inventory Module window In the Inventory Module window, the Primary User left-clicks on an entry for an inventory record in the inventory list The Primary User then left-clicks on the Delete button IWOMS displays a message box confirming the deletion The Primary User left-clicks on the Yes button IWOMS deletes this inventory record from the database IWOMS refreshes the inventory list on the Inventory Module window to reflect the deletion IWOMS returns the Primary User to the Inventory Module window. Alternative Paths In Step 5, if the Primary User does not want to delete an inventory record, he/she left-clicks on the No button. IWOMS returns him/her to the Inventory Module window. Postcondition The inventory record is deleted from the database. Exception Paths Other (For Functional Requirements Definition, see ) Use Case Name Priority Copy Inventory Record Copy Inventory Record Desired

29 Trigger Precondition IWOMS is loaded and at least one inventory record must exist in the database. Basic Path The Primary User left-clicks on the Inventory button on the IWOMS Main Menu IWOMS displays the Inventory Module window In the Inventory Module window, the Primary User left-clicks on an entry for an inventory record in the inventory list The Primary User then left-clicks on the Copy button IWOMS displays a dialog box requesting the Primary User to input the inventory tag number of the new computer/device and its name The Primary User then left-clicks on OK IWOMS creates this new inventory record in the database and copies the information, except the inventory tag number and the computer/device name, from the selected, preexisting inventory record to the new one IWOMS refreshes the inventory list on the Inventory Module window to include this new inventory record IWOMS returns the Primary User to the Inventory Module window. Alternative Paths Postcondition Exception Paths In Step 5, if the Primary User does not want to copy an inventory record, he/she left-clicks on the Cancel button. IWOMS returns him/her to the Inventory Module window. The inventory record is copied to a new inventory record in the database. In Step 5, if the input to a field(s) in the dialog box is invalid, when the Primary User left-clicks on the OK button (Step 6), IWOMS displays a message box with an error message indicating which field(s) are invalid, and upon the Primary User left-clicking on the Close button on the message box, he/she continues with Step 5 in the Basic Path. Other (For Functional Requirements Definition, see ) Use Case Name Priority Trigger Precondition Generate Work Order Statistics Report Generate Work Order Statistics Report Desired IWOMS is loaded and at least one work order must exist in the database. Basic Path The Primary User left-clicks on the Reports button on the IWOMS Main Menu IWOMS displays the Reports Module window.

30 3. 3. In the Reports Module window, the Primary User left-clicks on the Work Order Statistics button IWOMS displays a properly formatted report consisting of the amount of work orders completed by each IT Department staff member in ascending order by staff member name, the amount of work orders completed per computer/device in ascending order by computer/device name, the amount of work orders completed per each resolution type in ascending order by resolution type, and the amount of work orders involving each action, each object, or each combination of an action and an object in ascending order When the Primary User is finished viewing the report, he/she left-clicks on the Close button on the report window IWOMS returns the Primary User to the Reports Module window. Alternative Paths Postcondition The report is displayed in its proper format. Exception Paths Other (For Functional Requirements Definition, see ) Use Case Name Priority Trigger Precondition Generate Library Hours Report Generate Library Hours Report Desired IWOMS is loaded and at least one work order pertaining to a remote library must exist in the database. Basic Path The Primary User left-clicks on the Reports button on the IWOMS Main Menu IWOMS displays the Reports Module window In the Reports Module window, the Primary User left-clicks on the Library Hours button IWOMS displays a properly formatted report which gives a list of the number of hours that the IT Department devoted to each remote library in ascending order by library When the Primary User is finished viewing the report, he/she left-clicks on the Close button on the report window IWOMS returns the Primary User to the Reports Module window. Alternative Paths Postcondition Exception Paths The report is displayed in its proper format.

31 Other (For Functional Requirements Definition, see ) Use Case Name Priority Trigger Precondition Generate Mileage Report Generate Mileage Report Desired IWOMS is loaded and at least one work order pertaining to a remote library must exist in the database. Basic Path The Primary User left-clicks on the Reports button on the IWOMS Main Menu IWOMS displays the Reports Module window In the Reports Module window, the Primary User left-clicks on the Mileage button IWOMS displays a properly formatted report listing the date, the number of miles, and the library visited for each trip and the total number of miles for work-related travel that each IT Department staff member has in ascending order by staff member name and a grand total of the number of miles that the IT Department, as a whole, traveled When the Primary User is finished viewing the report, he/she left-clicks on the Close button on the report window IWOMS returns the Primary User to the Reports Module window. Alternative Paths Postcondition The report is displayed in its proper format. Exception Paths Other (For Functional Requirements Definition, see ) Use Case Name Priority Trigger Precondition Generate Network Address Report Generate Network Address Report Desired IWOMS is loaded and at least one inventory record pertaining to a networked computer/device must exist in the database. Basic Path The Primary User left-clicks on the Reports button on the IWOMS Main Menu IWOMS displays the Reports Module window In the Reports Module window, the Primary User left-clicks on the Network Address button IWOMS displays a properly formatted report consisting of the following, if applicable: computer/device name, patch panel location and

32 number, switch/hub location and port number, and IP address in ascending order by computer/device name When the Primary User is finished viewing the report, he/she left-clicks on the Close button on the report window IWOMS returns the Primary User to the Reports Module window. Alternative Paths Postcondition The report is displayed in its proper format. Exception Paths Other (For Functional Requirements Definition, see ) Use Case Name Priority Trigger Precondition Generate Expired Warranty Report Generate Expired Warranty Report Desired IWOMS is loaded and at least one inventory record must exist in the database. Basic Path The Primary User left-clicks on the Reports button on the IWOMS Main Menu IWOMS displays the Reports Module window In the Reports Module window, the Primary User left-clicks on the Expired Warranty button IWOMS displays a properly formatted report listing each computer/device and its warranty expiration in ascending order by date and then by computer/device name When the Primary User is finished viewing the report, he/she left-clicks on the Close button on the report window IWOMS returns the Primary User to the Reports Module window. Alternative Paths Postcondition The report is displayed in its proper format. Exception Paths Other (For Functional Requirements Definition, see ) Use Case Name Priority Trigger Precondition Generate Hardware Specifications Report Generate Hardware Specifications Report Desired IWOMS is loaded and at least one inventory record must exist in the database.

33 Basic Path The Primary User left-clicks on the Reports button on the IWOMS Main Menu IWOMS displays the Reports Module window In the Reports Module window, the Primary User left-clicks on the Hardware Specifications button IWOMS displays a properly formatted report indicating the hardware specifications for each computer/device When the Primary User is finished viewing the report, he/she left-clicks on the Close button on the report window IWOMS returns the Primary User to the Reports Module window. Alternative Paths Postcondition The report is displayed in its proper format. Exception Paths Other (For Functional Requirements Definition, see ) 3.3 Detailed Non-Functional Requirements Hardware: The IWOMS client application must run on an IBM-Compatible Pentium-based PC. Operating System: Either Microsoft Windows 9x, NT 4.0, or 2000 Professional must be installed on the client and Microsoft Windows NT Server 4.0 on the server. Software Needed: Microsoft Visual Basic 6.0 and Microsoft SQL Server 7.0 must be used to develop and maintain this system. Software Standard: Any IWOMS functionality which can modify the database will have a cancel option, where appropriate. If the user selects the cancel option, IWOMS will return the user to the previous form. Network Interface: The IWOMS client application must have network connectivity in order to access the SQL Server database. A.1 IWOMS Main Menu Appendix A: Sample User Interface Prototypes

34

35 A.2 Work Orders Module Form A.3 Work Order Form

36

37 A.4 Inventory Module Form

38 A.5 Inventory Record Form (Please note: The Inventory Record Component form is not displayed in this appendix because it is very similar to the form below.) A.6 Reports Module Form

39 Index