How to: Enable Tegrity Gradebook Services for Moodle

This article is for Moodle 2.3 and higher. Moodle releases prior to that are not supported

You will need:

  • Admin access to Tegrity Campus
  • Moodle 2.3 or later
  • Admin access to Moodle server  and File System (compatible with version 2.3+)
  • Your Tegrity Customer Number
  • Your Tegrity Shared Secret
  • Ports 443 and 80 open for aairs-connectors.tegrity.com – 174.129.12.210 on the network where your LMS resides
  • **For Moodlerooms customers: Please contact Moodlerooms and ask them to install the MH-AAIRS moodleblock on your instance, you might be required to provide them your Customer Number and Shared Secret.
  • **Moodle server must be running PHP version 5.2.x or later
  • Moodle Block for Tegrity Campus (Available on the AAIRS Download page)
  • Tegrity Campus Gradebook Services account activation
  • A Moodle Web services Token that can access the Moodle APIs for Gradebook

The Tegrity Gradebook Services require that you have single sign-on access properly configured and working from your Moodle LMS to Tegrity Campus.   If  you do not have single sign-on  configured for your account, please see the link above.   The Tegrity Gradebook Services utilize the Moodle Web services.   This article includes the steps for enabling Moodle Web services and configuring AAIRS for the Tegrity Campus Gradebook Services.

The MH Campus Gradebook Services Configuration process is very similar to configuring AAIRS for single sign-on with authorization and authentication.

**Note: If you are using Moodle version 2.3 or above please skip to step 3.**

1. Install the Moodle Plugin

  1. Copy the extracted plugin to htdocs/local/aairsgradebook
  2. Login to moodle as an Administrator, you will be prompted to install the plugin
  3. Go to: Site Administration -> Plugins ->Local plugins -> Manage local plugin
  4. Ensure aairsgradebook appears in the list

 

2. Enable the REST web service interface

  1. Login to Moodle as an administrator
  2. Go to Site Administration -> Plugins -> Web Services -> Manage protocols
  3. Click the closed eye next in the REST protocol row
  4. The REST web service protocol is now enabled
  5. Go to Site administration -> Advanced features
  6. Check the Enable web services option
  7. Click Save Changes

3. Enable Web Services

4. Enable “Tegrity/MHAAIRS Gradebook Service” web service

  1. Visit the page Site administration / Plugins / Web services / External services and locate the web service “MHAAIRS Gradebook Service”. Click on the Edit link. On the next page make sure that “Enabled” check box is selected before saving options. Save the configuration.

 

5. Create a new token

  1. Login to Moodle as an administrator
  2. Go to Site Administration -> Plugins -> Web Services -> Manage tokens
  3. Click Add
  4. Select your administrative user from the list of users
  5. Select “AAIRS Gradebook Service”  as the Service
  6. Click Save Changes
  7. Your token is now listed in the list of available tokens
  8. If you wish to test the token, please follow the steps found Here how-to-test-a-moodle-token-for-mhcampus.html

6. Configure AAIRS to use Moodle Web services for MH Campus Gradebook Services

  • Login to your MH Campus account as the admin
  • Navigate to the AAIRS interface (click ‘Manage AAIRS’ from the admin dashboard)

7. Configure Gradebook Services for Moodle, If you are using the MoodleRooms Framework see step 8.1

Note:  If you do not see a configuration area for Gradebook Services in your AAIRS account, you must contact MH Campus Support (support@mhcampus.com) to get it enabled.

  • Edit the ‘Gradebook section’ and add a ‘Custom’ connector

  • Configure the “Moodle” Gradebook connector:

Service URL: http://mhaairs.tegrity.com/CustomIntegrationModules/MoodleGradebookIntegration.svc
Extended Properties:
ServerURL=Moodle server Url
wsToken=Moodle token
  1. Replace the ‘wsToken’ and ‘Moodle Server Url’ above with your actual values.

You may have to add the protocol of: “https” or “http” to the URL

  • Save the Gradebook settings then “Save & Continue”

 

7.1 MoodleRooms Gradebook Connector:

MRplugin

 

Service URL: http://mhaairs.tegrity.com/CustomIntegrationModules/MoodleGradebookIntegration.svc
Extended Properties:
ServerURL=Moodle server Url
wsToken=Moodle token
useMRPlugin=True
  1. Replace the ‘wsToken’ and ‘Moodle Server Url’ above with your actual values.
  2. Add the line useMRPlugin=True after wsToken as seen above.

You may have to add the protocol of: “https” or “http” to the URL

  • Save the Gradebook settings then “Save & Continue”

8. How to test your Moodle Token for Tegrity Campus (Optional)

How to Test a Moodle Token

 

Proceed here to enable the Gradebook option.

Popular Articles

Let Tegrity Know!

We welcome your feedback on how we can improve the Tegrity lecture capture service. Please provide any comments and suggestions to your account management team.