OneRoster Tab
The OneRoster Tab controls how Manage1to1 integrates with a OneRoster-compliant source to synchronize buildings, students, and staff.
When enabled, OneRoster becomes the authoritative source for specific data within Manage1to1. This allows districts to keep roster information aligned with their SIS while reducing manual maintenance.
What OneRoster Does
OneRoster enables secure and structured data exchange between Manage1to1 and an external system, typically a Student Information System or identity platform. In this setup, Manage1to1 consumes roster data rather than maintaining it independently.
This integration is commonly used to:
- Import and maintain buildings
- Synchronize students and staff
- Keep enrollment and associations up to date automatically
Important Behavior Changes
Once OneRoster is enabled, certain Manage1to1 features are intentionally restricted to prevent data conflicts.
Notable changes include:
- Buildings will be added/updated based on your OneRoster data
- Automatic CSV imports for students and staff are disabled and OneRoster is used
- Building and user data is expected to originate from the OneRoster provider
If OneRoster is enabled after Manage1to1 has already been configured, special care should be taken to ensure existing data aligns correctly.
Building Alignment Requirement
When enabling OneRoster on an existing system, the OneRoster School Building sourcedId value must match the Building SIS field used in Manage1to1.
This alignment ensures that imported students are associated with the correct buildings. Students belonging to buildings that do not exist or do not match will be ignored during synchronization.
Initial Synchronization Process
Building Synchronization
After connecting a OneRoster provider, a one-time building synchronization is required. This step establishes the building structure that all future user imports depend on.
Building synchronization must be completed successfully before student or staff synchronization will function as expected.
User Synchronization
Once buildings are synchronized, an initial user synchronization can be performed. Depending on district size, this process may take some time.
During this process:
- Students and staff are imported from the OneRoster source
- Associations are established based on building alignment
- Completion messaging indicates when the process has finished
Ongoing Automation
After the initial sync, Manage1to1 continues to synchronize data automatically based on the schedule configured in the Automation Settings Tab.
Automatic synchronization requires:
- OneRoster to remain enabled
- Automated imports to be enabled in Automation Settings
Manual synchronization may also be initiated from this screen when needed.
Switching Providers
It is not recommended to switch OneRoster providers after one has already been configured and used. Doing so can result in mismatched identifiers and unexpected data behavior.
If a provider change is required, contact support before making changes.
Supported OneRoster Providers
Manage1to1 supports multiple OneRoster providers. Provider-specific configuration steps and requirements may vary.