How to upload data to the MGI using OneRoster API

Students must be integrated into the MGI before they can be added to a test plan. The quickest and most secure method to integrate students is to upload data from your district’s School Information System.

Please note that while most students will be integrated through this data upload, you might occasionally need to add a student on an individual basis.

Overview

The MGI supports several methods for data upload:

1. Clever Secure Sync – Automated data sync for districts using Clever as their SIS integration platform.
2. OneRoster API – Automated data sync from supported SIS platforms such as ClassLink, Infinite Campus, Skyward SMS 2.0, and Synergy.
3. OneRoster CSV – Manual upload via web interface or SFTP integration.

The OneRoster API method of upload is described below. For help with the other two data upload methods, please consult Clever Secure Sync and OneRoster CSV.

District Parameters Settings

You must define your District Parameters Settings before you roster your data through MGI.

These parameters align with the type of Testing Measures you will administer your tests with and the rostering data you provide.

Please review the following sections in the MGI Parameter Settings.

• MGI Student Application Testing Measures (recommended)
• Test Distribution by Class through Screening Class Identification
• All Records Processing

Using OneRoster API

This process is ideal for IT administrators seeking data syncing from their SIS.

Steps to Set Up OneRoster API Integration

1. Confirm SIS Compatibility
   • Ensure your district uses ClassLink, Infinite Campus, Skyward SMS 2.0, or Synergy.
   • Verify that OneRoster API is enabled in your SIS.
2. Request API Credentials
   • Contact your SIS provider or district IT team for API credentials (Client ID, Client Secret, Endpoint, and other possible parameters).
3. Log in to the MGI Application
   • Navigate to Data Integration > Rostering > REST API.
4. Enter API Credentials
   • Input your SIS API credentials and verify the connection by selecting Test Connection.
5. Test and Activate Sync
   • Run a test sync to check data integrity.
   • If there aren’t any issues with your upload, select the Approve option to complete the merge of your data into the MGI.
   • NOTE: To enable continuous updates from your SIS, you may configure an automatic sync schedule. For instructions, proceed to Automatic Data Sync.

Automatic Data Sync

Once your initial sync is approved, you can configure a schedule for automatic data updates directly within the OneRoster API integration screen.

Set up a sync schedule

• Navigate to Data Integration > Rostering > REST API within the MGI application.
• Select the days of the week you wish the sync to occur (Sunday through Friday).
• Choose a time window for the sync. Syncs must be scheduled between 8:00 PM and 5:00 AM UTC to avoid peak usage hours.
• Set an expiration date for the schedule—up to 60 days from the first sync.
• Click Update Schedule to save your settings.

Once submitted, you will receive a confirmation that the schedule has been successfully created.

Troubleshooting

If you receive an error message stating “The connection was not successful and the schedule has not been created,” please:

• Verify that your API credentials (Client ID, Client Secret, Endpoint) are accurate
• Run a Test Connection to confirm successful integration
• Retry the schedule setup after resolving any connection issues

Sync Frequency Guidelines

• Scheduled Basis: Syncs should occur daily/nightly or weekly during off-peak hours
• Testing Periods: Sync schedules automatically expire 60 days after initial setup
• Multiple Testing Terms: For districts with seasonal testing (e.g., fall and winter), a new sync schedule must be created for each term

This automated sync ensures student data remains current and aligned with your SIS, supporting accurate test planning and administration.