Skabelonoplysninger for at importere registre til Apple School Manager
Apple leverer seks skabeloner, som du kan bruge, når du føjer data til din lokalitet:
Studerende: Indeholder oplysninger om konti til studerende.
Personale: Indeholder oplysninger om personalekonti, f.eks. underviserkonti.
Kurser: Definerer kurser.
Klasser: Indeholder oplysninger om kursus og underviser (personale).
Deltagerlister: Indeholder oplysninger om klasse, studerende og lokalitet.
Lokaliteter: Indeholder oplysninger om lokalitet.
Skabeloner og administrerede Apple-id'er
Hvis et valgfrit felt – f.eks. person_number eller sis_username – er en del af formatet for dit administrerede Apple-id, 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:
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.
Hvis du redigerer skabelonerne, skal du erstatte eksempeldataene med dine egne. Du må ikke ændre indholdet i overskriftsrækken i arkiverne. Du må ikke oprette duplikerede kolonner i arkiverne. Du kan føje kolonner til bestemte skabeloner.
I hver skabelon skal hver enkelt række repræsentere en unik værdi. I .csv-arkivet for studerende skal hver række f.eks. være en unik studerende. Visse værdier for den studerende kan være tomme. 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.
Hvis en post fra en tidligere overførsel mangler, deaktiveres kontoen og slettes automatisk efter 120 dage, medmindre kontoen har købt volumenindhold.
Navnene på .csv-arkiverne skal stemme fuldkommen overens med det oprindelige arkivnavn.
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.
Alle referencer med fremmednøgler til andre .csv-arkiver skal defineres i det arkiv, der refereres til.
Tegnbegrænsninger i .csv-skabeloner
Visse felter i .csv-skabeloner har en begrænsning for tilladt antal tegn.
Felt | Skabeloner | Tegnbegrænsning |
|---|---|---|
first_name | Studerende, medarbejdere | 32 |
middle_name | Studerende, medarbejdere | 32 |
last_name | Studerende, medarbejdere | 64 |
grade_level | Elever/studerende | 64 |
email_address | Elever/studerende | 256 |
person_number | Studerende, medarbejdere | 64 |
person_id | Studerende, medarbejdere, klasser, deltagerlister | 256 |
sis_username | Studerende, medarbejdere | 256 |
class_id | Klasser, deltagerlister | 256 |
class_number | Klasser | 64 |
course_id | Kurser, klasser | 256 |
course_name | Kurser | 128 |
course_number | Kurser | 64 |
location_name | Steder | 256 |
location_id | Studerende, medarbejdere, kurser, klasser, lokaliteter | 256 |