Skabelonoplysninger til import af data til Apple School Manager
Hvis du vil føje data til Apple School Manager, kan du bruge .csv-skabelonarkiver formateret af Apple eller af OneRoster.
Navne på Apple-.csv-skabeloner: Studerende, Personale, Kurser, Klasse, Deltagerlister, Lokaliteter
Navne på OneRoster-.csv-skabeloner: Brugere, Kurser, Klasser, Tilmeldinger, Organisationer
Apple-arkivnavn | OneRoster-arkivnavn | Indhold | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple: Indeholder oplysninger om konti til studerende. OneRoster: Indeholder oplysninger om konti til studerende, undervisere og personale. | |||||||||||
Ikke relevant | Indeholder oplysninger om personalekonti, f.eks. underviserkonti. | ||||||||||
Indeholder kursusoplysninger. | |||||||||||
Indeholder oplysninger om hold og undervisere (personale). | |||||||||||
Indeholder oplysninger om klasse, studerende og lokalitet (deltagerliste). | |||||||||||
Indeholder oplysninger om lokalitet (skole eller afdeling). | |||||||||||
Skabeloner og administrerede Apple-konti
Hvis et valgfrit felt – f.eks. person_number eller sis_username – er en del af formatet for din administrerede Apple-konto, bliver det et påkrævet felt. Hvis du lader feltet være tomt, lykkes SFTP-overførslen ikke, og du modtager fejlen MANAGED_ID_GENERATION_FAILED.
Forberedelse af skabeloner
Følgende kriterier skal være opfyldt, når du forbereder en skabelon:
Struktur
Navnene på .csv-arkiverne skal stemme fuldkommen overens med det oprindelige arkivnavn.
Du må ikke ændre navnet i overskriftsrækken i nogen arkiver.
Du må ikke slette en kolonne, heller ikke selvom kolonnen er tom.
Du kan tilføje kolonner i skabelonerne til studerende, personale og klasser.
I hver skabelon skal hver enkelt række repræsentere en unik værdi. I students.csv-arkivet skal hver række f.eks. være en unik studerende.
I forbindelse med skabelonerne for students.csv og staff.csv skal person_id være unikt for alle lokaliteterne.
Vigtigt: Hvis du bruger SFTP til at overføre en ny bruger, og det person_id, du tildeler, allerede er tildelt til en anden bruger, overskriver den nye bruger den eksisterende bruger i Apple School Manager. Når brugeren er overskrevet, kan du kun opdatere den pågældende bruger via SFTP.
Visse værdier kan udelades. I students.csv-arkivet kan mellemnavnet f.eks. udelades.
Erstat eksempeldataene med dine egne.
Formatering
Bogstavelige værdier – f.eks. et linjeskift eller et anførselstegn i et navn – skal kodes med en omvendt skråsteg (\). Her er et eksempel: \". Alle angivne id'er skal være alfanumeriske og inkludere en bindestreg (-).
Hvis din værdi indeholder et mellemrum ( ) eller et komma (,), skal du anvende lige anførselstegn (") omkring det. Hvis din værdi ikke har nogen af disse specialtegn, skal du ikke bruge anførselstegn. Hvis du ikke bruger anførselstegn, hvor de burde anvendes, eller hvis du bruger krøllede anførselstegn, vil du opleve fejl i overførselsprocessen.
Værdierne i dit arkiv skal adskilles med kommaer (,) eller semikoloner (;), uanset hvordan du oprettede arkivet. Brug ikke mellemrum eller tabulatorskift mellem et komma eller semikolon og den efterfølgende værdi. Alle filer skal kodes som UTF-8. Til at repræsentere linjeslut skal du bruge UNIX-koden for ny linje \n.
Alle referencer med fremmednøgler til andre .csv-arkiver skal defineres i det arkiv, der refereres til.
Upload
Hvis en post fra et tidligere upload mangler, deaktiveres brugerkontoen, og den slettes automatisk efter 120 dage, medmindre:
Brugeren har en rolle, der har købt apps eller bøger i større mængder
Brugeren slettes manuelt inden grænsen på 120 dage
Alle arkiver skal komprimeres i ét .zip-arkiv for at blive overført.
Ingen arkiver må placeres i en mappe i det komprimerede .zip-arkiv.
Tegnbegrænsninger i .csv-skabeloner
Visse felter i .csv-skabeloner har en begrænsning for tilladt antal tegn.
Attributnavn | Skabeloner | Tegnbegrænsning |
|---|---|---|
Apple: first_name OneRoster: givenName | Apple: Studerende, Personale OneRoster: Brugere | 32 |
Apple: middle_name OneRoster: middleName | Apple: Studerende, Personale OneRoster: Brugere | 32 |
Apple: last_name OneRoster: familyName | Apple: Studerende, Personale OneRoster: Brugere | 64 |
Apple: grade_level OneRoster: grades | Apple: Studerende OneRoster: Brugere | 64 |
Apple: email_address OneRoster: email | Apple: Studerende OneRoster: Brugere | 256 |
Apple: person_number OneRoster: identifier | Apple: Studerende, Personale OneRoster: Brugere | 64 |
Apple: person_id OneRoster: sourcedId | Apple: Studerende, Personale, Klasser, Deltagerlister OneRoster: Brugere, Klasser, Tilmeldinger | 256 |
Apple: sis_username OneRoster: username | Apple: Studerende, Personale OneRoster: Brugere | 256 |
Apple: class_id OneRoster: sourcedID | Apple: Klasser, Deltagerlister OneRoster: Klasser, Tilmeldinger | 256 |
Apple: class_number OneRoster: classCode | Apple: Studerende, Klasser OneRoster: Klasser | 64 |
Apple: course_id OneRoster: sourcedID | Apple: Kurser, Klasser OneRoster: Kurser, Klasser | 256 |
Apple: course_name OneRoster: title | Apple: Kurser OneRoster: Kurser | 128 |
Apple: course_number OneRoster: courseCode | Apple: Kurser OneRoster: Kurser | 64 |
Apple: location_name OneRoster: name | Apple: Lokaliteter OneRoster: Organisationer | 256 |
Apple: location_id OneRoster: sourcedID | Apple: Studerende, Personale, Kurser, Klasser, Lokaliteter OneRoster: Brugere, Kurser, Klasser, Organisationer | 256 |