Mallinformation för import av data till Apple School Manager
Du kan använda CSV-mallfiler som formaterats av Apple eller OneRoster för att lägga till data i Apple School Manager.
Apples CSV-mallnamn: Students, Staff, Courses, Classes, Rosters, Locations
OneRosters CSV-mallnamn: Users, Courses, Classes, Enrollments, Orgs
Apple-filnamn | OneRoster-filnamn | Innehåll | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple: Innehåller studerandes kontoinformation. OneRoster: Innehåller studerandes, lärares och personals kontoinformation. | |||||||||||
Ej tillämpligt | Innehåller personalkontouppgifter, till exempel om lärare. | ||||||||||
Innehåller kursinformation. | |||||||||||
Innehåller information om klasser och lärare (personal). | |||||||||||
Innehåller information om klasser, studerande och platser (klasslistor). | |||||||||||
Innehåller platsinformation (skola eller departement). | |||||||||||
Mallar och hanterade Apple-konton
Om ett valfritt fält, såsom person_number eller sis_username, är en del av formatet för ditt hanterade Apple-konto blir det ett obligatoriskt fält. Om du lämnar det tomt misslyckas SFTP-överföringen med felet MANAGED_ID_GENERATION_FAILED.
Förbereda mallar
När du förbereder en mall måste den uppfylla följande kriterier:
Struktur
Namnen på CSV-filerna måste exakt stämma överens med det ursprungliga filnamnet.
Ändra inte namnet i sidhuvudraden i någon fil.
Radera inte någon kolumn, inte ens om kolumnen är tom.
Du kan lägga till kolumner i mallarna för studerande, personal och klasser.
Varje rad måste representera ett unikt värde i varje mall. I filen students.csv måste till exempel varje rad vara en unik studerande.
I mallarna students.csv och staff.csv måste person_id vara unikt för varje plats.
Viktigt: Om du överför en ny användare med SFTP och det person_id som du tilldelar redan har tilldelats till en annan användare skrivs den befintliga användaren över med den nya användaren i Apple School Manager. När överskrivningen är klar kan du endast uppdatera den användaren via SFTP.
Vissa värden kan vara tomma. Till exempel kan mellannamnet vara tomt i filen students.csv.
Ersätt exempeluppgifterna med egna uppgifter.
Formatering
Litteralvärden – till exempel en radbrytning eller ett citattecken inom ett namn – måste taggas med ett omvänt snedstreck (\). Här är ett exempel: \". Alla identifierare måste vara alfanumeriska och kan innehålla ett bindestreck (-).
Om värdet innehåller ett mellanslag ( ) eller komma (,) ska du använda raka citattecken (") runt det. Om värdet inte innehåller några av de här specialtecknen ska du inte använda citattecken. Om du inte använder citattecken där de måste användas eller använder typografiska citattecken får du ett felmeddelande under överföringen.
Värdena i dina filer måste avgränsas med komman (,) eller semikolon (;), oavsett hur du skapat filen. Använd inte mellanslag eller tabbar mellan ett komma eller semikolon och nästa värde. Alla filer måste vara UTF-8-kodade. Markera slutet av raden med UNIX-koden för ny rad, \n.
Alla sekundärnyckelreferenser till andra CSV-filer måste vara definierade i den refererade filen.
Överföring
Om en post från en tidigare överföring saknas avaktiveras användarkontot. Det raderas automatiskt efter 120 dagar, med följande undantag:
Användaren har en roll som har gjort volyminköp av appar eller böcker
Användaren raderas manuellt före gränsen på 120 dagar
Alla filer måste vara komprimerade i ett ZIP-arkiv för att kunna överföras.
Ingen fil får vara placerad i en mapp i ZIP-arkivet.
Max antal tecken i CSV-mallar
Vissa fält i CSV-mallar har gränser för hur många tecken som tillåts.
Attributnamn | Mallar | Teckengräns |
|---|---|---|
Apple: first_name OneRoster: givenName | Apple: Students, Staff OneRoster: Users | 32 |
Apple: middle_name OneRoster: middleName | Apple: Students, Staff OneRoster: Users | 32 |
Apple: last_name OneRoster: familyName | Apple: Students, Staff OneRoster: Users | 64 |
Apple: grade_level OneRoster: grades | Apple: Students OneRoster: Users | 64 |
Apple: email_address OneRoster: email | Apple: Students OneRoster: Users | 256 |
Apple: person_number OneRoster: identifier | Apple: Students, Staff OneRoster: Users | 64 |
Apple: person_id OneRoster: sourcedId | Apple: Students, Staff, Classes, Rosters OneRoster: Users, Classes, Enrollments | 256 |
Apple: sis_username OneRoster: username | Apple: Students, Staff OneRoster: Users | 256 |
Apple: class_id OneRoster: sourcedID | Apple: Classes, Rosters OneRoster: Classes, Enrollments | 256 |
Apple: class_number OneRoster: classCode | Apple: Students, Classes OneRoster: Classes | 64 |
Apple: course_id OneRoster: sourcedID | Apple: Courses, Classes OneRoster: Courses, Classes | 256 |
Apple: course_name OneRoster: title | Apple: Courses OneRoster: Courses | 128 |
Apple: course_number OneRoster: courseCode | Apple: Courses OneRoster: Courses | 64 |
Apple: location_name OneRoster: name | Apple: Locations OneRoster: Orgs | 256 |
Apple: location_id OneRoster: sourcedID | Apple: Students, Staff, Courses, Classes, Locations OneRoster: Users, Courses, Classes, Orgs | 256 |