Product: Roster Server
Audience: ClassLink Administrator
The purpose of having threshold alerts is to prevent an unintentional import of incorrect data and possibly passing along that incorrect data to all the vendors who automatically receive your rosters.
Thresholds are found in your Roster Server Console -> Settings -> General -> Thresholds.
Note: Thresholds should always be enabled once your OneRoster data is expected to remain consistent after the changes that would occur over the Back to School season.
Each time a new import of rosters comes into Roster Server, it is first compared to the existing roster data to see if the number of changes exceeds the defined thresholds for each data field.
If thresholds are not exceeded, the import proceeds automatically.
If thresholds are exceeded, the new data is not imported and an alert is sent to the email addresses that are set to receive threshold alerts in the Roster Server settings area.
Note: An administrator of Roster Server can review the data causing the threshold alert and, if it is acceptable, can Override Thresholds and allow the import to proceed.
Note: Thresholds can stop a bad import of entirely corrupt data.
If the threshold value is set to zero, it can prevent any changes from being made to the data. You are able to alter individual threshold values based on your district's data size.
Note: Typically, the standard threshold value is ~ 5% to ~10% of the total table data. For Example: if you have 10,000 users in your data set, then it is recommended to set the threshold between 1,500 and 2,500.
View Exceeded Thresholds :
1. Log into RosterServer.
2. Click the Import tab.
3. Under Import Details, click Thresholds Exceeded of the latest import.
Note: Thresholds will be hit if the combined total of rows deleted, added, and modified equals the threshold set for that CSV file. For Example, If classes.csv has a threshold of 200 and in the latest import 200 classes were removed and one was added, then the import would hit thresholds and not go through.
4. To see what the changes were, scroll down to the File Summary section.
5. Here you will be able to see in which sections the thresholds were exceeded.
Note: A list of changes between the past two imports will display on the page, organized by file.
6. If the changes look acceptable, then scroll to the top of the page.
7. Click Override Thresholds to allow the import to pass.
Updated: Aug 2020