Skip to main content

OneRoster Tab

The OneRoster tab controls how Manage1to1 integrates with a OneRoster-compliant source to synchronize buildings, students, and staff automatically.

When enabled, OneRoster becomes the authoritative source for specific data within Manage1to1, allowing districts to keep roster information aligned with their SIS while reducing manual maintenance.

Permission Required

To access the OneRoster tab, you need the Manage Settings permission assigned to your role.

Important Behavior Changes

Enabling OneRoster changes how Manage1to1 handles roster data. CSV imports for students and staff will be disabled and data will come from your OneRoster provider instead.

Understanding OneRoster Integration​

Think of OneRoster as automated data sync between your SIS and Manage1to1 - instead of manually importing CSV files, Manage1to1 connects directly to your SIS platform and pulls roster updates automatically.

What OneRoster does:

  • Imports and maintains buildings automatically
  • Synchronizes students and staff daily
  • Keeps enrollment and associations up to date
  • Eliminates manual CSV imports

Why OneRoster matters:

  • Accuracy - Roster data always matches SIS
  • Efficiency - No manual CSV exports or imports
  • Real-time - Changes in SIS appear in Manage1to1 within 24 hours
  • Reliability - Standardized integration reduces import errors

What OneRoster is: OneRoster is an industry-standard specification for securely exchanging roster data between systems. Student Information Systems like Infinite Campus and identity platforms like ClassLink support OneRoster, allowing Manage1to1 to consume data using a consistent, secure API.

Important Behavior Changes​

Once OneRoster is enabled, certain Manage1to1 features are intentionally restricted to prevent data conflicts.

What changes after enabling OneRoster:

  • Buildings - Added/updated based on OneRoster data, not manual entry
  • Students - Imported from OneRoster provider, CSV imports disabled
  • Staff - Imported from OneRoster provider, CSV imports disabled
  • Automation - OneRoster sync runs at configured daily automation time

Data flow:

SIS → OneRoster Provider → Manage1to1

Before enabling: Carefully review existing data to ensure alignment. If Manage1to1 is already in use, existing buildings must match the building identifiers your OneRoster provider will send.

Building Alignment Requirement​

When enabling OneRoster on an existing system, the OneRoster School Building sourcedId value must match the Building SIS field in Manage1to1.

Why this matters:

  • Students are associated with buildings based on the building identifier
  • If building identifiers don't match, students will be ignored during sync
  • Misalignment causes import failures and data gaps

How to ensure alignment:

  1. Review building identifiers in your SIS
  2. Confirm building SIS IDs in Manage1to1 match SIS identifiers
  3. Update Manage1to1 buildings if needed before enabling OneRoster
  4. Run building synchronization to confirm alignment

Example:

  • SIS building code: HS-001
  • Manage1to1 Building SIS field: HS-001 ✅ (matches)
  • OneRoster sends students with building HS-001
  • Students correctly associated with building

Mismatch example:

  • SIS building code: 001
  • Manage1to1 Building SIS field: HS-001 ❌ (doesn't match)
  • OneRoster sends students with building 001
  • Students ignored because building 001 doesn't exist in Manage1to1

Initial Synchronization Process​

Step 1: Configure OneRoster Provider​

Before synchronization can begin, configure your OneRoster provider (ClassLink, Infinite Campus, etc.) in the OneRoster tab.

Configuration requirements:

  • Provider selection (ClassLink, Infinite Campus, etc.)
  • Provider-specific credentials (Client ID, Secret, URLs)
  • Test connection to verify configuration

Provider-specific setup:

Step 2: 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.

What building sync does:

  • Imports all buildings from OneRoster provider
  • Creates new buildings that don't exist in Manage1to1
  • Updates existing buildings with matching SIS IDs
  • Establishes foundation for user synchronization

How to run building sync:

  1. Navigate to Settings > System Automation > OneRoster tab
  2. Click Sync Buildings (or similar)
  3. Wait for synchronization to complete
  4. Review results to confirm all buildings imported correctly

Important: Building synchronization must be completed successfully before student or staff synchronization will function as expected.

Troubleshooting: If buildings don't import, verify OneRoster provider configuration and check that provider has access to building data.

Step 3: User Synchronization​

Once buildings are synchronized, an initial user synchronization can be performed. Depending on district size, this process may take some time.

What user sync does:

  • Imports students from OneRoster provider
  • Imports staff from OneRoster provider
  • Associates users with buildings based on building alignment
  • Creates new accounts and updates existing accounts

How to run user sync:

  1. Ensure building sync completed successfully
  2. Click Sync Users (or similar) in OneRoster tab
  3. Wait for synchronization to complete (may take 5-30 minutes for large districts)
  4. Review completion message to confirm success

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

Progress indicators: Most OneRoster sync operations display progress or completion status. Large districts should expect longer sync times.

Ongoing Automation​

After the initial sync, Manage1to1 continues to synchronize data automatically based on the schedule configured in the Automation Settings tab.

How ongoing automation works:

  1. OneRoster sync runs at configured daily automation time (e.g., 2:00 AM)
  2. Manage1to1 pulls latest roster data from OneRoster provider
  3. New users are created, existing users are updated
  4. Users missing from OneRoster are marked inactive (if configured)

Requirements for ongoing automation:

  • OneRoster must remain enabled in OneRoster tab
  • Automated imports must be enabled in Automation Settings tab
  • OneRoster provider must remain accessible (credentials valid, API functioning)

Manual synchronization: You can also initiate synchronization manually from the OneRoster tab when needed:

  • Use case: SIS data changed and you want immediate sync instead of waiting for nightly automation
  • How: Click Sync Now (or similar) in OneRoster tab

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.

Why switching is problematic:

  • Different providers may use different building identifiers
  • User identifiers may not match between providers
  • Existing associations may break
  • Data alignment work required to prevent duplicates

If a provider change is required:

  1. Contact Manage1to1 Support before making changes
  2. Support will assess data alignment needs
  3. Plan transition to minimize disruption
  4. Test new provider in isolated environment if possible

Example problem: Switch from ClassLink to Infinite Campus. ClassLink used building ID BLDG-001, Infinite Campus uses 001. All students associated with BLDG-001 become orphaned unless buildings are realigned.

Supported OneRoster Providers​

Manage1to1 supports multiple OneRoster providers. Provider-specific configuration steps and requirements may vary.

Available providers:

  • ClassLink - Third-party identity and roster platform
  • Infinite Campus - Student Information System with native OneRoster support

Choosing a provider: If your district uses one of these systems, select it as your OneRoster provider. Follow the provider-specific documentation for detailed setup instructions.

Best Practices​

✅ Do:

  • Verify building alignment before enabling OneRoster
  • Run initial building sync before user sync
  • Test with small building or subset of users if possible
  • Monitor sync logs after enabling automation
  • Document which OneRoster provider you're using

❌ Don't:

  • Enable OneRoster without verifying building SIS IDs match
  • Skip building synchronization and go straight to user sync
  • Switch providers without contacting Support first
  • Disable automation without understanding impact (roster will stop updating)
  • Assume sync failures will resolve on their own (investigate immediately)

Common Questions​

Q: Can I use OneRoster and CSV imports at the same time? No. Once OneRoster is enabled, CSV imports for students and staff are disabled. OneRoster becomes the exclusive source for roster data.

Q: What happens if OneRoster sync fails? Sync failures are logged and previous data remains unchanged. Sync will retry at next scheduled automation time. Review logs to diagnose issue (credentials expired, provider API down, etc.).

Q: Can I manually add students if OneRoster is enabled? You can still do this when OneRoster is active, however it is not recommended since OneRoster is the authoritative source. If you must create users manually, you would need to disable the option in Automation Settings labeled Automatically Mark Missing Students as Inactive.

Q: How long does initial user sync take? Depends on district size. Small districts (1500 students): 2-5 minutes. Large districts (10000+ students): 15-30 minutes. Progress indicators display during sync.

Q: What if a student is in Manage1to1 but not in OneRoster? If "Automatically Mark Missing Students as Inactive" is enabled in Automation Settings, the student will be marked inactive. Otherwise, student remains active but won't receive updates.

Q: Can I preview what will be imported before running sync? No built-in preview. However, you can run building sync first to verify buildings import correctly before running user sync.

Q: Does OneRoster import guardians? Typically no. OneRoster focuses on buildings, students, and staff. Guardian data is usually imported via CSV separately.

Q: Can I disable OneRoster after enabling it? Yes, but switching back to CSV imports requires planning. Contact Support before disabling OneRoster to ensure smooth transition.

The OneRoster tab provides powerful SIS integration for districts that want automated roster synchronization. Proper configuration and building alignment ensure reliable, accurate data flow between your SIS and Manage1to1.

Last updated on