Mallinformation för import av register till Apple School Manager
Apple tillhandahåller sex mallar som du kan använda för att lägga till data för din plats:
Studerande: innehåller studerandes kontouppgifter.
Personal: Innehåller personalkontouppgifter, till exempel om lärare.
Kurser: definierar kurser.
Klasser: Innehåller information om kurser och lärare (personal)
Deltagarlistor: innehåller information om klasser, studerande och platser.
Platser: innehåller information om platser.
Mallar och hanterade Apple-ID
Om ett valfritt fält, såsom person_number eller sis_username, är en del av formatet för ditt hanterade Apple-ID 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:
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.
Om du redigerar mallarna ersätter du exempeluppgifterna med egna uppgifter. Ändra inte innehållet i sidhuvudraden i varje fil. Skapa inte duplicerade kolumner i någon fil. Du kan lägga till kolumner i specifika mallar.
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. Vissa värden för den studerande kan vara tomma. 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.
Om en post från en tidigare uppladdning saknas kommer kontot att avaktiveras och raderas automatiskt efter 120 dagar, om inte kontot har köpt volyminnehåll.
Namnen på CSV-filerna ska exakt stämma överens med det ursprungliga filnamnet.
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.
Alla sekundärnyckelreferenser till andra CSV-filer måste vara definierade i den refererade filen.
Max antal tecken i CSV-mallar
Vissa fält i CSV-mallar har gränser för hur många tecken som tillåts.
Fält | Mallar | Teckengräns |
---|---|---|
first_name | Studerande, Personal | 32 |
middle_name | Studerande, Personal | 32 |
last_name | Studerande, Personal | 64 |
grade_level | Studerande | 64 |
email_address | Studerande | 256 |
person_number | Studerande, Personal | 64 |
person_id | Studerande, Personal, Klasser, Deltagarlistor | 256 |
sis_username | Studerande, Personal | 256 |
class_id | Klasser, Deltagarlistor | 256 |
class_number | Klasser | 64 |
course_id | Kurser, Klasser | 256 |
course_name | Kurser | 128 |
course_number | Kurser | 64 |
location_name | Platser | 256 |
location_id | Studerande, Personal, Kurser, Klasser, Platser | 256 |