Integration with LMS

We provide integration with most popular lms system like Canvas, Blackboard, Moodle, Open EdEx. You can synchronize students' assignments grades with any of these platforms. To enable LMS synchronization, add to config:

c.CourseDirectory.lms_type = 'canvas'  # string

Requirements

  • Students' e-mails on Nbgrader are identical with students' e-mails on lms system
  • Assignments names on Nbgrader are identical with assignments names on lms system
  • You must be an course instructor on lms system
  • You must have API access on lms system

Integration with Canvas

Getting api token

Go to your profile settings page and at the bottom click the button that says "New Access Token". You can use this access token to synchronize grades with Nbgrader

Usage

Go to nbgrader home '/tree' and open nbgrader_config.py. Type next strings: 

c.CourseDirectory.lms_type = 'canvas'
c.CourseDirectory.canvas_token = 'Your canvas api token'  # string
c.CourseDirectory.canvas_domain = 'Your canvas domain'  # string (e.g https://canvas.instructure.com)
c.CourseDirectory.canvas_course_id = 'Your canvas course id'  # string (the easiest way to get course_id is from url on course page)

Then save the file. In Nbgrader assignments manager click synchronize button with assignment name near your assignment.

Integration with BlackBoard

Getting api token

Register new app on https://developer.blackboard.com then, contact with your blackboard portal administrator to accept your app

Usage

Go to nbgrader home '/tree' and open nbgrader_config.py. Type the following strings:

c.CourseDirectory.lms_type = 'blackboard'
c.CourseDirectory.blackboard_app_key = 'Your BlackBoard app key'  # string
c.CourseDirectory.blackboard_app_secret = 'Your BlackBoard app secret'  # string
c.CourseDirectory.blackboard_learn_domain = 'Domain of BlackBoard your blackboard portal'  # for example 'http://my.blackboard.com'
c.CourseDirectory.blackboard_course_id = 'Your BlackBoard course id'  # string

Then save the file. In Nbgrader assignment manager click synchronize button with assignment name near your assignment.

Integration with Moodle

Getting api token

Contact with your Moodle portal administrator to get access token

Usage

Go to nbgrader home '/tree' and open nbgrader_config.py. Type the following strings:

c.CourseDirectory.lms_type = 'moodle'
c.CourseDirectory.moodle_app_key = 'Your access Moodle token'  # string
c.CourseDirectory.moodle_domain = 'Your Moodle domain'  # for example 'http://mymoodle.com'
c.CourseDirectory.moodle_course_id = 'Your Moodle course id'  # string

Then save the file. In Nbgrader assignment manager click synchronize button with assignment name near your assignment.

Integration with Open EdEx

Open EdEx requirements

Edx-score-api (https://github.com/ExtensionEngine/edx-score-api) should be installed on Edx lms (ask your edx admin about this)

Getting api token

To request access to the edX Course Catalog API, you need a dedicated edx.org account with a user name that matches your organization’s identity. For example, if you are at an organization named Example, Inc., you need to create an edX account with a user name like Example. This enables edX to match your Course Catalog API request with an organization that is authorized to use the Course Catalog API.

To request access to the edX Course Catalog API, follow these steps.

On the EdX API Access Request page, enter the information for your organization. All fields are required.

  • Company Name: The name of your company. Website: The URL for your company’s website.
  • Company Address: Your company’s mailing address. This can be a street address or a post office box. Application Description: A brief description of the main use for your application.
  • At the bottom of the form, select the Terms of Service check box.
  • Select Request API Access to submit your request.
  • After you submit the request form, edX will review your request, and then edX will send you an email message approving your request or providing more information.

When you receive your approval email message from edX, follow these steps.

On the page that opens, enter the following information.

Select Generate API client credentials.

The screen displays your application name, client ID, client secret, and any redirect URIs that you entered. Make sure that you record your client ID and client secret.

Usage

Go to nbgrader home '/tree' and open nbgrader_config.py. Type next strings:

c.CourseDirectory.lms_type = 'edx'
c.CourseDirectory.edx_auth_username = 'edx username'
c.CourseDirectory.edx_auth_password = 'edx password'
c.CourseDirectory.edx_users_ids = {'honor@example.com': 6}  # You may put dict of edx students ids into the settings
c.CourseDirectory.edx_app_key = 'Your app key'
c.CourseDirectory.edx_app_secret = 'Your app secret'
c.CourseDirectory.edx_courseid = 'your edx course id'  # for example 'course-v1:edX+DemoX+Demo_Course'
c.CourseDirectory.edx_domain = 'http://your-edx-platform.com'

Then save it file. In Nbgrader assignment manager click synchronize button with assignment name near your assignment.

Plagiarism detection

We provide a powerful tool for plagiarism detection- it's a MOSS.

How to use Moss report

  • Go to Formgrader -> Manage Assignments
  • Click on submission count (must be > 1)
  • On "Manage Submissions" page click "Get moss report" button and wait few seconds
  • Go to "View moss report" URL, that generated near "Get moss report" button.