Gradebook Mini Functional Specs

View 1 Overview

View Authorization

Limited to instructor and admin roles

Wireframe

Wireframe of View 1.gif

Wireframe of View 1

UI Components

Assignment Table

Sorting: initial sort is by due date. If there's no date, sort to the bottom of the list. The course grade always appears at the bottom of the list, regardless of sort. The sort order is preserved for the duration of the session.

Assignment Title link

If the assignment was created in the GB, this links to View 2.

If the assignment was created in Samigo, this links to the view in Samigo where you score.

The assignment name has a maximum character length of 50. We may want to adjust this number as we see how it looks on screen.

Point Display Values

Values chop at at 2 decimal points; they are not rounded up.

 

 

View 2 Assignment Detail

View Authorization

Limited to instructor and admin roles

Wireframe

Wireframe of View 2.gif

Wireframe of View 2

UI Components

Note: Using the next and previous buttons, the return to roster button, the page navigation and the search all save scores entered before executing. More info about what these buttons do is in the style guide.

Options links

'Edit assignment settings' links to View 4.

'Remove assignment from gradebook' links to View 6.

New scores saved message

I added this as an example confirmation message.

Student table

Sorting: initial sort is by student name. Non-default sorts are retained for the session.

Save button

Save the data and refreshes the view (average score is updated and 'changes saved' message added to top of page). The last executed search and students per page values are retained and displayed upon refresh.

Cancel button

Don't submit form, return the user to the referring page. In the current view this is always View 1.

Point Entry

Validation: Values must be >= 0. Decimal values are accepted. Commas and other non-numerical characters are not accepted. Thier inclusion will throw an error message: "Please enter numbers only into the points field."

After values are saved, maximum number of visible characters in text box = 3; these are right aligned. Values > 3 characters are scrollable.

View 2a Final Grade detail

This view is similar to view 2. UI components not in View 2 are noted.

Wireframe

Wireframe of View 2a.gif

Wireframe of View 2a

UI Components

Grade field & 'Use Calculated' button

The grade field is by default filled with the grade calculated by the gradebook. If the field is edited and saved, the next time it is viewed the 'Use Calculated' button is there.

Pressing the 'Use Calculated' button refreshes the page and returns the grade to the calculated value.

For purposes of calculating the course grade, a student's cumulative average percentage is never rounded up. For example, a student who achieves an overall pecentage of 79.99 would receive a course grade of C+, if the lower threshold for a B- is 80%.

View 3 Student roster

View Authorization

Limited to instructor and admin roles

Wireframe

Wireframe of View 3.gif

Wireframe of View 3

UI Components

Find field

Initial value: as in wireframe. When the focus comes to this field, the initial value should disappear.

Validation: It should ignore the default value. If there is no match, the page reloads, there is a note where the listing table would be saying no results found for "[the search term]" The "Find" and "Assignment" values return to the initial values. The last executed students per page value is retained and displayed. Use the style specified for alert messages in the style guide.

Action: It is searching the beginning of the first name, last name and id. So 'hol' will return 'Josh Holtzman' but 'tzm' or 'man' will not.

Assignment dropdown

Choices: All assignments (the default value) then each assignment in the grade book.

Student table

Sorting: Default sort is by student name. All other columns can sort as well. Alphabetic sorting is not case sensitive. Numbers are sorted numerically.

Export buttons

Make sure the CSV is downloaded, not opened in the window. The exported files are named gradebook-[classnumber]-050611.csv and .xls (the number is the date). If the class number is not available b/c the course management API has not been implemented, just use 'gradebook-050611.'

All available class data is exported. Filtering the view by student or assignment does not affect the output. The full student display names and complete assignment names are exported. Point values are chopped at 2 decimal places.

There is no navigation state change after clicking these buttons

Point Display Values

Values chop at 2 decimal points; they are not rounded up.

Student Sort Name Display

Display the first 50 charachters of the student name (uses elipsis if the name is more than 50 charachters)

Assignment Name Display

Display the first 10 charachters of the assignemnt name. Show full assignment name in the sort mouseover (using 'title' attribute).

View 4 Add/Edit Assignment

View Authorization

Limited to instructor and admin roles.

Wireframe

Wireframe of View 4.gif

Wireframe of View 4

UI Components

Title field

Validation: This is a required field.

Assignment point value field

Validation: Value must be > 0. Decimals are permitted. If the entry is point entry is invalid, any values entered or selected in title or date are retained with the error message: "Please only enter numbers in the Assignment Point Value. The point value must be >0."

Due date date-picker

Note: The date picker is highly specified in the style guide. We need to watch consistency with Sakai here. I have requested a change to the SG to make it possible to clear the date using the date picker.

Validation: Check for a valid date. (month, day and year selected).

Submit button

Add: If the submit validates, the user is returned to the Assignment summary page for this new assignment (View 2).

Edit: If the submit validates, the user is returned to the referring page (this is always View 2 in the 605 UI)

Cancel button

Don't submit form, return the user to the referring page. If the user was on the "roster' page when they clicked 'Add assignment' they return there.

View 5 Feedback options

View Authorization

Limited to instructor and admin roles.

Wireframe

Wireframe of View 5.gif

Wireframe of View 5

UI Components

Display Assignment Grades checkbox

Default value: checked

Display course grade checkbox

Default value: unchecked

Display final grade 'what's this' link

Opens the help window with information explaining why you shouldn't display the final grade until all of the assignments have been added or . It's OK to display it if the scores haven't been added, but the total points won't be accurate until all assignments are listed.

Grade Type dropdown

Choices: Letters grade +/- (default choice), Simple letter grade, Pass/Fail

Change grade type button

Action: Refreshes the page with the percent table matching the scheme chosen in the dropdown.

Validation: If course grades have been manually entered and the instructor attempts to change the grade type, the application will throw an error message: "You have manually entered course grades of the grade type X. To change the course grade type, you must first undo all manually overwritten course grades."

Reset to default values link

Refreshes the page. The minimum % values are returned to the institution default. Grade type remains the same.

Grade/percent table

If the values are changed, then the instructor changes to a different scheme, then switches back, the GB remembers the instructors previously entered scheme.

Manually overwriiten course grades are unaffected by changes to the Grade/percent table. If there are manually entered course grades, the application throws a warning message: "You have changed the grading scheme. All manually overwritten course grades remain unaffected."

Minimum Percent text box

Validation: Values must be >= 0. Decimal values are accepted. Commas and other non-numerical characters, including % are not accepted. Their inclusion will throw an error message: "Please only enter numbers in the Minimum Percent Value. The percent value must be greater than 0."

DisplayAfter values are saved, maximum number of visible characters in text box = 3; these are right aligned. Values > 3 characters are scrollable.

Save button

Returns the user to the page they came from, with a confirmation message saying "Student Feedback Options Saved"

Cancel button

Returns the user to the page they came from, with no confirmation message.

View 6 Remove assignment

View Authorization

Limited to instructor and admin roles.

Wireframe

Wireframe of View 6.gif

Wireframe of View 6

UI Components

Remove this assignment checkbox

Default value: unchecked

Validation: The form can't submit unless this button is checked.

Remove button

Marks the assignment as 'removed' in the database. It no longer appears in the database, but in an emergency could be recovered by an administrator. The tool then returns view 1 (overview) with a confirmation message : "Assignment deleted"

If the checkbox above has not been selected when submit is pressed, a validation message should appear: "You must confirm this deletion by checking the box below before removing."

Student View

View Authorization

Open to Student

Wireframe

Wireframe of View 6.gif

Wireframe of Student View

UI Components

Cumulative score

Visibility: This is visible if the instructor has checked the 'Display Assignment Grades' checkbox in view 5.

Calculation: The points taken equals the total of available points for assignments the instructional staff has scored for this assignment.

Final grade

Visibility: This is visible if the instructor has checked the 'Display Final Grade' checkbox in view 5.

Calculation: If any assignments have not been graded, the feedback indicates only how many points remain before the final grade. if all assignments have been scored, the final grade is given, e.g.: "B+ (805 out of 900 points)"

Assignment Title link

Links are only for assignments created in Samigo.

If the assignment was created in Samigo, this links to the view in Samigo where students receive detailed feedback.