Mallipohjatiedot tietojen tuomiseksi Apple School Manageriin
Voit lisätä tietoja Apple School Manageriin käyttämällä Applen tai OneRosterin formatoimia .csv-mallipohjatiedostoja.
Applen .csv-mallipohjien nimet: Opiskelijat, Henkilökunta, Kurssit, Luokat, Opiskelijaluettelot, Sijainnit
OneRoster .csv-mallipohjien nimet: Käyttäjät, Kurssit, Luokat, Rekisteröinnit, Organisaatiot
Applen tiedostonimi | OneRosterin tiedostonimi | Sisältö | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple: sisältää opiskelijoiden tilitiedot. OneRoster: Sisältää opiskelijoiden, opettajien ja henkilökunnan tilitiedot. | |||||||||||
- | Sisältää henkilökuntatilien, esimerkiksi ohjaajien, tiedot. | ||||||||||
Sisältää kurssitiedot. | |||||||||||
Sisältää luokkien ja opettajien (henkilökunnan) tiedot. | |||||||||||
Sisältää tietoja luokasta, oppilaasta ja sijainnista (opiskelijaluettelo). | |||||||||||
Sisältää sijaintitiedot (koulu tai osasto). | |||||||||||
Mallipohjat ja hallitut Apple-tilit
Jos vapaaehtoinen kenttä (esimerkiksi person_number tai sis_username) on osa hallitun Apple-tilisi 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 rivinvaihtoa tai lainausmerkkiä 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 aiemmasta lähetyksestä puuttuu merkintä, käyttäjätili deaktivoidaan ja poistetaan automaattisesti 120 päivän kuluttua, paitsi jos:
Käyttäjällä on rooli, joka on ostanut appeja tai kirjoja suurina erinä
Käyttäjä poistetaan manuaalisesti ennen 120 päivän takarajaa.
.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.
Attribuutin nimi | Mallipohjat | Merkkirajoitus |
|---|---|---|
Apple: first_name OneRoster: givenName | Apple: opiskelijat, henkilökunta OneRoster: käyttäjät | 32 |
Apple: middle_name OneRoster: middleName | Apple: opiskelijat, henkilökunta OneRoster: käyttäjät | 32 |
Apple: last_name OneRoster: familyName | Apple: opiskelijat, henkilökunta OneRoster: käyttäjät | 64 |
Apple: grade_level OneRoster: arvosanat | Apple: opiskelijat OneRoster: käyttäjät | 64 |
Apple: email_address OneRoster: sähköposti | Apple: opiskelijat OneRoster: käyttäjät | 256 |
Apple: person_number OneRoster: tunniste | Apple: opiskelijat, henkilökunta OneRoster: käyttäjät | 64 |
Apple: person_id OneRoster: sourcedId | Apple: opiskelijat, henkilökunta, luokat, opiskelijaluettelot OneRoster: käyttäjät, luokat, rekisteröinnit | 256 |
Apple: sis_username OneRoster: käyttäjänimi | Apple: opiskelijat, henkilökunta OneRoster: käyttäjät | 256 |
Apple: class_id OneRoster: sourcedID | Apple: luokat, opiskelijaluettelot OneRoster: luokat, rekisteröinnit | 256 |
Apple: class_number OneRoster: classCode | Apple: opiskelijat, luokat OneRoster: luokat | 64 |
Apple: course_id OneRoster: sourcedID | Apple: kurssit, luokat OneRoster: kurssit, luokat | 256 |
Apple: course_name OneRoster: nimike | Apple: kurssit OneRoster: kurssit | 128 |
Apple: course_number OneRoster: courseCode | Apple: kurssit OneRoster: kurssit | 64 |
Apple: location_name OneRoster: nimi | Apple: sijainnit OneRoster: organisaatiot | 256 |
Apple: location_id OneRoster: sourcedID | Apple: opiskelijat, henkilökunta, kurssit, luokat, sijainnit OneRoster: käyttäjät, kurssit, luokat, organisaatiot | 256 |