Description
There are several nuances to the different pieces of data that can be sync from Apple School Manager (ASM) which will be covered below.
General Synchronization
By default Jamf School is not configured to automatically sync with ASM. You can change this behavior by doing the following:
In Jamf School Navigate to Organization > Settings.
Find the section of options for Apple School Manager and select the Synchronize option.
Use the Automatic synchronization settings option to select what time you would like your instance to sync with ASM.
Click Save in the bottom-right corner.
NOTE: Jamf School will only synchronize Automatically once per day, it is best to configure your automatic synchronization time after the time in which your ASM syncs with your SIS to get the most complete set of date for Jamf School.
Usernames
The following flow is used to determine usernames for users synced from ASM to Jamf School:
Most SIS systems provide a username to ASM which is stored in ASM as the sis_username and when Jamf School syncs with ASM it looks for this value first to use for the username.
If the sis_username is not found when syncing Jamf School will look at the Managed Apple Account for the user and truncate it by removing the domain and use what remains for the username.
Example: When syncing Shawn Hunter Jamf School from ASM Shawn's user in ASM doesn't have an sis_username stored, his Managed Apple Account is shawn.hunter@jamfexample.appleid.com so his username in Jamf School will be shawn.hunter.
Multi-location Users
In ASM users can belong to multiple locations but in Jamf School users can only be associated with a single location.
A user's location is determined by their class membership as a teacher or a student and during the sync process while adding students to their classes Jamf School moves the user to location where the class is created.
If a user belongs to classes at multiple locations the location of the user in Jamf School will be determined by the last the last class that they were added to during the sync.
Example: You have a teacher that teaches at the middle school and high school. When they sync to Jamf school they are associated with only one of those locations but are still associated to all the classes. All the functionality (Apple Classroom/Jamf Teacher) will work for all the classes despite the locational differences for the user.
If a user belongs to classes at 2 locations but one of the locations is not set for synchronization from ASM the user will not be synced to Jamf School.
More Resources
If you are working on ASM synchronization also check out theses related articles that may help with your configuration: