1 LMOD Introduction

Learning Modules is a replacement for Stellar.  (History Next Generation LMS Evaluation)

...

4.3 Gradebook/Attendance API

Offers advanced grade management options, integrated student photos, recitation and section support. The latest release of this module integrates the newly designed Assignments component, which integrates on-demand assignment creation and submission capabilities within the Gradebook Module interface. 

Attendance Module: provides a centralized means for tracking and grading student attendance via a customizable calendar.

4.3.1 Example

4.3.2 Intended Use Cases

4.3.3 Pitfalls

• Membership group changes take approximately 15 minutes to propagate to gradebook.  Sometimes the first access to a gradebook in a long time will get "stale" permissions since unused gradebooks are not agressively synced to membership. This may mean that after a permission change the consuming application may need to retry a query before giving up.  The 15 minutes can be shortened if a sysadmin manually kicks off a membership sync for a group.
• Similarly, membership user changes take approximately 6 hours to propagate to gradebook.  This is largely unnoticeable since one can always query membership for up-to-date person metadata.  The only time this would be an issue in gradebook is if a user has a new system-wide privilege change.  In this case, a new sysadmin may need to wait 6 hours to be able to do sysadmin tasks in gradebook.  The 6 hours can be shortened if a sysadmin manually kicks off a membership sync for a user.

4.3.4 Full Documentation link

4.4 Calendar API

The Calendar module provides a user-friendly interface for managing and displaying custom-created and time-specific events, as well as events listed on the Institute's academic calendar.

The Calendar module exposes the Google Calendar API via our own API underneath the /service/google-apps-proxy/calendar endpoint.  We have our own Google Apps for Education domain corresponding to learning-modules.mit.edu, and we map LMOD accounts onto google user accounts via a name translation scheme.  For example, jcalz@mit.edu in LMOD becomes jcalz-at-mit-dot-edu@learning-modules.mit.edu in Google.  The detail of this are not really that important since the only service we are currently exposing is Calendar.  We also map LMOD group/role pairings onto groups in Google (this may change soon).  When we provision calendars for a group, we assign google groups so that staff roles have "writer" permissions on the calendar, and student/guest roles have "reader" permissions.  Additionally, the gradebook and materials modules add events to a group's calendar corresponding to relevant dates (assignment due / posting dates).  These events have extended properties on them (event.extendedProperties.shared.lmodSystemManaged=true) so that they can be handled programmatically by consumers

4.4.1 Example

https://mv-ezproxy-com.ezproxyberklee.flo.org/service/google-apps-proxy/calendar/v3/calendars/mitacademiccalendar@learning-modules.mit.edu/events?singleEvents=true&orderBy=startTime&maxResults=1000

4.4.2 Intended Use Cases

• Allow users to view and/or edit google calendars to which they have access
• See assignment due/posting/release dates on their calendars
• Allow access to the MIT Academic Calendar (publicly viewable in Google as mitacademiccalendar@learning-modules.mit.edu)
• See the calendar UI code we provide for example usages: https://mv-ezproxy-com.ezproxyberklee.flo.org/calendar

4.4.3 Pitfalls

• Supports application certificate authentication but not impersonation.  This means that the application certificate account itself needs to have access to the calendar in order to read or write.
• Supports unauthenticated access by mapping unauthenticated users to guest@learning-modules.mit.edu.  This is a workaround since the Google calendar API itself does not support unauthenticated access.  The guest account has access to all public calendars.  It is considered a misuse of the API to do any writes as the guest account.
• The dev and test tiers have separate google apps domains, and the data is not copied from production to dev or test. 
• Users cannot authenticate directly to their google apps account via the google ui, since the password is a strong random value and we do not have touchstone enabled.  We currently only support authentication via the above proxy endpoint.
• Right now when course access settings are changed in membership (World / MIT-Wide / Class-Only / Staff-Only and Archived status) the calendar needs to be reprovisioned manually to pick up permission changes.  Group membership changes (e.g., person is added to or removed from the group) are picked up automatically, with no appreciable delay.

4.4.4 Full Documentation link

https://developers.google.com/google-apps/calendar/v3/reference/

4.5 Materials API

Materials module offers course administrators a flexible method of populating, organizing and displaying course materials, as well as controlling access to copyrighted and/or time-sensitive content. 

• Integration with Calendar: Materials author can post materials events to calendar
• Integration with Membership: Gets course information, course membership information and person information from Membership APIs.
• Integration with Gradebook:  For homework, Materials stores assignments, solutions, submissions and submission comments. Materials delegates to GB for permission and authorization.

4.5.1 Example

1. List materials for a course: https://mv-ezproxy-com.ezproxyberklee.flo.org/service/materials/groups/47994/files
2. Get materials: https://mv-ezproxy-com.ezproxyberklee.flo.org/service/materials/groups/47994/files/476d4ca0-097b-4967-879e-d026d48adb29
3. Export site: https://mv-ezproxy-com.ezproxyberklee.flo.org/service/materials/groups/47994/materials/exports

4.5.2 Intended Use Cases

1. Upload course material
2. View materials based on various filters - visibility, copyrighted, archived, staff-only
3. Organize course materials
4. Export / import course materials

4.5.3 Pitfalls

4.5.4 Full Documentation link

The Gradebook API is organized around objects including Gradebook, Assignment, Student, Grade.

Gradebook:

Gradebook is the overarching object by which all other objects are contained.

Assignments:

There is a hierarchy of assignments within a gradebook.

SimpleAssignment:
The most fundamental is a simple assignment which maps to an actual class assignment. Simple assignments can be simple holders of grades, or they can be homework assignments, and have associated materials stored in the materials service, including student submissions.

GradingSchemes on simple assignments: assignments can be set to us numeric grading schemes, letter grading schemes, or in the case of homework assignment, arbitrary values or phrases.

AssignmentCategories & Root Assignment:
SimpleAssignments are grouped by AssignmentCategories. The root assignment in a gradebook is parent to all categories, and is where the student's overall grade is stored. The rules by which grades for categories and the overall grade are calculated are determined in part by AssignmentAggregation settings -- e.g. they can be weighted average, normalized average, or numeric totals.

Assignments as calendar events: when assignments are created or updated, there is background communication with the calendar api, so that this information shows up on user calendars.

Students:

Calls to get students get basic student information, and can also get overall grade information, and assignment grade information (one or all assignments, one or all students).

Groups:

Gradebook group information, including staff and students, is gotten from the membership service. Most calls can be limited by section, adding /section/{groupId} to url, e.g. /assignments/{gradebookId}/section/{groupId}

Grades:

Grades can be set manually on student-assignment pairs. They are by default derived as you move up the assignment hierarchy (ie, category grades, and overall grade), though these also have the option of being manually set.

The grading scheme associated with the assignment determines the types of values that should be submitted (e.g. numeric, letter).

At the assignment level, grades are associated with submissions on assignments. This means that a "make-up" grade can be a set as a second submission, and will be taken as the grade. Only one submission is marked as default -- the most recent, unless otherwise set.

ExcelExport/ExcelImport:

There are a several calls that allow the export of information to excel, and some of which allow the import from excel to update information in gradebook.

Timeline:

The timeline calls are used by the you@lmod UI, which is replacing the you@Stellar interface. This provides remidners and notifcations such as assignments being due or posted, restricted by date range provided

4.3.1 Examples

To test these calls, you must login via touchstone. Redirection to touchstone will not happen automatically. If using calls via resttest.html, use LOGIN link at top of page.

GRADEBOOK:
Get Gradebook
https://mv-ezproxy-com.ezproxyberklee.flo.org/service/gradebook/gradebook?uuid=STELLAR:/project/gb-training&autocreate=true&skipValidityChecks=false

Get/Set Gradebook options
https://mv-ezproxy-com.ezproxyberklee.flo.org/service/gradebook/gradebook/options/2586 (GET/PUT)

ASSIGNMENTS:
Get all assignments for a gradebook
https://mv-ezproxy-com.ezproxyberklee.flo.org/service/gradebook/assignments/2586?includeMaxPoints=true&includeAvgStats=true&includeGradingStats=true
Note: to get grade data, look in the get students calls; this only provides details about the assignments themselves

Get one assignment
https://mv-ezproxy-com.ezproxyberklee.flo.org/service/gradebook/assignment/4522?includeMaxPoints=true&includeAvgStats=true&includeGradingStats=true

Get categories for a gradebook
https://mv-ezproxy-com.ezproxyberklee.flo.org/service/gradebook/assignment/4522?includeMaxPoints=true&includeAvgStats=true&includeGradingStats=true

STUDENTS:
Get all students with overall grades as well as grades for all assignments. Special value of 1 is used to represent all assignments. To get information for just a single assignment, pass the assignment id where the 1 is. Leaving off assignment id altogether will get just the basic student information, and no assignment-specific grade info. includeGradeInfo determines whether or not to return the Overall Grade info for the student.
https://mv-ezproxy-com.ezproxyberklee.flo.org/service/gradebook/students/2586/1?includePhoto=true&includeGradeInfo=true&includeGradeHistory=true&includeDroppedStudents=true&includeGradingSchemeDetails=false&includeAssignmentMaxPointsAndWeight=false&includeCompositeAssignments=false&includeAllSubmissions=false&convertGradesToParentGradingScheme=false

4.3.2 Intended Use Cases

Course assigns grades to assignments.

Course assigns grades to assignments, and also provides homework assignment content, and means for students to make submissions.

PE manages attendance, and determines grades based on attendance thresholds they set.

4.3.3 Pitfalls

• Membership group changes take approximately 15 minutes to propagate to gradebook.  Sometimes the first access to a gradebook in a long time will get "stale" permissions since unused gradebooks are not agressively synced to membership. This may mean that after a permission change the consuming application may need to retry a query before giving up.  The 15 minutes can be shortened if a sysadmin manually kicks off a membership sync for a group.
• Similarly, membership user changes take approximately 6 hours to propagate to gradebook.  This is largely unnoticeable since one can always query membership for up-to-date person metadata.  The only time this would be an issue in gradebook is if a user has a new system-wide privilege change.  In this case, a new sysadmin may need to wait 6 hours to be able to do sysadmin tasks in gradebook.  The 6 hours can be shortened if a sysadmin manually kicks off a membership sync for a user.

4.3.4 Full Documentation link

https://mv-ezproxy-com.ezproxyberklee.flo.org/service/gradebook/doc.html

Test Page Link: https://mv-ezproxy-com.ezproxyberklee.flo.org/service/gradebook/resttest.html

4.4 Calendar API

The Calendar module provides a user-friendly interface for managing and displaying custom-created and time-specific events, as well as events listed on the Institute's academic calendar.

The Calendar module exposes the Google Calendar API via our own API underneath the /service/google-apps-proxy/calendar endpoint.  We have our own Google Apps for Education domain corresponding to learning-modules.mit.edu, and we map LMOD accounts onto google user accounts via a name translation scheme.  For example, jcalz@mit.edu in LMOD becomes jcalz-at-mit-dot-edu@learning-modules.mit.edu in Google.  The detail of this are not really that important since the only service we are currently exposing is Calendar.  We also map LMOD group/role pairings onto groups in Google (this may change soon).  When we provision calendars for a group, we assign google groups so that staff roles have "writer" permissions on the calendar, and student/guest roles have "reader" permissions.  Additionally, the gradebook and materials modules add events to a group's calendar corresponding to relevant dates (assignment due / posting dates).  These events have extended properties on them (event.extendedProperties.shared.lmodSystemManaged=true) so that they can be handled programmatically by consumers

4.4.1 Example

https://mv-ezproxy-com.ezproxyberklee.flo.org/service/google-apps-proxy/calendar/v3/calendars/mitacademiccalendar@learning-modules.mit.edu/events?singleEvents=true&orderBy=startTime&maxResults=1000

4.4.2 Intended Use Cases

• Allow users to view and/or edit google calendars to which they have access
• See assignment due/posting/release dates on their calendars
• Allow access to the MIT Academic Calendar (publicly viewable in Google as mitacademiccalendar@learning-modules.mit.edu)
• See the calendar UI code we provide for example usages: https://mv-ezproxy-com.ezproxyberklee.flo.org/calendar

4.4.3 Pitfalls

• Supports application certificate authentication but not impersonation.  This means that the application certificate account itself needs to have access to the calendar in order to read or write.
• Supports unauthenticated access by mapping unauthenticated users to guest@learning-modules.mit.edu.  This is a workaround since the Google calendar API itself does not support unauthenticated access.  The guest account has access to all public calendars.  It is considered a misuse of the API to do any writes as the guest account.
• The dev and test tiers have separate google apps domains, and the data is not copied from production to dev or test. 
• Users cannot authenticate directly to their google apps account via the google ui, since the password is a strong random value and we do not have touchstone enabled.  We currently only support authentication via the above proxy endpoint.
• Right now when course access settings are changed in membership (World / MIT-Wide / Class-Only / Staff-Only and Archived status) the calendar needs to be reprovisioned manually to pick up permission changes.  Group membership changes (e.g., person is added to or removed from the group) are picked up automatically, with no appreciable delay.

4.4.4 Full Documentation link

https://developers.google.com/google-apps/calendar/v3/reference/

4.5 Materials API

Materials module offers course administrators a flexible method of populating, organizing and displaying course materials, as well as controlling access to copyrighted and/or time-sensitive content.

• Supports access based on class membership, staff-only, MIT-wide and world.
• Support for bulk delete and updates.
• Support for html5 pseudo streaming
• Integration with Calendar: Materials author can post materials events to calendar
• Integration with Membership: Gets course information, course membership information and person information from Membership APIs.
• Integration with Gradebook:  For homework, Materials stores assignments, solutions, submissions and submission comments. Materials delegates to GB for permission and authorization. Materials also provides homework timeline view for dashboard module.

4.5.1 Example

1. List materials for a course: https://mv-ezproxy-com.ezproxyberklee.flo.org/service/materials/groups/47994/files
2. Get materials: https://mv-ezproxy-com.ezproxyberklee.flo.org/service/materials/groups/47994/files/476d4ca0-097b-4967-879e-d026d48adb29
3. Export site: https://mv-ezproxy-com.ezproxyberklee.flo.org/service/materials/groups/47994/materials/exports

4.5.2 Intended Use Cases

1. Upload course material
2. View materials based on various filters - visibility, copyrighted, archived, staff-only
3. Organize course materials
4. Export / import course materials

4.5.3 Pitfalls

1. Supports application certificate authentication but not impersonation. 
2. Requires membership API and gradebook API to be available. Does not cache information from these API.
3. Not yet SCORM compatible
4. No support "yet" for transcode of audio and video files from one format to another.

4.5.4 Full Documentation link

https://learning-modules-dev.mit.edu/service/materials/doc.html 

4.6 Forum/Announcement API

...