Configuring OneRoster Connections

 This tool is available as part of the Campus Learning premium offering.

PATH: System Administration > Learning Interoperability > click a specific vendor > OneRoster Connections

OneRoster connections allow outside programs to request roster and section data from Campus and, if enabled, send assignment and score data back through the OneRoster API. These connections are helpful for users who manage assignments and grading outside of Campus, but use Campus as the source of truth for report cards and transcripts, and use the Campus Student and Campus Parent Portals to communicate with students and parents.

OneRoster connections are available to the 1.1 version of the specification and the pre-certification version of 1.2.

Types of OneRoster Connections

The lozenges at the right of the screen indicate what functions are available for the partner and what functions have been enabled by the district.

Lozenges indicate available and enabled functions.

Vendors with Roster Sync enabled can request section and roster data from Campus.

Vendors with Grade Book Sync enabled can send assignment and score data to Campus. This type of connection includes roster sync by default.

 Expand for more information about receiving grades.

A grading services connection allows Campus to receive assignments, scores, and grades from a vendor partner, assuming the following conditions are met:

  • Grading Window must be open for the Task/Standard.
  • Traditional Grading/Grading Tasks
    • If only a Percent is provided, Campus matches the value to the correct score in the Score Group aligned to the Grading Task, based on the minimum percent values entered for the Score Group. Unique Minimum Values must be entered for Score Group items.
    • If only a Score is provided, the percent reports as null. Reported scores must exist in the aligned Score Group.
    • If both a Percent and Score are provided, the score is not determined using the minimum percent.
  • Standards-Based Grading/Standards
    • If only a numeric value is provided, Campus matches the value to a score based on Power Law values or rubric item sequence. The numeric value must either be within the Power Law range or match the sequence of a rubric item.
    • If only a Score is provided, the numeric value reports as null.
    • If both a numeric value and a Score are provided, the mapping between the two is not enforced.

Lozenges that are black without a checkmark indicate that a function that is available for the vendor but has not been enabled by the district.

1.1 Versus 1.2

OneRoster connections can be made through the 1.1 or 1.2 version of the OneRoster specification.

The 1.2 specification is currently available as a pre-certification version. These connections will be available on a vendor-by-vendor basis as partners implement this new version of the specification. Campus encourages districts to contact the vendors they use to inquire about 1.2 implementation timelines.

What's new with 1.2?

OneRoster 1.2 includes:

Enabling a OneRoster Connection to a Partner

To enable a connection, select the application from the Learning Interoperability tool or click Add Application to select from the list of Campus-supported partners.

1.1 Connection
  1. Expand the OneRoster 1.1 Connections section.
  2. Click Generate New OneRoster 1.1 Credentials. A set of credentials generate that are enabled by default.
  3. is enabled by default. Toggle to No to disable.
  4. Send required data to the vendor.

Additional Information: 1.1

  • 1.1 connections expire one year from when they are created. Click to set the date to a year from the current date.
  • The link to the REST Documentation Client is available, which documents the API and allows users to review endpoints and retrieved data for troubleshooting and verification purposes.
  • When teacher receive assignments through a 1.1 connection, they must select categories and grading alignments for those assignments so that grades can be reported. The Uncategorized Assignments and Non-Campus Assignment Defaults article provides instructions to teachers for completing this process.

Share the Consumer Key, Consumer Secret, and OneRoster (1.1) Base URL with the vendor to allow them to connect to your district's instance of Campus. See the OneRoster API for more information that may be useful to send.

  

1.2 Connection
  1. Expand the OneRoster 1.2 Connections section.
  2. Click Generate New OneRoster 1.2 Credentials. A set of credentials generate that are enabled by default.
  3. Demographics data is not shared by defaults. Toggle to Yes to share this data with the vendor. Consult district guidelines concerning data protection and FERPA before sharing this data.
  4. is enabled by default. Toggle to No to disable.
  5. The connection is scoped to All Schools by default. Click Edit to select specific schools.
  6. Generate additional sets of credentials as needed, including credentials scoped to individual schools.

Additional Information: 1.2

  • Links to the Rostering API Documentation and Gradebook API Documentation provide documentation for the API and allow users to review endpoints and retrieved data for troubleshooting and verification purposes.

Share the Client Key, Client SecretToken URL, and OneRoster (1.2) Base URL with the vendor to allow them to connect to your district's instance of Campus. See the OneRoster API for more information that may be useful to send.

Disable versus Delete

There are three ways to stop a connection:

Disable a connection to stop the flow of data to and from Campus until the connection is re-enabled.

Remove credentials to remove connections using that Key and Secret. To reconnect, generate new credentials and share them with the vendor.

Delete a connection to remove all connections to that vendor. To reconnect, click Add Application and start over.



Connecting to Non-Partner Vendors

Districts have the option of connecting to vendors who are not part of the Infinite Campus Digital Learning Partner Program. Be aware that Campus does not support these connections; Campus Support will not be able to help troubleshoot.

is not available for non-partner vendors. Additionally, lozenges do not display indicating what functions are available.

  1. Click Add Application, then scroll to the bottom and click Connect to Other Applications.
  2. Enter an Application Name. The image displayed in the vendor is the first letter of the entered name.
  3. Generate credentials and share them with the vendor to connect.

Use caution when sharing student data with vendors that may not meet Campus's data security standards.

Have a vendor you think Campus should partner with? Share this form with the vendor.

Considerations for Using Grade Book Sync

Feedback