Mallipohjatiedot tietueiden tuomiseksi Apple School Manageriin
Apple tarjoaa kuusi mallipohjaa käytettäväksi sijaintia koskevien tietojen lisäämiseen:
Opiskelijat: Sisältää opiskelijatilien tiedot.
Henkilökunta: Sisältää henkilökuntatilien, esimerkiksi ohjaajien, tiedot.
Kurssit: Määrittää kurssit.
Luokat: Sisältää kurssien ja ohjaajien (henkilökunnan) tiedot.
Opiskelijaluettelot: Sisältää luokkien, opiskelijoiden ja sijaintien tiedot.
Sijainnit: Sisältää sijaintien tiedot.
Mallipohjat ja rajoitetut Apple ID:t
Jos vapaaehtoinen kenttä (esimerkiksi person_number tai sis_username) on osa rajoitetun Apple ID:si muotoa, siitä tulee pakollinen kenttä. Jos jätät sen tyhjäksi, SFTP-lähetykset epäonnistuvat virheellä MANAGED_ID_GENERATION_FAILED.
Mallipohjien valmisteleminen
Mallipohjaa valmistellessa pitää noudattaa seuraavia sääntöjä:
Students.csv- ja staff.csv-mallipohjissa person_id-tunnuksen pitää olla yksilöllinen kaikissa sijainneissa.
Tärkeää: Jos lähetät uuden käyttäjän SFTP:llä ja liittämäsi person_id on jo liitetty toiselle käyttäjälle, uusi käyttäjä korvaa olemassa olevan käyttäjän Apple School Managerissa. Kun korvaus on tehty, voit päivittää tätä käyttäjää vain SFTP:llä.
Jos muokkaat mallipohjia, korvaa esimerkkitiedot omillasi. Älä muuta minkään tiedoston otsikkorivin sisältöä. Älä luo kaksinkertaisia sarakkeita mihinkään tiedostoon. Voit lisätä sarakkeita tiettyihin mallipohjiin.
Jokaisessa mallipohjassa kunkin rivin pitää edustaa yksilöllistä arvoa. Esimerkiksi tiedostossa students.csv jokaisen rivin pitää olla yksilöllinen opiskelija. Tietyt opiskelijan arvot voi jättää tyhjäksi. Kirjaimellisia arvoja, esimerkiksi lainausmerkkiä tai rivinvaihtoa nimen sisällä, pitää edeltää kenoviiva (\). Tässä esimerkki: \". Syötettyjen tunnisteiden pitää olla aakkosnumeerisia ja ne voivat sisältää yhdysmerkin (-).
Jos arvo sisältää sanavälin ( ) tai pilkun (,), käytä suoria lainausmerkkejä (") sen ympärillä. Jos arvossa ei ole mitään näistä erikoismerkeistä, älä käytä lainausmerkkejä. Jos et käytä lainausmerkkejä, kun niitä tarvitaan, tai käytät kaarevia lainausmerkkejä, lähetysvaiheessa tapahtuu virhe.
Tiedostojen arvot pitää erottaa pilkuilla (,) tai puolipisteillä (;) riippumatta siitä, miten tiedosto on luotu. Älä käytä välilyöntejä tai sarkaimia pilkun tai puolipisteen ja seuraavan arvon välillä. Kunkin tiedoston pitää olla UTF-8-koodattu. Ilmaise rivin loppu uuden rivin UNIX-koodilla \n.
Jos aiemman lähetyksen merkintä puuttuu, tilin aktivointi poistetaan ja tili poistetaan automaattisesti 120 päivän kuluessa, ellei tilillä ole ostettua volyymisisältöä.
.csv-tiedostojen nimien pitää vastata täysin alkuperäisiä tiedostonimiä.
Kaikki tiedostot pitää pakata yhteen .zip-tiedostoon lähetettäväksi.
Tiedostoja ei saa sijoittaa .zip-tiedoston sisäisiin kansioihin.
Kaikki viiteavaimien viittaukset muihin .csv-tiedostoihin pitää määrittää referenssitiedostossa.
Merkkirajoitukset .csv-mallipohjissa
Joihinkin .csv-mallipohjien kenttiin liittyy merkkirajoitus.
Kenttä | Mallipohjat | Merkkirajoitus |
---|---|---|
first_name | Opiskelijat, henkilökunta | 32 |
middle_name | Opiskelijat, henkilökunta | 32 |
last_name | Opiskelijat, henkilökunta | 64 |
grade_level | Opiskelijat | 64 |
email_address | Opiskelijat | 256 |
person_number | Opiskelijat, henkilökunta | 64 |
person_id | Opiskelijat, henkilökunta, luokat, opiskelijaluettelot | 256 |
sis_username | Opiskelijat, henkilökunta | 256 |
class_id | Luokat, opiskelijaluettelot | 256 |
class_number | Luokat | 64 |
course_id | Kurssit, luokat | 256 |
course_name | Kurssit | 128 |
course_number | Kurssit | 64 |
location_name | Sijainnit | 256 |
location_id | Opiskelijat, henkilökunta, kurssit, luokat, sijainnit | 256 |