Malinformasjon for import av data til Apple School Manager
For å legge til data i Apple School Manager kan du bruke .csv-malfiler formatert av Apple eller OneRoster.
Navn på .csv-maler fra Apple: Students (elever/studenter), Staff (personale), Courses (kurs), Classes (klasser), Rosters (klasselister), Locations (avdelinger)
Navn på .csv-maler fra OneRoster: Users (brukere), Courses (kurs), Classes (klasser), Enrollments (registreringer), Orgs (organisasjoner)
Apple-filnavn | OneRoster-filnavn | Innhold | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple: Inneholder kontoinformasjon for elever/studenter. OneRoster: Inneholder kontoinformasjon for elever/studenter, instruktør og personale. | |||||||||||
Ikke tilgjengelig | Personale: inneholder kontoinformasjon for personale, for eksempel for instruktører. | ||||||||||
Inneholder kursinformasjon. | |||||||||||
Inneholder informasjon om klasser og instruktører (personale). | |||||||||||
Inneholder informasjon om klasser, elever/studenter og avdelinger (klasseliste). | |||||||||||
Inneholder informasjon om avdeling (skole eller fakultet). | |||||||||||
Maler og administrerte Apple-kontoer
Hvis et valgfritt felt – f.eks. person_number eller sis_username – er en del av formatet ditt for administrerte Apple-kontoer, blir det et påkrevd felt. Hvis du lar det stå tomt, mislykkes SFTP-opplastingen og gir feilen MANAGED_ID_GENERATION_FAILED.
Klargjøre maler
Når du klargjør en mal, må du oppfylle følgende krav:
Struktur
Navnene på .csv-filene må samsvare nøyaktig med det opprinnelige filnavnet.
Du må ikke redigere navnet på overskriftraden i noen av filene.
Ikke slett noen kolonne, selv om kolonnen er tom.
Du kan legge til kolonner i malene for elever/studenter, ansatte og klasser.
Hver rad i hver mal må representere en unik verdi. For eksempel: hver rad i students.csv-filen må være en unik elev/student.
For malene students.csv og staff.csv må person_id være unik for alle avdelinger.
Viktig: Hvis du bruker SFTP til å laste opp en ny bruker, og hvis person_id-verdien du tilordner, allerede er tilordnet en annen bruker, medfører det at den nye brukeren overskriver den eksisterende brukeren i Apple School Manager. Når overskrivingen er fullført, kan du bare oppdatere den aktuelle brukeren via SFTP.
Enkelte verdier kan ikke være tomme. Innenfor student.csv-filen, for eksempel, kan mellomnavn være tomt.
Erstatt eksempeldataene med dine egne data.
Formatering
Eksakte verdier – for eksempel linjebrudd eller anførselstegn i et navn – merkes med omvendt skråstrek (\). Her er et eksempel: \". Identifikatorer som er oppgitt må være alfanumeriske og kan inkludere en bindestrek (-).
Hvis verdien inneholder et mellomrom ( ) eller komma (,), må du bruke rette anførselstegn (") på hver side av den. Ikke bruk anførselstegn hvis verdien ikke inneholder noen av disse spesialtegnene. Hvis du ikke bruker anførselstegn når de trengs, eller om du bruker feil type anførselstegn, oppstår det feil under opplastingen.
Verdiene i filene dine må skilles med komma (,) eller semikolon (;), uansett hvordan du opprettet filen. Ikke bruk mellomrom eller tabulatorer mellom komma eller semikolon og neste verdi. Alle filene må være UTF-8-kodet. Bruk UNIX newline-kodingen «\n» til å vise slutten på linjen.
Alle referanser med fremmednøkler til andre .csv-filer må være definert i referansefilen.
Laster opp
Hvis en oppføring fra en tidligere opplasting mangler, blir brukerkontoen deaktivert og slettes automatisk etter 120 dager, med mindre
brukeren har en rolle som har kjøpt apper eller bøker i større volum
brukeren slettes manuelt før grensen på 120 dager
Alle filer må være komprimert i ett zip-arkiv (.zip) for å lastes opp.
Du kan ikke legge noen av filene i en undermappe i zip-arkivet.
Tegngrenser i .csv-maler
Enkelte felter i .csv-malene har grenser for antallet tegn som er tillatt.
Attributtnavn | Maler | Tegngrense |
|---|---|---|
Apple: first_name OneRoster: givenName | Apple: Students (elever/studenter), Staff (personale) OneRoster: Users (brukere) | 32 |
Apple: middle_name OneRoster: middleName | Apple: Students (elever/studenter), Staff (personale) OneRoster: Users (brukere) | 32 |
Apple: last_name OneRoster: familyName | Apple: Students (elever/studenter), Staff (personale) OneRoster: Users (brukere) | 64 |
Apple: grade_level OneRoster: grades | Apple: Students (elever/studenter) OneRoster: Users (brukere) | 64 |
Apple: email_address OneRoster: email | Apple: Students (elever/studenter) OneRoster: Users (brukere) | 256 |
Apple: person_number OneRoster: identifier | Apple: Students (elever/studenter), Staff (personale) OneRoster: Users (brukere) | 64 |
Apple: person_id OneRoster: sourcedId | Apple: Students (elever/studenter), Staff (personale), Classes (klasser), Rosters (klasselister) OneRoster: Users (brukere), Classes (klasser), Enrollments (klasselister) | 256 |
Apple: sis_username OneRoster: username | Apple: Students (elever/studenter), Staff (personale) OneRoster: Users (brukere) | 256 |
Apple: class_id OneRoster: sourcedID | Apple: Classes (klasser), Rosters (klasselister) OneRoster: Classes (klasser), Enrollments (registreringer) | 256 |
Apple: class_number OneRoster: classCode | Apple: Students (elever/studenter)), Classes (klasser) OneRoster: Classes (klasser) | 64 |
Apple: course_id OneRoster: sourcedID | Apple: Courses (kurs), Classes (klasser) OneRoster: Courses (kurs), Classes (klasser) | 256 |
Apple: course_name OneRoster: title | Apple: Courses (kurs) OneRoster: Courses (kurs) | 128 |
Apple: course_number OneRoster: courseCode | Apple: Courses (kurs) OneRoster: Courses (kurs) | 64 |
Apple: location_name OneRoster: name | Apple: Locations (avdelinger) OneRoster: Orgs (organisasjoner) | 256 |
Apple: location_id OneRoster: sourcedID | Apple: Students (elever/studenter), Staff (personale), Courses (kurs), Classes (klasser), Locations (avdelinger) OneRoster: Users (brukere), Courses (kurs), Classes (klasser), Orgs (organisasjoner) | 256 |