Malinformasjon for import av oppføringer til Apple School Manager
Apple gir deg seks maler du kan bruke når du legger til data for avdelingen:
Elever/studenter: inneholder kontoinformasjon for elever/studenter.
Personale: inneholder personellkontoinformasjon, for eksempel for instruktører.
Kurs: definerer kurs.
Klasser: inneholder informasjon om kurs, instruktør (personale).
Klasselister: inneholder informasjon om klasser, elever/studenter og avdelinger.
Avdelinger: inneholder informasjon om avdelinger.
Maler og administrerte Apple‑ID‑er
Hvis et valgfritt felt – f.eks. person_number eller sis_username – er en del av formatet ditt for administrerte Apple‑ID-er, 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:
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.
Hvis du redigerer malene, må du erstatte eksempeldataene med din egen data. Du må ikke redigere innholdet i overskriftraden i filene. Du må heller ikke opprette dupliserte kolonner i filene. Du kan legge til kolonner i spesifikke maler.
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. Visse verdier for den aktuelle eleven/studenten kan være tomme. 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.
Hvis en oppføring fra en tidligere opplasting mangler, blir kontoen deaktivert og automatisk slettet etter 120 dager med mindre kontoen har kjøpt voluminnhold.
Navnene på .csv-filene må samsvare nøyaktig med det opprinnelige filnavnet.
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.
Alle referanser med fremmednøkler til andre .csv-filer må være definert i referansefilen.
Tegngrenser i .csv-maler
Enkelte felter i .csv-malene har grenser for antallet tegn som er tillatt.
Felt | Maler | Tegngrense |
---|---|---|
first_name | Elever/studenter, Personale | 32 |
middle_name | Elever/studenter, Personale | 32 |
last_name | Elever/studenter, Personale | 64 |
grade_level | Elever/studenter | 64 |
email_address | Elever/studenter | 256 |
person_number | Elever/studenter, Personale | 64 |
person_id | Elever/studenter, Personale, Klasser, Klasselister | 256 |
sis_username | Elever/studenter, Personale | 256 |
class_id | Klasser, Klasselister | 256 |
class_number | Klasser | 64 |
course_id | Kurs, Klasser | 256 |
course_name | Kurs | 128 |
course_number | Kurs | 64 |
location_name | Avdelinger | 256 |
location_id | Elever/studenter, Personale, Kurs, Klasser, Avdelinger | 256 |