Note:

If you want to create a new page for developers, you should create it on the Moodle Developer Resource site.

Activity Grading Interface Specification

From MoodleDocs
Revision as of 23:43, 3 April 2013 by Jason Hardin (talk | contribs) (→‎See also)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Visioning

Overview

Moodle's current activity grading interfaces are scattered across the course and lack a consistent look-and-feel. The features are separate and not always equal. Teachers are required to click through numerous screens in order to grade a student submission and to check for submissions that require grading. To view the student's submissions Teacher have to download or display a second screen, which slows down their grading process.

The activity grader interface (to be renamed) is designed to remove these issues and provide a teacher with:

  • A universal and simple grading interface that handles all gradeable Moodle plugins.
  • A decrease in the amount of time it takes for a teacher to grade all activity submissions that require grading.
  • A common communication interface between teachers and students for all gradeable activities.
  • An inline view of the student's submission while grading.
  • And a unified grading experience across all gradeable activities.

Moodlerooms has created and been running an activity grading interface for over a year now, it is called Activity Grading Interface (see [#References| References] for demo videos of existing functionality). Moodlerooms will be submitting this code to core for consideration for inclusion into Moodle. Modification may need to be made to the existing code to create a more cohesive activity grading interface. This specification depends on the Comments UI Update.

The activity grader is composed of the following functional specification areas:

  • ViewBase Activity Grading Interface - Describing the overall user interface design and setup
  • Navigation Pane - Describing how the teacher will navigate between students, groups and courses as well as filtering by activities needing grading.
  • Submission View Pane - Describing the user's inline view of the student's submission for the activity. Currently describes assignment and advanced forums activities as these are the only ones supporting advanced grading.
  • Grading Pane - Describes the grading interface for the activity, including the support for all advanced grading methods.
  • Activity Comments Pane - Describes the addition so submission comments to all gradeable Moodle activities within the Activity Grading Interface. This depends on the Comments UI Update.
  • Updates for Assignment in Moodle 2.4 - Describes the changes Moodlerooms needs to make to the existing functionality for full support for the new features in Assignment in Moodle 2.4.
  • Accessibility - Describes the accessibility requirements for the Activity Grading Interface.

Scenarios

Teacher Interacts With Activity Grading Interface via a Screen reader

A teacher with a visual disability wants to use the Activity Grading Interface to quickly grade all their student’s submissions. The teacher has setup the assignment to allow for online text only and needs to be able to navigate through Activity Grading Interface via a keyboard only. The user needs to know when modals appear and be able to close those and interact with them without getting confused about where they are within the page and the process.

Student Views Feedback From Activity Grading Interface in the User Grader Report

A student doesn’t always want to use Activity Grading Interface to understand their grade for an activity. Sometime they want to use the gradebook but also view the feedback from the teacher there in order to quickly understand feedback for all activities within the course.

Teacher Grades an Assignment Using Activity Grading Interface

A teacher needs to grade a student's submission to an assignment that they created in Moodle 2.3. The assignment allows for both online and file submissions and more than one file to be submitted. Further more the teacher needs to be able to grade the assignment using any of the advanced grading methods and wants to be able to not have to download submissions to their desktop, instead view them within the browser where they can.

References

Feature Information

Base Activity Grading Interface

Description

The Activity Grading Interface will be broken up into four panes within the Moodle page. The four panes will be navigation, submission view, grading, submission comments. The focus of the Activity Grading Interface is to provide the teacher with all of the information needed to grade a student's submission in one screen and provide a consistent interface across all gradeable activities.

Requirements
  1. The Activity Grading Interface will add a link within the Settings block under the Course Administration group titled Activity Grading Interface. See Teacher Settings Block and Student Settings Block
  2. The Activity Grading Interface will be separated into four panes with each focusing on one of the following functions: (see Mockup: Base Activity Grading Interface View)
    1. Navigation
    2. Submission viewing
    3. Grading/overall feedback for the submission
    4. Submission comments between the submitter and the grader.
  3. The Activity Grading Interface will be an API that any activity can plugin to.
  4. # Joule grader's grading and commenting areas will take up 1/3rd of the screen by default. See Mockup: Base Activity Grading Interface View
  5. Joule grader will allow the user to adjust the width of the grading and commenting area. See Mockup: Base Activity Grading Interface View
  6. The grading and commenting width adjustment will adjust both areas at once, the areas will always be the same width.
  7. The resizing of the grading area will require a user to click and drag a resizing bar.
  8. The HTML Editor and File attachment interfaces within the grading, activity and comments panels will resize when the resizing bar is dragged left or right.
Mockups
Teacher Settings Block

teacherSettingsBlock.png

Student Settings Block

studentSettingsBlock.png

Base Activity Grading Interface View

activityGradingInterface.png

Navigation Pane

Description

The navigation pane provides the teacher with the capability to navigate between activities, groups and students within a course. When the teacher navigates to one of these areas the student submission pane and grade/comments pane change to reflect the selection. Students are able to navigate between activities in a course.

Requirements
  1. The Activity Grading Interface will have two display modes:
    1. Fullscreen
    2. Normal
  2. The fullscreen display mode will be the default display mode for all users
  3. Activity Grading Interface will add a new user preference for display type and this will be saved to the last Activity Grading Interface display type the user used.
  4. In full screen mode Activity Grading Interface will only display the the four Activity Grading Interface panels, no theme header, footer or blocks (recommended the embedded theme layout be used). See Mockup: Teacher Full Screen Mode and Mockup: Student Full Screen Mode
  5. Block display will be disabled in full screen mode. See Mockup: Teacher Full Screen Mode and Mockup: Student Full Screen Mode
  6. In full screen mode the following will display to the teacher in the navigation pane: (see Mockup: Teacher Full Screen Mode)
    1. Return to course button
    2. Exit fullscreen mode button
    3. Show activities needing grading or Show all activities
    4. Previous activity arrow
    5. Activity drop down
    6. Next activity arrow
    7. Previous group arrow
    8. Group drop down
    9. Next group arrow
    10. Previous user arrow
    11. User drop down
    12. Next user arrow
  7. In full screen mode the following will display to the student in the navigation pane: (see Mockup: Student Full Screen Mode)
    1. Return to course button
    2. Exit fullscreen mode button
    3. Previous activity arrow
    4. Activity drop down
    5. Next activity arrow
  8. In normal mode will display the same elements for a teacher as the full screen mode except the Exit fullscreen mode button will be titled Display fullscreen. (see Mockup: Normal Teacher Navigation Pane)
  9. In normal mode will display the same elements for a student as the full screen mode except the Exit fullscreen mode button will be titled Display fullscreen. ( Mockup: Student Navigation Pane)
  10. When the user clicks the full screen button the full screen mode will display and the user’s view of Activity Grading Interface will stay in full screen mode until they click the button again, including after login and in other courses. See Mockup: Teacher Full Screen Mode and Mockup: Student Full Screen Mode
  11. When in the full screen mode the user click the exit full screen mode button to exit full screen mode. See Mockup: Teacher Full Screen Mode and Mockup: Student Full Screen Mode
  12. Full screen mode will be the default mode for Activity Grading Interface a user will have to click the exit full screen mode to display the header, footer and blocks. See Mockup: Teacher Full Screen Mode and Mockup: Student Full Screen Mode
  13. In full screen mode the Return to course button will send the user back to the course main page
  14. Selecting an activity in the activity drop down displays the submission, grade and comment data for the submission of the first student in the user drop down for the activity in the submission, grade and comment panes.
  15. Clicking the previous activity arrow displays the submission, grade and comment data for the submission of the first student in the user drop down for the previous activity in the activity drop down in the submission, grade and comment panes.
  16. Clicking the next activity arrow displays the submission, grade and comment data for the submission of the first student in the user drop down for the next activity in the activity drop down in the submission, grade and comment panes.
  17. The group previous, next and drop down elements will not display if the course doesn't have any groups in it.
  18. Selecting a group in the group drop down updates the student drop down to only display students in that group and displays in the submission, grade and comment panes the submission, grade and comment data for the submission of the first student in the user drop down for the currently selected activity in the activity drop down.
  19. Clicking the next group arrow updates the student drop down to only display students in that previous group in the group drop down and displays in the submission, grade and comment panes the submission, grade and comment data for the submission of the first student in the user drop down for the currently selected activity in the activity drop down.
  20. Clicking the previous group arrow updates the student drop down to only display students in that next group in the group drop down and displays in the submission, grade and comment panes the submission, grade and comment data for the submission of the first student in the user drop down for the currently selected activity in the activity drop down.
  21. Selecting a user in the user drop down displays in the submission, grade and comment panes the submission, grade and comment data for the submission of the student for the in the activity drop down.
  22. Clicking the next group arrow displays in the submission, grade and comment panes the submission, grade and comment data for the submission of the first student in the user drop down for the next group in the group drop down.
  23. Clicking the previous group arrow displays in the submission, grade and comment panes the submission, grade and comment data for the submission of the first student in the user drop down for the previous group in the group drop down.
  24. When the teacher clicks the Show activities requiring grading button the activity, group and user drop downs are filtered to only show the activities, groups for the activity and users for the activity that need grading. See Mockup: Needs Grading Teacher Navigation Pane
Mockups
Normal Teacher Navigation Pane

navigationPane.png

Needs Grading Teacher Navigation Pane

needsGradingNavigationPane.png

Student Navigation Pane

studentNavigationPane.png

Teacher Full Screen Mode

teacherFullScreen.png

Student Full Screen Mode

studentFullScreen.png

Use Cases
Teacher Views the Navigation Pane

Description

The teacher navigates to the Activity Grading Interface and views the navigation pane on the page.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in the course
  4. The course has students enrolled in the course
  5. The course has activities that are gradeable by Activity Grading Interface
  6. The course has groups in it

Steps

  1. The teacher clicks on the Activity Grading Interface link in the Settings block

Postconditions

  1. The teacher views the following in the navigation pane:
    1. Return to course button
    2. Exit fullscreen mode button
    3. Show activities needing grading or Show all activities
    4. Previous activity arrow
    5. Activity drop down
    6. Next activity arrow
    7. Previous group arrow
    8. Group drop down
    9. Next group arrow
    10. Previous user arrow
    11. User drop down
    12. Next user arrow
Student Views the Navigation Pane

Description

The student views the navigation pane for the first time.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a student in the course

Steps

  1. The student clicks on the Activity Grading Interface link in the settings block

Postconditions

  1. The student views the following in the navigation pane:
    1. Return to course button
    2. Exit fullscreen mode button
    3. Previous activity arrow
    4. Activity drop down
    5. Next activity arrow
Teacher Filters to Activities Needing Grading

Description

The teacher wants to quickly grade only those activities and students that have added a submission since the last time the teacher graded submissions.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in the course
  4. An assignment has been created in the course
  5. More than one student has created a submission for each assignment
  6. The teacher has not graded the student's submissions

Steps

  1. The teacher clicks on the Activity Grading Interface link in the Settings block
  2. The teacher clicks the Show activities needing grading button in the navigation pane

Postconditions

  1. The activities drop down lists only activities with student submissions that have no grade
  2. The student drop down shows only student's with submissions that have no grade
Teacher Selects an Activity From the Drop Down

Description

The teacher selects an activity from the activity drop down to grade the student's submissions for that assignment.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in the course
  4. More than one assignment has been created in the course
  5. More than one student has created a submission for each assignment

Steps

  1. The teacher clicks on the Activity Grading Interface link in the Settings block
  2. The teacher selects and activity from the activity drop down

Postconditions

  1. The group drop down changes to supported groups for the activity
  2. The view activity submission pane displays the activity submission for the currently selected student
Teacher Navigates to the Next Activity

Description

The teacher navigates to the next activity using the next activity arrow

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in the course
  4. More than one assignment has been created in the course
  5. More than one student has created a submission for each assignment

Steps

  1. The teacher clicks on the Activity Grading Interface link in the Settings block
  2. The teacher clicks on the next activity arrow button

Postconditions

  1. The group drop down changes to supported groups for the activity
  2. The view activity submission pane displays the activity submission for the currently selected student
Teacher Navigates to the Previous Activity

Description

The teacher navigates to the previous activity using the pervious arrow button

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in the course
  4. More than one assignment has been created in the course
  5. More than one student has created a submission for each assignment

Steps

  1. The teacher clicks on the Activity Grading Interface link in the Settings block
  2. The teacher clicks on the previous activity arrow button

Postconditions

  1. The group drop down changes to supported groups for the activity
  2. The view activity submission pane displays the activity submission for the currently selected student
Teacher Selects a Group From the Drop Down

Description

The teacher selects a specific group to grade within the activity

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in the course
  4. The course has more than one group created in it
  5. An assignment has been created and set to use groups
  6. More than one student has created a submission for the assignment

Steps

  1. The teacher clicks on the Activity Grading Interface link in the Settings block
  2. The teacher selects a group from the group drop down

Postconditions

  1. The student drop down changes to only display the students in the currently selected group.
  2. The view activity submission pane displays the activity submission for the currently selected student
Teacher Navigates to the Next Group

Description

The teacher selects the next group to grade within the activity

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in the course
  4. The course has more than one group created in it
  5. An assignment has been created and set to use groups
  6. More than one student has created a submission for the assignment

Steps

  1. The teacher clicks on the Activity Grading Interface link in the Settings block
  2. The teacher clicks the next group arrow button

Postconditions

  1. The student drop down changes to only display the students in the currently selected group.
  2. The view activity submission pane displays the activity submission for the currently selected student
Teacher Navigates to the Previous Group

Description

The teacher selects the previous group to grade within the activity

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in the course
  4. The course has more than one group created in it
  5. An assignment has been created and set to use groups
  6. More than one student has created a submission for the assignment

Steps

  1. The teacher clicks on the Activity Grading Interface link in the Settings block
  2. The teacher clicks the previous group arrow button

Postconditions

  1. The student drop down changes to only display the students in the currently selected group.
  2. The view activity submission pane displays the activity submission for the currently selected student
Teacher Selects a Student From the Drop Down

Description

The teacher selects a specific student to grade from the student drop down.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in the course
  4. An assignment has been created in the course
  5. More than one student has created a submission for the assignment

Steps

  1. The teacher clicks on the Activity Grading Interface link in the Settings block
  2. The teacher selects a student from the student drop down

Postconditions

  1. The view activity submission pane displays the activity submission for the currently selected student


Teacher Navigates to the Next Student

Description

The teacher uses the next student arrow to grade the next student's submission.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in the course
  4. An assignment has been created in the course
  5. More than one student has created a submission for the assignment

Steps

  1. The teacher clicks on the Activity Grading Interface link in the Settings block
  2. The teacher clicks the next student arrow button

Postconditions

  1. The view activity submission pane displays the activity submission for the currently selected student
Teacher Navigates to the Previous Student

Description

The teacher clicks the previous user arrow to grade the pervious student's submission

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in the course
  4. An assignment has been created in the course
  5. More than one student has created a submission for the assignment

Steps

  1. The teacher clicks on the Activity Grading Interface link in the Settings block
  2. The teacher clicks the previous student arrow button

Postconditions

  1. The view activity submission pane displays the activity submission for the currently selected student
Teacher Exits Fullscreen Mode

Description

The teacher exits out of full screen mode to access blocks and the header and footer in the Express design

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in a course on the site.
  4. An Assignment or Advanced forums exists in the course

Steps

  1. The teacher expands the course administrations link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher clicks the exist full screen mode button in the navigation bar

Postconditions

  1. The teacher views Activity Grading Interface with the header, footer and blocks
Teacher Enters Fullscreen Mode

Description

The teacher enters into fullscreen mode to maximize the information they can see within the Activity Grading Interface and focus on grading without distractions.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in a course on the site.
  4. An Assignment or Advanced forums exists in the course

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher clicks the Enter full screen mode button in the navigation bar

Postconditions

  1. The teacher views Activity Grading Interface without the header, footer and blocks.


Teacher Returns to the Course

Description

The teacher is in fullscreen mode and wishes to navigate back to the course and keep fullscreen mode as their default display mode.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in a course on the site.
  4. An Assignment or Advanced forums exists in the course
  5. The teacher has not entered fullscreen mode

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher clicks the Enter full screen mode button in the navigation bar
  4. The teacher clicks the Return to Course button

Postconditions

  1. The teacher is returned to the course main page
  2. If the teacher clicks on the Activity Grading Interface link in the settings block then Activity Grading Interface is displayed in fullscreen mode.

Submission View Pane

Description

The submission view pane is where the activity will renderer the student's submission for the teacher to view while grading. The submission view pane may include other information about the student's submission. This specification states how assignment and advanced forums should work as well as general support needs other activities would need with the Activity Grading Interface api.

Requirements
  1. The activity plugging into the Activity Grading Interface will determine how the submission pane is rendered
  2. Activity Grading Interface will display a sentence stating the submission was was late if the due date subtracted from the last modified date for the submission is negative. The sentence should read this submission was posted X days after the due date. See [#Assignment_Submission_View_Pane| Mockup: Assignment Submission View Pane]
  3. Activity Grading Interface will display all assignment submission types that are enabled in the right hand column in their own titled section if they are enabled in the assignment settings. See [#Assignment_Submission_View_Pane| Mockup: Assignment Submission View Pane]
  4. Activity Grading Interface will display a scroll bar if the display or one or more submission types takes up more than the area in left hand column of Activity Grading Interface.
  5. Activity Grading Interface will display the entire content of an online text submission as HTML. See [#Assignment_Submission_View_Pane| Mockup: Assignment Submission View Pane]
  6. Activity Grading Interface will display file submissions as a list of files with two linked options if there is more than one file submitted or more than one submission type with a submission: See [#Assignment_Submission_View_Pane| Mockup: Assignment Submission View Pane]
    1. View inline
      1. The view inline link associated with a file will only display for file types that can be displayed by Joule inline.
      2. Clicking the view inline link will hide all other submission areas in the left column and display the following: See [#Assignment_Submission_File_View_Pane| Mockup: Assignment Submission File View Pane]
        1. The file submissions area
        2. A icon linked to show the previous file if there is more than one file submitted
        3. A listing of all files submitted in a select drop down with an option to view all files and a hidden label
          1. Selecting a file brings the user to the file
          2. Selecting all files brings the user back to the submission screen. See [#Assignment_Submission_View_Pane| Mockup: Assignment Submission View Pane]
        4. An icon linked to show the next file if there is a next file in the list
        5. The file displayed in line if the file can be displayed inline, supported file types are:
          1. txt
          2. HTML
          3. jpg, jpeg
          4. gif
          5. bmp
          6. svg
          7. xml
          8. pdf (browser based only)
          9. Video supported by the video filter
      3. When a user clicks on the view inline link the user will be notified that the content on the page has changed and the user will be focused on the file submissions area, the page will not reload
      4. When a user clicks on the previous icon the user will be notified that the content on the page has changed and the user will be focused on the file loaded, the page will not reload
      5. When a user clicks on the next icon the user will be notified that the content on the page has changed and the user will be focused on the file loaded, the page will not reload
      6. When a user selects a file in the files drop-down the user will be notified that the content on the page has changed and the user will be focused on the file, the page will not reload
    2. Download
      1. The download link will display for all files
      2. Clicking the download link will download the file to the user's desktop
  7. If there are more than one file submitted to the assignment a link to download all files will display below the list of files. See [Assignment_Submission_View_Pane| Mockup: Assignment Submission View Pane]
  8. Clicking the download all link will download a zip file of all files submitted to the assignment.
  9. The advanced forum submission view pane will display the following information to a teacher about the current selected student's submission: (see [Advanced_Forums_Submission_View_Pane| Mockup: Advanced Forums Submission View Pane])
    1. The total number of posts and replies the user has created in the advanced forum
    2. The total number of posts a users has made in the advanced forum
    3. The total number of replies a used has made in the advanced forum
    4. The total number of user's posts and replies that a teacher has marked as substantive
    5. The average rating for all advanced forum posts will be displayed if rating of posts is enabled.
  10. Below the post information the advanced forums submission view pane will display the main first discussion post of any discussion a student has replied to with the student's posts in the discussion below it. See [Advanced_Forums_Submission_View_Pane| Mockup: Advanced Forums Submission View Pane]
  11. The advanced forum replies will display the following information: (see[Advanced_Forums_Submission_View_Pane| Mockup: Advanced Forums Submission View Pane])
    1. The user's picture
    2. The reply title
    3. The first and last name of the user that posted it
    4. The date the post was made
    5. The full text of the post
    6. A link to view the post in the context of the discussion
  12. Clicking on view in context clink will bring up a modal that will display the advanced forum in nested replies format and scroll to where the reply was made
  13. If a advanced forum is set to anonymous then the student's posts in the advanced forum will not show in the left column of the Activity Grading Interface.
  14. If a advanced forum is set to anonymous then the message this is an anonymous advanced forum will display in the left panel of the Activity Grading Interface below the student' statistics.


Mockups
Assignment Submission View Pane

assignmentViewPane.png

Assignment Submission File View Pane

assignmentInlineDisplay.png

Advanced Forums Submission View Pane

advancedForumsViewPane.png

Use Cases
Teacher Grades a Assignment Using Activity Grading Interface

Description

A teacher will be able to grade assignments via the Activity Grading Interface, viewing online submissions and file submissions inline.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in a course on the site.
  4. A Assignment has been created in the course using simple grading
  5. A student has posted a submission to the assignment

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher view the online submission on the left hand column
  4. The teacher enters a grade in the Grade text field
  5. The teacher clicks the Save button

Postconditions

  1. The grade is saved for the activity
  2. The grade is displayed in Activity Grading Interface to the teacher and student
  3. The grade is displayed in the grader report and Activity Grading Interface
  4. The grade is displayed in the assignment grading screen.
Teacher Views a File Submission Inline

Description

The teacher will be able to select file submissions to be viewed inline.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in a course on the site.
  4. A Assignment that allows file submissions has been created in the course
  5. A student has posted a file submission to the assignment that supports inline display (pdf).

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher clicks on the view inline link to the right of the file name

Postconditions

  1. The file is displayed inline in the left column
  2. Only the file submission area and the due information displays in the left column
Teacher Views the Next File Submission Inline

Description

The teacher will be able to select file submissions to be viewed inline.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in a course on the site.
  4. A Assignment that allows file submissions has been created in the course
  5. A student has posted more than one file submission to the assignment that supports inline display (pdf).

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher clicks on the view inline link to the right of the file name
  4. The teacher click on the next icon

Postconditions

  1. The file is displayed inline in the left column
  2. Only the file submission area and the due information displays in the left column
Teacher Views the Previous File Submission Inline

Description

The teacher will be able to select file submissions to be viewed inline.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in a course on the site.
  4. A Assignment that allows file submissions has been created in the course
  5. A student has posted more than one file submission to the assignment that supports inline display (pdf).

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher clicks on the view inline link to the right of the file name
  4. The teacher click on the next icon
  5. The teacher click on the previous icon

Postconditions

  1. The file is displayed inline in the left column
  2. Only the file submission area and the due information displays in the left column
Teacher Views All File Submission

Description

The teacher will be able to select file submissions to be viewed inline.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in a course on the site.
  4. A Assignment that allows file submissions has been created in the course
  5. A student has posted more than one file submission to the assignment that supports inline display (pdf).

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher clicks on the view inline link to the right of the file name
  4. The teacher selects All from the files drop-down

Postconditions

  1. The overview screen is displayed with all submissions.
Teacher Downloads a File Submission

Description

A teacher can download files that can’t be displayed inline to view them on their desktop.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in a course on the site.
  4. A Assignment that allows file submissions has been created in the course
  5. A student has posted a file submission to the assignment

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher clicks on the download link to the right of the file name

Postconditions

  1. The file is downloaded to the teacher’s desktop
Teacher Downloads All File Submissions

Description

A teacher can download all files that have been submitted to save for later or to view offline before grading.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in a course on the site.
  4. A Assignment that allows file submissions has been created in the course
  5. A student has posted a file submission to the assignment

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher clicks the download all link below the list of files.

Postconditions

  1. A zip file of all the submitted files is downloaded to the teacher’s desktop.
Student Views Activity Grading Interface Comments in the Assignment

Description

The student will be able to view overall feedback left in the Activity Grading Interface within the user gradebook report

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a student in a course on the site.
  4. An Assignment or Advanced forums exists in the course
  5. A student has posted a submission to the assignment
  6. A teacher has left overall feedback for the activity

Steps

  1. The student clicks on the assignment
  2. The student clicks on the View submission button
  3. The student expands the Comments group to the right of the submissions comment header

Postconditions

  1. The student sees any comments the teacher or they have made in Activity Grading Interface in the submission comments.
Teacher grades the student without ratings

Description

The teacher grades a student's advanced forum posts when the advanced forum is setup to not allow ratings.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in the course
  4. An advanced forum is created in the course
  5. Students have posted to the advanced forum

Steps

  1. The teacher navigates to the course
  2. The teacher navigates to the forum
  3. The teacher clicks the grade link in the settings block under forum administration
  4. The teacher views the student post statistics
  5. The teacher views the student's posts
  6. The teacher enters a grade for the student
  7. The teacher clicks the save button

Postconditions

  1. The student posts are displayed in the submissions view pane
  2. The student's post statistics are displayed in the submissions view pane without a rating.
Teacher grades the student with ratings

Description

The teacher grades student's posts in an advanced forum that has has been set to allow rating of posts.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in the course
  4. An advanced forum is created in the course
  5. Students have posted to the advanced forum

Steps

  1. The teacher navigates to the course
  2. The teacher navigates to the forum
  3. The teacher clicks the grade link in the settings block under forum administration
  4. The teacher views the student post statistics with the rating statistic added for average ratings
  5. The teacher views the student's posts
  6. The teacher enters a grade for the student
  7. The teacher clicks the save button

Postconditions

  1. The student posts are displayed in the submissions view pane
  2. The student's ratings is displayed in the post statistics based on the aggregation method chosen by the teacher.
Teacher grades the student for an anonymous forum

Description

The teacher grades the student's posts in an anonymous forums.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in the course
  4. An advanced forum is created in the course and is set to anonymous posting
  5. Students have posted to the advanced forum

Steps

  1. The teacher navigates to the course
  2. The teacher navigates to the forum
  3. The teacher clicks the grade link in the settings block under forum administration
  4. The teacher views the student post statistics.
  5. The teacher does not views the student's posts but instead views a message that the forum is anonymous
  6. The teacher enters a grade for the student
  7. The teacher clicks the save button

Postconditions

  1. The student posts are displayed in the submissions view pane
  2. The student's actual posts are not displayed

Grading Pane

Description

The grading pane is used to contain all the grading activities the teacher will need to do for a student for the activity. The grading pane supports all advanced grading methods and feedback types.

Requirements
  1. The activity plugging into the Activity Grading Interface will determine which grading type is displayed in the grading pane
  2. A grading area will display the following to a teacher if the activity doesn't use advanced grading:
    1. The student's current grade for the activity in a text input field out of the total number of points possible
    2. A button save the student's grade
    3. A button to save the student's grade and reload the Activity Grading Interface with the next student in the navigation pane's user drop down
    4. A text area to enter a text only overall feedback that will get stored in the gradebook
    5. If the activity is an assignment and file feedback is enabled an uploaded then the files upload interface
  3. Activities using an advanced grading method will display the student's current grade without an input field. See [#Rubric_Advanced_Grading_Modal_Teacher_View| Mockup: Rubric Advanced Grading Modal Teacher View]
  4. Activities using an advanced grading method will display a button with the text "Grade with <advanced grading type>" for the teacher. See [#Rubric_Advanced_Grading_Modal_Teacher_View| Mockup: Rubric Advanced Grading Modal Teacher View]
  5. A teacher clicking the grade with advanced grading method button a modal a modal will display with the grading interface for the advanced grading method.
    1. Rubric (see [#Rubric_Advanced_Grading_Modal_Teacher_View| Mockup: Rubric Advanced Grading Modal Teacher View])
    2. Checklist (see [#Checklist_Advanced_Grading_Modal_Teacher_View| Checklist Advanced Grading Modal Teacher View])
    3. Marking Guide (see [#Marking_Guide_Advanced_Grading_Modal_Teacher_View| Mockup: Marking Guide Advanced Grading Modal Teacher View])
  6. The advanced grading modal will display information based on the advanced grading form's settings for both student's and teachers. See [Checklist Advanced Grading Modal Student View Without Scores| Mockup: Checklist Advanced Grading Modal Student View Without Scores] as an example
  7. A grading area will display the following to a student if the activity doesn't use advanced grading: (see [#Marking_Guide_Advanced_Grading_Modal_Student_View| Mockup: Marking Guide Advanced Grading Modal Student View])
    1. The student's current grade for the activity out of the total number of points possible
    2. The teacher's overall feedback text
    3. If the activity is an assignment and file feedback is enabled and the teacher has uploaded a file that will display and be downloadable
  8. Activities using an advanced grading method will display a button with the text "View <advanced grading type>" for the student. See [#Rubric_Advanced_Grading_Modal_Student_View| Mockup: Rubric Advanced Grading Modal Student View]
  9. The student’s grade will display above the button to view the marking grade.
  10. A student clicking the view rubric button will display a modal with the rubric the teacher graded the student with. See [#Rubric_Advanced_Grading_Modal_Student_View| Mockup: Rubric Advanced Grading Modal Student View]
  11. A student clicking the view checklist button will display a modal with the checklist the teacher graded the student with. See [#Checklist_Advanced_Grading_Modal_Student_View| Mockup: Checklist Advanced Grading Modal Student View]
  12. A student clicking the view rubric button will display a modal with the rubric the teacher graded the student with. See [#Marking_Guide_Advanced_Grading_Modal_Student_View| Mockup: Marking Guide Advanced Grading Modal Student View]
  13. If a gradebook override has been created for a student then a checkbox with the text Previously, an instructor created a grade for this activity directly in the gradebook. Check this box if you want to replace that grade, too. will be displayed
  14. If a teacher checks the Previously, an instructor created a grade for this activity directly in the gradebook. Check this box if you want to replace that grade, too. checkbox the gradebook override for the activity and the student will be removed.
Mockups
Base Grading Pane

gradebookOverrideView.png

Rubric Advanced Grading Modal Teacher View

rubricTeacherView.png

Rubric Advanced Grading Modal Student View

rubricStudentView.png

Checklist Advanced Grading Modal Teacher View

checklistTeacherView.png

Checklist Advanced Grading Modal Student View With Scores

checklistScoreStudentView.png

Checklist Advanced Grading Modal Student View Without Scores

checklistNoScoreStudentView.png

Marking Guide Advanced Grading Modal Teacher View

markingGuideTeacherView.png

Marking Guide Advanced Grading Modal Student View

markingGuideStudent.png

Use Cases
Teacher Grades a Student With Simple Grading

Description

The teacher grades the student's activity using the simple grading method.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher
  4. An assignment has been created and set to use simple grading
  5. A student has posted a submission to the assignment

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher enters a grade value in the grade text input
  4. The teacher clicks the Save button

Postconditions

  1. The student's grade is saved
  2. The page is reloaded and the student's current grade is displayed in the input field.
Teacher Grades a Student With Simple Grading Entering a Grade Larger Than the Maximum Grade

Description

The teacher grades the student's activity using the simple grading with a grade over the maximum allowed points for the activity.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher
  4. An assignment has been created and set to use simple grading
  5. A student has posted a submission to the assignment

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher enters a grade value in the grade text input over the maximum points allowed
  4. The teacher clicks the Save button

Postconditions

  1. The student's grade is not saved
  2. The page is reloaded and the grade input field in blank.
  3. An error shows on the page stating that the grade value is over the maximum allowed points.
Teacher Grades a Student and Removes a Gradebook Override

Description

The teacher grades the student's activity using the simple grading method.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher
  4. An assignment has been created and set to use simple grading
  5. A student has posted a submission to the assignment
  6. The teacher has added a grade for the student for the assignment via the gradebook.

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher enters a grade value in the grade text input
  4. The teacher clicks the Previously, an instructor created a grade for this activity directly in the gradebook. Check this box if you want to replace that grade, too. checkbox
  5. The teacher clicks the Save button

Postconditions

  1. The student's grade is saved
  2. The page is reloaded and the student's current grade is displayed in the input field.
  3. The Previously, an instructor created a grade for this activity directly in the gradebook. Check this box if you want to replace that grade, too. checkbox doesn't display
  4. The gradebook override is removed.
Teacher Grades a Student With Simple Grading and Provides Feedback

Description

The teacher not only grades the student using simple grading but they also provide the student with and overall feedback for the submission and grade.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher
  4. # An assignment has been created and set to use simple grading and feedback comments are enabled
  5. A student has posted a submission to the assignment

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher enters a grade value in the grade text input
  4. The teacher enters overall feedback in the HTML editor
  5. The teacher clicks the Save button

Postconditions

  1. The student's grade is saved
  2. The page is reloaded and the student's current grade is displayed in the input field.
  3. The overall feedback is saved
  4. The overall feedback is displayed in the HTML editor on page reload.
Teacher Grades a Student With Simple Grading and Goes to the Next Student

Description

Instead of grading the student and saving the grade the teacher saves the grade and wants to go to the next student to grade.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher
  4. # An assignment has been created and set to use simple grading
  5. A student has posted a submission to the assignment

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher enters a grade value in the grade text input
  4. The teacher clicks the Save and next button

Postconditions

  1. The student's grade is saved
  2. The page reloads and displays the submission for the next student in the navigation pane's user drop down.
Student View's Their Simple Grade

Description

The student views their grade for the assignment in Activity Grading Interface.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a student
  4. An assignment has been created and set to use simple grading
  5. The student has posted a submission to the assignment
  6. The teacher has graded the submission

Steps

  1. The student expands the Course administration link group in the settings block
  2. The student clicks on the Activity Grading Interface link

Postconditions

  1. The student views their current grade out of the total points possible
  2. The student views any overall feedback left by the teacher.
Teacher Grades a Student With Rubric in Activity Grading Interface

Description

The teacher clicks on the grade with rubric button to grade the student's submission using a rubric.

Preconditions

  1. User is logged in
  2. User is enrolled in a course as a teacher
  3. The teacher has navigated to the course
  4. An assignment has been created in the course and set to use the rubric advanced grading method
  5. A rubric has been created for the assignment
  6. A student has posted a submission to the assignment

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher clicks the Grade with rubric button for the student
  4. The teacher fills in the rubric for the student
  5. The teacher clicks the Save button

Postconditions

  1. The student’s grade is calculated based on the rubric and the total grade for the activity
  2. The rubric modal is closed
  3. The student’s grade is saved.
Student Views Rubric in Activity Grading Interface

Description

The student views's the rubric that their submission was graded with.

Preconditions

  1. User is logged in
  2. User is enrolled in a course as a student
  3. The student has navigated to the course
  4. An assignment has been created in the course and set to use the rubric advanced grading method
  5. A rubric has been created for the assignment
  6. The student has posted a submission to the assignment
  7. The teacher has grade the assignment submission using the rubric advanced grading method

Steps

  1. The student expands the Course administration link group in the settings block
  2. The student clicks on the Activity Grading Interface link
  3. The student clicks the View grading rubric button

Postconditions

  1. The student views the modal rubric for how their submission was graded
  2. The student can view any overall feedback the teacher left.
  3. The student’s focus is in the modal
Teacher Grades a Student With Checklist in Activity Grading Interface

Description

The teacher clicks on the grade with checklist button to grade the student's submission using a rubric.


Preconditions

  1. User is logged in
  2. User is enrolled in a course as a teacher
  3. The teacher has navigated to the course
  4. An assignment has been created in the course and set to use the checklist advanced grading method
  5. A checklist has been created for the assignment
  6. A student has posted a submission to the assignment

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher clicks the Grade with rubric button for the student
  4. The teacher fills in the rubric for the student
  5. The teacher clicks the Save button

Postconditions

  1. The student’s grade is calculated based on the rubric and the total grade for the activity
  2. The rubric modal is closed
  3. The student’s grade is saved.
Student Views Checklist in Activity Grading Interface

Description

The student views the checklist used to grade their submission.

Preconditions

  1. User is logged in
  2. User is enrolled in a course as a student
  3. The student has navigated to the course
  4. An assignment has been created in the course and set to use the checklist advanced grading method
  5. A checklist has been created for the assignment
  6. A student has posted a submission to the assignment
  7. The teacher has grade the assignment submission using the checklist advanced grading method

Steps

  1. The student expands the Course administration link group in the settings block
  2. The student clicks on the Activity Grading Interface link
  3. The student clicks the View grading checklist button

Postconditions

  1. The student views the modal checklist for how their submission was graded
  2. The student can view any overall feedback the teacher left.
  3. The student’s focus is in the modal
Teacher Grades a Student With Marking Guide in Activity Grading Interface

Description

The teacher clicks on the grade with marking guide button to grade the student's submission using a rubric.

Preconditions

  1. User is logged in
  2. User is enrolled in a course as a teacher
  3. The teacher has navigated to the course
  4. An assignment has been created in the course and set to use the marking guide advanced grading method
  5. A marking guide has been created for the assignment
  6. A student has posted a submission to the assignment

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher clicks the Grade with marking guide button for the student
  4. The teacher fills in the marking guide for the student
  5. The teacher clicks the Save button

Postconditions

  1. The student’s grade is calculated based on the marking guide and the total grade for the activity
  2. The marking guide modal is closed
  3. The student’s grade is saved.
Student Views Marking Guide in Activity Grading Interface

Description

The student views the marking guide that was used to grade them.

Preconditions

  1. User is logged in
  2. User is enrolled in a course as a student
  3. The student has navigated to the course
  4. An assignment has been created in the course and set to use the marking guide advanced grading method
  5. A marking guide has been created for the assignment
  6. A student has posted a submission to the assignment
  7. The teacher has grade the assignment submission using the marking guide advanced grading method

Steps

  1. The student expands the Course administration link group in the settings block
  2. The student clicks on the Activity Grading Interface link
  3. The student clicks the View grading marking guide button

Postconditions

  1. The student views the modal marking guide for how their submission was graded
  2. The student can view any overall feedback the teacher left.
  3. The student’s focus is in the modal

Activity Comments Pane

Description

There are a number of usability issues with Activity Grading Interface and the other interfaces in Moodle such as the user gradebook report. We will be improving Activity Grading Interface to work on providing a teacher with more room to grade and read as well as add more support for core features like feedback.

Requirements
  1. The activity plugging into the Activity Grading Interface will determine if the submission comment pane is displayed
  2. Activity Grading Interface will display the following in the right hand column for the student when the activity uses simple grading: (see Mockup:Activity Grading Interface Student View)
    1. A grading area containing
      1. The student’s current grade for the activity
      2. The overall feedback from the gradebook
      3. If the activity is an assignment, file feedback is enabled, and a file was uploaded then the files uploaded with a link to download the file
    2. Comments area
  3. Activity Grading Interface will display the following in the right hand column for the student when the activity uses an advanced grading method: (see Mockup:Activity Grading Interface Student View)
    1. A grading area containing
      1. The student’s current grade for the activity
      2. A button to access the advanced grading form if an advanced grading method is used
    2. Comments area
  4. If an activity is set to an advanced grading method then overall feedback and a link to any uploaded file feedback will appear in the advanced grading screen. See Mockup: Activity Grading Interface Checklist Student View
  5. Activity Grading Interface will display the following in the right hand column for the teacher when an activity is set to an advanced grading method: (see Mockup: Activity Grading Interface Marking Guide Teacher View)
    1. A grading area containing
      1. The student’s current grade for the activity
      2. A button to grade the student with the advanced grading form if advanced grading is used
    2. Comments area
  6. Activity Grading Interface will display the following in the right hand column for the teacher when the activity is set to simple grading: (see Mockup:Activity Grading Interface Teacher View)
    1. A grading area containing
      1. The student’s current grade for the activity
      2. An hTMl editor to enter a text only overall feedback that will get stored in the gradebook
      3. If the activity is an assignment and file feedback is enabled an uploaded then the files upload interface
    2. Comments area
  7. If an activity is set to an advanced grading method then overall feedback html editor and file feedback file upload field for assignments will appear in the advanced grading screen. See Mockup:Activity Grading Interface Marking Guide Teacher View
  8. The overall feedback field will be a full HTML Editor. See Mockup:Activity Grading Interface Teacher View
  9. If the activity is a Moodle 2.3 assignment then the overall text feedback will also be stored in the Feedback comments plugin for assignment as well as the gradebook.
  10. Feedback provided to the user in the Moodle gradebook will show to the student in the Activity Grading Interface
  11. Feedback added in the Moodle gradebook will be editable in the Activity Grading Interface.
  12. When a student views Activity Grading Interface for an activity with advanced grading setup rename the button to view the advanced grading form to “View <advanced grading method> grading”, example is view checklist grading. See Mockup:Activity Grading Interface Checklist Student View
  13. Comments display will be updated to display the commenter’s picture, commenter’s name and date and time of the post above the comment. See Mockup:Activity Grading Interface Student View
  14. Activity Grading Interface will have the view rubric button renamed to grade with <advanced grading method> when a teacher views the button. (see Mockup:Activity Grading Interface Marking Guide Teacher View)
  15. The grade area will have a fieldset wrapped around it with the legend set to Grading. See Mockup:Activity Grading Interface Teacher View
  16. The comments area will have a fieldset wrapped around it with the legend set to Comments. See Mockup:Activity Grading Interface Teacher View
  17. A default comment type of Activity Grading Interface will be created for all activities that do not have their own comment grouping.
  18. Activity Grading Interface’s comment system will be converted to use the commenting api
  19. Activity Grading Interface will use the commenting api to render comments in the activity comments area.
  20. Activity Grading Interface will tell the commenting api to display comment order by the newest comment at the bottom.
  21. Activity Grading Interface will display as many comments as it can within the comment area
  22. If there are more comments than can be displayed in the comments area Activity Grading Interface will display a scroll bar for the user to view all comments.
Mockups
Activity Grading Interface Student View

assignmentStudentView.png

Activity Grading Interface Checklist Student View

checklistStudentView.png

Activity Grading Interface Teacher View

assignmentTeacherView.png

Activity Grading Interface Marking Guide Teacher View

markingGuideTeacherView.png

Use Cases
Teacher Posts Overall Feedback for an Advanced Forum with Simple Grading

Description

The teacher can enter over all feedback via the grader area of the Activity Grading Interface and have it show in the gradebook.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in a course on the site.
  4. An Assignment or Advanced forums exists in the course
  5. A student has posted a submission to the assignment

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher enters text in the Overall feedback text area
  4. The teacher clicks the Save button in the grading area.

Postconditions

  1. The feedback is stored in the database as text
  2. The feedback shows in the Activity Grading Interface grading area
  3. The feedback show in the grader report
  4. The feedback shows in the user gradebook report.
Teacher Posts Overall File Feedback for an Assignment With Simple Grading

Description

The teacher can post overall file feedback for assignments in Activity Grading Interface and know that a student can view it in other areas of Joule.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in a course on the site.
  4. An Assignment set to simple grading exists in the course and allows file feedback
  5. A student has posted a submission to the assignment

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher drags a file to the file upload areas
  4. The teacher clicks the Save button

Postconditions

  1. The file is uploaded to Joule
  2. The file feedback displays in Activity Grading Interface grading area
  3. The file feedback displays in the Assignment submission/grading page.
Teacher Posts Overall Feedback for an Advanced Forum With Advanced Grading

Description

The teacher can enter over all feedback via the grader area of the Activity Grading Interface and have it show in the gradebook.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in a course on the site.
  4. An Assignment or Advanced forums set to grade with an advanced grading method exists in the course
  5. A student has posted a submission to the assignment

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher clicks the View checklist button
  4. The teacher enters text in the Overall feedback text area
  5. The teacher clicks the Save button in the grading area.

Postconditions

  1. The feedback is stored in the database as text
  2. The feedback shows in the advanced grading popup in Activity Grading Interface
  3. The feedback show in the grader report
  4. The feedback shows in the user gradebook report.
Teacher Posts Overall File Feedback for an Assignment With Advanced Grading

Description

The teacher can post overall file feedback for and assignment configured to use advanced grader viw Activity Grading Interface.

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in a course on the site.
  4. An Assignment set to grade with an advanced grading method exists in the course and allows file feedback
  5. A student has posted a submission to the assignment

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher clicks the View checklist button
  4. The teacher drags a file to the file upload areas
  5. The teacher clicks the Save button

Postconditions

  1. The file is uploaded to Joule
  2. The file feedback displays in the advanced grading popup in Activity Grading Interface
  3. The file feedback displays in the Assignment submission/grading page.
Student Views Activity Grading Interface Feedback in the User Gradebook Report

Description

The student will be able to view overall feedback left in the Activity Grading Interface within the user gradebook report

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a student in a course on the site.
  4. An Assignment or Advanced forums exists in the course
  5. A student has posted a submission to the assignment
  6. A teacher has left overall feedback for the activity

Steps

  1. The student expands the Course administration link group in the settings block
  2. The student clicks on the Activity Grading Interface link

Postconditions

  1. The student can read the overall text feedback in the grade area of the right column.
Student Downloads File Feedback in Activity Grading Interface

Description

The student will be able to download file feedback the teacher has posted from within Activity Grading Interface

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a student in a course on the site.
  4. An Assignment or Advanced forums exists in the course
  5. A student has posted a submission to the assignment
  6. A teacher has left overall file feedback for the activity

Steps

  1. The student expands the Course administration link group in the settings block
  2. The student clicks on the Activity Grading Interface link
  3. The student clicks the Download link next to the file name in the grading area of the Activity Grading Interface

Postconditions

  1. The feedback file is downloaded to the user’s desktop.

Fullscreen Mode

Description

We will be improving Activity Grading Interface to work on providing a teacher with more room to grade and read. The fullscreen mode will remove the header and footer user interface from the theme.

Requirements

Updates for Assignment in Moodle 2.4

Description

There have been a couple additions to the grading features for the assignment activity in Moodle 2.4. Those include blind marking and group grading. Joule grade needs to be updated to support these features for the assignment activity. Assignment 2.2 also allowed teachers to comment on the student’s online text post with inline comments. This is done by the student’s entire online text being pre-populated into the overall feedback field. This feature is not currently in Assignment 2.3 but has been requested to be added back in ticket: [1]. Should this feature be added back into the assignment activity Activity Grading Interface also support it.

Requirements
  1. Activity Grading Interface comments for assignment 2.3 activities will be converted to assignment submission comments
  2. If an assignment has be configured to use inline comments the overall feedback field in Activity Grading Interface will be pre-populated with the online text the student has submitted
  3. If a student has not submitted an assignment then the overall feedback field will not be pre-populated
  4. If the overall feedback field already has text then the online text the student posted will not be copied to the overall feedback field.
  5. This feature requires that Moodle closes the following feature ticket https://tracker.moodle.org/browse/MDL-34432.
  6. If an assignment has enabled group grading Activity Grading Interface will display a yes/no drop down setting in the grading area. See Mockup: Activity Grading Interface Group Grading
  7. The text for the drop down will read “Apply grades and feedback to entire group”. See Mockup: Activity Grading Interface Group Grading
  8. If the Apply grades and feedback to entire group field is set to yes then all students will have the overall feedback and grade posted into the gradebook for the assignment. See Mockup: Activity Grading Interface Group Grading
  9. If the Apply grades and feedback to entire group is set to no then the grade and overall feedback will only be entered into the gradebook for the currently selected student.
  10. A help icon will be added to the right of the _Apply grades and feedback to entire group_ with the help text as follows appearing in a modal when it is clicked:(see Mockup: Activity Grading Interface Group Grading)
    1. If Yes is selected and a student has a gradebook override then the group grade will remove the gradebook override and the student will receive the grade of the group.
  11. If group grading is used and the student selected has a gradebook override then the gradebook override removal checkbox will appear disabled. See Mockup: Activity Grading Interface Group Grading
  12. If the _Apply grades and feedback to entire group_ field is set to No the gradebook override checkbox will be enabled. See
  13. When group grading is set then all students in the group assigned to the assignment will see all comments for the submission. See Mockup: Activity Grading Interface Group Grading
  14. When group grading is set then all students in the group assigned to the assignment will see all comments for the submission. See Mockup: Activity Grading Interface Group Grading
  15. If a teacher is grading a group and has entered a grade in the gradebook for a student the gradebook grade will be removed and the group grade will be applied to the student.
  16. Activity Grading Interface will only display comments if the allow comment submission setting is set to yes for the assignment.
  17. If blind marking is set for the assignment the user drop down in the navigation will list the word participant plus a number. The number will be determined the same way the assignment’s view/grade all submissions screen does. See Mockup: Activity Grading Interface Blind Marking
  18. If blind marking is set for the assignment Activity Grading Interface tell the commenting api to display all user’s information anonymously, except the teacher. See Mockup: Activity Grading Interface Blind Marking
  19. If the students have been revealed in the assignment Activity Grading Interface tell the comments API to display all user’s data with comments
  20. If a teacher is blind grading a student and has entered a grade in the gradebook for a student the gradebook grade will stay and the assignment process for grading will be followed once a student is revealed.
  21. Activity grading interface will not display the default group that assignment 2.4 uses for all users not in a group or in multiple groups. Activity Grading Interface will display only the groups that are in the course.
  22. # Activity Grading Interface will show all groups in a course and the teacher will be required to remember which group assignments they have associated with the assignment.
  23. Activity Grading Interface will display the user drop down list in alphabetical order at all times:
    1. After a group or activity has been selected
    2. After the show all activities or show activities needing grading buttons have been pressed
  24. Activity Grading Interface will not publish grades to the gradebook or remove gradebook overrides when blind marking is used for an assignment.


Mock ups
Activity Grading Interface Blind Marking

blindMarking.png

Activity Grading Interface Group Grading

groupGrading.png

Activity Grading Interface Group Grading Override

groupGradingNo.png

Use Cases
Teacher Makes a Comment in Activity Grading Interface That Shows in Assignment Submissions

Description

The teacher makes a comment in Activity Grading Interface for a Moodle 2.3 assignment.

Preconditions

  1. User is logged in
  2. User is enrolled in a course as a teacher
  3. A student has posted a submission to an advanced forum
  4. The teacher has navigated to the course

Steps

  1. The teacher clicks the Activity Grading Interface link in the Settings block under the Course administration group
  2. The teacher enters a comment in the text area
  3. The teacher clicks the Save comment button

Postconditions

  1. The comment is added into the comment area above the text area
  2. The page is not refreshed.
Activity Grading Interface Comments for an Assignment 2.3 are Upgraded

Description

The site is upgraded to the new version of Joule and all Activity Grading Interface comments for an assignment 2.3 are converted to assignment submission comments.

Preconditions

  1. The user is logged into the site
  2. The user is set to be a site administrator
  3. The user is at the site page
  4. A course has an assignment 2.3 in it
  5. The assignment 2.3 has a student submission
  6. The assignment 2.3 has Activity Grading Interface comments.

Steps

  1. The site administrator clicks the Notifications link
  2. The upgrade process executes
  3. The site administrator clicks the Continue button

Postconditions

  1. The comments show up in the Assignment 2.3 grade screen under submission comments
  2. The comments show up in the Activity Grading Interface in the comments area.
Teacher Grades an Online Text Assignment with Inline Comments Enabled

Preconditions

  1. User is logged in to the site
  2. The user has navigated to the course level
  3. The user is enrolled as a teacher in a course on the site.
  4. An Online text based Assignment set to grade via simple grading exists in the course

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link

Postconditions

  1. The Overall feedback field is pre-populated with with online text the student submitted.
Teacher Grades a Group for a Group Assignment via Activity Grading Interface

Description

The teacher decides to grade the group assignment using Activity Grading Interface.

Preconditions

  1. The user is logged in
  2. The user is enrolled as a teacher in a course
  3. The teacher has navigated to the course
  4. The teacher has created and assignment that has Students submit in a group set to yes
  5. One of the student’s in a group has submitted an assignment

Steps

  1. The teacher clicks on the Activity Grading Interface link in the Settings block
  2. The teacher selects the assignment in the activity selector in the navigation bar.
  3. The teacher selects the Group they wish to grade in the navigation bar
  4. The teacher enters a grade in the grade field
  5. The teacher clicks the Save grade button

Postconditions

  1. The grade is applied to all student’s in the group
  2. Navigating to any student in the group displays the same grade.
Teacher Grades a Single Student for a Group Assignment via Activity Grading Interface

Description

The teacher decides that one of the students in the group deserves a different grade than the rest.

Preconditions

  1. The user is logged in
  2. The user is enrolled as a teacher in a course
  3. The teacher has navigated to the course
  4. The teacher has created and assignment that has Students submit in a group set to yes
  5. One of the student’s in a group has submitted an assignment

Steps

  1. The teacher clicks on the Activity Grading Interface link in the Settings block
  2. The teacher selects the assignment in the activity selector in the navigation bar.
  3. The teacher selects the Group they wish to grade in the navigation bar
  4. The teacher enters a grade in the grade field
  5. The teacher select No in the Apply grades and feedback to entire group drop down
  6. The teacher clicks the Save grade button

Postconditions

  1. Only the student that was selected has the grade entered set for them.
Teacher Grades a Group a Group Assignment After Grading a Single Student via Activity Grading Interface

Description

The teacher has graded a single student and set Apply grades and feedback to entire group to no. Now the teacher is grading the rest of the group and setting Apply grades and feedback to entire group to yes.

Preconditions

  1. The user is logged in
  2. The user is enrolled as a teacher in a course
  3. The teacher has navigated to the course
  4. The teacher has created and assignment that has Students submit in a group set to yes
  5. One of the student’s in a group has submitted an assignment
  6. The teacher has graded one of the students in a group.

Steps

  1. The teacher clicks on the Activity Grading Interface link in the Settings block
  2. The teacher selects the assignment in the activity selector in the navigation bar.
  3. The teacher selects the Group they wish to grade in the navigation bar
  4. The teacher enters a grade in the grade field
  5. The teacher clicks the Save grade button

Postconditions

  1. All student’s grades are set to the new grade, including the student that was already graded.
Teacher Grades a Group After Adding a Grade for a Student in the Gradebook

Description

The teacher has overridden a grade for the assignment in the gradebook for one of the students in the group. The teacher then grades the group for the assignment and the grade is applied to all students.

Preconditions

  1. The user is logged in
  2. The user is enrolled as a teacher in a course
  3. The teacher has navigated to the course
  4. The teacher has setup an assignment that has group grading enabled.
  5. The teacher has recorded a grade for a student in the gradebook for the assignment

Steps

  1. The teacher clicks on the Activity Grading Interface link in the Settings block
  2. The teacher selects the assignment in the activity selector in the navigation bar.
  3. The teacher selects the Group they wish to grade in the navigation bar
  4. The teacher enters a grade in the grade field
  5. The teacher clicks the _Save grade_ button

Postconditions

  1. All student's grades are set to the new grade, including the student that was already graded.
  2. The student that had a grade in the gradebook has that grade replaced with the one entered in the grade field


Student Views Comments for a Group Assignment via Activity Grading Interface

Description

A student in a group for a group assignment navigates to Activity Grading Interface to view the other student’s comments.

Preconditions

  1. The user is logged in
  2. The user is enrolled as a student in a course
  3. The student has navigated to the course
  4. The teacher has created and assignment that has Students submit in a group set to yes
  5. One of the student’s has submitted a comment
  6. The teacher has also submitted a comment.

Steps

  1. The student clicks the Activity Grading Interface link in the Settings block
  2. The student selects the group assignment in the assignment drop down in the navigation bar.

Postconditions

  1. The student sees the comments from the teacher
  2. The student sees the comments made by other students.
Teacher Grades a Student for a Blind Marking Assignment

Description

The teacher has setup an assignment to use blind marking. They are going to grade the students.

Preconditions

  1. The user is logged in
  2. The user is enrolled as a teacher in a course
  3. The teacher has navigated to the course
  4. The teacher has setup an assignment that has blind marking enabled.

Steps

  1. The teacher clicks on the Activity Grading Interface link in the Settings block
  2. The teacher selects the assignment in the activity selector in the navigation bar.
  3. The teacher selects the User they wish to grade in the navigation bar
  4. The teacher enters a grade in the grade field
  5. The teacher clicks the Save grade button

Postconditions

  1. The teacher only sees the words Participant with a number instead of the student’s names in all areas where a student name normally appears (comments and user select in navigation bar).
Teacher Views a Student’s Assignment via Activity Grading Interface After Students Have Been Revealed

Description

The teacher has revealed the students and can now see their names in Activity Grading Interface.

Preconditions

  1. The user is logged in
  2. The user is enrolled as a teacher in a course
  3. The teacher has navigated to the course
  4. The teacher has setup an assignment that has blind marking enabled.
  5. The teacher has revealed the students in the assignment.

Steps

  1. The teacher clicks on the Activity Grading Interface link in the Settings block
  2. The teacher selects the assignment in the activity selector in the navigation bar.
  3. The teacher selects the user they wish to view in the navigation bar

Postconditions

  1. The teacher sees the student’s name in all locations they normally see the students name (comments and user select in navigation bar)

Accessibility

Description

Resolve all accessibility issues with Activity Grading Interface to make it WCAG A and AA compliant.

Requirements
  1. Add labels to all select drop-down form fields in Activity Grading Interface, these labels will be hidden via CSS (class=accesshide)’
  2. The advanced grading modal need to announce to the user that it has appeared on the screen
  3. The advanced grading modal need to hold the keyboard focus within the modal not letting the user tab out unless they have closed the modal
  4. The comment delete icon must have unique alt text such as select comment 1 for the first comment
Use Cases
Teacher Uses a Screen reader to Read Select Drop-downs

Description

The teacher is visually disabled and uses a screen reader and keyboard to navigate through Activity Grading Interface, specifically accessing the drop-down menus in the Activity Grading Interface navigation for group, activity and student.

Preconditions

  1. User is logged in
  2. User is enrolled in a course as a teacher
  3. User has posted a submission to a Assignment
  4. The teacher has navigated to the course

Steps

  1. The teacher expands the Course administration link group in the settings block
  2. The teacher clicks on the Activity Grading Interface link
  3. The teacher tabs through the Activity Grading Interface with the screen reader on

Postconditions

  1. Labels for each select drop-down are read by the screen reader to the user.
Student Clicks on Advanced Grading Button

Description

The student clicks on the advanced grading button to view how they were graded and the modal that appears tells the user there has been a change on the screen and presents focus in the modal.

Preconditions

  1. User is logged in
  2. User is enrolled in a course as a student
  3. User has posted a submission to a Assignment
  4. The teacher has grade the assignment submission using an advanced grading method

Steps

  1. The student expands the Course administration link group in the settings block
  2. The student clicks on the Activity Grading Interface link
  3. The student clicks the View grading <advanced grading name> button

Postconditions

  1. The student understands from the screen reader that a modal has popped up on the page.
  2. The student’s focus is in the modal
Student Tabs Through the Advanced Grading Modal

Description

The student uses the keyboard to tab through the advanced grading modal and is able to close it and access it without getting confused.

Preconditions

  1. User is logged in
  2. User is enrolled in a course as a student
  3. User has posted a submission to a Assignment
  4. The teacher has graded the assignment using an advanced grading method.

Steps

  1. The student expands the Course administration link group in the settings block
  2. The student clicks on the Activity Grading Interface link
  3. The student clicks the View grading <advanced grading name> button
  4. The student tabs through the links in the modal

Postconditions

  1. The student stays within the links in the modal when tabbing
  2. The student can access the close modal link.

Document Information

Revision Summary

Revision History

  • Jason Hardin 20130326: Updated to include more language around gradebook override removals, specifically that activity grading interface will remove gradebook overrides with group grading, but not when blind marking is used for assignments.
  • Jason Hardin 20130403: Updated the Base activity grading interface section to contain the requirements for the resizing bar that has been added. Uploaded new mockups.

See also

[Forum Discussion]

Retrieved from "https://docs.moodle.org/dev/index.php?title=Activity_Grading_Interface_Specification&oldid=38691"
Powered by MediaWiki