Access Keys:
Skip to content (Access Key - 0)

Moodlerooms Manual

The most recent documentation for Moodle/Joule 2 has moved.

Please go to http://kb.moodlerooms.com to view the New Knowledge Base.

Table of Contents

1. Advanced Forum

1.1. Overview

Advanced Forums enhance Moodle Forums by providing teachers and students with quick, simple views into the forums and their discussions.  Allowing users to sort and search discussions easily and in multiple layouts is key to Advanced Forums increased usability. Read tracking is a feature in Advanced forums that highlights unread posts, making it even easier to manage a forum. This saves the student time in viewing and responding to posts, and saves the teacher time in finding the posts that are most relevant to the class. Teachers are empowered to create anonymous interactions with students while still being able to provide accurate grading with advanced grading methods. Teachers are confident that their grading of the forum content reflects the content the student is posting, by allowing a teacher to grade a forum while viewing the student's posts.

1.2. User Documentation

With Advanced Forums you can browse and reply to previous posts, make new posts, bookmark threads so you can revisit them, and mark them "Substantive" meaning that they have substance and are relevant to the topic. To access Advanced Forums, log in to your site and navigate to the Advanced Forum activity in your course. The main forum page opens.

main forum page with forums listed

1.2.1. Adding New Discussion Topics

To add a new topic to the forum, click Add a new discussion topic.

add topic button

Your new discussion topic page opens where you can create a new forum post.

add new topic page where you create new posts

Enter the following information:

  • Subject: Enter the subject of the post. This will be what people browsing posts will read. This field is required.
  • Message: Enter the body of the post. This field is required.
  • Subscription: Select whether you do or do not want e-mail notifications of posts to this topic.
  • Attachment: Click Add to attach a file to the post.

When you have completed your post and are ready to publish it, click Post to forum.

post to forum button

1.2.2. Viewing and Sorting Advanced Forums

Click on a discussion topic link in the Advanced Forum to view the post. The original discussion appears with all replies listed.

discussion thread screen

You can customize how Advanced Forums are displayed. Decide how to display forums several different ways using the drop-down menu toward the top right.

discussion display drop down menu

You can display forums in the following ways:

  • Default: Displays discussion topics in a table-like format. Discussion, Started by, Replies, Unread, and Last post are listed across the top with discussion topics listed below according to how you sort them with the drop-down menus at the top.
  • Tree: Displays discussion topics in a data tree format with discussion topics listed with plus signs next to them which expand the discussion when clicked.
  • Nested: Displays discussion topics in a more streamlined way than Default with discussion topics listed in rows. This is an instructor preference only as students will always see the default view. Clicking on the topic will expand within the same window with the discussion.

You can customize how the discussion/ replies are displayed on the screen with the drop-down menu at the top of the page.

drop down menu with discussion display options

You can display discussions the following ways:

  • Display replies flat, by user first name: Displays full replies listed under the original discussion alphabetically by user first name.
  • Display replies flat, by user last name: Displays full replies listed under the original discussion alphabetically by user last name.
  • Display replies flat, with oldest first: Displays full replies listed under the original discussion by date with oldest first.
  • Display replies flat, with newest first: Displays full replies listed under the original discussion by date with newest first.
  • Display replies in threaded form: Displays replies chronologically as links to the new page showing only the reply clicked.
  • Display replies in nested form: Displays replies chronologically and indented under the original discussion.

You can navigate to the next/ previous discussion in the forum with the (Topic title) Next/Previous links at the top/ bottom left/ right of the page.

next button previous button

Sort forums a number of ways using the drop-down menus toward the top left.

sort drop down menu

You can sort discussions the following ways:

  • Sort by last post date: Sorts posts/replies from most recent to oldest.
  • Sort by creation date: Sorts original discussion posts from oldest to most recent.
  • Sort by first name: Sorts posts alphabetically by the author's first name.
  • Sort by last name: Sorts posts alphabetically by the author's last name.
  • Sort by number of replies: Sorts posts from most replies to least replies.
  • Sort by number of unread posts: Sorts posts from most to least number of unread posts.

For each of the sorting options above, you can arrange the posts in Ascending or Descending order by choosing one from the drop-down menu.

ascending and descending drop down menu

1.2.3. Searching Advanced Forums

Search Advanced Forums by placing key words in the box and clicking Search forums.

search box

1.2.4. Read Tracking

You can configure two settings related to Advanced Forums in your user profile regarding subscriptions and read tracking. Configure these settings by logging into your course and navigating to Settings > My profile settings > Edit profile. Locate the following drop-down menus and choose the desired settings.

drop down menus for options discussed below

  • Forum auto-subscribe: If set to yes, will automatically subscribe a user to a forum when the user posts in that forum.
  • Forum tracking: If set to yes, will keep track of posts that have/ haven't been read by showing new posts highlighted in color.

1.3. Teacher Documentation

1.3.1. Creating an Advanced Forum Activity

Creating an Advanced Forum activity is similar to creating other activities in Joule/ Moodle. The Teacher adds the activity via the Turn editing on button and selects Activity > Advanced forum in the Add Activity drop-down menu of a course. The Adding a new Advanced Forum to page opens.

1.3.1.1. General

general settings for advanced forum discussed below

Enter the General settings:

  • Forum name: This will appear on the course page and will typically signal to users the purpose or type of certificate being issued.
  • Forum type: There are five different types of forums to choose from.
    • A single simple discussion: This is a discussion topic which everyone can reply to.
    • Each person posts one discussion: In this forum, each student can post exactly one new discussion topic, which everyone can then reply to.
    • Q and A forum: For this forum type, students must first post their perspectives before viewing other students' posts.
    • Standard forum displayed in a blog-like format: This is an open forum where anyone can start a new discussion at any time, and in which discussion topics are displayed on one page with "Discuss this topic" links.
    • Standard forum for general use: This forum type is an open forum where anyone can start a new discussion at any time.
  • Enable anonymous posting: If enabled, then the author's name for each post will be suppressed when viewing the forum.
  • Forum introduction: Text entered here will be displayed to students when they open the Advanced forum activity. This can be descriptive and indicate the subject/topic to be discussed.
  • Display description on course page: If enabled, this setting displays the forum description on the front page of the course.
  • Subscription mode: This setting determines the subscription requirements, or lack thereof, for the forum.
  • Read tracking for this forum: This setting determines the read tracking requirements, or lack thereof, for the forum.
  • Maximum attachment size: This setting limits the file size of attachments that can be uploaded to the forum.
  • Maximum number of attachments: This setting limits the number of individual attachments that a user can upload to one forum post.
1.3.1.2. Post Threshold For Blocking

post threshold for blocking settings discussed below

Enter the Post threshold for blocking settings:

  • Time period for blocking: Students can be blocked from posting more than a given number of posts in a given time period. Users with the permission to Post without throttling are exempt from post limits. Select Don't block or the number of days you wish to block the user from posting again.
  • Post threshold for blocking: This setting specifies the maximum number of posts which a user can post in the given time period. Users with the capability mod/hsuforum:postwithoutthrottling are exempt from post limits.
  • Post threshold for warning: This setting warns students as they approach the maximum number of posts allowed in a given period. This setting specifies after how many posts they are warned. Users with the capability Post without throttling are exempt from post limits.
1.3.1.3. Grade

grade settings discussed below

Enter the Grade settings:

  • Grade Type: This setting is used to determine the method of grading. There are three grade types to choose from.
    • None: Selecting this option means that the forum is not graded.
    • Manual: Selecting this option means that the forum has to be manually graded by the teacher via the Moodle Grader Report or the Joule Gradebook.
    • Rating: Selecting this option means that the forum uses ratings for generating a grade, given inside the forum context.
  • Grade: This is the grade format used for the activity (i.e. number grade, scale, no grade).
  • Grading method: Here, you should choose the advanced grading method that should be used for calculating grades in the given context. To disable advanced grading and switch back to the default grading mechanism, choose 'Simple direct grading'.
  • Grade category: This setting controls the category in which this activity's grades are placed in the Gradebook.
1.3.1.4. Ratings

ratings settings discussed below

Enter the Ratings settings:

  • Roles with permission to rate posts: To submit ratings, users require the moodle/rating:rate capability and any module-specific capabilities. Note that nothing will appear here unless the list of roles has been amended via the Permissions link in the settings block.
  • Aggregate type: The aggregate type defines how ratings are combined to form the final grade in the gradebook.
    • No ratings - If No ratings is selected, then the activity will not appear in the gradebook.
    • Average of ratings - The mean of all ratings.
    • Count of ratings - The number of rated items becomes the final grade. Note that the total cannot exceed the maximum grade for the activity.
    • Maximum rating - The highest rating becomes the final grade.
    • Minimum rating - The lowest rating becomes the final grade.
    • Sum of ratings - All ratings are added together. Note that the total cannot exceed the maximum grade for the activity.
  • Grading scale: Select the scale associated with the activity (if one is being used).
  • Restrict ratings to items within a date range: Only allow ratings to be set for a post between the from and to dates
  • From: The date and time that ratings can begin being submitted.
  • To: The date and time that ratings will no longer be accepted.
1.3.1.5. Common Module Settings

common module settings discussed below

Enter the Common Module Settings:

  • Group Mode: This setting determines the display properties to users within groups
    • No groups - There are no sub groups, everyone is part of one big community.
    • Separate groups - Each group member can only see their own group, others are invisible.
    • Visible groups - Each group member works in their own group, but can also see other groups.
      Note
      The group mode defined at the course level is the default mode for all activities within the course. Each activity that supports groups can also define its own group mode, though if the group mode is forced at the course level, the group mode setting for each activity is ignored.
  • Grouping (Advanced): A grouping is a collection of groups within a course. If a grouping is selected, students assigned to groups within the grouping will be able to work together.
  • Visible: Determines if the activity is displayed to students or not within the course.
  • ID Number: Teachers who want to create advanced grade calculations within the gradebook can create a unique ID number here. This allows the creation of formulas in the grade book that perform calculations using the grades within this activity. For example, the instructor might create a gradebook calculation that multiplies the number of points in the Midterm (see the image above where the ID number is set to Midterm) by 2 in order to emphasize its importance to the course grade.
1.3.1.6. Restrict Access

restrict access settings discussed below

Determine how access to the Advanced Forum is handled using the following options:

  • Allow access from/until: These dates determine when students can access this course item on the course page.
  • Release code: This course item will not be available to students until the student acquires the release code entered here.
  • Grade condition: This setting determines any grade conditions which must be met in order to access this course item. Multiple grade conditions may be set if desired. If so, this course item will only allow access when ALL grade conditions are met.
  • Completion condition/Before this can be accessed: This setting determines any activity completion conditions which must be met in order to access this course item. Note that completion tracking must first be set before an activity completion condition can be set. Multiple grade conditions may be set if desired. If so, this course item will only allow access when ALL grade conditions are met.

Click on one of the following options when you are finished:

  • Save and return to course: This option saves the Advanced Forum and returns to the course main page.
  • Save and display: This option saves the Advanced Forum and opens it for viewing.
  • Cancel: this option does not save the Advanced Forum and returns you to the course main page.

1.3.2. Flagging Advanced Forums

Teachers have the ability to flag posts in Advanced forums. This can be done in one of two ways:

  • Bookmark: When this feature is selected, it serves as an indicator that you wish to return to this post later for some reason. Click the bookmark icon to bookmark a post.
  • Substantive: When this feature is selected, it serves as an indicator that the post is relative to the topic or significant in some way. This can factor into grading. Click the substantive icon to mark a post as substantive.

1.3.3. Moving Discussions

move discussion drop down menu

Teachers can move discussions to other Advanced Forums. To do so, select and click on a forum from the Move this discussion to... drop-down menu to move the discussion.

1.4. Administrator Documentation

Advanced forums are turned on by default in all new and upgraded sites. If you wish to change the permissions for different roles, navigate to Settings > Course administration > Users > Permissions. Scroll or filter to Activity: Advanced Forum.

Edit the following permissions at the user role level:

  • Add news: This allows a user to start discussions in a News forum. This capability is allowed for the default roles of manager, teacher, and non-editing teacher.
  • Add question: This allows a user to add a question to a Q & A forum. This capability is allowed for the default roles of manager, teacher, and non-editing teacher.
  • Allow user to respond privately: This allows a user to respond to forums privately.
  • Create attachments: This allows a user to add attachments. This capability is allowed for the default roles of manager, teacher, non-editing teacher, and student.
  • Delete any posts (anytime): This allows a user to delete any forum post at any time. This capability is allowed for the default roles of manager, teacher, and non-editing teacher.
  • Delete own posts (within deadline): This allows a user to delete their own forum posts within a certain time period as set by an administrator (the default is 30 minutes). This capability is allowed for the default roles of manager, teacher, non-editing teacher and student.
  • Edit any post: This allows a user to edit any forum post at any time. This capability is allowed for the default roles of manager, teacher, and non-editing teacher.
  • Export whole discussion: This allows a user to export a forum discussion to any portfolio enabled for the site. This capability is allowed for the default roles of manager, teacher, and non-editing teacher.
  • Export own post: This allows a user to export their forum posts to any portfolio enabled for the site. This capability is allowed for the default roles of manager, teacher, non-editing teacher, and student.
  • Export post: This allows a user to export any forum post to a portfolio. This capability is allowed for the default roles of manager, teacher, and non-editing teacher.
  • Manage subscriptions: This allows a user to manage forum subscriptions. This capability is allowed for the default roles of manager, teacher, and non-editing teacher.
  • Move discussions: This allows a user to move discussions to another forum. This capability is allowed for the default roles of manager, teacher, and non-editing teacher.
  • Exempt from post threshold: This allows a user to post in a forum without ever being blocked (i.e. it exempts them from the post threshold for blocking, as set in Settings > Forum administration > Edit settings). This capability is not set for the default role of student and is allowed for the roles of manager, teacher, and non-editing teacher.
  • Rate post: This allows a user to rate forum posts for forums which allow posts to be rated. This capability is allowed for default roles of manager, teacher, and non-editing teacher and is not set for the default student role.
  • Reply to news: This allows a user to reply to posts in a News forum. This capability is allowed for the default roles of manager, teacher, and non-editing teacher.
  • Reply to posts: This allows a user to reply to forum posts. This capability is allowed for the default roles of manager, teacher, non-editing teacher, and student.
  • Reveal yourself in an anonymous forum: This allows a user to reveal themselves in an anonymous forum.
  • Split discussions: This allows a user to split forum discussions. Splitting a discussion means that beginning with the post selected and going to the end of that thread; the posts are cut from the current discussion topic and put into a newly created discussion topic. If discussion has strayed away from the original topic, splitting the discussion can provide new attention and space for the tangent discussion while keeping the original discussion on topic. This capability is allowed for default roles of manager, teacher, and non-editing teacher.
  • Start new discussions: This allows a user to start forum discussions. This capability is allowed for the default roles of manager, teacher, non-editing teacher, and student.
  • View all ratings given by individuals: This allows a user to view all ratings given to forum posts. This capability is allowed for the default roles of manager, teacher, and non-editing teacher.
  • View total ratings that anyone received: This allows a user to view total ratings given to forum posts. This capability is allowed for the default roles of manager, teacher, and non-editing teacher.
  • View discussions: This allows a user to view forum discussions. This capability is allowed for the default roles of manager, teacher, non-editing teacher, student, and guest.
  • View post flags: This allows a user to see post flags in Advanced forums. This capability is allowed for the default roles of manager, teacher, and non-editing teacher.
  • View hidden timed posts: This allows a user to create timed posts i.e. set a display start and end date for a new forum discussion. It also allows a user to view timed posts while they are hidden. This capability is allowed for default manager, teacher, and non-editing teacher roles and is not set for the default student role. The timed posts feature is disabled by default. It may be enabled in the Forum settings via Settings > Site administration > Plugins > Activity modules > Forum.
  • View forum posters: This allows a user to view forum posters. This capability is allowed for the default roles of manager, teacher, non-editing teacher, and student.
  • Always see Q and A posts: This allows a user to view Q & A forum posts without first posting. By default a Q and A forum requires students to post once before viewing other students' postings. This capability is allowed for the default roles of manager, teacher, and non-editing teacher.
  • View the total rating you received: This allows a user to view their ratings for forum posts. This capability is allowed for the default roles of manager, teacher, non-editing teacher, and student.
  • View subscribers: This allows a user to view the list of subscribers to a forum. This capability is allowed for the default roles of manager, teacher, and non-editing teacher.

2. Access ID

2.1. Overview

The access ID authentication plugin is used to single sign on (SSO) a user to Joule from an external system such as Campus Vue. The access ID plugin works by using a shared secret between Joule and the external system. Based on this shared secret and a configured administrative login, the external system generates a one time use token that can be used to craft a unique URL. The external system provides the unique URL to the user and once clicked, Joule validates the user's access based on the IP of the external system as well as the unique token and shared secret. This system is a secure token based authentication via a shared system for constructing and deconstructing generated tokens.

2.2. Global Settings

To get to the Access ID settings, navigate to the settings block and select Site administration > Plugins > Authentication > Access ID authentication

settings block path to get to Access ID authentication settings in the path above

Configure the general settings.

general settings for the Access ID authentication plugin described below

  • Allowed IP list: Enter all IPs that can communicate with the authentication plug-in. Put every entry on one line. Only full IP addresses or addresses in CDIR notation will be accepted as valid entries.
  • Secret key: The secret key entered must be identical to the one configured on the side of the system with which you are configuring the single sign-on from.
  • Username: Specify the username for accessing the endpoint URL.
  • Password: Specify the password for accessing the endpoint URL.
  • User Lookup: Specify Joule user profile field used for user lookups.
    • idnumber
    • username
  • Access ID Duration: Specify the duration that a generated Access ID is valid (in minutes). Default:5 mins
  • Hashing algorithm: Specify hash algorithm validation for incoming parameters.
    • SHA-256 (default)
    • SHA-1

2.2.1. Lock user fields

The lock user fields section of the authentication plugin's settings is used to lock a user's access to update a user profile field's value. This is useful for user data that is updated via an external system or that the administrator doesn't want the user to change after it has been entered. If you are locking fields that are required by Moodle, make sure that you provide that data when creating user accounts or the accounts will be unusable. Consider setting the lock mode to 'Unlocked if empty' to avoid this problem. Administrators can only lock the following profile field:

  • First name
  • Surname
  • Email address
  • City/town
  • Country
  • Language
  • Description
  • Web page
  • ID number
  • Institution
  • Department
  • Phone 1
  • Phone 2
  • Address

Each profile field can be set to one of the following settings with the default being unlocked:

  • Unlocked: The user can change the value in the profile field at anytime.
  • Unlocked if empty: The user can only set the value for the user profile field once. If the value is set by an external system the user cannot change it in Joule.
  • Locked: The user cannot change the user profile field's value in Joule, it must be changed by an administrator or by an external system.

2.3. Example Code

The following code examples compare a generated hash using the variables:

  • Shared Secret: GerwtYxxd34
  • userid: janedoe
  • timestamp: 1326827023
  • username: jdoe
  • pass: pass

Expected token: 153283f1909be96a23a3324b345098010320b0db1fd71a726bbad0ca3cfd67ff

2.3.1. Java Example

Java Example

2.3.2. PHP Example

PHP Example

3. Checklist

The Checklist advanced grading method is an easy way for the user and teacher to view a list of criteria and the associated grade value for each criteria. The Checklist provides teachers with a simple way to assign points to a set of criteria for grading any activity in Moodle that allows the use of advanced grading (currently Assignment and Advanced forum). Checklists allow the teacher to consistently grade all students on an activity with the same list of criteria and the same point values for each. Grades entered by the teacher in the Checklist are automatically entered into the gradebook.

3.1. User Documentation

3.1.1. Viewing Checklists For Assignments

If a checklist is being used for an Assignment and a Teacher or Site Administrator is allowing students to view it, then you can view the criteria for grading and the point for each prior to submission. Log in to your course and navigate to an Assignment. Go to the Navigation block and select Submissions grading under the Assignment name.

navigation path to submission grading for assignments

The Submissions grading page opens, displaying the grading criteria and the points available for each one.

list of criteria and points available

For assignments, you can view the graded checklist by viewing the assignment or by using Joule Grader. Checkmarks signify that credit was received for the criteria grade while X's signify that credit was not received for the criteria grade. Feedback, group/overall points, and final grade out of total possible points are displayed.

student view of graded checklist

3.1.2. Viewing Checklists For Advanced Forums

If a checklist is being used for an Advanced forum and the Teacher or Site Administrator has given permission for ability to view checklists, you can view the criteria you are going to be graded on and see point values for each criteria before you post to an Advanced forum.

Log in to your course view the Advanced forum. Go to the Navigation block and select Posts grading under the Advanced forum activity.

navigation path to posts grading for advanced forums

The Posts grading page opens displaying the criteria and the points available for each.

list of criteria and points available

For Advanced forums, you must use the Joule Grader to view the graded checklist. Navigate to your settings block and select Course administration > Joule Grader.

settings block view as student

Checkmarks signify that credit was received for the criteria grade while X's signify that credit was not received for the criteria grade. Feedback, group/overall points, and final grade out of total possible points are displayed.

student view of graded checklist

3.2. Teacher Documentation

3.2.1. Overview

Checklists allow teachers to consistently grade all students on an activity with the same list of criteria and the same point values for each criteria. By default, only site administrators and managers have permissions to publish one of your forms as a site wide template for others to use. You can, however, reuse your own forms as many times as you like within a course or within other courses. If you don't have permission to share an advanced grading method as a template, then you can instead share it by backing up the activity using it and giving the backup file to another teacher to restore and use.

3.2.2. Checklist a Checklist from Scratch

To define a new checklist, navigate to the activity you wish to grade with a checklist (remember that only certain activities support advanced grading methods), navigate to the Settings block and select Activity administration > Edit settings. Change the grading method to Checklist and Save the activity. Alternatively, create a new activity and set the grading method to Checklist.

Choose to Define new grading form from scratch to define a new checklist or click Create new grading from from a template to reuse an existing one. For this example, we'll create a new one.

define new grading form from scratch button

Enter a Name and Description for the checklist.

name and description fields

Checklists are composed of groups with "items", which are the criteria for the grade.

area to enter items

Click the text Click to edit group/item to enter groups/items and enter a description of the criteria to be graded (i.e. Participation).

Enter the point value for each item added. The total of these points will be the total grade for the activity.

Click Add item to add more items to a group.

Click Add group to add another group of items.

Click the X next to a group or item to delete it. Click Yes to confirm deletion, or click Cancel to return to the checklist.

3.2.3. Checklist Options

Checklist options can be configured to allow customization of viewing and commenting on the checklist.

list of options outlined below

Check or uncheck the boxes to configure the following checklist options:

  • Allow users to preview checklist used in the module (otherwise checklist will only be visible after grading)
  • Display points for each item during evaluation
  • Display points for each item to those being graded
  • Allow grader to add text remarks for each checklist item
  • Allow grader to add text remarks for each checklist group
  • Show all remarks to those being graded

3.2.4. Create a Checklist from a Template

To define a checklist based on a template, choose to Create new grading from from a template. You will be able to use the template as is, or modify it to meet your needs.

create new grading form from a template button

Search for a template by viewing the list of forms, or by enter a title into the search field and clicking Search. Select the include my own forms checkbox if you would like to search for your forms in addition to the site-wide ones. Your forms will display the text OWN FORM and site-wide templates will display SHARED TEMPLATE.

search feature

Click Use this template to use the chosen template as the checklist for the current module.

list of templates with use this template button highlighted

Click Continue to create a new grading form using the template chosen from the list.

continue button for creating a new grading form as a template

Click Edit the current form definition if you would like to modify the form. If you do not edit the form, it will be used as is.

3.2.5. Saving a Checklist

When you are finished defining your checklist, scroll to the bottom of the page and select one of the following:

checklist save buttons at bottom of page

  • Save checklist and make it ready: Select to save the checklist and make it available for use grading the module.
  • Save as draft: Select to save the checklist as a draft that can be modified and/or used at a later time. Drafts are listed on the Advanced grading > Checklist main page. Students can not see drafts.
  • Cancel: If selected, you checklist will not save and you will return you to the Advanced grading > Checklist main page.

3.2.6. Checklist Drafts

You can tell the state of readiness a checklist is in by the Draft and Ready for usage indicators on the Advanced grading > Checklist page and on the checklist editing page.

To make a checklist ready for use, click Edit the current form definition. Then, save the form by clicking Save checklist and make it ready.

edit button for checklist

3.2.7. Editing Checklists

You can easily edit a checklist by either clicking Edit the current form definition or by going to Settings > Activity adminsitration > Advanced grading > Define checklist. Once you are done editing the form, click Save.

3.2.8. Removing Checklists

To delete a checklist, click Delete the currently defined form. Then click Continue.

3.2.9. Grading via Checklist

Once checklist has been selected as the grading type for the module, there are several ways you can grade using the checklist. Assignments are gradable via Checklist using Joule Grader and through Submitted assignments. Advanced forums can only be graded via checklist using Joule Grader.

3.2.9.1. Grading with Checklists in Joule Grader

To grade via checklist using Joule Grader, log in to a course and navigate to the module you wish to grade. Navigate to your settings block and select Course administration > Joule Grader.

settings block with path to Joule grader

You will see the grade on the right and the module that needs to be graded on the left. Click View Checklist to open the checklist for grading. The Checklist grading pane opens.

Check the boxes for each criteria to award the assigned point value. Comments can be made on each criteria and on groups of criteria. Group and overall points are listed at the bottom out of the total points for the module.

check list criteria with comment boxes and save button to enter grade in gradebook

Click Save to save the comments in the checklist and the grade in the gradebook.Click View Checklist again if changes need to be made.

Once grades have been saved via checklist, you can view the score above View Checklist.

Joule grader with graded checklist

3.2.9.2. Grading Submitted Assignments at the Activity Level

To grade a submitted assignment using the activity grade, view the assignment and click the View/grade all submissions link.

link to submitted assignments

Click the Grade icon in the Status column. Alternatively, rollover the Edit icon in the Edit column and select Grade. The module feedback page opens.

submitted assignments list with link to grade feedback interface

Grade using the checklist and click Save changes when finished. The grade is saved into the gradebook.

grades submitted feedback interface with checklist for grading

3.3. Administrator Documentation

3.3.1. Overview

Site administrators and Managers are the only roles by default that can create site-wide templates for advanced grading forms. Templates allow for the quick creation of forms that can then be reused in multiple courses on a site. Existing forms can be published as a template or new ones can be created from scratch.

3.3.2. Publishing a Teachers Checklist as a Site-wide Template

To create a template from a defined checklist that can be used site-wide, log in to a site and navigate to the activity with that is using the Checklist advanced grading method. Then, navigate to your Settings block and select Activity administration > Advanced grading > Define checklist.

settings block

Modify the form as needed. When you are done, click Save.

Click Publish the form as a new template.

options for selecting new

Click Continue to save a copy of the grading form as a new public template that can be used for creating checklists for other modules.

continue button for creating a new grading form from a template

A message stating The form was successfully saved as a template should appear, and the form will show up in the list of templates available.

template saved message

3.3.3. Creating New Site-wide Templates

When Site Administrators and Managers save a new template, they will see the Publish the form as a new template, which teachers do not see. Clicking this button will make it a site-wide template. To learn how to create a new template from scratch, see the Teacher's Documentation for more information.

4. Convert Moodle 1.9 to 2.0 Backups Utility

4.1. Overview

From Moodle 2.3 onwards all 1.9 course backup files without user data can be converted directly from the course restore area. Click here to see a tutorial on how to restore a course in Moodle.
The Convert 1.9 to 2.0 Backups utility was developed by Moodlerooms to assist clients who are coming from Moodle 1.9 or clients who have come from another LMS and have converted all of their courses using Moodlerooms’ Course Converter block or via Moodlerooms. This utility requests a conversion of one or more Moodle 1.9 courses. A backend process will take the courses and restore them into a 1.9 site, upgrade the 1.9 site to 2.0 and then back up those courses. The 2.0 backup files are then placed back on the client's site for restoration or download.
This feature is recommended for clients with multiple courses to be converted and for 1.9 courses that include user data in their backup files. If there are only a few courses to convert, and they do not have user data saved inside them, it is a faster process to convert them directly in the restore area of a course.

4.1.1. Convert 1.9 to 2.0 Backups Utility Process Flowchart

Convert 1.9 to 2.0 Backups Utility Process Flowchart see below for text based steps

  1. Site administrator uploads Moodle 1.9 course backup files
  2. Site Administrator requests the 1.9 course backup files be converted to 2.0
  3. Request added to conversion queue
  4. Requests higher in the queue are processed
  5. Request reaches top of the queue kicking off conversion process
  6. Temporary Moodle 1.9 site created
  7. Requested backup files copied to temporary Moodle 1.9 site
  8. Moodle 1.9 backup files are restored into the temporary Moodle 1.9 site
  9. Temporary Moodle 1.9 site upgraded to temporary Moodle 2 site
  10. All courses on temporary Moodle 2 site are backed up
  11. All Moodle 2 backup files are moved to client's Joule 2 site's "moodledata/moodle19to20/converted" directory
  12. E-mail sent to client notifying them that the conversion is complete

4.1.2. Related Features

4.2. Administrator Documentation

The Convert 1.9 to 2.0 Backups utility is separated into three tabs with each tab serving a different purpose in the process:

  • 1.9 Backups (ready): Contains all Moodle 1.9 course backup files not processed and allows a Site administrator to upload new files
  • 2.0 Backups (converted): Contains all Moodle 2.0 course backups that have been created via the conversion process
  • 1.9 Backups archive (archived): Contains all Moodle 1.9 course backup files that have been converted

Each of the tabs corresponds to a moodledata directory that can be accessed by an administrator via SFTP.

  • 1.9 Backups (ready) matches the directory "moodle19to20/ready" under the client's moodledata directory for the site.
  • 2.0 Backups (converted) matches the directory "moodle19to20/converted" under the client's moodledata directory for the site.
  • 1.9 Backups archive (archived) matches the directory "moodle19to20/archived" under the client's moodledata directory for the site.

4.2.1. Accessing Backup Converter Utility

The Convert 1.9 to 2.0 Backups utility is accessed via the Settings block > Site administration > Moodlerooms > Convert 1.9 to 2.0 backups link.

Site Settings block access to convert 1.9 to 2.0 backups link

The Convert 1.9 to 2.0 Backups utility is only available to site administrators and can only be accessed via the site administration panel.

4.2.2. 1.9 Backups (Ready)

When first accessing the Convert 1.9 to 2.0 Backups utility, a site administrator is brought to the main 1.9 Backups (Ready) tab, which looks similar to below.

1.9 Backups screen

The 1.9 Backups (ready) tab is used to:

  • Display the amount of storage used by each tab based on the course backup files within the moodledata directory
  • Display all of the current 1.9 course backups that are available to be converted
  • Upload new Moodle 1.9 course backup files
  • Move Moodle 1.9 course backups that have been converted from another LMS via the Course Converter block to the utility
  • Submit the Moodle 1.9 course backup files for conversion
  • Download Moodle 1.9 course backup files
  • Delete Moodle 1.9 course backup files
4.2.2.1. Current Storage Usage

The top box of the 1.9 Backups (ready) tab displays the amount of storage used by the course backup files in each of the moodledata directories (ready, converted and archived). This helps a site administrator determine what amount of their allotted storage space is being used during the conversion process. The detailed listing of storage being used by each folder can be collapsed by clicking the down arrow icon and expanded by clicking the right arrow icon to the right of the total storage usage statement.

4.2.2.2. Upload a Moodle 1.9 Backup File to Convert

To upload a Moodle 1.9 backup file via the 1.9 Backups (ready) tab, click on the Upload Moodle 1.9 backup file button.

Click the Upload Moodle 1.9 Backup File button

You will now see the Joule 2 upload file interface. Click the Choose file... button to bring up the file picker.

Click the Choose File button to upload a file

Next, click the Upload a file link and then click the Browse button. Select a file from your computer and click the Open button. Click the Upload this file button.

Select Upload a File and then browse to the file to upload.

Finally, click the Save changes button. The file will be added to the Directory listing for moodledata/moodle19to20/ready/ area in alphabetical order.

4.2.2.3. Move a Backup from the Course Converter Block to Convert

If you have converted course backup files from another LMS, you can use the Move backups from "Course Converter" button to select files to move to the Convert 1.9 to 2.0 Backups utility. Click Move backups from "Course Converter" to locate Moodle 1.9 course backups to move from the Course Converter block.

This button will not appear if you do not have the Course Converter block added to a page on your Joule 2 site.

Click the Move backups from "Course Converter" button

Click the checkbox next to each Moodle 1.9 course backup file you want to move to the Convert 1.9 to 2.0 Backups utility for conversion. You can use the Select all/none links to check all checkboxes or uncheck all checkboxes to the right of the file name.

The message "No candidate files found for moving. Please ensure that you have backup files in the Manage converted files area in the Course Converter." will appear if you have no more Moodle 1.9 course backup files in the Course Converter block to move. If this message appears, convert more LMS course backup files using the Course Converter block.

Check the checkbox for each file you want to move from the Course Converter block

Finally click the Move files button. The file will be added to the Directory listing for moodledata/moodle19to20/ready/ area in alphabetical order, and you will see a green message at the top of the screen informing you which files have been moved.

Files Are Moved, Not Copied
The files in the Course Converter block are moved, not copied. This means that you will want to either download a copy of the file locally or ensure you have the original LMS course backup file before you click the Move files button because the file will be removed from the Course Converter block.
4.2.2.4. Submit Backup Files for Conversion

Once the site administrator has moved or uploaded Moodle 1.9 course backup files to the Convert 1.9 to 2.0 Backups utility, the site administrator can request that those Moodle 1.9 course backup files be converted to a Moodle 2.0 course backup file. To initiate this process, the site administrator clicks the checkbox to the left of each Moodle 1.9 course backup file name in the Directory listing for "moodledata/moodle19to20/ready/" area.

Check the checkbox for files to be converted and click the Submit for Conversion button

Click the Submit request for processing button and you will be brought to a screen to enter the e-mail address of the user you would like to be notified upon completion.

Enter e-mail for the user to have the conversion completion notification sent to

Click the Submit request for processing button to send the request to Moodlerooms for processing within the conversion queue. You will be returned to the Manage 1.9 tab and the following success message will appear at the top of the page:

"Your request has been successfully submitted and you will be automatically notified once the process has been completed. Once complete, your 1.9 backup files will be placed in the 1.9 Backups Archive (archived) section, and the converted 2.0 backup files will be placed in the 2.0 Backups (converted) section."

Once the files have been converted to Moodle 2.0, the e-mail address submitted above will receive an e-mail notification similar to the image below.

Example e-mail notification that course conversions are complete

The Moodle 1.9 course backup files selected to be converted will be moved from the 1.9 Backups(ready) tab to the 1.9 Backups Archive (archived) tab when the converted file is created in the 2.0 Backups(converted) tab.

4.2.2.5. Deleting a 1.9 Ready Backup File

There are two ways to remove Moodle 1.9 course backup files that you no longer want to request a conversion for. If you want to delete one Moodle 1.9 course backup file, right-click on the menu icon to the right of the file name. Select "Delete" from the drop-down menu that appears.

Right-click on the menu icon to the right of the file name and select delete to delete a file

At this point you will be asked to confirm that you want to delete the file selected. Click the Continue button to delete the files and click the Cancel button if you have changed your mind and do not wish to delete the files.

Confirmation of Moodle 1.9 backup file to be deleted

If you want to delete one or more Moodle 1.9 course backup files, click the checkbox to the left of the file name or click Select All/None to toggle between all of the checkboxes being checked or unchecked. Once all files have been checked to your satisfaction, select "Delete" from the With selected... drop-down menu below the list of files.

Click the With Selected... drop down and select "Delete" to delete all checked files

At this point you will be asked to confirm that you want to delete the files selected. Click the Continue button to delete the files and click the Cancel button if you have changed your mind and do not wish to delete the files.

Confirmation of Moodle 1.9 backup file to be deleted

If you clicked the Continue button, a message similar to "Successfully deleted the following file(s) under moodledata/moodle19to20/ready/" with a list of each file deleted will appear at the top of the page. The Moodle 1.9 course backup file(s) will be deleted and no longer show in the Directory listing for moodledata/moodle19to20/ready/ area.

4.2.2.6. Downloading a 1.9 Ready Backup file

To download a Moodle 1.9 course backup file, right-click the menu icon to the right of the Moodle 1.9 course backup file that you wish to download and select Download from the drop-down menu that appears.

Right-click on the menu icon to the right of the file name and select download to download a file

Depending on your browser and settings, the file will begin downloading or a pop-up box will appear asking you where you want to save the backup file to.

4.2.3. 2.0 Backups (converted)

Converted backup files

The 2.0 Backups (converted) tab is used to:

  • Display the amount of storage used by each tab based on the course backup files within the moodledata directory
  • Display all of the current 2.0 course backups that are available to be converted
  • Copy a 2.0 backup file to Site Backups
  • Restore a 2.0 backup file
  • Download Moodle 2.0 course backup files
  • Delete Moodle 2.0 course backup files
4.2.3.1. Current Storage Usage

The top box of the 2.0 Backups (converted) tab displays the amount of storage used by the course backup files in each of the moodledata directories (ready, converted, and archived). This helps a Site administrator determine the total amount of their allotted storage space is being used during the conversion process. The detailed listing of storage being used by each folder can be collapsed by clicking the down arrow icon and expanded by clicking the right arrow icon to the right of the total storage usage statement.

4.2.3.2. Copy a 2.0 Backup File to Site Backups

There are two ways to copy Moodle 2.0 course backup files to the site backup directory for later use. If you want to copy one Moodle 2.0 course backup file to the site backups directory, right-click on the menu icon to the right of the file name. Select "Copy to site backups" from the drop-down menu that appears.

Right-click on the menu icon to the right of the file name and select copy to site backups to copy the course backup file to the site backups directory

If you want to copy one or more Moodle 2.0 course backup files to the site backups directory, click the checkbox to the left of the file name or click Select All/None to toggle between all checkboxes being checked or unchecked. Once all files have been checked to your satisfaction select Copy to site backups from the With selected... drop-down below the list of files to copy the files to the site backups directory.

Click the with selected drop down and select {{_Copy to site backups_}} to copy all checked files to the site backups directory

A message similar to "Successfully copied the following files under moodledata/moodle19to20/converted to the site backup files:" with a list of each file copied will appear at the top of the page after all the files have been copied. Click the site backup files link to view the 2.0 backup files or start a restore process. This is the same as clicking the Settings block > Front page settings > Restore link.

4.2.3.3. Restore a 2.0 Backup File

There are two ways to restore a Moodle 2.0 course backup file to the site for use. If you want to restore one Moodle 2.0 course backup file to the site, right-click on the menu icon to the right of the file name. Select Restore from the drop-down menu that appears.

Right-click on the menu icon to the right of the file name and select Restore to begin the course restore process

If you want to restore one or more Moodle 2.0 course backup files to the site, click the checkbox to the left of the of the file name or click Select All/None to toggle between all checkboxes being checked or unchecked. Once all files have been checked to your satisfaction, select Restore from the With selected... drop-down below the list of files to start the restore process.

Click the With selected... drop-down menu and select "Restore" to begin the restore process

Next you need to select the restore options going forward. You will see a screen similar to below:

Select restore options

  • Files to restore: Check the checkbox next to each course backup file you want to restore
  • Restore into category: This is the category all selected course backup files will be restored into
  • Un-attended operation: If checked, each course will be restored without the need for a user to click continue. At the end a final summary of all course conversion logs will be displayed.

Once you have the settings the way you want them, click the Restore now button.

A message similar to "Successfully copied the following files under moodledata/moodle19to20/converted to the site backup files:" with a list of each file deleted will appear at the top of the page. Click the Site backup files link to view the 2.0 backup files or start a restore process. This is the same as clicking the Settings block > Front page settings > Restore link.

4.2.3.4. Deleting a 2.0 Backup File

There are two ways to remove Moodle 2.0 course backup files that you no longer want to request a conversion for. If you want to delete one Moodle 2.0 course backup file, right-click on the menu icon to the right of the file name. Select Delete from the drop-down menu that appears.

Right-click on the menu icon to the right of the file name and select Delete to delete a file

If you want to delete one or more Moodle 2.0 course backup files, click the checkbox to the left of the file name or click Select All/None to toggle between all checkboxes being checked or unchecked. Once all files have been checked to your satisfaction, select Delete from the With selected... drop-down menu below the list of files.

Click the With Selected... drop down and select Delete to delete all checked files

At this point you will be asked to confirm that you want to delete the file selected. Click the Continue button to delete the files and click the Cancel button if you have changed your mind and do not wish to delete the files.

Confirmation of Moodle 2.0 backup file to be deleted

If you clicked the Continue button, a message similar to "Successfully deleted the following file(s) under moodledata/moodle19to20/converted:" with a list of each file deleted will appear at the top of the page. The Moodle 2.0 course backup file(s) will be deleted and no longer show in the Directory listing for moodledata/moodle19to20/converted/ area.

4.2.3.5. Downloading a 2.0 Backup file

To download a Moodle 2.0 course backup file, right-click the menu icon to the right of the Moodle 2.0 course backup file you wish to download and select Download from the drop-down menu that appears.

Right-click on the menu icon to the right of the file name and select download to download a file

Depending on your browser and settings, the file will begin downloading or a pop-up box will appear asking you where you want to save the backup file to.

4.2.4. 1.9 Backups Archive (archived)

1.9 backups archived tab main display

The 1.9 Backups Archive (archived) tab is used to:

  • Display the amount of storage used by each tab based on the course backup files within the moodledata directory
  • Display all of the current 1.9 course backups that are available to be converted
  • Move Moodle 1.9 course backups from archived backups to ready for conversion
  • Download a Moodle 1.9 archived course backup file
  • Delete a Moodle 1.9 archive course backup file
4.2.4.1. Current Storage Usage

The top box of the 1.9 Backups Archive (archived) tab displays the amount of storage used by the course backup files in each of the moodledata directories (ready, converted, and archived). This helps a site administrator determine what amount of their allotted storage space is being used during the conversion process. The detailed listing of storage being used by each folder can be collapsed by clicking the down arrow icon and expanded by clicking the right arrow icon to the right of the total storage usage statement.

4.2.4.2. Moving a 1.9 Archived Backup to Ready

There are two ways to move a Moodle 1.9 course backup file back to the 1.9 Backups(ready) tab for conversion. If you want to move one Moodle 1.9 course backup file, then right-click on the menu icon to the right of the file name. Select Move to 'ready' from the drop-down menu that appears.

Right-click on the menu icon to the right of the file name and select {{_Move to ready_}} to move the file to the 1.9 backups (ready) tab

If you want to delete one or more Moodle 1.9 course backup files, click the checkbox to the left of the file name or click Select All/None to toggle between all checkboxes being checked or unchecked. Once all files have been checked to your satisfaction, select "Move to 'ready'"from the With selected... drop-down menu below the list of files.

Click the "With selected..." drop down and select move to ready to move all checked files

You will be returned to the 1.9 Backups Archive (archived) tab, and a message similar to "Successfully moved the following files under moodledata/moodle19to20/archived to moodledata/moodle19to20/ready:" with a list of each file moved will appear at the top of the page. The Moodle 1.9 course backup file(s) will be moved and no longer show in the Directory listing for moodledata/moodle19to20/archived/ area.

4.2.4.3. Deleting a 1.9 Archived Backup file

There are two ways to remove Moodle 1.9 course backup files that you no longer want to request a conversion for. If you want to delete one Moodle 1.9 course backup file, right-click on the menu icon to the right of the file name. Select "Delete" from the drop-down menu that appears.

Right-click on the menu icon to the right of the file name and select "Delete" to delete a file

If you want to delete one or more Moodle 1.9 course backup files, click the checkbox to the left of the file name or click Select All/None to toggle between all checkboxes being checked or unchecked respectively. Once all files have been checked to your satisfaction, select Delete from the With selected... drop-down menu below the list of files.

Click the With selected... drop down and select Delete to delete all checked files

At this point, you will be asked to confirm that you want to delete the file selected. Click the Continue button to delete the files and click the Cancel button if you have changed your mind and do not wish to delete the files.

Confirmation of Moodle 1.9 backup file to be deleted

If you clicked the Continue button, a message similar to "Successfully deleted the following file(s) under moodledata/moodle19to20/archived:" with a list of each file deleted will appear at the top of the page. The Moodle 1.9 course backup file(s) will be deleted and no longer show in the Directory listing for moodledata/moodle19to20/archived/ area.

4.2.4.4. Downloading a 1.9 Archived Backup File

To download a Moodle 1.9 course backup file, right-click the menu icon to the right of the Moodle 1.9 course backup file that you wish to download and select Download from the drop-down menu that appears.

Right-click on the menu icon to the right of the file name and select Download to download a file

Depending on your browser and settings, the file will begin downloading or a pop-up box will appear asking you where you want to save the backup file.

4.2.5. SFTP for Upload and Downloading of Course Backup Files

The Moodle 1.9 and Moodle 2.0 course backup files can be uploaded to or downloaded from your Joule site in batch or one at a time using your favorite FTP/SFTP program. The following are a few recommended SFTP programs:

First, connect to your SFTP account using the information provided by a Moodlerooms employee. You will initially be placed in a Clients directory. From here, you need navigate to the /clients/<sitename>/moodle19to20/ directory. Replace the <sitename> string with the beginning of the URL for your site provided by Moodlerooms (for example branch.mrooms2.net would use clients/branch/moodle19to20/). From here, you will have three directories to choose from, each corresponding to a different tab in the Convert 1.9 to 2.0 Backups utility.

  • Archived: Corresponds to the 1.9 Backups Archive (archived) tab. This is where you can download all of your archived Moodle 1.9 course backup .zip files after they have been converted.
  • Converted: Corresponds to the 2.0 Backups (converted) tab. This is where you can download all of your converted Moodle 2.0 course backup .zip files after they have been created from the Moodle 1.9 course backups.
  • Ready: Corresponds to the 1.9 Backups (ready) tab. This is where you can upload all of your Moodle 1.9 course backup .zip files. You will see a list of all the files you have uploaded via the Upload Moodle 1.9 backup file interface as well. The file you upload will be added to the Directory listing for moodledata/moodle19to20/ready/ area of the 1.9 Backups (ready) tab on your Joule site.

5. DB Backup

5.1. Overview

DB Backups allows site Administrators to download a copy of nightly backups of their database. The backup files can be saved and viewed locally. This feature used to be the mPower Toolbox block, which has been renamed and moved to the Moodlerooms, Site administration settings.   

5.2. Administrator Documentation

Log in to your site as the Administrator.

Navigate to the Settings block and select DB Backups under Settings>Site administration>Moodlerooms>DB Backups.

settings block menu open to DB Backup

A list of available backups will appear under Site Archives with File Name, File Date, and File Size for each backup.

list of backups where file name is a link to download the backup file

Note: These are the site's raw SQL backups, generated using the mysqldump tool. They are gzip-compressed, plain-text, SQL dump files.

6. Joule Gradebook

6.1. Overview

The Joule gradebook is an alternate grading option to the default Moodle Grader report. You can easily switch back and forth between gradebooks using the jump menu located at the top of the screen. A simplified view displays categories and course totals for each student. You can set up grade categories, move assignments around, and grade activities easier than ever. New column and row actions simplify grading and allow Teachers to perform actions like send messages to students directly from the gradebook and change all of the grades in a column at once.

Unable to render {include} Couldn't find a page to include called: ELEMENTS:JGBK V2 student interface

6.2. Teacher Documentation

The Joule gradebook was designed to simplify the gradebook experience by improving default views, and it is more productive because it can perform actions in the course directly from the gradebook.

6.2.1. Accessing the Joule gradebook

Navigate to the Settings block and select Course Administration > Grades.

If the Joule gradebook is not displayed you can select it from the navigation drop-down menu near the top of the page, or selecting the Joule gradebook link under the View tab.

drop down menu with Joule gradebook option

Note: The site administrator can make the Joule gradebook the default choice so it automatically displays when you open Grades.
6.2.1.1. Uncategorized items

Click Show uncategorized items or Hide uncategorized items to show and hide uncategorized items in the Joule gradebook. This can streamline the Joule gradebook and make it less cluttered. You can customize what is displayed, only showing category totals, or showing all items.

show uncategorized items button hide uncategorized items button

6.2.1.2. Navigating

Navigating through categories is easily done by using the drop-down menu and the "Next" and "Previous" arrows.

left and right arrows with drop-down menu in between to select categories

6.2.1.3. Entering grades

You can enter grades in the empty cells using point values, percentages and/or letter grades. Press Enter or click in another cell to save the grade.

Note: Grades entered in the gradebook will override grades entered in the Module Grader report for each activity, and grades that are assigned automatically. If a student retakes a quiz after a grade has been entered in the gradebook, the new quiz grade will not replace the grade entered in the gradebook even if it is higher.

image of the gradebook interface with cells for entering student grades

You can use the Tab key to quickly toggle through the fields.
Letter grade values can be set in the Settings block under Course administration > Grades > Grade administration > Letters or Site administration > Grades > Letters. Letter grades entered in the Joule gradebook will use the mean of the range assigned to the letter. For example, if a student receives an A on an activity and the grade range for A is set to 90-93%, the grade value entered will be 91.5. If the assignment is only worth 50 points, you would take the 93% and multiply it by the total possible points, in this case 50 (.93x50=46.5). The student will receive 46.5 points out of 50 for the assignment if an A is entered in the Gradebook.

6.2.2. Column Actions

Joule gradebook is more productive with actions to perform bulk and individual grading and messaging tasks. Actions can be viewed by clicking the action icons in a the rows and columns. The actions below are available for column actions. Some actions are available when viewing categories where as others are only available for items within categories.

action icon

  • Joule Grader: Jump to the Joule grader.
  • Module Grader: Jump to the activity grades to view detailed results.
  • Column Grader: Input activity grades for all course participants at one time.
  • Message to Incompletes: Send a message to all participants who have not completed a specific activity.
  • Message to Grade Range: Set a grade range that will trigger a custom message to be sent to students whose grades fall within that range.
  • Change all grades in this column to: Change all grades for an activity using this feature. If all students except a few received the same grade, you can use this feature to save time by only having to input the exceptions.
  • Toggle Visible/Hidden (Currently Visible/Hidden): Makes the grade for the activity visible/hidden to students.
  • Move this to a different gradebook category: Move the item to a different category in the gradebook.
6.2.2.1. Joule Grader Action

Select this action to jump to the Joule grader.

6.2.2.2. Module Grader Action

Select this action to jump to the activity grader.

6.2.2.3. Column Grader Action Action

Open the Column Grader to easily grade all students in the column. Enter grades and use Check to make empty cells=0 to enter zeros in all cells that do not have a grade entered already. Click Save when you're finished grading in the Column Grader.

column grader modal with cells to enter grades for column and empty cell=0 check box

You can use the Tab key to quickly toggle through the fields.
6.2.2.4. Message to Incompletes Action

Send a message to all students that have not completed the activity. All students that do not have a grade entered for the activity will be added to a message automatically. Add/remove recipients, and enter a subject and body for the message. Click Send to send a message to all students who do not have a grade in the activity.

message to incompletes modal

6.2.2.5. Message to Grade Range Action

Send a message to all students in a specified grade range, good, or bad. Enter the grade range you would like to send the message to and click Save.

message to grade range range selection modal with sliders to select range and fields for grades

Add or remove recipients using the Add Recipients link and/or the red X's next to a name. Enter a subject and body for the message.

message to grade range message modal

Click Send to deliver the message.

6.2.2.6. Change all grades in this column to.. Action

Change all grades in a column to a specified grade. Check Ignore cells with existing values to leave grades already entered in a column as they are, or uncheck it and replace all grades with the value that is entered. Use this to grade exception. Enter the grade you wish to change all grades in the column to, and click Save when you are finished.

change all grades in this column modal

6.2.2.7. Toggle Visible/Hidden (Currently Visible/Hidden) Action

Select whether or not you want this activity to be visible/hidden to students. When you click this option in the menu it will change the visibility without having to save.

toggle visible/hidden options in drop-down menu

6.2.2.8. Move this to a different gradebook category Action

Use this action to move an item to a different category without the need of using the Moodle Grader report. Select the category for where you would like it to be located.
Click Save when you are finished.

move activity to a different category modal

6.2.3. Row Actions

Joule gradebook is more productive with row actions to perform bulk and individual grading and messaging tasks. Click the action icon next to the student's name and select the Row Grader or Message to student options to grade all activities for the student or to send him/her a direct message.

row action

6.2.3.1. Row Grader Action

View and change grades for one student at a time. The Row Grader allows you to quickly enter grades for all of a student's assignments, with the option to make any empty cells=0 by checking the box. Enter the grades for the student for each activity. When you finish entering grades and decide how to handle empty cells, click Save.

row grader modal with fields for grades and check box to make all empty cells=0

You can use the Tab key to quickly toggle through the fields.
6.2.3.2. Message to Student Action

Send a message to a student.

6.2.4. Sorting

You can organize students by names, grades, and groups.

6.2.4.1. By name

Sort students by Last name and First name by clicking on the respective links above the list of names. Click a student's name to visit the student's profile.

first and last name links above list of student names

6.2.4.2. By grade

Click the course Category or Item link at the top of a column to sort the grades in the column in an ascending/descending order.

image of category header with sort ascending link

6.2.4.3. By group

Sort students by the groups they belong to for group grading using the participants menu. If groups have been created in the course, the All participants drop-down menu will be available. Click the drop-down menu or use the "Next" and "Previous" arrows to navigate between groups. Select a group from the list and only those students belonging to the group will be displayed in the Joule Gradebook.

Note: Groups need to be set up in the course for the All participants drop-down menu to appear.

groups created in the course will be listed here

6.2.5. My Preferences

Teachers can customize settings in the My preferences tab in the Joule gradebook.

Navigate to the My preferences tab and select Joule Gradebook from the drop-down menu.

6.2.5.1. Show/hide toggles

show/hide toggles settingslisted

The following settings can be configured:

  • Show calculations: If enabled, when editing is turned on, a calculator icon is shown for each grade item and category, with tool tips over calculated items and a visual indicator that a column is calculated.
  • Show show/hide icons: If enabled, when editing is turned on, a show/hide icon is shown for each grade for controlling its visibility to the student.
  • Show column averages: If enabled, the Joule gradebook will contain an additional row displaying the average (mean) for each category and grade item.
  • Show locks: If enabled, when editing is turned on, a lock/unlock icon is shown for each grade for controlling whether the grade can be automatically updated by the related activity.
  • Show user profile image: Determines whether or not to show user profile images.
  • Show ranges: If enabled, the Joule gradebook will contain an additional row displaying the range for each category and grade item.
6.2.5.2. Special Rows

special rows settings listed

The following settings can be configured:

  • Range display type: This setting determines whether the range is displayed as real grades, percentages or letters, or whether the display type for the category or grade item is used (inherit).
  • Decimals shown in ranges: This setting determines the number of decimal points to display for each range or whether the overall decimal points setting for the category or grade item is used (inherit).
  • Column averages display type: This setting determines whether the average (mean) is displayed as real grades, percentages or letters, or whether the display type for the category or grade item is used (inherit).
  • Decimals in column averages: This setting determines the number of decimal points to display for each average or whether the overall decimal points setting for the category or grade item is used (inherit).
  • Grades selected for column averages: This setting determines whether cells with no grade should be included when calculating the average (mean) for each category or grade item.
  • Show number of grades in averages: If enabled, the number of grades used when calculating the average (mean) is displayed in brackets after each average.
6.2.5.3. General

general settings listed

The following settings can be configured:

  • Students per page: This setting determines the number of students displayed per page in the Joule gradebook.
  • Aggregation position: This setting determines whether the category and course total columns are displayed first or last in the gradebook reports.
  • Enable AJAX: Adds a layer of AJAX functionality to the Joule gradebook, simplifying and speeding up common operations. Depends on Javascript being switched on at the user's browser level. This option is set to "Yes" because AJAX is required for Joule gradebook.

Click Save changes to apply these settings when you are finished, or click Cancel to discard any changes and proceed.

6.3. Administrator Documentation

You can set the Joule gradebook to be the default report for teachers.

Navigate to the Settings block and select Site administration > Grades > General settings.

Scroll down to the Teacher profile report and choose Joule Gradebook.

settings

When you are finished, scroll to the bottom and click Save changes.

There are also report settings for the Joule gradebook located in the Settings block under Site administration > Grades > Report settings>Joule gradebook.

report settings listed below

Enter the following options:

  • Students per page: Determines the number of students displayed per page in the Joule gradebook.
  • Grades selected for column averages: Determines whether cells with no grade should be included when calculating the average (mean) for each category or grade item.
  • Show column averages: If enabled, the Joule gradebook will contain an additional row displaying the average (mean) for each category and grade item.
  • Show ranges: If enabled, the Joule gradebook will contain an additional row displaying the range for each category and grade item.
  • Show user profile images: If enabled, will show the user's profile image next to the name in the Joule gradebook.
  • Show number of grades in averages: If enabled, the number of grades used when calculating the average (mean) is displayed in brackets after each average.
  • Column averages display type: Determines whether the average (mean) is displayed as real grades, percentages or letters, or whether the display type for the category or grade item is used (inherit).
  • Range display type: Determines whether the range is displayed as real grades, percentages or letters, or whether the display type for the category or grade item is used (inherit).
  • Decimals in column averages: Determines the number of decimal points to display for each average or whether the overall decimal points setting for the category or grade item is used (inherit).
  • Decimals show in ranges: Determines the number of decimal points to display for each range or whether the overall decimal points setting for the category or grade item is used (inherit).
  • Aggregation position: Determines whether the category and course total columns are displayed first or last in the gradebook reports.

When you are finished, remember to scroll to the bottom and click Save changes.

7. Joule Grader

7.1. Overview

Joule Grader is an alternate grading option that allows teachers to view, grade, and download a student submitted assignment in a simplified, adjustable two-pane grading experience. A student can only view his/hers own submission along with the grade of a particular activity. Joule Grader allows both teachers and students to start a discussion about a particular grade or submission. Joule Grader also gives the teacher and student the opportunity to view/grade (teacher only) advanced grading methods (e.g., a Rubric) for an activity in a grader pane.

7.2. User Documentation

7.2.1. Viewing graded work

You can view work graded by teachers using Joule grader.

Log in to your site and navigate to the Settings block and select Joule grader.

student settings block with Joule grader

In the Joule Grader you can view and navigate through assignments that have been graded. You can also see comments from the teacher and make comments in return. To maximize the use of the two pane view, click and drag on the sliding bar that separates the panes. This is not a sticky setting.

You may view the Grader with no distractions by clicking Full screen mode, which removes blocks and menus for distraction free viewing. The Grader opens in Full screen mode the first time, but you may return to the course by clicking Return to course or stay in the Joule Grader but exit full screen mode by clicking Exit full screen mode. The settings will stay with you, meaning that the next time you open the Joule Grader, it will open how you used it last.

You can navigate through graded assignments using the left/right arrows or drop-down menu at the top right.

You can find the grade for the activity in the Grading area, located below the navigation controls. Overall feedback comments from the teacher are located in the Grading area and within the activity page.

Both the user and the teacher may make comments in the Activity comments area. These comments are used as a dialogue between the user and teacher, and are not the same as overall feedback. There is no notification when a comment is posted.

You can make comments and submit them by entering text into the box and clicking Save Comment. The comment will post in the list above. You can also find this conversation in the Submission comments area within the activity.

7.3. Teacher Documentation

7.3.1. Grading activities using Joule grader

You can easily view and grade activities, that have been submitted by users using Joule grader. Log in to your site and navigate to the Settings block and select Course administration > Joule Grader. Note that at the current time, only Assignment and Advanced forum are support in Joule Grader.

settings block with Joule grader chosen

The Joule Grader page opens where you can view, grade, and navigate through assignments that have been submitted by users. You can grade using simple or advanced grading methods and make comments to users while viewing comments they've made in return. Click Show Activities Requiring Grading to filter by activities that have yet to be graded. To adjust the size of the panels, click and drag the sliding bar to maximize your use of the two-pane view.

When the Joule Grader opens initially, it will be in full screen mode. To toggle out of full screen mode, you can either click Exit full screen mode, returning to normal view of the Grader within the course, or Return to course, which exits the Grader completely and returns you to the course home page. 

Navigate between activities that need to be graded using the left and right arrows or the drop-down menu.

Navigate between students in the course to see what they have submitted that needs grading.

Enter in a grade for the assignment of the chosen student. Grades saved here will populate the gradebook. Different grading methods will bring up different options here. Enter the grade and then a comment in the Overall feedback area, if desired. Click Save grade and next to save the grade for the current student chosen and move to the next student who has submitted the assignment chosen above.

There are two text entry boxes: Overall feedback and Activity comments. 

Feedback comments needs to be set to yes in the activity settings to see the Overall feedback in Joule Grader for use by the student and teacher. The teacher will see overall feedback, when turned on, whether or not students have submitted. Feedback will appear in the Joule Grader, Joule Gradebook, and Assignment page. Overall feedback for Assignments will show up in the Grader report and Module report; however, feedback for Advanced Forums will only show up in the Joule Grader and Gradebook.

Submission comments needs to be set to yes to see the Activity comments for use in the Grader by students and teacher. The teacher will only see the Activity comments in the Joule Grader after students submit, even when Submission comments are set to yes in the activity settings. This conversation will show up in the Joule Grader under Activity comments and in the Submission Comments column in the Activity Grader. It will not appear in the gradebook. There are no notifications when a  comment is posted.

Activity comments are available for both Advanced forums and Assignments; however, comments will only sync for Assignments and may be turned off in the Assignment settings. Activity comments are always on for Advanced forums.
Feedback files are located in the Grading area, under the Overall feedback text entry area. It must be set to yes in the Assignment activity settings for the option to appear in the Joule Grader. Feedback files are not available for Advanced Forums. When enabled, files may be uploaded and accessed from either the Joule Grader or Activity Grader. The Feedback files will also display in the User report.

7.4. Administrator Documentation

7.4.1. Define roles

You must authorize the non-editing teacher role to use Joule grader.

Log in to your site and navigate to the Settings block and select Site administration > Users > Permissions > Define roles.

settings block with path to define roles

On the Manage roles tab, locate the role you wish to modify Joule Grader permissions for and click edit.

list of roles to edit

The Editing role page appears.

Scroll down and locate Joule grader. You will see two options:

  • Grade work via Joule grader: If checked, any user with this role will have the ability to grade activities completed in a course using Joule Grader.
  • View graded work via Joule grader: If checked, any user with this role will have the ability to view Joule grader.

image of check boxes for options above

For non-editing teachers, "View graded work via Joule grader" and "Grade work via Joule grader." should be checked.

Make your selections and scroll to the bottom of the page and click Save changes to save and return to Manage roles. Click Cancel to cancel your changes.

8. Joule Mobile Theme

8.1. Overview

The Joule Mobile theme allows students and teachers to access their Joule courses and use most of Joule's features from their mobile device browsers without a dedicated app. Once the Joule Mobile theme is enabled for a site/course users can view activities, course materials, submit forum posts, assignments and quizzes and more. The Joule Mobile theme was designed to allow users access to their Joule courses from mobile devices to view and communicate within a course. We recommend things like creating content, grading, and course design still be done on a computer. 

8.2. Benefits

The benefits of the Joule Mobile theme:

  • Fully interact with your students, peers, and instructors using mobile browsers
  • View resources, submit posts, assignments, and quizzes from mobile devices
  • No need to download a separate application, just use a mobile browser

8.3. User Documentation

The Joule Mobile theme allows users to access course materials and resources while on-the-go with any mobile browser, no special application required.

Note: The site Administrator needs to enable the Joule Mobile theme for it to be available for mobile device access.

8.3.1. Navigation

Navigate to your course URL on your mobile browser and log in using your username and password just like you would on a computer. Refer to your mobile device manual if you need assistance with mobile browsing.

You will be taken to the Joule Mobile front page. This will vary greatly from course to course depending on who set up the Joule Mobile theme for the site and how it has been customized.

mobile front page with links for settings

Things to note:

  • In general, items that take up a lot of space on the screen, such as Calendar and Messages are moved to buttons that open the item in a full page view.
  • A Jump menu allows you to quickly navigate to areas in the course.
  • Menus such as Blocks, Settings, and Navigation are moved to buttons at the top of the page that open pages with the corresponding choices.
  • Links are bold colored text that will take you to a destination. For example, Linear Inequalities Assignment Dropbox will take you to that assignment.
  • At the bottom of every page you should see a button labeled Up that will take you to the top of a page when pressed.

8.3.2. Examples

Like any theme, there are many different ways to have a course display information. Here are other examples of what the Joule Mobile theme can look like:

mobile front page with course links in a different format

Note: the layout of the course sections is different and links are separated into their own areas.

mobile front page with course links in a different format

Note: this course looks similar to a standard course, except the links for Blocks, Settings, and Navigation at the top.

mobile front page with course links in yet another format/layout

Note: this course layout is very basic but still displays the course on a small mobile device screen and has the buttons for Blocks, Settings, Jump, and Navigation.

8.4. Administrator Documentation

8.4.1. Select Joule Mobile theme

To apply the Joule Mobile them to a site, you must select it for mobile devices using the Theme selector. To select the Joule Mobile theme, log in as a user with site administration privileges.

Navigate to Settings>Site administration>Appearance>Themes>Theme selector.

settings block with theme selector link

Scroll down to the mobile device type and click Select theme.

Joule mobile theme with select theme button

Scroll down to Moodlerooms Mobile and click Use theme.

This will set the Joule Mobile theme for anyone accessing the site from a mobile device browser.

It is not recommended to set the tablet device type to the mobile theme. A tablet should be able to display any available theme.

8.4.2. Enable Device detection

In order for mobile devices to see the Joule Mobile theme when they access the site from their mobile device you must first enable device detection.

Navigate to Settings>Site administration>Appearance>Themes>Theme settings.

site administration menu with appearance

Scroll down to Enable device detection and check the box to enable the detection of mobile phones, tablets, or default devices for the application of themes.

check box for enable device detection

Device detection regular expressions allow advanced instructional designers to specify the detection of extra device types using regular expressions. For example, you could create separate themes for different mobile device software platforms and have each one see a different custom theme when accessing the site.

8.4.3. Moodlerooms Mobile settings

To customize your Joule Mobile theme, navigate to Settings>Site administration>Appearance>Themes>Moodlerooms Mobile.

settings menu with site administration

You can customize the Joule Mobile theme the following ways:

  • Mobile theme color swatch: select a color for your theme from the drop-down for Mobile theme color swatch.

drop down with color selections for theme

  • Mobile Intro Text: make a custom introduction message with text and images for the mobile homepage that only users accessing the course from a mobile browser will see. Enter your message in the Mobile Intro Text box.
  • Show site topic: select Yes to show the standard site topic section(s) on the front page for mobile theme users (if available). Default is Yes, if you do not want to show site topics select No.
  • Show full images on site index and course pages: select Yes to show full size images on site index and course pages. Default is No, if you want to show full size images select Yes.
  • Mobile Launch icon (for iphone/ipad): add a URL to a home screen launch icon (suggested size (72px x 72px).
The URL should point to an image that will be used for the home screen launch icon. The launch icon can be placed on a mobile device home screen to launch the site directly, without having to open a mobile browser and enter the site URL.
  • Mobile Launch icon for high res devices (for iphone4): add a URL to a home screen launch icon (suggested size 114px x 114px).

Click Save changes when you are finished.

The following is an example of what the mobile theme can look like on a mobile browser.

mobile browser layout with jump menu

9. Joule Reports

9.1. Overview

Reports allow a user (student, teacher and administrator) to view data about activity in a course or group of courses that is relevant to them. There are six categories of reports in Joule 2, each with a number of reports:

  • Course Reports: These reports provide simple views of student engagement within course activities.
  • Correlation Reports: These reports compare grades in the course to the level of engagement against activities.
  • Exception Reports: These reports are used by teachers to track which students are not interacting with the course activities and may need assistance.
  • LearnerView Reports: These reports are used by teachers to view what specific students are doing in a course and understanding an individual's progress.
  • Admin Reports: These reports are aggregate data reports for site administrators and department heads on their courses and programs as a whole.
  • Learner Reports: These reports are for the student and focus on their activity in the course as well as a compilation of all data around specific activities in the course.
  • Comparison Reports: These reports compare students' engagement, grades, completion, and teacher correlation. Joule Comparison Reports also begin to interact at the site level allows program administrators to view comparative data about courses and teachers.

9.1.1. Related Features

Note
Joule Reports display data gathered by the Collect block. Please review the Collect Block Manual for more information on configuring and setting up data collection.

9.2. Changes from Joule to Joule 2

A lot of work has gone into overhauling the reports for Joule 2. The following are the major revisions that have been made to reports in Joule 2:

  1. Updated look and feel using a dashboard interface with an AJAX look and feel
  2. Migrated reports to a navigation link within the Setting and Navigation blocks as well as the Joule Reports block in 1.x
  3. Removed the aggregate group of reports
  4. Renamed Engagement Reports to Collaboration Reports
  5. Added 4 new report categories:
    1. LearnerView
    2. Admin
    3. Exception
    4. Learner
  6. New reports in each category
  7. Administrators now have access to an ad-hoc report generator based on an SQL query

9.3. Student Documentation

9.3.1. Accessing Reports

In Joule 2, Joule Reports are accessed via the Joule Reports link in the Settings block. Clicking the Joule Reports link will bring up the Joule Reports Dashboard.

jouel Reports link in the settings block

9.3.2. Exporting Reports

Tabular data for all reports can be exported to a CSV file via the Export drop-down menu on the bottom of the page.

Export report data to a file drop-down

The user will be asked if they want to save or open the file, depending on the browser's settings.

9.3.3. Learner Reports

Learner reports focus on each individual student's activity in the course and contain a compilation of all data around specific activities in the course. Please note that a teacher may not use all activities in a course that have reports listed in the reports drop-down menu, which will result in a blank report for that particular unused activity.

9.3.3.1. Common Filters

The following are common filters that are available for all Course reports:

  • Grade Category: Setting this filter narrows the report results to show only data of activities within a specific grade category in the course's grade book. The "Course Category" option in the drop-down menu refers to the overall grade category for the course.
  • Sections: Setting this filter narrows the report results to show only data for activities that are within a specific section of the course. A section refers to either a topic, week or folder, depending the course format.
9.3.3.2. Activity Grades

The Activity Grades report provides a simple view into your activity grades in the course.

9.3.3.2.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Activities: Setting this filter narrows the report results to show only data for a specific activity within the course.
  • Activity Type: Setting this filter narrows the report results to show only data for activities in the course that are of the type selected.
9.3.3.2.2. Report View

Example learner report activity grades

9.3.3.3. Activity Views

The Activity Views report provides a quick look at the number of times you have viewed each activity in the course.

9.3.3.3.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Activities: Setting this filter narrows the report results to show only data for a specific activity within the course.
  • Last Viewed: Setting this filter narrows the report results to show only data for activities in the course that were last viewed date after a specified date and time, before a specific date and time, or between two specified dates.
9.3.3.3.2. Report View

Example learner report activity views

9.3.3.4. Assignment Submissions

The Assignment Submissions report provides a view of all assignment submissions in the course.

9.3.3.4.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Assignment: Setting this filter narrows the report results to show only data for a selected assignment within the course.
  • Due Date: Setting this filter narrows the report results to show only data for assignments in the course with a due date that is after a specific date and time, before a specific date and time, or between those two dates.
  • Date Submitted: Setting this filter narrows the report results to only show data for assignments in the course that are due after a specific date and time, before a specific date and time, or between two specified dates and times.
9.3.3.4.2. Report View

Example learner report assignment submissions

9.3.3.5. Dashboard

The Dashboard is a quick view of the Recent Activity chart, which is intended to visually show the student their activity level in the course.

9.3.3.5.1. Report View

Example learner report dashboard

9.3.3.6. Forum Posts

The Forum Posts report shows all of the forums and a total number of posts and discussions you have contributed to those forums.

9.3.3.6.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Forum: Setting this filter narrows the report results to show only data for a specific forum within the course.
  • Last Posted: Setting this filter narrows the report results to show only data for forums where the last post was made after a specific date and time, before a specific date and time, or between two specified dates.
9.3.3.6.2. Report View

Example learner report forum posts

9.3.3.7. Glossary Posts

The Glossary Posts report shows all of the glossaries and the total number of posts that you have contributed to each of those glossaries.

9.3.3.7.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Glossary: Setting this filter narrows the report results to show only data for a specific glossary within the course.
  • Last Posted: Setting this filter narrows the report results to show only data for glossaries where the last glossary entry was posted after a specific date and time, before a specific date and time, or between two specified dates.
9.3.3.7.2. Report View

Example learner report glossary posts

9.3.3.8. Outcomes

The Outcomes report is a quick look at all the activities in the course that are associated with a outcome and what your rating is for each outcome and activity.

9.3.3.8.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Activities: Setting this filter narrows the report results to show only data for a specific activity within the course.
  • Graded On: Setting this filter narrows the report results to show only data for activities that were graded after a specific date and time, before a specific date and time, or between two specified dates.
9.3.3.8.2. Report View

Example learner report outcomes

9.3.3.9. Quiz Submissions

The Quiz Submissions report shows you all of your attempts for each quiz in the course and the grade for that attempt as well as the final grade. This is a good look at your quiz status in the course.

9.3.3.9.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Quiz: Setting this filter narrows the report results to only data for a specific quiz within the course.
  • Attempt Timestamp: Setting this filter narrows the report results to only data for quizzes with an attempt after a specific date and time, before a specific date and time, or between two specified dates and times.
9.3.3.9.2. Report View

Example learner report quiz submissions

9.3.3.10. Recent Activity

The Recent Activity report provides a view of all the activity you have had within the course that Joule reports to teachers. This provides you with a good idea of what you have been doing and what your teacher will see you doing.

9.3.3.10.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Activities: Setting this filter narrows the report results to only data for a specific activity within the course.
  • Timestamp: Setting this filter narrows the report results to only show data for activity that occurred after a specific date and time, before a specific date and time, or between two specified dates and times.
9.3.3.10.2. Report Views

Tabular

Example learner report recent activity

Chart

Example learner report recent activity chart

9.3.3.11. Roster

The Roster report allows the student to view the last time they accessed an activity in a section of the course or any specific activity in the course.

9.3.3.11.1. Report-Specific Filters

Roster is different than the other Course reports as it only supports the following filter:

  • Last Access: Setting this filter narrows the report results to only show users whose last recorded activity within the course was after a specific date and time, before a specific date and time, or between two specified dates and times.
9.3.3.11.2. Report View

Example learner report roster

9.3.3.12. SCORMs

The SCORM report provides you with a look at all the SCORM packages in the course along with each attempt you have made for each section of the SCORM (called a sco). Each record will show your grade, time on task and last access.

9.3.3.12.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • SCORM package: Setting this filter narrows the report results to only show data for a specific SCORM package within the course.
  • Last Access: Setting this filter narrows the report results to only show data for SCORM packages where the last accessed date is after a specific date and time, before a specific date and time, or between two specified dates.
9.3.3.12.2. Report View

Example learner report scorm

9.3.3.13. Wiki Posts

The Wiki Posts report is a quick view of all the wikis in the course and how many pages and posts you have created in each.

9.3.3.13.1. Report-Specific Filters

The Wiki Posts report doesn't use the Grade category filter but has the following filters that apply specifically to it:

  • Wiki: Setting this filter narrows the report results to only show data for a specific wiki within the course.
  • Last Posted: Setting this filter narrows the report results to only show data for wikis that have a post that was added after a specific date and time, before a specific date and time, or between two specified dates and times.
9.3.3.13.2. Report View

Example learner report wiki posts

9.4. Teacher Documentation

Reports Depend on Collectors
Reports depend on the Collector block that your Joule Administrator configures. The collectors run on a regular interval based on your administrator's settings, usually every 2 hours. Collectors do not collect data about hidden assignments. This means that if you un-hide an assignment, you will not see Joule Report data about that assignment until after the collector has run and collected data about the assignment. Please allow several hours to pass before expecting to see report data about assignments that you have recently made visible. Also note that report data will be delayed about 2 hours from real time, depending on the set interval.

9.4.1. Accessing Reports

in Joule 2, Joule Reports are accessed via the Joule Reports link in the Settings block. Clicking the Joule Reports link will bring up the Joule Reports Dashboard.

Joule Reports link in the course settings block

9.4.2. Exporting Reports

Tabular data for all reports can be exported to a CSV file via the Export drop-down menu on the bottom of the page.

Export report data to a file drop-down

The user will be asked if they want to save or open the file, depending on the browser's settings.

9.4.3. Report Actions

Course, Exception and LearnerView reports have an Action drop-down menu below the Select column of a report. This Action drop-down menu can be used to perform an action on the student listed in the user column for a record selected. The current action is:

  • Send Message to Student: This action is used to send an e-mail message to the student. This message will go to the user's external e-mail address specified in their profile.

To perform an action on a student, click the checkbox in the Select column and then select the action from the Action drop-down menu.

9.4.3.1. Sending a Message to a Student(s)

To send a message to a student or students, click the checkbox in the Select column for each student you want to send a message to. Next select the Send message to student action from the Action drop-down menu.

Select send message to student action in the action drop-down

This will cause a message pop up to appear.

Send message pop up

Add your message to the Message body text area and click the Send message button to send the message to the student(s). A message will be sent to the user based on their Moodle messaging Personal messages between users_ settings.

You can remove students from the selected users to send a message to by clicking the Remove button to the right of the user's name and email address.

9.4.4. Course Reports

These reports provide simple views of student engagement within course activities.

9.4.4.1. Common Filters

The following are common filters that are available for all Course reports:

  • Grade Category: Setting this filter narrows the report results to only show data within a set of activities that are within a specific grade category in the course's grade book. The "Course Category" option in the drop-down menu refers to the overall grade category for the course. If accessed at the site level, the Course filter must be set to use this filter.
  • Sections: Setting this filter narrows the report results to only show data for activities that are within a specific section of the course. A section refers to either a topic, week or folder, depending on the course format. If accessed at the site level, the Course filter must be set to use this filter.
  • Group: Setting this filter narrows the report results to only show data for a specific set of users within a group in the course. If accessed at the site level, the Course filter must be set to use this filter.
  • User: Setting this filter narrows the report results to only show data for a specific user in the course.
9.4.4.2. Activity Grades

The Activity Grades report provides a simple view into the activity grades in a course for users.

9.4.4.2.1. Report Specific Filters

The report has the following filters that apply specifically to it:

  • Activities: Setting this filter narrows the report results to only show data for a specific activity within the course.
  • Activity Type: Setting this filter narrows the report results to only show data for the type of activity selected.
9.4.4.2.2. Report View

Example course report activity grades

9.4.4.3. Activity Views

The Activity Views report provides a quick look into the number of times that users have viewed each activity in the course. This provides teachers an idea of the popular or most used resources or activities in a course.

9.4.4.3.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Activities: Setting this filter narrows the report results to only show data for a specific activity within the course.
  • Last Viewed: Setting this filter narrows the report results to only show data for activities that were last viewed after a specific date and time, before a specific date and time, or between two specified dates and times. Default: is after today's date minus seven days, is before today's date
9.4.4.3.2. Report View

Example course report activity views

9.4.4.4. Assignment Submissions

The Assignment Submissions report provides the teacher with a view of all assignment submissions for all students in the course.

9.4.4.4.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Assignment: Setting this filter narrows the report results to only show data for a specific assignment within the course.
  • Due Date: Setting this filter narrows the report results to only show data for assignments in the course that are due after a specific date and time, before a specific date and time, or between two specified dates and times.
  • Date Submitted: Setting this filter narrows the report results to only show data for assignment submissions that were sent after a specific date and time, before a specific date and time, or between two specified dates and times. Default: is after today's date minus seven days, is before today's date
9.4.4.4.2. Report View

Example course report assignment submissions

9.4.4.5. Dashboard

The Dashboard is a quick view of charts for the most common reports: Recent Activity, Forum Posts, Quiz Submissions and Assignment Submissions. These charts are intended to provide the teacher with a quick idea of the level of activity in the course.

9.4.4.5.1. Report View

Example course report dashboard

9.4.4.6. Forum Posts

The Forum Posts report provides a quick look into the usage of each forum in the course by providing a list of students and number of posts they have each made in each forum.

9.4.4.6.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Forum: Setting this filter narrows the report results to only show data for a specific forum within the course.
  • Last Posted: Setting this filter narrows the report results to only show data for forums where the last post was made after a specific date and time, before a specific date and time, or between two specified dates and times. Default: is after today's date minus seven days, is before today's date
9.4.4.6.2. Report Views

Tabular

Example forum posts report

Chart

Example forum posts chart

9.4.4.7. Glossary Posts

The Glossary Posts report provides a quick look into the usage of each glossary in the course by providing a list of students and the number of posts they have each made in each glossary.

9.4.4.7.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Glossary: Setting this filter narrows the report results to only show data for a specific glossary within the course.
  • Last Posted: Setting this filter narrows the report results to only show data for glossaries with an entry that was last posted after a specific date and time, before a specific date and time, or between two specified dates and times. Default: is after today's date minus seven days, is before today's date
9.4.4.7.2. Report View

Example course report glossary posts

9.4.4.8. Needs Grading

The Needs Grading report provides a quick list of all of the activities in a course that have attempts that need to be graded by the teacher.

9.4.4.8.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Activities: Setting this filter narrows the report results to only show data for a specific activity within the course.
  • Activity Type: Setting this filter narrows the report results to only show data for the selected type of activity in the course.
9.4.4.8.2. Report View

Example course report needs grading

9.4.4.9. Outcomes

The Outcomes report provides a quick list of all the students outcome ratings for each activity that has been assigned an outcome.

9.4.4.9.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Activities: Setting this filter narrows the report results to only show data for a specific activity within the course.
  • Graded On: Setting this filter narrows the report results to only show data for activities that were graded after a specific date and time, before a specific date and time, or between two specified dates and times. Default: is after today's date minus seven days, is before today's date
9.4.4.9.2. Report View

Example course report outcomes

9.4.4.10. Quiz Submissions

The Quiz Submissions report provides a quick look at all student attempts for each quiz in the course, along with the grade for each attempt and the final grade.

9.4.4.10.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Quiz: Setting this filter narrows the report results to only show data for a specific quiz within the course.
  • Attempt Timestamp: Setting this filter narrows the report results to only show data for quizzes on which an attempt was made after a specific date and time, before a specific date and time, or between two specified dates and times. Default: is after today's date minus seven days, is before today's date
9.4.4.10.2. Report Views

Tabular

Example quiz submissions report

Chart

Example quiz submissions report chart

9.4.4.11. Recent Activity

The Recent Activity report provides a view of all activity for all of the students in the course. From a graph perspective, this report provides you with a basic usage chart for the course and all students in the course.

9.4.4.11.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Activities: Setting this filter narrows the report results to only show data for a specific activity within the course.
  • Timestamp: Setting this filter narrows the report results to only show data about user activity that was recorded after a specific date and time, before a specific date and time, or between two specified dates and times. Default: is after today's date minus seven days, is before today's date
9.4.4.11.2. Report View

Tabular

Example course report recent activity

Chart

Example course report recent activity chart

9.4.4.12. Roster

The Roster provides a quick look at all of the users who are enrolled in the course and the last date they accessed the course.

9.4.4.12.1. Report-Specific Filters

Roster is different than the other Course reports because it only supports the following filter:

  • Last access: Setting this filter narrows the report results to only show users whose last recorded activity within the course was after a specific date and time, before a specific date and time, or between two specified dates and times. Default: is after today's date minus seven days, is before today's date
9.4.4.12.2. Report View

Example course report roster

9.4.4.13. SCORMs

The SCORMs report provides a list of all SCORM packages and the SCOs within those packages that students have accessed in the course. This report also reports the attempt, time on attempt and grade for the SCO.

9.4.4.13.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • SCORM package: Setting this filter narrows the report results to only show data for a specific SCORM package within the course.
  • Last Access: Setting this filter narrows the report results to only show data for SCORM packages that were last accessed after a specific date and time, before a specific date and time, or between two specified dates and times. Default: is after today's date minus seven days, is before today's date
9.4.4.13.2. Report View

Example course report scorm

9.4.4.14. Wiki Posts

The Wiki Posts report provides a quick look into the usage of each wiki in the course by providing a list of students and the number of posts each student has made in each wiki.

9.4.4.14.1. Report-Specific Filters

The Wiki Posts report doesn't use the Grade category filter and has the following filters that apply specifically to it:

  • Wiki: Setting this filter narrows the report results to only show data for a specific wiki within the course.
  • Last Posted: Setting this filter narrows the report results to only show data for wikis that have a post that was added after a specific date and time, before a specific date and time, or between two specified dates and times. Default: is after today's date minus seven days, is before today's date
9.4.4.14.2. Report View

Example course report wiki posts

9.4.5. Correlation Reports

The Correlation reports compare grades in the course to the level of engagement for activities in a course.

9.4.5.1. Activity Grade via Engagement Detail Report

This report reveals various learner scores within course activities. The average grade for the activity is represented with a bar chart. When you hover your cursor over the chart, you will see the total number of views and posts (engagement) within the grade's context.

This report can be viewed in several different contexts with different results.

9.4.5.1.1. Report Filters

The report allows the following filters to be applied:

  • Group: Limit the results based on the users that are in a specific group
  • Grade Category: Limit the activities displayed to those in a specific grade category
  • Sections: Limit the activities displayed to those in a specific section (week, topic or folder)
  • User: Limits the report to data about a selected user
  • Grade Distribution: Limit the grades that are shown to greater than a number and less than a number
  • Activities to Show: Limit the activities shown to just graded activities or all activities in the course
9.4.5.1.2. Report Views

Tabular

Example correlation report activity grade via engagement detail

Chart

Example correlation report activity grade via engagement detail chart

9.4.5.2. Learner Engagement Distribution Report

This report reveals how much learner engagement is captured within each grade distribution (e.g. How many views/posts are students making whose grades are between 50-60%? How many views/posts are students making whose grades are between 90-100%?).

9.4.5.2.1. Report Filters

The report allows the following filters to be applied:

  • Group: Limit the results based on the users that are in a specific group
  • User: Limit the report to data about a selected user
  • Date Range: Display data for views/posts that occurred between a specific start and end date
  • View to Display: What data is displayed?
    • Views - Activity views
    • Posts - Activity posts
9.4.5.2.2. Report Views

Tabular Posts

Example correlation report learner engagement distribution detail posts

Chart Posts

Example correlation report learner engagement distribution detail posts chart

Tabular Views

Example correlation report learner engagement distribution detail views

Chart Views

Example correlation report learner engagement distribution detail views chart

9.4.5.3. Learner Engagement Trends Report

This report reveals a total number of views or posts of users over a range of time. One can see when students are engaged (or not) with the course.

9.4.5.3.1. Report Filters

The report allows the following filters to be applied:

  • Group: Limit the report based on the users that are in the group
  • User: Limit the report to data about the selected user
  • Date range: Display views or posts for the course between a specific start and end date
  • View to display: What data is displayed?
    • Views - Activity views
    • Posts - Activity posts
9.4.5.3.2. Report Views

Tabular Posts

Example correlation report learner engagement trends detail posts

Chart Posts

Example correlation report learner engagement trends detail posts chart

Tabular Views

Example correlation report learner engagement trends detail views

Chart Views

Example correlation report learner engagement trends detail views chart

9.4.5.4. Learner Grade via Engagement Detail Report

This report reveals a learner's grade within an activity, course or series of courses. The learner's accumulated grade is represented with a bar chart. When you hover your cursor over the chart, you will see the total number of views and posts (engagement) within the grade's context.

This report can be viewed in several different contexts with different results.

9.4.5.4.1. Report Filters

The report allows the following filters to be applied:

  • Group: Limit the results based on the users that are in a specific group
  • Grade Category: Limit the results to activities in a particular grade category
  • Sections: Limit the activities displayed to those in a specific section (week, topic or folder)
  • Activities: Limit the report to data about a specific activity
  • Grade Distribution: Limit the grades that are shown to greater than a number and less than a number
9.4.5.4.2. Report Views

Tabular

Example correlation report learner grade via engagement detail

Chart

Example correlation report learner grade via engagement detail chart

9.4.6. Exception Reports

The Exception reports are used by teachers to track which students are not interacting with the course activities and may need assistance. These reports focus on students that are missing information. For example, those who haven't posted to a forum or a wiki.

9.4.6.1. Common Filters

The following are common filters that are available for all Course reports:

  • Grade Category: Setting this filter narrows the report results to only show data for a set of activities within specific grade category in the course's grade book. The "Course Category" option in the drop-down refers to the overall grade category for the course. If accessed at the Site level, the Course filter must be set to use this filter.
  • Sections: Setting this filter narrows the report results to only show data for activities that are within a specific section of the course. A section refers to either a topic, week or folder, depending the course format. If accessed at the site level, the Course filter must be set to use this filter.
  • Group: Setting this filter narrows the report results to only show data for a set of users within a specific group in the course. If accessed at the site level, the Course filter must be set to use this filter.
  • User: Setting this filter narrows the report results to only show data for a specific user in the course.
9.4.6.2. Activity Grades

The Activity Grades report provides the teacher with a list of all users and the activities that they have not received a grade on yet. This report will only show activities that can actually be graded.

9.4.6.2.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Activities: Setting this filter narrows the report results to only show data for a specific activity within the course.
  • Activity Type: Setting this filter narrows the report results to only show data for the type of activity selected.
9.4.6.2.2. Report View

Example exception report activity grades

9.4.6.3. Activity Views

The Activity Views report provides the teacher with a look at all activities in a course that a student hasn't viewed at least once.

9.4.6.3.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Activities: Setting this filter narrows the report results to only show data for a specific activity within the course.
  • Last Viewed: Setting this filter narrows the report results to only show data for activities in the course that a user did not view after a specific date and time, before a specific date and time, or between two specified dates and times. Default: is after today's date minus seven days, is before today's date
9.4.6.3.2. Report View

Example exception report activity views

9.4.6.4. Assignment Submissions

The Assignment Submissions report provides the teacher with a view of all the assignments in the course that the student hasn't made a submission to.

9.4.6.4.1. Report Specific Filters

The report has the following filters that apply specifically to it:

  • Assignment: Setting this filter narrows the report results to only show data for a specific assignment within the course.
  • Due Date: Setting this filter narrows the report results to only show data for assignments in the course that are due after a specific date and time, before a specific date and time, or between two specified dates and times.
  • Date Submitted: Setting this filter narrows the report results to only show data for assignments for which a user did not make a submission after a specific date and time, before a specific date and time, or between those two specified dates and times. Default: is after today's date minus seven days, is before today's date
9.4.6.4.2. Report View

Example exception report assignment submissions

9.4.6.5. Forum Posts

The Forum Posts report provides the teacher with a list of users and what forums they have not made a post to.

9.4.6.5.1. Report-Specific Filters

The report has the following specific filters that apply to it:

  • Forum: Setting this filter narrows the report results to only show data for a specific forum within the course.
  • Last Posted: Setting this filter narrows the report results to only show data for forums to which a user did not post after a specific date and time, before a specific date and time, or between two specified dates. Default: is after today's date minus seven days, is before today's date
9.4.6.5.2. Report View

Example exception report forum posts

9.4.6.6. Glossary Posts

The Glossary Posts report provides a teacher with a quick view of all the users who have not posted to a glossary within the course.

9.4.6.6.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Glossary: Setting this filter narrows the report results to only show data for a specific glossary within the course.
  • Last Posted: Setting this filter narrows the report results to only show data for glossaries that a user did not post to after a specific date and time, before a specific date and time, or between two specific dates and times. Default: is after today's date minus seven days, is before today's date
9.4.6.6.2. Report View

Example exception report glossary posts

9.4.6.7. Outcomes

The Outcomes report provides the teacher with a list of students who have not performed against an outcome within the course.

9.4.6.7.1. Report Specific Filters

The report has the following filters that apply specifically to it:

  • Activities: Setting this filter narrows the report results to only show data for a specific activity within the course.
  • Graded on: Setting this filter narrows the report results to only show data for activities that were graded after a specific date and time, before a specific date and time, or between two specified dates and times.
9.4.6.7.2. Report View

Example exception report outcomes

9.4.6.8. Quiz Submissions

The Quiz Submissions report provides the teacher with a list of students who have not attempted quizzes within the course.

9.4.6.8.1. Report Specific Filters

The report has the following filters that apply specifically to it:

  • Quiz: Setting this filter narrows the report results to only show data for a specific quiz within the course.
  • Attempt Timestamp: Setting this filter narrows the report results to only show data for quizzes that a user did not attempt after a specific date and time, before a specific date and time, or between two specified dates and times. Default: is after today's date minus seven days, is before today's date
9.4.6.8.2. Report View

Example exception report quiz submissions

9.4.6.9. SCORMs

The SCORMs report provides the teacher with a list of students who have not attempted SCORMs in the course.

9.4.6.9.1. Report View

Example exception report scorm

9.4.6.9.2. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • SCORM Package: Setting this filter narrows the report results to only show data for a specific SCORM package within the course.
  • Last Access: Setting this filter narrows the report results to only show for SCORMs that a user did not access after a specific date and time, before a specific date and time, or between two specified dates and times. Default: is after today's date minus seven days, is before today's date
9.4.6.10. Wiki Posts

The Wiki Posts report provides the teacher with a list of students who have not posted to a wiki within the course.

9.4.6.10.1. Report-Specific Filters

The Wiki Posts report doesn't use the Grade category filter but has the following filters that apply specifically to it:

  • Wiki: Setting this filter narrows the report results to only show data for a specific wiki within the course.
  • Last Posted: Setting this filter narrows the report results to only show data for wikis that a user did not post to after a specific date and time, before a specific date and time, or between two specified dates and times. Default: is after today's date minus seven days, is before today's date
9.4.6.10.2. Report View

Example exception report wiki posts

9.4.7. LearnerView Reports

The LearnerView reports are used by teachers to view what specific students are doing in a course and understanding each individual's progress. These reports have a unique interface that focuses the reports on a student and works to provide the teacher with quick navigation between students.

9.4.7.1. Common Filters

The following are common filters that are available for all Course reports:

  • Grade Category: Setting this filter narrows the report results to only show data for a set of activities within a specific grade category in the course's grade book. The "Course Category" option in the drop-down menu refers to the overall grade category for the course. If accessed at the site level, the Course filter must be set to use this filter.
  • Sections: Setting this filter narrows the report results to only show data for activities that are within a specific section of the course. A section refers to either a topic, week or folder, depending on the course type. If accessed at the site level, the Course filter must be set to use this filter.

The LearnerView reports also have a navigation element in the upper right-hand corner of the report. The user navigation provides a quick way to navigate between users in the course to view their report information. Click the Previous user link to return to the report of the previous user in the list. Click the Next user link to navigate to the report of the next user in the course. A drop-down menu can also be used to jump to a specific user in the course. When navigating between users, the report filters stay the same for each user, providing a quick view into the same data for each user for an apples-to-apples comparison.

9.4.7.2. Activity Grades

The Activity Grades report provides a simple view into the activity grades in a course for the selected user.

9.4.7.2.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Activities: Setting this filter narrows the report results to only show data for a specific activity within the course.
  • Activity Type: Setting this filter narrows the report results to only show data for the selected type of activities in the course.
9.4.7.2.2. Report View

Example learner view report activity grades

9.4.7.3. Activity Views

The Activity Views report provides a quick look into the number of views for each activity in the course that the user has performed. This provides the teachers with an idea of the popular or most used resources or activities for the individual student.

9.4.7.3.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Activities: Setting this filter narrows the report results to only show data for a specific activity within the course.
  • Last Viewed: Setting this filter narrows the report results to only show data for activities in the course that the student last viewed after a specific date and time, before a specific date and time, or between two specified dates and times. Default: is after today's date minus seven days, is before today's date
9.4.7.3.2. Report View

Example learner view report activity views

9.4.7.4. Assignment Submissions

The Assignment Submissions report provides the teacher with a view of all the assignment submissions for a student in the course.

9.4.7.4.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Assignment: Setting this filter narrows the report results to only show data for a specific assignment within the course.
  • Due date: Setting this filter narrows the report results to only show data for assignments in the course that are due after a specific date and time, before a specific date and time, or between two specified dates and times.
  • Date submitted: Setting this filter narrows the report results to only show data for assignments that were submitted after a specific date and time, before a specific date and time, or between two specified dates and times. Default: is after today's date minus seven days, is before today's date
9.4.7.4.2. Report View

Example learner view report assignment submissions

9.4.7.5. Forum Posts

The Forum Posts report provides the teacher with the number of posts a student has made in each course forum.

9.4.7.5.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Forum: Setting this filter narrows the report results to only show data for a specific forum within the course.
  • Last Posted: Setting this filter narrows the report results to only show data for forums that the user posted to after a specific date and time, before a specific date and time, or between two specified dates and times. Default: is after today's date minus seven days, is before today's date
9.4.7.5.2. Report View

Example learner view report forum posts

9.4.7.6. Glossary Posts

The Glossary Posts report provides the teacher with the number of posts a student has made in each course glossary.

9.4.7.6.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Glossary: Setting this filter narrows the report results to only show data for a specific glossary within the course.
  • Last Posted: Setting this filter narrows the report results to only show data for glossaries that the user last posted to after a specific date and time, before a specific date and time, or between two specified dates and times. Default: is after today's date minus seven days, is before today's date
9.4.7.6.2. Report View

Example learner view report glossary posts

9.4.7.7. Outcomes

The Outcomes report provides the teacher with the student's outcome grade by activity for the course.

9.4.7.7.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Activities: Setting this filter narrows the report results to only show data for a specific activity within the course.
  • Graded on: Setting this filter narrows the report results to only show data for activities that were graded after a specific date and time, before a specific date and time, or between two specified dates and times. Default: is after today's date minus seven days, is before today's date
9.4.7.7.2. Report View

Example learner view report outcomes

9.4.7.8. Quiz Submissions

The Quiz Submissions report provides the teacher with data about all of the quiz attempts, including grades, that a student has made in the course.

9.4.7.8.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Quiz: Setting this filter narrows the report results to only show data for a specific quiz within the course.
  • Attempt timestamp: Setting this filter narrows the report results to only show data for quiz attempts that were made after a specific date and time, before a specific date and time, or between two specified dates. Default: is after today's date minus seven days, is before today's date
9.4.7.8.2. Report View

Example learner view report quiz submissions

9.4.7.9. Recent Activity

The Recent Activity report provides the teacher with the recent activity for the student in the course.

9.4.7.9.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Activities: Setting this filter narrows the report results to only show data for a specific activity within the course.
  • Timestamp: Setting this filter narrows the report results to only show data for activity that occurred after a specific date and time, before a specific date and time, or between two specified dates and times. Default: is after today's date minus seven days, is before today's date
9.4.7.9.2. Report View

Example learner view report recent activity

9.4.7.10. SCORMs

The SCORMs report provides the teacher with a view of all the SCORM and SCO attempts the student has made in the course.

9.4.7.10.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • SCORM package: Setting this filter narrows the report results to only show data for a specific SCORM package within the course.
  • Last Access: Setting this filter narrows the report results to only show data for SCORM packages that were last accessed after a specific date and time, before a specific date and time, or between two specified dates and times. Default: is after today's date minus seven days, is before today's date
9.4.7.10.2. Report View

Example learner view report scrom

9.4.7.11. Wiki Posts

The Wiki Posts report provides the teacher with the number of posts a student has made in each wiki in the course.

9.4.7.11.1. Report-Specific Filters

The Wiki report doesn't use the Grade category filter but has the following filters that apply specifically to it:

  • Wiki: Setting this filter narrows the report results to only show data for a specific wiki within the course.
  • Last Posted: Setting this filter narrows the report results to only show data for wikis that a user posted to after a specific date and time, before a specific date and time, or between two specified dates. Default: is after today's date minus seven days, is before today's date
9.4.7.11.2. Report View

Example learner view report wiki posts

9.4.8. Comparison Reports

Comparison Reports help the teacher and other course managers focus on comparisons between courses, course activities, and student performance within their courses.

9.4.8.1. Course Summaries

The Course summaries report enables administrators, instructors or students to compare the summary data of different courses to each other. Summary data in these reports include table columns for course category, course, grade, completion, engagement hits, and sample of activities.

9.4.8.1.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Course: Setting this filter narrows the report results to only show data for a specific course.
  • Category: Setting this filter narrows the report results to only show data for a specific category.
9.4.8.1.2. Report View

9.4.8.2. Participant Summaries

The Participant summaries report enables administrators and instructors to compare specific users across a site or course. Summary data in these reports include table columns for course participant, course category, course, grade, completion, engagement hits, and sample of activities.

9.4.8.2.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Participants: Setting this filter narrows the report results to only show data for a specific participant.
  • Cohorts: Setting this filter narrows the report results to only show data for a specific cohort.
9.4.8.2.2. Report View

9.4.8.3. Participants Comparison 

The Participants comparison report enables administrators and instructors to compare the summary data of different users within a single course. This report can only be accessed at the course level. Summary data in these reports include table columns for course participant, activity, grade, completion, engagement, and samples of activities.

9.4.8.3.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Participants: Setting this filter narrows the report results to only show data for a specific participant within the course.
  • Cohorts: Setting this filter narrows the report results to only show data for a specific cohort.
9.4.8.3.2. Report View

9.4.8.4. Activities Comparison

The Activities comparison report enables administrators and instructors to compare the summary data of different course activities within a course. Like the Participants comparison report, this report is only accessible at the course level as well. Summary data in these reports include table columns for course activity, participant, grade, completion, and engagement.

9.4.8.4.1. Report-Specific Filters

The report has the following filters that apply specifically to it:

  • Course: Setting this filter narrows the report results to only show data for a specific course.
  • Category: Setting this filter narrows the report results to only show data for a specific category.
9.4.8.4.2. Report View

9.5. Administrator Documentation

9.5.1. Accessing the Admin Reports

The Admin reports can be accessed from the Joule site page via the Navigation block. The link is accessed by clicking Site Pages > Reports > Dashboard.

Joule Reports link in the navigation block under Site pages > reports > dashboard

9.5.2. Admin Report

The Admin report in Joule 2 allows an administrator to create a custom ad-hoc report based on an SQL query for a MySQL database.

9.5.2.1. Create a Query

To create a new report, enter a query in the provided text area to the right and above the Generate Report button. All queries must be written for a MySQL database. See the MySQL documentation for syntax structure for a query.

At this time, all field names that you wish to display as columns in the report must be specified and/or aliased. For example, the following query is not valid:

You must specify field names such as id, username, firstname, lastname.

Table aliases may be used. For example, the following query is valid:

Aggregate function fields must be aliased. For example, the following query is valid:

While the following query is not valid:

Colons in query
If a query has a colon in it then this must be concatenated with the rest of the string. This usually occurs when you are searching capabilities and plugins configuration variables. An example query is below:

To submit a query to produce a report, click the Generate Report button and the report will be displayed below the query area.

Filter Button
If you have run previous reports in the same session, the Generate Report button may be hidden and the Filter button displayed instead. Click the Filter button to display the report query text area and the Generate Report button.

The following SQL code will generate the report shown below it:

Example SQL query

Example report based on the query above

You can click the Reset button to clear the query text area of any SQL report and start over or load a saved query.

Collect Tables
The tables that start with "mdl_block_collect" in the database schema are block collector tables and contain the collected data points as set in the Collect block's global settings.

9.5.2.1.1. Example SQL Queries
9.5.2.2. Browse Schema

The Browse Schema button allows the administrator to view the database schema for their Joule site as well as the structure of each table. To view the database schema, click the Browse Schema button. The initial load of the schema can take a few seconds, so be patient. To view a table's structure, select the table in the right-hand column and you will view the table structure in the left-hand column.

Browse schema for mdl_block

Close the schema by clicking on the X button in the upper right-hand corner of the schema dialogue.

Download Joule 2 Database Schema and data dictionary
An alternative to the schema browser is the attached Joule 2 database schema you can download it as a pdf or as a png. If a data dictionary is easier to read you can download the that as a pdf.
9.5.2.3. Save Query

To save a query after you have generated a report from it, enter a name in the Name text field below the report display and click the Save Query button. The report name will now show up in the saved query dialogue when you click the Saved Queries button.

Enter query in the name filed and click the Save Query button

You will then see an alert message stating that the query was saved.

9.5.2.4. Load a Saved Query

To load a saved query, first click the Saved Queries button. A dialogue box will appear with a list of all saved queries. Click on the name of the saved query you want to load in order to load the query into the text area. Clicking on a saved query will overwrite any code that has been entered in the query text area, so make sure that you have a copy of what was in the query field or that you have saved it before loading a saved query. Click the Generate Report button to display the report from the loaded query.

Filter Button
If you have run previous reports in the same session, the Generate Report button may be hidden and the Filter button displayed instead. Click the Filter button to display the report query text area and the Generate Report button.

Click the saved query button then the name of the query to load it in the text area

9.5.2.5. Delete Saved Query

To delete a saved query, click the Saved Queries button and then click the red X icon to the right of the query name you wish to delete.

Click the red X icon to the right of a query name to delete a saved query

A confirmation message will appear on the screen. Click the Ok button to delete the saved query.

9.5.3. Exporting Reports

Tabular data for all reports can be exported to a CSV file via the Export drop-down menu on the bottom of the page.

Export report data to a file drop-down

The user will be asked if they want to save or open the file, depending on the browser's settings.

9.5.4. Report Requirements

Joule Reports require that the Collector block have certain collectors enabled to gather data used by the reports. Below are the collectors required for each Joule Report.

9.5.4.1. Course Reports
9.5.4.1.1. Collect Block Collectors to Enable for all Course Reports

You will need to ensure that the data collection points below have been enabled in order to use all of the Course reports:

  • Course/User Collector and Any/All of the Following:
    • Enrollment End
    • Enrollment Start
    • Course Grade
    • Course Completion
    • View
  • Activity Collector
    • Name
    • Sort Order
  • Activity/User Collector
    • Attempt
    • Grade
    • Post
    • View
9.5.4.1.2. Collect Block Collectors to Enable for the Course Report's SCORMs Report

Beyond the collector required for all Course reports, the SCORMs report requires the following extra data collection points to be enabled:

  • SCORM/Track Collector
  • Track
9.5.4.2. Correlation Reports
9.5.4.2.1. Collect Block Collectors to Enable for all Correlation Reports

You will need to ensure that the data collection points below have been enabled in order to use all the Correlation reports:

  • Course/User Collector and Any/All of the Following:
    • Enrollment End
    • Enrollment Start
    • Course Grade
    • Course Completion
    • View
  • Activity Collector
    • Name
    • Sort Order
  • Activity/User Collector
    • Attempt
    • Grade
    • Post
    • View
9.5.4.2.2. Collect Block Collectors to Enable for the Course Report's Learner Engagement Distribution Report

Beyond the collectors required for all Course reports, the Learner Engagement Distribution report requires the following extra data collection points to be enabled:

  • Activity/Action Collector
    • Post
    • View
9.5.4.3. Exception Reports
9.5.4.3.1. Collect Block Collectors to Enable for all Exception Reports

You will need to ensure that the data collection points below have been enabled in order to use all the Exception reports:

  • Course/User collector and any/all of the following:
    • Enrollment End
    • Enrollment Start
    • Course Grade
    • Course Completion
    • View
  • Activity Collector
    • Name
    • Sort Order
  • Activity/User Collector
    • Attempt
    • Grade
    • Post
    • View
9.5.4.4. Learner Reports
9.5.4.4.1. Collect Block Collectors to Enable for all Learner Reports

You will need to ensure that the data collection points below have been enabled in order to use all of the Learner reports:

  • Course/User Collector and Any/All of the Following:
    • Enrollment End
    • Enrollment Start
    • Course Grade
    • Course Completion
    • View
  • Activity Collector
    • Name
    • Sort Order
  • Activity/User Collector
    • Attempt
    • Grade
    • Post
    • View
9.5.4.5. LearnerView Reports
9.5.4.5.1. Collect Block Collectors to Enable for all LearnerView Reports

You will need to ensure that the data collection points below have been enabled in order to use all of the LearnerView reports:

  • Course/User Collector and Any/All of the Following:
    • Enrollment End
    • Enrollment Start
    • Course Grade
    • Course Completion
    • View
  • Activity Collector
    • Name
    • Sort Order
  • Activity/User Collector
    • Attempt
    • Grade
    • Post
    • View
9.5.4.6. Comparison Reports
9.5.4.6.1. Collect Block Collectors to Enable for all Comparison Reports

You will need to ensure that the data collection points below have been enabled in order to use all of the Comparison reports:

  • Course/User Collector and Any/All of the Following:
    • Enrollment End
    • Enrollment Start
    • Course Grade
    • Course Completion
    • View
  • Activity Collector
    • Name
    • Sort Order
  • Activity/User Collector
    • Attempt
    • Grade
    • Post
    • View

9.6. Global Settings

  • AJAX default: Sets the default report view for users, which is either Basic HTML if set to "No" or AJAX if set to "Yes." Default: Yes

9.7. Permissions

  • View (block/reports:view): If this permission is set to "allow," then the user is able to view the reports at the level they are at (site, category and course).
    • Default Permissions
      Role Not Set Allow Prevent Prohibit
      Manager   X    
      Course Creator X      
      Teacher   X    
      Non-Editing Teacher   X    
      Student X      
      Guest X      
      Authenticated User X      

10. New Outcomes

Outcomes are specific descriptions of what a student has demonstrated and understood at the completion of an activity or course. Each outcome is evaluated by the instructor to determine whether the student has met the criterion. Other terms for outcomes are Competencies, Standards, and Goals. Currently there are two types of Outcomes available in Joule, Legacy Outcomes and new Outcomes, both types of Outcomes can be enabled at the site level. This portion of the Moodlerooms Manuals will only cover the new Outcomes settings, creation, and mapping. Legacy Outcomes are scheduled to be retired with the release of Moodle 2.6.

10.1. Administrator Documentation

The Moodle administrator will be responsible for enabling outcomes and determining which outcomes if any will be available on the site. The option for enabling Outcomes are: Disable, Legacy Outcomes, New Outcomes, or Both Legacy and New. As a best practice, it is suggested to enable new Outcomes. If you are currently using the Legacy Outcomes, you may want to enable both until you migrate completely to the new system.

10.1.1. Enabling Outcomes

To enable Outcomes go to Settings>Site administration>Advanced features>Enable outcomes. Choose the option that best fits your institutions needs, then scroll to the bottom and save changes.

10.1.2. Creating Outcomes Set

Additionally, site administrators are responsible for adding outcomes to the site. There are two (2) options for adding outcomes, manual or import.

10.1.2.1. Adding New Outcome Sets

To manually add outcomes to a site go to Settings>Site administration>Grades>Outcomes and select Add a new outcome set.

An outcome set refers to a collective group of individual outcomes that share a commonality. Items included as identifiers for the set are Name, Unique ID, Description, Provider, and Region. Once the outcome set details have been entered individual outcomes can then be added.

To add individual outcomes to an outcome set, select the Add outcome button. A pop up window will appear to add the details of the outcome. Click Ok and Save changes when finished adding all outcomes.

  • Unique ID: Identifier associated with outcome unique to the site.
  • Doc Number: Identification number associated with outcome that was created outside of the system.
  • Subjects: Subject(s) that the outcome addresses, i.e. Math, English, Science.
  • Educational level: Grade level connected to the outcomes.
  • Assessable: Determines if this outcome can be mapped to content and assessed.
  • Description: Text based criterion associated with the outcome.

10.1.2.2. Importing Outcome Sets

To import outcomes select Import Outcome Set.

Determine the import format, Academic Benchmarks (XML), Achievement Standards Network (ASN), or General Moodle Format (XML). Then add the file by either choosing the file to upload or dragging and dropping into the upload box. Lastly click the button Import Outcome Set.

Note
Moodlerooms' clients can place support tickets to request copies of the following Academic Benchmark outcome set:
Arizona
California
NGA Center/CCSSO
Colorado
Connecticut
District of Columbia
Delaware
Florida
Georgia
Hawaii
Iowa
Idaho
Illinois
Indiana
Kansas
Kentucky
Louisiana
Massachusetts
Maryland
Maine
Michigan
Minnesota
Missouri
Mississippi
Montana
North Carolina
North Dakota
Nebraska
New Hampshire
New Jersey
New Mexico
Nevada
New York
Ohio
Oklahoma
Oregon
Pennsylvania
Rhode Island
South Carolina
South Dakota
Tennessee
Texas
Utah
Virginia
Vermont
Washington
Wisconsin
West Virginia
Wyoming

10.1.3. Managing Outcomes

The chart within the Settings>Site administration>Grades>Outcomes displays the Full Name of the outcome sets, the Mapped Courses, and the Edit/Delete/Export options. To view which courses the outcomes have been mapped, click the number in the mappings column. In addition, you can click the links to Edit, Delete, or Export any of the existing outcomes. When exporting a set, you will be saving the file as a General Moodle Format. Remember to select that option if you decide to import the export outcome set into another Moodle site.

10.1.4. Updating Outcomes

Outcome sets are often updated by the institutions that define their structure. The outcomes system does not currently support the overwriting of outcome sets. If you need to update an existing outcome set, you will need to delete the old set, import the new set, then  re-map all courses and activities to the most-recent set.

10.1.5.

10.2. Teacher Documentation

10.2.1. Selecting Outcome Sets

Courses are where Outcomes really get implemented. Instructors have the responsibility, in an outcomes driven system, to map content against outcomes, to monitor student progress, and to respond when students appear to have a problem.

To map a set of outcomes to an individual course go to Settings>Course administration>Edit settings>Outcomes, click Select outcome sets

A pop-up window will appear to select an outcome set that has been added to the site by a site administrator. Use the menu to choose an outcome set, the subject of the set, and the education level (e.g. 6th grade). Click Add.Additional outcome sets can be mapped by selecting the options from the drop-down menus.
Click Ok once all the outcome sets have been chosen.

10.2.2. Mapping Outcomes to Resources and Activities

Add outcomes to a resource or activity within the settings area of the module under Outcomes click Select outcomes.

A pop-up window will appear, click on each outcome to align to the resource/activity, a checkmark will appear to the left of each selected outcome. Once all the outcomes have been chosen scroll to the bottom and click Ok.

10.2.3. Mapping Outcomes to Quiz Questions

When creating/editing quiz questions outcomes can be added. On the editing page of the quiz question go to the Outcomes area, choose Select outcomes.

A pop-up window will appear to select the outcomes to align and then scroll to the bottom and click Ok.

10.2.4. Mapping Outcomes to Rubrics

To add outcomes to a rubric, create the Assignment or Advanced Forum as normal, selecting rubric as the desired grading method. Within the rubric creation page click inside the criterion text box to display the link to select the outcomes. Click Select outcomes, choose one of the outcomes as the criterion, and click Ok.

10.2.5. Outcomes Reports

To evaluate outcomes go to Settings>Course administration>Outcomes. The page display the outcome sets associated to the course and links to four types of reports: Completion Marking report, Activity and Performance report, Coverage report, and Unmapped Content Items and Quiz Questions report.

10.2.5.1. Completion Marking Report

The Completion Marking report displays all outcomes included in an Outcome set and lists the average percentage of completion tracking, average grade, and the scale items associated to each outcome per student. Use the Outcome set and the User menus to pick an outcome set and the student.

Teachers can mark a student complete for each outcome. Select the checkbox next to each outcome that the student has completed and save changes.

10.2.5.2. Activity and Performance Report

The Activity and Performance report displays all outcomes included in an Outcome set and lists the average percentage of completion tracking, average grade, the scale items, and it lists the associated content to each outcome mapped into the course. Use the Outcome set to pick an outcome and the Group menu to filter the information according to groups.

Click the Associated Content link to see the list of activities, resources and quiz questions associated to each outcome.

10.2.5.3. Coverage Report

The coverage report allows you  to quickly see which outcomes are covered with content, and how deep that coverage is for each outcome. It shows all outcome sets that have been mapped against a course, lists out all outcomes within a given outcome set, and shows the number of resources, quiz questions, or activities that are mapped against those particular outcomes.

Click the numbers listed in the Resources, Activities and Question Columns to see the associated content.

10.2.5.4.
10.2.5.5. Unmapped Content Items and Quiz Questions Report

This report shows all unmapped activities, resources, and questions. It gives you the ability to jump directly to a content item in your course and map it, if necessary.

Click the link Map next to each title to map an unmapped content. Update the settings by mapping the outcomes and save changes.

10.3. Permissions

  • Edit outcomes: Allows the user to create new outcomes.
    • Default Permissions
      Role Not Set Allow Prevent Prohibit
      Manager X
         
      Course Creator X

         
      Teacher X
         
      Non-Editing teacher X
         
      Student X
         
      Guest X

         
      Authenticated User X

         
  • Export outcomes: Allows the user to export outcome sets.
    • Default Permissions
      Role Not Set Allow Prevent Prohibit
      Manager X
         
      Course Creator X

         
      Teacher X
         
      Non-Editing teacher X
         
      Student X
         
      Guest X

         
      Authenticated User X

         
  • Export outcomes: Allows the user to import outcome sets.
    • Default Permissions
      Role Not Set Allow Prevent Prohibit
      Manager X
         
      Course Creator X

         
      Teacher X
         
      Non-Editing teacher X
         
      Student X
         
      Guest X

         
      Authenticated User X

         
  • Map outcome sets to courses: Allows the user to map outcome sets to course instances.
    • Default Permissions
      Role Not Set Allow Prevent Prohibit
      Manager   X    
      Course Creator
      X
         
      Teacher   X    
      Non-Editing teacher X
         
      Student X      
      Guest X      
      Authenticated User X      
  • Map outcomes to activities, questions, etc: Allows the user to map outcome sets to course content.
    • Default Permissions
      Role Not Set Allow Prevent Prohibit
      Manager   X    
      Course Creator X      
      Teacher   X    
      Non-Editing teacher X
         
      Student X      
      Guest X      
      Authenticated User X      

11. Personalized Learning Designer

11.1. Overview

The Personalized Learning Designer (PLD) offers instructors the ability to create and modify one or more "rules" within a course. Rules designate triggering events in the course, upon which Joule automatically performs specific actions.

Instructors can create numerous rules to work as an agent on their behalf. For example, a rule can watch for "at risk" grades, sending messages to key figures in the student's life. A rule could also encourage students for improvement by watching for the completion of activities. Numerous possibilities exist as instructors combine different events, conditions, and actions within the course into rules.

11.2. Usage Scenarios

  • After Abraham Student earns a 55% on a quiz, he receives an automated e-mail with a number of specific suggestions from his instructor.
  • Barry Student submits a quiz that is automatically graded. His grade is a “D” and he is automatically redirected to a lesson with additional content on the topic.
  • Professor Saturn has read a great deal about positive reinforcement. Over her fall break, she created a number of rules that sent out positive messages to her students when their actions and grades met her specific criteria.
  • Dean Strict has created an odious PDF file that describes what discipline measures will be inflicted upon those who plagiarize. Now whenever students submit their term papers, they are directed to a course resource that forces an automatic download of this file.
  • Jean Student is in a course that starts and stops during different times of the year. Each element of his course is designed to open based on the success of his previous one. When he performs badly, he is given more activities about the same topic, and when he succeeds, he moves to the next topic area.
  • Barry, Abraham and Jean are in the same Econ class, but when they log in to the course, they see different activities. This is because different content has been automatically been made available to them based on previous and ongoing assessments.

11.3. User Documentation

Students in a course do not ever see rules; however, they are recipients of actions performed by the rules.

Here is a list of actions that you may receive from the Personalized Learning Designer:

  • Alert: A message appears within the browser of the course, which requires your attention before the being able to proceed.
  • E-mail: An e-mail with a personalized message from the course is sent to your e-mail inbox.
  • Go to Activity: You are automatically redirected to another resource or activity within the course.
  • Go to URL: You are sent to a specific URL.
  • Release Codes: You can view (or lose rights to view) specific course content that is tagged with a specific release code.
  • Add/Remove User from Group: You may be added or removed from specific course groups based on your interaction in a course.

11.4. Teacher Documentation

The Personalized Learning Designer (PLD) is available via the Settings block.

Alternatively, in edit mode, teachers can navigate to the PLD by clicking the PLD icon.

Both actions lead to the Rules summary page.

11.4.1. The Rules Summary Page

All of the existing rules are listed on the Rules page. They can be filtered using the top drop-down menus. The first menu filters rules that belong to one or all of the activities. The second menu filters the type of event that is being examined (e.g. Activity Completion, Activity Grade, Activity View) by the rule.

The existing rules can be edited or deleted by clicking the icon that looks like a gear.

To create a new rule, click the Add Rule button.

11.4.2. Rule Examples

  • If a quiz is viewed, but the learner has not read a particular lesson, show an alert instructing them to read it before taking the quiz.
  • If a learner submits a quiz and the grade is less than 70%, release some remedial content and inform the learner they have access to it.
  • If a learner submits a quiz and the grade is greater than or equal to 90%, release the next lesson.
  • If a learner submits a quiz and the grade is less than 50%, send an e-mail to course educators notifying them that intervention may be required.
  • When a forum is viewed, show an alert with instructions that you don't want the learner to overlook.

11.4.3. Create/Edit a Rule

Specify events, conditions, and actions of a rule by visiting each associated tab.

11.4.3.1. Event Tab

Events determine when this rule will run. When users trigger any of the specified events, actions will fire if the conditions are fulfilled.

To add an event, select at least the event and activity type, then click the Add button.

The following event types are available. Note that not all event types are applicable to all activity and resource types.

  • Activity completed: Triggered when an activity is marked as complete, based on pre-configured completion criteria. Requires completion tracking to be enabled for the Joule site and in the course.
  • Activity graded: Triggered when an activity has a grade assigned. This can occur automatically (when a quiz is submitted), or manually (when a grade is entered by an educator). Keep in mind that the user triggering the event (e.g. the instructor) may be different than the recipient of the grade.
  • Activity viewed: Triggered when an activity or resource is viewed. For example, when a learner clicks on a quiz, the view event is triggered.
  • Quiz or assignment submitted: Triggered when a quiz or assignment has been submitted (e.g. when a user completes an assignment, when a user clicks submit on a quiz). It can be used to release new content, without waiting for manually graded items to be graded.
  • Forum reply: Triggered when a user replies to a forum topic or to another user's reply to a forum topic.
  • Forum topic post: Triggered when a user posts a new topic to a forum.
  • User added to group: Triggered when a user has been added to a group, whether manually, automatically by a different rule in the Personalized Learning Designer, or automatically via Conduit.
  • User removed from group: Triggered when a user has been removed from a group, whether manually, automatically by a different rule in the Personalized Learning Designer, or automatically via Conduit.
  • Course entered: Triggered when a user enters the course for the first time during the day. Leaving the course to visit other Joule courses and pages will reset the trigger.
  • Course grade change: Triggered when the course total changes in the grade book (typically because an activity receives a grade).
  • Specific date and time: Triggered at scheduled date and time. This date can be set in the future to check conditions at that point in time. This event does not have a triggering activity.
  • Recurring event: Triggered at scheduled dates and times. This event can be scheduled to occur daily or weekly at a specific time of day.
Note
The Course grade change event and the Activity events should be used respectively with the Course or Activity actions.
11.4.3.2. Condition Tab (optional)

Conditions determine if actions will fire when an event occurs. If no conditions are specified, actions will always fire when an event occurs.

Add a condition by selecting a condition type, then clicking the Add button. A dialog box will appear where additional configuration can be specified.

The following condition types are available:

  • Activity viewed: Checks if an activity or resource has been viewed by the user who triggered the rule.
  • Activity completed: Checks if an activity has been marked as complete for the user who triggered the rule. Requires completion tracking to be enabled for the site and in the course.
  • Activity grade range: Checks if the grade for an activity is within configured bounds. For activities that allow multiple submissions, the grade used is the overall grade for the activity, not necessarily the most recent submission.
  • User role check: Checks if the user who triggered the event is a member of a certain role. This may be useful to prevent some rules from triggering for educators.
  • Group membership check: Checks if a user is within a specific group.
  • Course grade change: Checks if a course grade is within a specific range.
  • Course login: Checks if the user has logged into the course or not within a specified number of days.
  • Date check: Checks if an event takes place before or after a designated date.
11.4.3.3. Action Tab

Actions are performed when an event occurs and specified conditions are fulfilled.

To add an action, select an action type, then click Add. A dialog box will appear where additional configurations can be specified.

The following action types are available:

  • Display alert: Specified text will be displayed to the triggering user in a standard browser JavaScript alert window. The user must acknowledge the alert before proceeding.
  • Send e-mail: An e-mail will be sent from the site server with the specified configuration parameters.
  • Go to activity: Sends the user directly to a specific activity or resource in the course.
  • Go to URL: Sends the user to another Web site (or even course or site page), specified by a URL.
  • Unlock release code: Makes all content that is protected by a specified release code available to the user who triggered this rule.
  • Lock release code: Makes all content that is protected by a specified release code unavailable to the user who triggered this rule.
  • Add user to group: Makes a user part of a specific course group.
  • Remove user from group: Removes a user from a specific course group.

11.5. Examples of Rules

11.5.1. Send an E-Mail when a Specific Activity is Completed

  1. Select "Activity Completion" as a triggering event.
  2. Select the type of activity that you are monitoring (e.g. Assignment).
  3. Choose the specific activity that you are monitoring (e.g. "Final Quiz").
  4. Select "Send Email" as an action event.
  5. Add the "Action Creator" as a recipient.
  6. Create an e-mail message with the "Action Creator" as a recipient. In the e-mail's body, include something like "Newsflash: ((student_firstname)) ((student_lastname)) just completed ((activity_name))."

11.5.2. Send an E-Mail Upon Activity Graded

  1. Select "Activity Graded" as a triggering event.
  2. Select an activity that you might grade (e.g. Assignment).
  3. Choose "Any of type" rather than a specific assignment.
  4. Select another activity that you might grade (e.g. Quiz).
  5. Choose "Any of type" rather than a specific quiz.
  6. Create an e-mail as an action event.
  7. Add the "Action Creator" and the "Learner" as recipients.
  8. Include something like this in the e-mail's body: "Hello ((student_firstname)). The activity: ((activity_name)) has been graded and your score is ((grade_percent_raw))."

11.5.3. Personalized Greeting Upon Viewing an Activity

  1. Select "Activity View" as a triggering event.
  2. Select "Page" as an activity type that will trigger the event.
  3. Select "Course Training Objectives" as a specific triggering event.
  4. Select "Display alert" as an action type.
  5. Create a message as an action event.
  6. Include something like this in your message: "Hello, ((student_firstname)). Thanks for viewing the ((activity_name)), as it will be a critical component of the Jan 15 exam."

11.5.4. Send an E-Mail that a Student has Been Added to a Group

  1. Select "User added to a group" as a triggering event.
  2. Choose the specific group (e.g. Lab Section C).
  3. Create an e-mail as an action event.
  4. Add the "Action Creator" as a recipient.
  5. Include something like this in your e-mail's body: "Hello, ((student_firstname)) ((student_lastname)) has now been added to Lab Section C."

11.5.5. Send an E-mail that a Student has Been Removed from a Group

  1. Select "User removed from group" as a triggering event.
  2. Choose the specific group (e.g. Lab Section H).
  3. Create an e-mail as an action event.
  4. Add the "Action Creator" as a recipient.
  5. Include something like this in your e-mail's body: "Hello, ((student_firstname)) ((student_lastname)) has been removed from Lab Section H."

11.5.6. Welcome the Student Back to the Course

  1. Select "Course entered" as a triggering event.
  2. Select "Display Alert" as an action event.
  3. Include something like this in your alert's body: "Welcome back to the course, ((student_firstname))!"

11.5.7. Send an E-Mail Upon Course Grade Change

  1. Select "Course Grade Change" as an action type.
  2. Select "Course Grade Range" as a condition type.
  3. Choose a grade range to trigger an action (e.g. Grade is greater or equal to 0%, Grade is less than 70%).
  4. Select "Send Email" as an action type.
  5. Add "Learner" and "Action Creator" as recipients of e-mail.
  6. Include something like this in your e-mail's body: "Hello. ((student_firstname)) ((student_lastname)) is currently at risk with a grade of ((course_grade_percent)) in the course."

11.5.8. Using "User Role Check" as a Condition

(Scenario: You want to prevent a rule from running for teachers.)

  1. Select "User role check" as a conditional event.
  2. Configure Triggering user "is" in role: "Student".

11.5.9. Using "Group Membership Check" as a Condition

(Scenario: You want to reserve a rule for a specific group of students.)

  1. Select "Group membership check" as a conditional event.
  2. Configure Triggering user "is" a member of group: "Good Times".

11.5.10. Using "Date Check" as a Condition

(Scenario: You want to release course content 7 days after a student's enrollment)

  1. Select "Date check" as a conditional event.
  2. Configure Current date is "after".
  3. Choose "Learner's enrollment date".
  4. Check the "Plus" checkbox and type "7" in the days field.
  5. Select "Unlock Release Code" as an action event.
  6. Type "Week 2 Content" in the Release code field (Don't forget to mark the course content with this same code).

11.6. Permissions

  • Edit Course Rules: The user can add and edit rules within the course.
    • Default Permissions
      Role Not Set Allow Prevent Prohibit
      Manager   X    
      Course Creator   X    
      Teacher   X    
      Non-Editing Teacher X      
      Student X      
      Guest X      
      Authenticated User X      

12. Streams and Alerts

12.1. Overview

Joule Streams and Alerts keep users up-to-date on course events and messages by enabling various types of notifications for important events. Teachers and students can customize the types of notifications they wish to receive and when they would like to receive them by updating their message settings. Notifications can be delivered when on and offline via the Activity stream, popup notification, email and alert badge.

12.2. User Documentation

12.2.1. Activity Stream

The Activity stream is a live stream of course activity and an easy way to keep track of important course activities. The My home/My Moodle page is the perfect place to add the Activity stream block. This will allow you to view the most recent activity from all of your courses in one place.

Add the Activity stream block to your site home page, if it has not been added already. To do this, follow these steps:

  1. Log in to your Moodle site.
  2. Go to the site homepage and click the Turn Editing On button.
  3. Add the Activity stream block via the Add block drop down. This will display the Activity stream block.

For more information on adding a block, click here.

Streams and Alerts will deliver event information based on the settings in message center preferences. Students can determine their message preferences for Streams and Alerts by clicking My profile settings > Messaging in their Settings block.

settings block image

The Messaging settings allow you to configure your notification methods for event messages. Check the options for Activity stream and Alert badge notification, when logged in, offline, or both for each notification type.

check boxes to enable messages

When selecting what messages to send to the Activity stream and what messages you would like to receive Alerts for, keep in mind that you may want to make important messages Alert notifications and less important messages Activity stream notifications. For example, you may want to know about things like Joule Gradebook messages and messages about a recent activity that has been graded without having to navigate to your Activity stream, if so, set them up as Alert notifications. If there are less important messages, set them up as Activity stream notifications, that way you check them when you have time to review your Activity stream.

Note
Don't forget to scroll down to the bottom of the page and click the Update profile button to update these settings.

Click Visit, or on any link in the Activity stream to navigate to that area in a course.

activity stream with posts alerting user of messages

To see older activities in a stream, just click on the More button in the block. The block will reveal more items for your viewing.

12.2.2. Alerts

Alerts are almost the same as streams. Alerts are triggered by various course events, but are most likely important enough that you want to know about them without having to navigate to the My home/My Moodle page to view the stream. When there is a new alert, the Alert badge will display a number indicating how many alerts are in your queue. The Alert badge is located at the top of the page and is automatically loaded when you use the Express theme. The Alert badge can be moved to a different location on your page by editing your Express theme.

alert badge exclamation point in red

Click on the alert badge to display a list of alerts.

alert menu with alerts listed

Click Remove, Read, or Visit to perform that action on each alert. You can also click on any link in the alert to navigate to that area in the course.

Note
Alerts are removed from the list once they have been read, visited, or removed.

13. xpLor

13.1. Overview

xpLor is an advanced learning object repository that allows users to author and store rich educational materials. xpLor houses shareable, reusable content to be accessible to courses within several Learning Management System (LMS) platforms. Instructors and other content providers can create or upload content that can then be shared with other users and institutions as determined by specific parameters and sharing filters. Content can be searched according to grade level, subject matter, standards and other criteria.

Watch the following video to see a quick preview of Blackboard xpLor

13.2. User Documentation

13.2.1. Accessing an xpLor Object

Students and teachers will be able to access xpLor objects in a course, just like a standard Moodle activity. This interaction will be seamless to every user, no second login to xpLor will be required. Students will simply click a link to see the xpLor resource.

Once inside the activity, students will have access to see and interact with the content hosted inside xpLor.

Note
By default,  xpLor resources will display in an iframe window that automatically embeds into the course. Please note the footer of your site will not appear once you view the xpLor resource. To return to the main page of the course, we recommend you to use the breadcrumb bar located at the top of the screen.

13.3. Teacher Documentation

13.3.1. Creating a xpLor Activity

Creating a xpLor activity is similar to creating other activities in Joule/ Moodle. The Teacher adds the activity via the Turn editing on button and selects Add Resource > Add from xpLor.

The Dashboard page in xpLor opens.

13.3.2. Teacher documentation

Teachers can use xpLor to discover, deliver, share, author, and copyright content. Visit the xpLor Teacher- Blackboard Help site to obtain more information on how teachers can use xpLor.

13.3.3. Configuring the xpLor Resource in Joule

Upon selecting the Add from xpLor activity type, you will be able to change the settings of  the xpLor activities added to the course. All xpLor resources will be loaded in Moodle as an External Tool activity. You may have to update the settings of the External Tool activity  in order to configure the features that are exclusive to Joule such as Grades, Restricted access, or Completion tracking.

To update the xpLor activity setting in Moodle, turn editing on and click the Update icon next to the activity on the front page of the course.

13.3.3.1. General

Most of these settings must stay at default in order to have xpLor working properly within your course. Consider updating only the following :

  • Activity Name: Change the name of the xpLor resource in your Moodle course.
  • Activity Description: Enter description for xpLor resource.
  • Display activity name when launched: If selected, the activity name (specified above) will display above the tool provider's content.
  • Display description on course page: Select the description written above to be displayed on course page. The description may be used to provide additional instructions for launchers of the tool, but it is not required. The description is never displayed when the tool's launch container is in a new window.
  • Launch Container: The launch container affects the display of the xpLor resource when launched from the course. Some launch containers provide more screen real estate to the tool, and others provide a more integrated feel with the Moodle environment. The following are launch container types:
    • Default: Use the launch container specified by the tool configuration..
    • Embed: xpLor is displayed within the existing Moodle window, in a manner similar to most other Activity types.
    • Embed, without blocks: xpLor is displayed within the existing Moodle window, with just the navigation controls at the top of the page.
    • New window: xpLor opens in a new window, occupying all the available space. Depending on the browser, it will open in a new tab or a popup window. It is possible that browsers will prevent the new window from opening. The new window is also not section 508 compliant.
13.3.3.2. Privacy

Consider updating the following Privacy settings :

  • Activity Name: Specify whether xpLor can add, update, read, and delete grades associated to this particular activity. You must check this box if you want the xpLor resource to display in your Moodle gradebook. This feature will only work if the grading delivery settings have been properly set within xpLor as well.
13.3.3.3. Grade

Enter the Grade settings:

  • Grade: Select the grade format for the activity (i.e. number grade, scale, no grade).
13.3.3.4. Common Module Settings

Enter the Common Module Settings:

  • Grouping (Advanced): A grouping is a collection of groups within a course. If a grouping is selected, students assigned to groups within the grouping will be able to work together.
  • Available for group members only: If this checkbox is ticked, the activity (or resource) will only be available to students assigned to groups within the selected grouping.
  • Visible: Determines if the activity is displayed to students or not within the course.
  • ID Number: Setting an ID number provides a way of identifying the activity for grade calculation purposes. If the activity is not included in any grade calculation then the ID number field may be left blank. The ID number can also be set in the gradebook, though it can only be edited on the activity settings page.
13.3.3.5. Restrict Access

Determine how access to this xpLor resource is handled using the following options:

  • Allow access from/until: These dates determine when students can access this course item on the course page.
  • Release code: This course item will not be available to students until the student acquires the release code entered here, in connection to a Personalized Learning Designer rule.
  • Grade condition: This setting determines any grade conditions which must be met in order to access this course item. Multiple grade conditions may be set if desired. If so, this course item will only allow access when ALL grade conditions are met.
  • User field: This setting restrict access based on any field included in the user profile of students.
  • Completion condition: This setting determines any activity completion conditions which must be met in order to access this course item. Note that completion tracking must first be set before an activity completion condition can be set. Multiple grade conditions may be set if desired. If so, this course item will only allow access when ALL grade conditions are met.
  • Before this can be accessed: If completion conditions are set, this setting determines whether or not users will be able to see the activity greyed-out with information describing why it is not available yet or if the activity will be hidden until the completion conditions are met.
13.3.3.6. Activity Completion

Enter the Activity Completion Settings:

  • Completion tracking: If enabled, activity completion is tracked, either manually or automatically, based on certain conditions. Multiple conditions may be set if desired. If so, the activity will only be considered complete when ALL conditions are met. A tick next to the activity name on the course page indicates when the activity is complete.
    • Do not indicate activity completion - Activity completion is disabled for this activity and will not report on the activity completion report.
    • Students can manually mark the activity as completed - The student self selects the check box to the right of the activity when the activity is completed.
    • Show activity as complete when conditions are met - Setting this enables the optional settings below and completion of the activity will be marked when the student meets all of the enabled conditions.
  • Require view: If enabled, the activity is considered complete when a student views the activity.
  • Require grade: If enabled, the student must receive a grade (any grade) to complete this activity. This is only displayed in the activity settings for activities that can be graded. If a passing grade is set in the grade book for the activity, then the activity will be marked as passed or failed.
  • Expect completed on: This setting specifies the date when the activity is expected to be completed. The date is not shown to students and is only displayed in the activity completion report.

13.4. Administrator Documentation

13.4.1. License Agreement

Moodlerooms will pre-configure the xpLore connection for all new and upgrade Joule sites. The administrator who is authorized to agree with the terms and conditions for using xpLor must confirm the agreement before connecting their site to xpLor.

To confirm the terms and conditions agreement, navigate to the Settings block and select Site administration > Cloud services > xpLor.

Read the Blackboard xpLor License Schedule and click the button I am legally authorized to bind my institution to these terms and conditions, and I accept.

13.4.2. xpLor Default Settings

xpLor will be connected to Joule via the Moodle external tools plugin. Site administrators have the option to modify the default settings of the external tools plugin that is connected to xpLor. To modify the default selections, navigate to your Settings block and select Site administration > Plugins > Activity modules > LTI.

A list with all external tool types active on the site will display.  In this screen, you will be able to remove or change the settings of the xpLor connection. On the Action column, click the Accept icon  to change the default settings of your xpLor activities.

On the Tool settings page, you can change the default settings for xpLor activities added into your courses. The setting Default Launch Container is the only option that you should change in this area. This option will allow you to select the default display mode on how xpLor content will display in your Moodle course.


 

13.4.3. Deleting xpLor connection

Site administrators can delete xpLor connection at any time. For security purpose,deleted LTI connections are automatically placed in the Rejected tab, in case they need to be restored in the future. To delete the xpLor connection, navigate to Site administration > Plugins > Activity modules > LTI  and click the delete icon to the right of xpLor.

Note
As a best practice, do not delete your xpLor connection without communicating with your teachers. Removing the xpLor connection will cause all existing external tool activities in a course connected to xpLor to break.


13.4.4. Restoring xpLor Connection

Deleted xpLor connection can be restored by the site administrators at any time. To reconnect your site to xpLor, go to Site administration > Plugins > Activity modules > LTI  and click the Rejected Tab.

A list of all reject LTI connections will display. Find the xpLor connection and click the Accept icon

 

13.4.5. Site Administrator Navigates to xpLor's

To access xpLor as an administrator, navigate to the Settings block and select Site administration > Cloud services > xpLor.

13.4.6. Documentation for Administrators

Visit the Administrator- Blackboard Help site to obtain more information on how to administer xpLor in your site.

Your Rating: Results: PatheticBadOKGoodOutstanding! 6 rates
Adaptavist Theme Builder Powered by Atlassian Confluence