Beruflich Dokumente
Kultur Dokumente
Document Control
Approval
The Guidance Team and the customer, Dr. Greg Lush, will approve this document.
Distribution List
This following list of people will receive a copy of this document every time a new version of this document
becomes available:
Guidance Team Members:
Dr. Ann Gates
Dr. Steve Roach
Nelly Delgado
Customer: Dr. Gregory Lush
Change Summary
The following table details changes made between versions of this document
Version Date Modifier Description
1.1 2/6/01 N. Delgado Changes to sections outlined in memo dated
2/6/01
1.2 6/1/01 N. Delgado BNF update.
DOCUMENT CONTROL............................................................................................................................II
APPROVAL................................................................................................................................................... II
DOCUMENT CHANGE CONTROL.................................................................................................................II
DISTRIBUTION LIST.....................................................................................................................................II
CHANGE SUMMARY.....................................................................................................................................II
1. INTRODUCTION..................................................................................................................................1
1.1. PURPOSE AND INTENDED AUDIENCE..............................................................................................1
1.2. SCOPE OF PRODUCT........................................................................................................................1
1.3. DEFINITIONS, ACRONYMS, AND ABBREVIATIONS..........................................................................2
1.3.1. Definitions................................................................................................................................2
1.3.2. Acronyms..................................................................................................................................3
1.3.3. Abbreviations...........................................................................................................................4
1.4. OVERVIEW........................................................................................................................................4
1.5. REFERENCES....................................................................................................................................4
2. GENERAL DESCRIPTION..................................................................................................................6
2.1. PRODUCT PERSPECTIVE..................................................................................................................6
2.2. PRODUCT FEATURES.......................................................................................................................6
2.2.1. Data Management....................................................................................................................6
2.2.2. Mapping of Outcomes..............................................................................................................6
2.2.3. Report Generation....................................................................................................................7
2.3. USER CHARACTERISTICS................................................................................................................7
2.3.1. Use-Case Diagram...................................................................................................................7
2.3.2. Actors.......................................................................................................................................7
2.3.3. Use-Case Descriptions.............................................................................................................7
2.3.4. Scenarios..................................................................................................................................8
2.4. GENERAL CONSTRAINTS...............................................................................................................12
2.5. ASSUMPTIONS AND DEPENDENCIES..............................................................................................12
3. SPECIFIC REQUIREMENTS............................................................................................................13
3.1. EXTERNAL INTERFACE REQUIREMENTS......................................................................................13
3.1.1. User Interfaces.......................................................................................................................13
3.1.2. Hardware Interfaces..............................................................................................................18
3.1.3. Software Interfaces.................................................................................................................18
3.1.4. Communications Interfaces....................................................................................................18
3.2. BEHAVIORAL REQUIREMENTS......................................................................................................18
3.2.1. Same Class of User................................................................................................................18
3.2.2. Related Real-world Objects...................................................................................................18
3.2.3. Stimulus..................................................................................................................................22
3.2.4. Related Features....................................................................................................................25
3.2.5. Functional..............................................................................................................................28
3.3. NON-BEHAVIORAL REQUIREMENTS..............................................................................................28
3.3.1. Performance Requirements....................................................................................................28
3.3.2. Qualitative Requirements.......................................................................................................28
3.3.3. Design and Implementation Constraints................................................................................28
3.4. OTHER REQUIREMENTS................................................................................................................29
3.4.1. Database..................................................................................................................................29
Software Requirements Specification CS 4310 Fall 2000 Date 1/17/2001 2:38 PM Page iii
Software Requirements Specification
1. Introduction
1.1. Purpose and Intended Audience
The purpose of the Software Requirements Specification (SRS) is to give the customer a clear and precise
description of the functionality of the assessment-support software to be developed and to eliminate ambiguities
and misunderstandings that may exist. For the customer, the SRS will explain all functions that the software
should perform. For the developer, it will be a reference point during software design, implementation and
maintenance. To clarify keywords used throughout the document, a set of definitions, acronyms and
abbreviations is provided in section 1.3.
The SRS divides the system requirements into two parts, behavioral and non-behavioral requirements. The
behavioral requirements describe the interaction between the system and its environment. Non-behavioral
requirements relate to the definition of the attributes of the product as it performs its functions. This includes the
level of security, efficiency, reliability, maintainability, portability, capacity, and the standards of compliance of
the product. The intended audience of the SRS is the College of Engineering at The University of Texas at El
Paso (UTEP) and the development team. This document serves as an agreement between both parties regarding
the product to be developed.
1.3.1. Definitions
The definitions in this section are given in the context of the product being developed. This intention is to assist
the user in their understanding of the requirements for the system.
TERM DEFINITION
A-K Program outcomes defined by ABET Engineering Criteria 2000. Please
refer to [1] for a complete list.
Accreditation Process of determining whether colleges or departments meet a set of
standards as set forth by an accrediting agency, such as ABET.
Archive To maintain data in a designated repository; in CACQI, data will be
maintained in the central database.
Assessment The systematic and periodic evaluation of whether students are achieving
the learning outcomes associated with a given course.
Assessment instrument a) The tool used to assess students’ skills and knowledge in a course, e.g,
test, quiz, report, observation.
b) An assessment instrument is composed of one or more assessment
instrument parts.
Assessment instrument part An assessment instrument unit or a set of assessment instrument parts.
Assessment instrument unit An element of an assessment instrument for which grades may be assigned
and that maps to a single outcome, e.g., a question on an exam.
Call Number A course request number
Encrypt The alteration of data so that it is meaningful only to the intended receiver.
Local database An Oracle relational database stored on one or more machines at the
departmental level.
Mapping The linkages of two objects, e.g., an outcome to an assessment unit.
Server The main computer in a network. A central computer that connects and
services those computers (clients) attached to it.
Spreadsheet The work area for entering grades that appears as a table with rows and
columns.
Subject identifier A 4-character field that corresponds to a subject.
1.3.2. Acronyms
ACRONYM MEANING
ABET Accreditation Board for Engineering and Technology
AI Assessment Instrument
AIP Assessment Instrument Part
AIU Assessment Instrument Unit
BNF Backus Naur Form
CACQI (pronounced Khaki) Classroom Assessment for Continuous Quality Improvement
CQI Continuous Quality Improvement
CRN Course Request Number
Software Requirements Specification CS 4310 Fall 2000 Date Page
1/17/2001 2:38 PM 3
Software Requirements Specification
1.3.3. Abbreviations
ABBREVIATION MEANING
e.g. For example
id Identification
i.e. Such as
info. Information
1.4. Overview
The SRS is divided into three major sections: Introduction (Section 1), General Description (Section 2), and
Specific Requirements (Section 3). This overview describes Section 2 and Section 3 of the SRS.
Section 2 includes five subsections. Section 2.1 provides a description of the product, its overall structure, and
its functionality. Section 2.2 summarizes the main features of the software from a high-level point of view.
Section 2.3 identifies the different users of the system. This is accomplished through use-cases. A summary of
the actors, use-cases, and scenarios is given. Section 2.4 states existing constraints. Section 2.5 gives the
assumptions and dependencies of CACQI.
Section 3 includes four major subsections. External Interface Requirements (Section 3.1) gives the
requirements for user, hardware, software and communications interfaces. Behavioral Requirements (Section
3.2) organizes the requirements in the following categories: same class of user, related real-world objects,
stimulus, related features and functional requirements. Non-behavioral Requirements (Section 3.3) consists of
performance and qualitative requirements, as well as design and implementation constraints. Section 3.4
outlines database, operations and site adaptation requirements.
1.5. References
[1] “ABET Homepage: Accreditation Board of Engineering and Technology.” December 15, 2000. Online
Posting. Available: http://www.abet.org/
[2] Gates, A., Requirements Definition, CS4310 Handout, September 6, 2000.
[3] Gates, A., Memorandum RE: ABET CQI Project, e-mail message dated 11/12/2000, 2:31 p.m.
[4] Gates, A., Message from Dr. Lush, e-mail message dated 11/14/200, 5:58 p.m.
[5] International Software Development, OmegaSoft Development, Renaissance Software Developers,
Strategic Engineering Team, Strategy X, Utopia Software, Interview Report. September 2000.
[6] International Software Development, OmegaSoft Development, Renaissance Software Developers,
Strategic Engineering Team, Strategy X, Utopia Software, Feasibility Report, September 2000.
2. General Description
2.1. Product Perspective
CACQI is designed to provide departments with a tool that facilitates the monitoring and evaluation of a
student’s progress throughout his or her college education. The system provides management of course and
student data, the ability to map outcomes to assessment items, and report generation. A more complete
description of CACQI’s functionality can be found in Section 2.2.
There are various existing products that have similar functionality to CACQI [6]. 1 st Class GradeBook manages
student grades for a particular assignment. In addition, this application generates spreadsheets and graphs that
compare students’ grades with each other on one or more assignments. Standards-based Gradebook is similar
to 1st Class Gradebook, but it is also able to monitor students’ performance against standards. Other
applications that support functionality provided by CACQI include the following:
Gradebook Power: provides the ability to calculate grades.
Seagate Crystal Reports: supports report generation.
PostgreSQL: provides database management and report generation.
Although the above software products provide many of CACQI’s features, the ability to manage and map
outcomes to assessment items is not supported.
outcomes to program outcomes and to associate a targeted competency with each outcome. Using these
targeted competencies, CACQI will be able to determine the degree to which AIUs count towards achieving a
specific outcome.
2.3.2. Actors
CACQI classifies the actors of the system into three groups:
General User: The general user can enter data into the system, save course-work descriptions, archive data,
calculate grades, and view reports for the courses h/she can access.
Central Database: The central database is responsible for storing data at the end of the semester. The central
database is an external entity, which can only be written to at the end of the semester.
Local Database: The local database stores all the information needed by the system during the semester.
Information is read from and saved to the local database during the semester.
University Database: The university database (Goldmine) stores student and course information.
Map entities: the general user can use the system to map course outcomes to program outcomes; to
map AIUs to course outcomes; and to map course outcomes to targeted competencies. The local
database maintains the information.
Define AIs: the general user can use the system to enter information related to an AI. For each
instrument, the stored information includes such items as description, category, assessment instrument
part (AIP) label and description, AIU label and description, AIU point value. For each student, the user
can enter the points earned for each assessment unit. The local database maintains the information.
Modify AIs: the general user can use the system to modify information related to an AI. The local
database maintains the information.
Enter grades: the general user can use the system to enter student grades related to an AI and to enter
formulae for calculating grades. The local database maintains the information.
Generate reports: the general user can use the system to display, print, or download a predefined report
to the local database. The general user can query the system to calculate individual or class grades, to
determine the mean or median grade on an individual AI or collection of instruments.
Archive course and student information: the general user can use the system to archive course and
student information to the central database from the local database at the end of the semester.
The use cases that are associated with an include relationship are as follows:
Access the system: the general user can access the system through a unique login name and password.
Open course: the general user can select a course from the list of courses that s/he owns.
The use cases that are associated with an extend relationship are as follows:
Set password - The user can set the password for accessing and entering information on the course.
Set property list – The user can set the property list that gives the login names for the users who can
access a course.
Enter formula: the general user can define the formulas that will be used to calculate students’ grades
on an AI, assessment category, or course.
2.3.4. Scenarios
Use Case: Manage course information
Actor: General user and local database
Scenario:
1. The user enters values for the following attributes:
a. subject identifier
b. course number
c. CRN
d. section number
e. course title
f. professor login
g. semester
h. year
i. AI categories (e.g., Exam)
j. AI weights for each category.
k. grade-to-letter conversion scheme
2. The user saves the information to the local database.
Alternatives:
1. The user does not enter all required information.
2. The user modifies a value in an existing attribute.
3. The user enters a new value to an existing attribute.
4. The user enters an incorrect value for course number.
5. The user enters an incorrect value for CRN.
6. The user enters percentages for each instrument category and the sum exceeds 100%.
Alternatives:
1. The user chooses the option to save the predefined report to a file.
2. The user chooses the option to print the report.
3. Specific Requirements
3.1. External Interface Requirements
The following section discusses the requirements related to the interfaces used to communicate with external
entities. These entities include human users and other hardware and software interfaces that permit the system
to carry out its tasks.
[SRSreq 1] All screens will have the name of the system, CACQI, displayed on the screen.
[SRSreq 2] After the login screen, all screens will provide the user with the ability to navigate through the
system, i.e., to select different functions of the system. See 2.3.3.
[SRSreq 3] After a course has been selected, all screens will display the course number and course title.
[SRSreq 4] The user will have the option to save changes to information stored in the local database.
[SRSreq 5] The user will have the option to cancel a submission to the local database.
[SRSreq 6] The user will have the option to print displayed information.
[SRSreq 7] Upon entry to CACQI, the system will display the following welcome screen and prompt the user
for a login and password.
[SRSreq 8] The user will have the option to reset his/her password.
[SRSreq 9] The user will be able to select an existing course section to which s/he has access, i.e., the user is
owner of the course section or the user is on the property list.
[SRSreq 10] The user will be able to select the option to define a new course section and associated attributes as
described in Section 3.2.2.4.
[SRSreq 11] The user will be able to select the option to define students who are registered for a course section,
using the attributes given in Section 3.2.2.7.
[SRSreq 12] Only the owner of a will have the option to add or delete a user login to the property list.
[SRSreq 13] The user will be able to choose the AI categories that will be used in the course section as follows:
select one or more categories from a list of pre-defined instrument categories (see Section
3.2.2.1)
define one or more new instrument categories.
[SRSreq 14] The user will be able to set a weight for each instrument category.
[SRSreq 15] The user will be able to define the range for each letter grade.
[SRSreq 16] The user will be able to view, modify, or delete all information related to a course section.
3.1.1.4. Outcomes
[SRSreq 17] The user will be able to select the option to enter course-section outcomes.
[SRSreq 18] The user will be able to enter the label and description associated with one or more course-section
outcomes. See Section 3.2.2.5.
[SRSreq 19] The user will be able to select the ranking of a course-section outcome from predefined choices.
[SRSreq 20] The user will have the option to view course-section outcomes or program outcomes.
[SRSreq 21] The system will display the following choices and the user will be able to select one:
x% of students will achieve y% or higher.
The students will achieve an average of y% or higher.
Other
[SRSreq 22] The user will be able to view a list of pre-defined course-section outcomes and will be able to map
a targeted competency to a course-section outcome.
[SRSreq 23] The user will be able to view the targeted competency that is associated with an outcome.
[SRSreq 24] The user will be able to modify the targeted competency that is associated with an outcome.
[SRSreq 25] The user will be able to enter a formula using (or selecting) AIUs and Boolean logic for calculating
the targeted competency.
An AI can be viewed as a tree structure. See Figure 1 for an example AI and corresponding structure.
[SRSreq 26] The user will have the option to define a new AI.
[SRSreq 27] For an AI, the user will be able to select an AI category as defined during course section set-up
(see Section 3.2.2.1).
[SRSreq 28] For an AI, the user will be able to enter associated attributes as described in Section 3.2.2.1.
[SRSreq 29] The user will be able to define multiple AIPs or AIUs that are associated with an AI.
Test 1
Q1 AIU
Q2 AIU AI
Q3
a AIU
AIP
b AIU
[SRSreq 30] For an AIP or an AIU, the user will be able to enter associated attributes as described in Sections
3.2.2.2 and 3.2.2.3, respectively.
[SRSreq 31] The user will be able to define multiple AIPs or AIUs that are associated with an AIP.
[SRSreq 32] The system will allow the user to map each AIU to one and only one course-section outcome using
the pre-defined list of course-section outcomes.
3.1.1.7. Mapping
A mapping links two entities by defining a relation, i.e., an association between the two.
[SRSreq 33] The user will be able to select the option to map a course-section outcome to one or more than one
program outcome.
[SRSreq 34] The user will be able to select the option to map an AIU to a course-section outcome.
[SRSreq 35] The user will be able to modify the mappings between a course section and program outcome.
[SRSreq 36] The user will be able to modify the mappings between an AIU and a course-section outcome.
[SRSreq 37] The user will be able to view the program outcomes that are associated with a course-section
outcome.
[SRSreq 38] The user will be able to view the AIUs that are associated with a course-section outcome, and the
AIUs will be identified by their label appended to the AI label and associated AIP labels, if
applicable.
3.1.1.8. Grades
[SRSreq 39] The user will have the ability to enter a formula for calculating the totals in each of the
spreadsheets, see Section 3.2.4.2.
[SRSreq 40] The formula created from the assessment category weights is the default setting for calculating
totals.
[SRSreq 41] The user will be able to choose a spreadsheet format for viewing scores for all students in a course
section. For each format, the first two columns are reserved for student name (last name, first
name, middle initial) and id. The options and formats are as follows:
Assessment Instrument Category Spreadsheet: for each category, the category label will
appear in a column heading and the student's average weighted score or value resulting from
the user-defined formula for each category will appear in the rows below. See Figure 2a.
Assessment Instrument Summary Spreadsheet: for each AI in which grades have been
entered, the label will appear in a column and, in each row below, the students' total score for
each AI (grouped by category) will appear. See Figure 2b. Note that AI refers to an AI label.
Individual Assessment Instrument Spreadsheet: for a selected AI, the scores associated with
AIUs and the totals for the AIPs are displayed. See Figure 2c. Note that U n refers to the label
of an AIU and Pn refers to the label of an AIP.
Mean
Median
Mean
Median
Mean
Median
[SRSreq 42] In an Individual Assessment Instrument Spreadsheet, the user will be able to enter or modify
grades for a student.
[SRSreq 43] The user will have the option to use the formulas automatically created from the assessment
category weights, to enter a user-defined formula, or to reset the formulas to the default setting.
3.1.1.9. Reports
[SRSreq 44] The user will be able to view a report associated with an outcome associated with one of the
following two targeted competencies:
Targeted competency type 1: x% of students will achieve y% or higher on the outcome.
Targeted competency type 1: The students will achieve an average of y% or higher.
[SRSreq 45] Each report will display the following information:
The text of the outcome statement.
An indication either by text or color or both whether the outcome was achieved.
The formula for calculating the respective targeted competency, e.g., OUTCOME1 was
measured by (E1.Q1 AND E1.Q5) OR F1.Q15.P2.
[SRSreq 46] The report for targeted competency type 1 will also display the following statements:
w% of the students scored y% or higher on the outcome (where w is the actual performance.)
x% of the students scored v% or higher on the outcome (where v is the student performance
level you must drop down to indicate the xth percentile).
[SRSreq 47] The report for targeted competency type 2 will also display the following statements:
The students achieved an average of u% or higher (where u is the actual performance).
[SRSreq 48] The user will have the ability to archive course section and student information from the local
database to the central database.
[SRSreq 49] The system will interface with the following software systems:
Oracle
Banner/Goldmine
[SRSreq 50] The system will run over the existing campus network.
[SRSreq 51] The system will be developed as a client-server application with the server providing data access
services only.
[SRSreq 52] The first time, a user logs into CACQI, the system will ask the user to enter a new password.
[SRSreq 53] Only users whose login are in the property list for a course section, or who own the course section,
will be able to view, modify, or delete information on a course section.
date: a date of the form MMM-DD-YYYY where MMM represents the month using 3-
characters, DD represents the day using two digits, YYYY represents the year using four
digits, e.g., Sep-10-2000
description: a description of the instrument, e.g., Test 1 covering Chapters 1-10
category: one of the user-defined categories
path name (optional): the path where the AI file is stored on the user's machine
[SRSreq 55] The number of AIPs defined for an AI will be one or greater.
[SRSreq 61] The user will be able to define an “assesses” relation from an AIU to a course-section outcome.
[SRSreq 62] The information associated with a course section is the following:
[SRSreq 64] The user will be required to define at least one course-section outcome.
[SRSreq 65] The information associated with each course-section outcome is the following:
label: a description of the course-section outcome, e.g, dataflow level-1
description: a statement of the course-section outcome, e.g., “The students will be able to
draw a level-1 dataflow diagram from a requirements definition.”
ranking: one of the following - "critical," "important," or "relevant"
[SRSreq 66] The default setting for ranking is “relevant.”
[SRSreq 67] The user will be able to define an “is-associated-with” relation from course-section outcome to a
program outcome.
[SRSreq 68] The user will be able to define an “is-assessed-by” relation from course-section outcome to an
AIU.
[SRSreq 69] The user will be able to associate a course-section outcome to more than one program outcome.
[SRSreq 70] Each course outcome will be associated with one and only one targeted competency.
3.2.2.6. Spreadsheet
The CACQI spreadsheet differs from an Excel-like spreadsheet because in an Excel-like spreadsheet there may
be cells available for constants and work values. The CACQI spreadsheet (henceforth referred to as
spreadsheet) does not allow this. Every cell corresponds to a field in a record in a database table. Therefore,
there are no absolute addresses in these formulae. A cell range is a contiguous rectangular set of cells. Cell
Software Requirements Specification CS 4310 Fall 2000 Date Page
12/8/2021 3:58 AM 20
Software Requirements Specification
addresses do not row identifiers only column identifiers unless the formula applies to a particular row, i.e., a
student.
[SRSreq 71] A cell will contain a number, a formula or a text string as allowed by the BNF given in Figure 3.
[SRSreq 72] A column in a spreadsheet will represent such items as AIU, AIP, AI, total, name, id, and letter
grade.
[SRSreq 73] The rows in a spreadsheet will represent values associated with an individual student.
[SRSreq 74] Legal values for scores entered into columns labeled AIU are floating point values greater than or
equal to 0.
[SRSreq 76] Valid cell addresses will be a column identifier or a row and column identifier.
[SRSreq 77] When copying a formula from one cell to another there will be two cases.
When copying a formula from one cell to a cell below or above it, the cell addresses in the
copied formula will refer to the row that is the target of the copy.
When copying a formula from one cell to a different cell in the same row, the columns will be
adjusted in the copied formula.
3.2.2.7. Student
[SRSreq 82] The values entered for the percentages on templates must be between 0 and 100%.
[SRSreq 83] A targeted competency will be associated with one and only one course-section outcome.
[SRSreq 84] The user will be able to enter a formula for combining AIUs, using AIU labels and boolean logic,
to determine whether a targeted competency has been met. For example:
Software Requirements Specification CS 4310 Fall 2000 Date Page
12/8/2021 3:58 AM 21
Software Requirements Specification
[SRSreq 85] The default targeted competency for each course-section outcome is as follows: “90% of the
students will achieve 70% or higher.”
[SRSreq 86] The user will be able to define an “is-associated-with” relation from a targeted competency to a
course-section outcome.
3.2.3. Stimulus
The following requirement applies to all user-entered values. Valid ranges and values should be checked against
the specification of the tables given in Appendix B.
[SRSreq 87] If the user enters an invalid value or range, an error message will be displayed.
[SRSreq 88] Whenever the user submits information to the database, the system will ask the user to confirm the
submission.
[SRSreq 89] After the user enters a login and password, the system will validate the password. If the password
is validated, then the welcome screen will appear. If the password is not validated, then the
system will display:
Incorrect login. Please try again.
[SRSreq 90] If the user selects the option to reset his/her password, the system will prompt the user for a new
password and will ask the user to renter the password.
[SRSreq 91] When the user reenters a new password after selecting the option to change his/her password, the
system will check the password against the newly entered password.
[SRSreq 92] When the user selects the option to change his/her password, the system will check whether the
new password is greater than six characters and less than 20 characters.
[SRSreq 93] When the user enters an incorrect login or password for the third time, the system will lock the
application for two minutes and send a message to a log file. See Section 3.3.2.1.
[SRSreq 94] If the user deletes an AIP that has successors, the following message will display:
Warning: This AIP has descendants. Deletion will result in deletion of all
descendants. Do you wish to proceed?
[SRSreq 95] The entered AIPs will be associated with the AI or predecessor AIP, depending on which one
initiated the entry.
[SRSreq 96] If the user selects the option to define a relation between an AIU and a course-section outcome, the
labels of the AIUs will be displayed. The user will be able to view a list of pre-defined course-
section outcomes and will be able to link an AIU to a course-section outcome.
[SRSreq 97] If the user defines an “is-assessed-by” relation from course-section outcome to an AIU, the
association is maintained in a table.
[SRSreq 98] When the user creates a new course section, the system will make the user the owner of the course
section.
[SRSreq 99] When the owner of a course section selects the option to add a user login to the property list, the
login will be maintained in a table in the local database that stores the property list.
[SRSreq 100] If the user selects the option to add a user login to the property list, the following message will
display, and the user will be able to select another option:
You are unauthorized to change property list.
[SRSreq 101] If the user selects the option to delete a student, the following message will appear:
Are you sure you want to delete student XX?
[SRSreq 102] When the user enter ranges for letter grades, the system the check the ranges for overlaps and
display the following message if any are found:
Overlapping ranges for letter grade. Please reenter range.
[SRSreq 103] If the user selects the option to view a course section, the course section attributes as defined in
Section 3.2.2.4 will display.
[SRSreq 104] If the user selects the option to associate a course-section outcomes to a program outcome, a list
of pre-defined course section and program outcomes will be displayed, and the user will be able
to link a course-section outcome to one or more program outcomes.
[SRSreq 105] If the user defines an “is-associated-with” relation from course-section outcome to a program
outcome, the association is maintained in a table.
[SRSreq 106] If the user selects the option to view outcomes, the system will display the attributes of the
outcomes as described in Section 3.2.2.5 and the mappings from the course-section outcome to a
program outcome.
[SRSreq 107] If the user modifies or deletes a course-section outcome that is associated with other entities, the
following message will display:
Warning: This change may invalidate existing mappings. Do you wish to continue?
[SRSreq 108] When the user selects the option to download student information from the database, the system
will connect to university database over the network.
[SRSreq 109] When the user selects the option to download student information from the university database
for a CRN, the system will connect to the university database and retrieve the following
information for the students registered in the CRN:
Last name
First name
Middle initial
Id
Software Requirements Specification CS 4310 Fall 2000 Date Page
12/8/2021 3:58 AM 23
Software Requirements Specification
Classification
[SRSreq 110] If the user chooses the option to display grades in the Assessment Instrument Category
Spreadsheet or the Assessment Instrument Summary Spreadsheet and a formula has not been
entered, the system will calculate the totals based on an even distribution within each AI
category, and the grand total will be the sum of the weighted averages in each AI category.
[SRSreq 111] If the user chooses the option to display grades in the Assessment Instrument Category
Spreadsheet or the Assessment Instrument Summary Spreadsheet and the user selects to enter a
formula, the entered formula will override the default setting.
[SRSreq 112] If the user chooses the option to display grades, the grades will be displayed on a spreadsheet
with AIs grouped by category, and the headings displayed as given in Section 3.1.1.8 (depending
on the spreadsheet requested).
[SRSreq 113] If the user chooses the option to display grades in the Assessment Instrument Category
Spreadsheet or the Assessment Instrument Summary Spreadsheet, the "Letter Grade" field will be
automatically generated by determining the interval in which the grand total lies with respect to
the user-defined letter grade ranges.
[SRSreq 114] When the user selects the option to view the Individual Assessment Instrument Spreadsheet, the
user will have the option to select an AI from a predefined list of AIs.
[SRSreq 115] If the user modifies a grade on the spreadsheet, the newly entered grade will replace the existing
grade in the database and all formulas associated with that grade will be updated.
[SRSreq 116] If the user chooses the option to enter grades and no course-section outcomes have been defined,
the system will display the following message and the system will go back to the "Select Option"
state.
At least one course-section outcome must be defined.
[SRSreq 117] If the user enters a grade value that is greater than the maximum AIU point value, the following
message will display:
Warning: The points entered exceed the maximum AIU point value. Would you like
to proceed?
[SRSreq 118] If the user selects the template, the user will be able to enter values for the percentages. Refer to
[SRSreq 21].
[SRSreq 119] If the user selects the template, the values entered for the percentages will be greater than 0 and
less than or equal to 100. Otherwise, an the following error message will appear:
Percentage must be greater than 0 and less than or equal to 100. Please reenter.
[SRSreq 120] If the user selects the “Other” option, the user will be able to enter text.
[SRSreq 121] If the user defines an “is-associated-with” relation from a targeted competency to a course-section
outcome, the system will maintain the association in a table.
[SRSreq 122] If the user selects the option to archive information into the central database, then all tables in the
local database will be transferred to the central database.
[SRSreq 123] If the user attempts to archive data into the central database before the end of the semester, the
following message will appear:
The time frame for archiving data is invalid.
[SRSreq 124] If the user selects the option to archive information into the central database and the system
successfully initiates the archive, the following message will display:
Archive in progress. Please wait for confirmation of completion.
[SRSreq 125] When the archive into the central database completes, the user will be notified of its completion.
3.2.4.1. Spreadsheet
[SRSreq 126] The Individual Assessment Instrument Spreadsheet will display raw scores, i.e., the actual scores
assigned to an AIU.
[SRSreq 127] In an Individual Assessment Instrument Spreadsheet, the total represents the summation of the
AIPs (AIUs) with respect to its predecessor AIP or the result of a user-defined formula, and the
final column gives the grand total for the AI or the result of a user-defined formula.
[SRSreq 128] In an Individual Assessment Instrument Spreadsheet, the totals will be automatically calculated.
[SRSreq 129] For any spreadsheet format, the mean and median will be computed for each column and will be
displayed at the end of the class list.
[SRSreq 130] For the Assessment Instrument Summary Spreadsheet and Assessment Instrument Category
Spreadsheet, the grand total and the intermediate total for the Category Summary will be
displayed based on the selections of the user. See Section 3.2.2.4.
[SRSreq 131] The user will not be able to modify a system-calculated total.
[SRSreq 132] The user will be able to define a formula as specified by the BNF presented in Figure 4.
[SRSreq 135] Relational operators <, <=, >, >=, =, != will have the standard meanings.
Avg =
1 Xi The arithmetic average of a
n i=1 collection of cells.
AVG (<CELLRANGELIST>) where n is the number of non-empty cells in
the cells specified
Xi is the value contained in the i th cell
of the <CELLRANGELIST>
1. Perform an ascending sort on the values. The median is the halfway point
2. If n is odd, the median is the value in of an ordered list.
index (n + 1)/2.
MEDIAN (<CELLRANGELIST>)
3. If n is even, the median is the value in
indices (n/2) and n/2 + 1.
4. Return the value of the cell(s) in the
median position of the sorted list.
1. Search for the smallest value in the list The smallest value in an ordered
MIN (<CELLRANGELIST>) for the specified cells. list.
2. Return this value.
1. Search for the largest value in the list for The largest value in an ordered
MAX (<CELLRANGELIST>) the specified cells. list.
2. Return this value.
3.2.5. Functional
[SRSreq 136] With client and server running on the same machine, response time will be a maximum of two
seconds.
3.3.2.1. Security
This section is not complete. Additional requirements will follow.
[SRSreq 137] Each time there is a security violation, the log file will be updated with the login, date, and time.
3.3.2.2. Maintainability
[SRSreq 138] The system will be designed to allow the following changes:
Reports consisting of plots and graphs
Administration of accounts, ABET outcomes, mapping of ABET outcomes to program
outcomes, definition of program outcomes.
Database queries
Administration of Oracle
Archive files to central database
3.3.2.3. Portability
[SRSreq 139] The system will run on multiple platforms, in particular Windows, Unix, and Macintosh.
[SRSreq 140] The system will be designed for the following future extensions:
Archive course-section data
Use of existing course information as template for creation of a new course section
Administration of database
Student access
Prorated grade calculation
3.4.1. Database
This section describes requirements associated with a database. The database schema will be provided at a later
date.
[SRSreq 141] All information created, modified, or deleted through CACQI will be stored in the local database.