Manage Specific Quiz | Quiz Enhancements
We need to add a screen that allows users to view each student’s quiz submission for a specific quiz.
User Story: As an educator, I want to view a list of students who have/have not completed the quiz AND I want to view completed quizzes, so I can ensure my students are learning new skills.
Acceptance Criteria:
Given I am an educator who has clicked on a quiz from the Manage Assignments screen, I will see a list of all students I have access to who are assigned to or who have completed the quiz, based on filter selections.
Given that the student has not completed the quiz, we will show the unassign icon.
Given that the student has completed the quiz and has not yet been reassigned the quiz, we will show the reassign icon.
Given that I have clicked the unassign icon and confirmed I want to unsassign the quiz from the student, the student’s name will disappear from this list and the student will be unassigned from the quiz (quiz will not show in student center).
Given that I have clicked the reassign icon and confirmed I want to reassign the quiz to the student, I will see a new row for the student showing the quiz as not complete, and the student will see the quiz as not started in the student center under Due Today.
Given that I have clicked the reassign icon and confirmed I want to reassign the quiz to the student, I will continue to see the completed quiz for the student, in addition to the new assignment of the quiz.
Given the student has completed the quiz, and no one has yet reviewed it, I will see the Needs Review button.
Given the student has completed the quiz, and a user has already reviewed it, I will see the Reviewed button.
Given the student has completed the quiz, and no user has started a discussion with the student, I will see the Start button in the discussion column.
Given the student has completed the quiz, and a user has already started a discussion with the student, I will see the number of messages sent by users and the student in the discussion column.
Design:
https://www.figma.com/file/gdwMnbpudJxuzVrORrOGvd/Ed-Member-Site-UX?node-id=6115%3A57587
General Concept
UI
When the user clicks to view an assignment from the Manage All Assignments screen, they will see a table indicating the details of the assignment for each student
We will show a heading formatted as Domain Name | Area Name | Assignment Type | Grade | Tier Level
We will show a bar denoting class average and students who have completed the quiz
We will show one row for each instance of this assignment
We will show a column for:
Student Name
Status
Score
Date Assigned
Date Completed
Unassign/Reassign
Review
Discussion
The user may click the Load more button to load additional rows
If the user clicks on the “-” icon under the Unassign/Reassign column, the user will see a message asking if they are sure they would like to unassign the item. If the user clicks Unassign, the item will be unassigned from the student and this assignment will no longer show on the screen.
If the user clicks on the “+” icon under Unassign/Reassign column, the user will see a message asking if they are sure they would like to reassign the item. If the user clicks Reassign, the item will be assigned to the student and a new row will show for that assignment.
When the user clicks on the student name or reviewed/needs review link, they will be taken to the Review Assignment screen.
When the user clicks on an item in the Discussion column, they will be taken to the Review Assignment Screen (messaging will exist here).
When the user clicks on an item in the Discussion column, they will be taken to the Messaging Screen.
If the user clicks on the print button, we will print the assignment block as it currently shows on the screen
If the user clicks the export button, we will export the assignment block based on the current view.
Users may sort the table by any column
Business Rules
Domain name will show the lesson domain associated with the item
Area will show the lesson area associated with the item. For mental health items, this will not show.
Assignment Type will show Quiz.
Grade will show the grade associated with the item
Tier will show the tier(s) associated with the item. For mental health, this will not show.
Class average will be the average score students received on this quiz within the selected date range
Students completed will show both the number of students who have completed the quiz and the percent of students who have completed the quiz (out of those assigned), based on the filter settings
Student
We will list a row for each instance of the assignment within the date range. This means that if a student was assigned the item twice or submitted the item twice within the date range, their name will appear twice in the list. If a student was never assigned the item within the date range, they will not show in the list.
Students who have completed the assignment are clickable.
Status
Not Complete will show if the student was assigned the item, but did not complete it within the date range
Complete will show if the student completed the assignment within the date range
Score
We will show the score the student received on the quiz
Date Assigned
This will show the date the item was assigned to the student
Date Completed
This will show the date the item was completed by the student
If the student did not complete the item within the date range, we will show --
Unassign/Reassign
We will show the unassign icon “-” for any student who has not completed the assignment, regardless of date range. Clicking this will unassign the item from the student.
We will show the the reassign icon “+” for any student who has completed the assignment and does not have another instance of the item currently not completed, regardless of date range. Clicking this will assign the item to the student.
Review
If the student has not yet completed the assignment, we will show --. This is not clickable.
If the student has completed the assignment but the teacher has not yet marked it as reviewed, we will show Needs Review. Clicking this will take the user to the review screen.
If the student has completed the assignment and the teacher has already marked it as reviewed, we will show Reviewed. Clicking this will take the user to the review screen.
Discussion
If no discussion has been had related to this assignment, we will show Start. Clicking this will take the user to the view assignment screen (messaging will be available here)
If a discussion has been started related to this assignment, we will show the number of messages sent/received. Clicking on this will take the user to the view assignment screen (messaging will be available here) and they will see the messages sent and received.
For now, only show discussion buttons for complete quizzes. The column should be blank for quizzes not complete.
Delete this instance
Do not need to implement this at this time. Showing in design as an idea for a future enhancement.
Sort
Users may sort by any column, but we will default to sorting by date assigned (most recent to least recent)
Filter by Region
UI
Admins will see a filter for Region above the report
Clicking on this will produce a list of all regions
Clicking on a region will filter the results based on the selected region
Business Rules
Region filter will show for users with a role marked is admin AND have access to more than 1 region
We will list all regions the user currently has access to
Regions will be listed alphabetically
This is a single-select filter
If a region was previously selected on another screen (i.e. manage all assignments screen), we will keep this filter selection
Filter by Building
UI
Admins will see a filter for Building above the report
Clicking on this will produce a list of all buildings
Clicking on a building will filter the results based on the selected building
Business Rules
Building filter will show for users with a role marked is admin AND have access to more than 1 building
We will list all buildings the user currently has access to
Buildings will be listed alphabetically
This is a single-select filter
If the user selected a region, we will only list the buildings associated with that region
If the user selects a building and then changes the region, the building filter will reset
If a building was previously selected on another screen (i.e. manage all assignments screen), we will keep this filter selection
Search
UI
If the user clicks the search button, they will be able to type in the box to search by student name
Business Rules
If the user searches a name, we will search across first and last names for all students who are/were assigned the item based on filter settings
Classroom Filter
UI
If the user clicks the classroom filter, they may select a classroom from the list.
This selection will filter the data on the screen to reflect assignment data for students in the selected classroom.
Business Rules
The classroom filter will show all classrooms
the user is currently has access to AND
that have students assigned to at least 1 item or students who have submitted at least 1 item
We will list classrooms alphabetically
This is a single select filter
If the user filters by classroom, we will only show details for the assignment for students in the selected classroom
If a classroom was previously selected on another screen (i.e. manage all assignments screen), we will keep this filter selection
Date Filter
UI
If the user clicks on the date filter, they will see a variety of pre-set options and a calendar to select a date range.
The pre-set options are:
Past 7 days
Past 30 days
Past 90 days
Past year
If the user clicks on dates on the calendar, they will need to select 2 dates to create a date range.
Business Rules
If the user filters by date range, we will only show students actively assigned to the item within the date range OR students who completed the item within the date range
We will default to Past Year (365 days)
If a date range was previously selected on another screen (i.e. manage all assignments screen), we will keep this filter selection