User Interaction

2.1 Relationship Diagram

Every shaded box represents a web page and every other box represents a link except the mission and menu box. Diamonds represent composition,  Straight lines represent association, Straight lines with arrows represent navigation, and Dotted lines with arrows represent dependency. 

2.2 Display Screen Formats, Menus, and Fault Handling

2.2.1 Main Screen

The Main Screen shall look as shown in the following diagram: 

Display

Display Components

• This page shall include the following links: Guest Login, Instructions, Information, Abandon Session, Reading Assessment, Results and Recommendations, Tips on Reading, and Evaluation of This Tool.

 Error Handling

• Error: User clicks "Reading Assessment" menu at the Main Screen (2.2.1) before filling out the guest entry form of Guest Entry Screen (2.2.2).

          Error Handling:  Error Screen (2.2.10) shall be 

          displayed / message box with similar information.

• Error: User clicks on "Results and Recommendations" at the Main Screen (2.2.1) before completing the test on Reading Assessment

          Error Handling:  Error Screen (2.2.11) shall be 

          displayed / message box with similar information telling them what to do.

• Error: User clicks on "Evaluation of This Tool" at the Main Screen (2.2.1) before completing the test on "Reading Assessment" Screen (2.2.5)

          Error Handling: Error Screen (2.2.12) shall be 

          displayed / similar message box.

2.2.2 Guest Entry Screen

The Guest Entry Screen shall look as shown in the following diagram: 

Display

Display Components

• This link shall lead to a page, which will prompt the user for his/her personal information.  If the user leaves the answer as "Yes", the last two questions will not appear.  If the user selects "No" as the answer to the "Is English your first language?" question, then the last two questions will appear.  Once the user has entered their valid information, the user will then be able to begin the reading assessment test.

 Error Handling

• Error: User tries to continue without completing screen.  

          Error handling: User is shown a message box stating that they must complete the     

                 information before continuing.

2.2.3 Information Screen

The Information Screen shall look as shown in the following diagram:

Display

Display Components

• This link shall lead to a page that provides the user with information over the reading assessment tests.

2.2.4 Instructions Screen

The Instructions Screen shall look as shown in the following diagram:

Display

Display Components

• This link shall lead to a page, which will introduce how to do the reading assessment before the user begins the reading assessment tests. Once the user has read the instructions, they may then begin the reading assessment test.

2.2.5 Reading Passage Screen

The Reading Passage Screen shall look as shown in the following diagram:

Display

Display components

• This screen shall have a start button. Upon clicking the start button the passage and stop button shall appear.
• This page shall contain a link to the data base where each passage is stored.

2.2.6 Questions Screen

The Questions Screen shall look as shown in the following diagram:

Display

Display Components

This page shall have one question. The answer shall be stored as a variable and use in the calculations of 2.3 .

Error Handling

If the User tries to proceed without answering the question a message box will appear stating that the user must answer to proceed.

2.2.7 Results and Recommendations Screen

The Results and Recommendations Screen shall look as shown in the following diagram:

Display

Display Components

• This link shall only be accessed after the reading assessment tests have been completed. It shall then display the users results and recommendations.

2.2.8 Tips On Reading Screen

The Tips on Reading Screen shall look like the following diagram:

Display

Display Components

• This link shall display a list of helpful tips that the user might need before beginning the assessment test. This shall be accessible either before the test begins or after the test is completed.

2.2.9 Evaluation Screen

The Evaluation Screen shall look like the following diagram:

Display

Display Components

• This link shall lead to a page, which will give the user an opportunity to evaluate the reading assessment tests once the user has completed the test.

2.2.10 Error on Reading Assessment menu

 

2.2.11 Error on Results and Recommendations Menu

 

2.2.12 Error on Evaluation menu

 

2.3  Report Formats

2.3.1 Results

Report Display

Results and Recommendation 

·   Time Score =         251                                    ·  Recall Score % = Number Right

                        Reading Time                                                                       0.1

·  Efficiency for Time Use =              Individual Time Score              

                                            Average Time Score for college students

·  Efficiency for Reading Recall =              Individual Reading Score              

                                                   Average Reading Score for college students

·    If Efficiency for Time Use is less than or equal to 0.5 then recommend the individual seek professional assessment.

• If Efficiency for Reading Recall is less than or equal to 0.5 then recommend that the individual seek professional assessment.

Your Time Score:  (display Individual Time Score here)

Your Recall Score %:  (display Individual Recall Score here)

(message of recommendation to the user according to the Efficiency for Time Use or the Efficiency for Reading Recall should come up here-  wording is provided by client) 

PRINT

Report Components  

• Screen Title
• Efficiency for Time Use
  • Individual Time Score = 251 / Reading Time
  • Efficiency = Individual Time Score / Average Time Score for college students
  • If Efficiency > 1, set Efficiency = 1.
  • If Efficiency <= 0.5, recommend professional assessment
  • Output: Individual Time Score
• Efficiency for Reading Recall

  o  Individual Recall Score = Number Right / 0.1

  o  Efficiency = Individual Recall Score / Average Recall Score for college students

  o  If Efficiency > 1, set Efficiency = 1.

  o  If Efficiency <= 0.5, recommend professional assessment

  ○  Output:  Individual Reading Recall Score

• Recommendation
  • Output:  Appropriate recommendation (wording by client)

• PRINT button

2.4 Human Interfaces

• (2.4.1) The user shall use a monitor (as an output device) to read the choices and to know what he/she has to choose from. 
• (2.4.2) The user shall also use a mouse (as an input device) to click on various choices on the "guest entry" screen. 
• (2.4.3) If the user does not have access to a mouse, he/she could use a keyboard to "tab" to the various selections and use the spacebar or arrow keys to select the desired choice. The system shall have error handling in case the user attempts an action that should not be done. The user will not need to type any text. However, the user will need to use drop-down boxes, option buttons, and command buttons.

Data Storage/Format

3.1 Data Structures

N/A

3.2 Files

3.2.1 Two Files:

    3.2.1.1  the filenames shall be in the form *.htmf

                 example:    BACCII.htmf

                                   TexasTech.htmf

    3.2.1.2  each file will be listed in the database under the filename column of the passages table

    3.2.1.3  each file will contain a passage and the passage will be an html fragment. (the fragment is the html between the body element on a normal  

                 html page.

3.3 Databases

3.3.1

3.3.2

3.4 Additional Information

3.4.1  Passage Title:

    3.4.1.1  Black

    3.4.1.2  12 point Times New Roman

    3.4.1.3  Left Justified

3.4.2  Passage:

    3.4.2.1  Black

    3.4.2.2  10 point Times New Roman

    3.4.2.3  Left Justified

    3.4.2.4  Paragraphed and Spaced as in Source File

External System Interfaces

The external systems designed for the software system shall include Internet Information Server (IIS) ASP.dll, global.asa, SQL server, ADO objects, VB script, and FrontPage and Internet explorer 4.0.

4.1  Internet Information Server (IIS)

IIS version 4.0/5.0 and can be run on Windows 95,Windows98, Windows NT, Windows2000 and comes with ASP 2.0 as standard.

This software/interface loads all the associated files needed for storing and executing the ASP page.

4.2  ASP.dll description

When a client (browser) requests an ASP page from the web server, the server passes the request to ASP.dll, which first checks whether global.asa is executed.

ASP.dll executes global.asa if it is not executed.

When the user requests the questions page, a request is in turn passed on to ASP.dll which processes the request

This file is stored in the directory C:\windows\system\inetserv

If you can not see it, make sure you have turned the show hidden files option in windows explorer on.

The file global.asa is a text file that contains details about an ASP application, such as when it should begin and end. Each application has only one global.asa and is placed in the virtual directory root.

The two main components of this file are Application and Sessions. An application starts when the first user accesses a web page in the system. A session starts when any user accesses a web page in the system.

This file shall consist of four main functions namely Application_onstart, Application_onend, Session_onstart, and Session_onend. It needs to contain the commands to open connection and access the data store in the SQL server.

4.3.1 Sample of global.asa

<Script language = "vbscript" RUNAT = "server">

Sub application_onstart

Vbscript goes here…

End sub

Sub application_onstart

Vbscript goes here…

End sub

Sub session_onstart

Vbscript goes here…

End sub

Sub session_onend

Vbscript goes here…

End sub

</script>

Connection to the database server shall have to be established in order to store data entered by the users and to retrieve information from the data store to the users.

The database shall contain the links to passages and the questions for the users.

Establishing a connection to the database shall have to be done using the command

Dim objconn

Set objconn=server. Create object ("ADODB.connection")

The database connection may be opened by sending the system dsn filename located on the computer on which the software runs, database username, and database password.

Call objconn ("dsn name","username","password")

Open the connection with the command

Objconn.open ()

When there are no more users, close the database connection

Objconn.close ()

The ADO object enables interaction with database-stored procedures. It is used for running processes against a data store.

This helps to load the passages and questions from the data store and present to the user for viewing and analyzing it.

It helps to insert questions for the passages and retrieve it to the users.

These can be commands that return record sets or they could be commands that do not return any values. It is used to update the records in the dataset.

Set objcommand =server. Create object ("ADODB.command")

Objcommand.execute

These commands can be used to access the records in the database. We can modify or display all the records of a data store.

Set object =server. Create object ("ADODB.Recordset")

ObjRec.execute

ObjRec.open"SELECT " * from table name

4.6  VB Script

This language helps to present user interactive pages and shall have to be declared as the first command while writing the ASP codes.

This script used in the ASP file helps to design the home page, guest entry forms, question pages and the result page

4.6.1 Script language

<Html><head>

<Title>an example</title>

</head>

<Body bgcolor=blue>

<P>today’s date is

<Script language =Vbscript>

Document. Write (Date)

</script></body>

</html>

Front Page 98/2000/2002 helps to modify/create the web pages and presents it effectively to the users. This Interface helps to modify the guest entry page, logon page, home page and allows us to preview the web page before presenting it to the users.

IE 4.0 shall have to be installed in order to visualize the working of the software. The users need this to use the software to evaluate their performance and get the results.