This guide shows you how to set up School Passport with MichiganDataHub integration.
In this article
The Michigan Data Hub is a collaborative, statewide effort to address challenges in managing and using school data. The work of this initiative has centered around creating an ecosystem where information is exchanged between the large number of disconnected data systems used by schools in the state based on pre-defined standards.
To configure data sync with MichiganDataHub, perform the following steps:
Obtain API credentials
To configure the API sync you'll first generate API credentials in MichiganDataHub:
- Open the PDF file and follow the steps to set up API integration with MichiganDataHub.
- In the Manage API Integration, specify the required information for the School Passport:
- System Type: Integration Vendors
- Vendor: Global Grid for Learning
- System: Global Grid for Learning
- Select Permit Access to OneRoster API.
- In the All Available Scopes, select all scopes.
- In the Year, set the school year available to the OneRoster API.
Setup MichiganDataHub app on School Passport
Add MichiganDataHub app from the gallery:
- Sign in to your School Passport.
- Go to Connect > Application Gallery.
- Type "MichiganDataHub" in the search box.
- Select MichiganDataHub from results panel.
- Click Activate. Wait a few seconds while the app is added to your environment.
Configure MichiganDataHub app:
- On the Delivery Config, enter your API credentials:
- Service URL: https://apihub.midatahub.org/ims/oneroster/v1p1
- Client ID: Enter the Client ID copied from MichiganDataHub.
- Client Secret: Enter the Client Secret copied from MichiganDataHub.
- (Optional) Click Advanced Settings to configure additional delivery config options:
- SIS ID Prefix: Use this if you have multiple data sources of the same type, to avoid merging entities with the same SIS IDs.
- Bulk Upload Mode: Select to detect deleted records by comparing them with the previous upload.
- Data will be uploaded from multiple data sources: Select if uploading data from multiple sources (e.g., SIS and Active Directory). Leave clear if uses a single source (e.g., SIS only).
- Compare records by Domains of Uniqueness: Select to activate duplicate detection.
- Sync Hold Threshold: Set a threshold for significant changes. Updated data won’t be exported until you approve the changes.
- (Optional) Click Test Connection to verify the connection with MichiganDataHub.
- Accept the Terms of Use and/or Privacy Policy. Click Next.
- In the Schools Mapping, select the schools you want to sync with School Passport. Drag the slider for individual schools or click Auto Mapping to select all. Click Next.
- In the Attributes Mapping, set the attributes for data synchronization between Infinite Campus and School Passport. Click Next. Tip: You can finish the configuration of the Infinite Campus app in this step.
- (Optional) In the Data Requirements, choose how to handle missing data attributes: Report if Missing or Skip if Missing. Click Next.
- (Optional) In the Filter Rules, set up filtering for seven entity types: student, contact, teacher, course, class, calendar, and admin. Use templates or create custom filters for more accuracy. Click Next.
- (Optional) In the Domains of Uniqueness, define unique parameters that are required to be unique to avoid duplicates. The default unique attributes are First Name, Last Name, and Email, but you can add others. See Domains of Uniqueness. Click Next.
- (Optional) In the Master Fields, configure which attributes from different data sources will be primary to avoid data duplication. See Master Fields. Click Next.
- (Optional) In the Sync Schedule, set how often to sync (daily or weekly), specify the time, and choose an expiration date for the sync. Click Next.
- (Optional) In the Done, click Finish to complete the setup.
- Wait a few seconds for the app configuration to apply, after which you will be redirected to the MichiganDataHub application dashboard.
Sync data with MichiganDataHub
Once the MichiganDataHub integration is set up, you can run a sync with MichiganDataHub at any time.
We recommend running a sync if you have new or updated data in MichiganDataHub for School Passport. Please note, that if a teacher or student is removed from the sync, their enrollments will also be deleted.
To run a sync with MichiganDataHub, go to the MichiganDataHub app in School Passport and click Run Sync.
If you have any questions about the MichiganDataHub app configuration, please reach out to GG4L Customer Support.