Πληροφορίες προτύπων για την εισαγωγή δεδομένων στο Apple School Manager
Για να προσθέσετε δεδομένα στο Apple School Manager, μπορείτε να χρησιμοποιήσετε αρχεία προτύπων .csv μορφοποιημένα από την Apple ή από το OneRoster.
Ονόματα προτύπων .csv Apple: Μαθητές, Προσωπικό, Μαθήματα, Τάξεις, Κατάλογοι, Τοποθεσίες
Ονόματα προτύπων .csv OneRoster: Χρήστες, Μαθήματα, Τάξεις, Εγγραφές, Οργανισμοί
Όνομα αρχείου Apple | Όνομα αρχείου OneRoster | Περιεχόμενα | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple: Περιέχει πληροφορίες για λογαριασμούς μαθητών. OneRoster: Περιέχει πληροφορίες για λογαριασμούς μαθητών, εκπαιδευτών και προσωπικού. | |||||||||||
Μ/Δ | Περιέχει πληροφορίες για λογαριασμούς προσωπικού, όπως εκπαιδευτές. | ||||||||||
Περιέχει πληροφορίες μαθημάτων. | |||||||||||
Περιέχει πληροφορίες για τάξεις και εκπαιδευτές (προσωπικό). | |||||||||||
Περιέχει πληροφορίες για τάξεις, μαθητές και τοποθεσίες (κατάλογος). | |||||||||||
Περιέχει πληροφορίες τοποθεσιών (σχολείο ή τμήμα). | |||||||||||
Πρότυπα και Διαχειριζόμενα Apple ID
Αν ένα προαιρετικό πεδίο, όπως το person_number ή το sis_username, είναι μέρος της μορφής του Διαχειριζόμενου Apple ID σας, γίνεται υποχρεωτικό πεδίο. Εάν το αφήσετε κενό, η μεταφόρτωση SFTP αποτυγχάνει, λόγω σφάλματος MANAGED_ID_GENERATION_FAILED.
Προετοιμασία προτύπων
Όταν προετοιμάζετε ένα πρότυπο, πρέπει να ικανοποιούνται τα ακόλουθα κριτήρια:
Για τα πρότυπα students.csv και staff.csv, το person_id πρέπει να είναι μοναδικό για όλες τις τοποθεσίες.
Σημαντικό: Αν χρησιμοποιείτε SFTP για το ανέβασμα ενός νέου χρήστη και το person_id που εκχωρείτε είναι ήδη εκχωρημένο σε άλλον χρήστη, ο νέος χρήστης αντικαθιστά τον υπάρχοντα χρήστη στο Apple School Manager. Όταν ολοκληρωθεί η αντικατάσταση, μπορείτε να ενημερώσετε αυτόν τον χρήστη μόνο μέσω SFTP.
Αν κάνετε αλλαγές στα πρότυπα, αντικαταστήστε τα υποδείγματα δεδομένων με τα δικά σας δεδομένα. Μην αλλάξετε τα περιεχόμενα της επικεφαλίδας σε κάθε αρχείο. Μη δημιουργήσετε διπλότυπες στήλες σε κανένα αρχείο. Μπορείτε να προσθέσετε στήλες σε ορισμένα πρότυπα.
Σε κάθε πρότυπο, κάθε σειρά πρέπει να αντιπροσωπεύει μια μοναδική τιμή. Για παράδειγμα, εντός του αρχείου students.csv, κάθε σειρά πρέπει να είναι ένας μοναδικός μαθητής. Ορισμένες τιμές για τον συγκεκριμένο μαθητή μπορεί να είναι κενές. Καθορισμένες τιμές, για παράδειγμα μια αλλαγή γραμμής ή εισαγωγικά εντός ενός ονόματος, πρέπει να αποφεύγονται με ανάστροφη κάθετο (\). Ακολουθεί ένα παράδειγμα: \". Οποιαδήποτε αναγνωριστικά εισαχθούν πρέπει να είναι αλφαριθμητικά και μπορούν να συμπεριλαμβάνουν παύλα (-).
Αν η τιμή σας περιέχει ένα διάστημα ( ) ή κόμμα (,), χρησιμοποιήστε ευθεία εισαγωγικά (") γύρω από αυτό. Αν η τιμή σας δεν έχει κανέναν από αυτούς τους ειδικούς χαρακτήρες, μη χρησιμοποιήσετε εισαγωγικά. Αν δεν χρησιμοποιήσετε εισαγωγικά όπου απαιτούνται, ή αν χρησιμοποιήσετε καμπύλα εισαγωγικά, θα λάβετε σφάλματα κατά τη διαδικασία φόρτωσης.
Οι τιμές στα αρχεία σας πρέπει να διαχωριστούν με κόμματα (,) ή ερωτηματικά (;), ανεξάρτητα από τον τρόπο που δημιουργήσατε το αρχείο. Μην χρησιμοποιείτε διαστήματα ή tab μεταξύ ενός κόμματος ή ερωτηματικού και της επόμενης τιμής. Κάθε αρχείο πρέπει να είναι κωδικοποιημένο ως UTF-8. Για την αναπαράσταση του τέλους γραμμής, χρησιμοποιήστε την κωδικοποίηση νέων γραμμών UNIX \n.
Αν λείπει μια καταχώριση από προηγούμενη αποστολή, ο λογαριασμός χρήστη απενεργοποιείται και διαγράφεται αυτόματα μετά από 120 ημέρες, εκτός αν:
Ο χρήστης έχει έναν ρόλο που έχει αγοράσει εφαρμογές ή βιβλία μαζικά.
Ο χρήστης διαγραφεί μη αυτόματα πριν από το όριο των 120 ημερών.
Τα ονόματα των αρχείων .csv θα πρέπει να ταιριάζουν ακριβώς με το αρχικό όνομα αρχείου.
Όλα τα αρχεία πρέπει να συμπιεστούν σε ένα συμπιεσμένο αρχείο αρχειοθήκης (.zip) προς αποστολή.
Κανένα αρχείο δεν μπορεί να τοποθετηθεί εντός ενός φακέλου μέσα στο συμπιεσμένο αρχείο αρχειοθήκης.
Όλες οι αναφορές εξωτερικών κλειδιών σε άλλα αρχεία .csv πρέπει να οριστούν στο αναφερόμενο αρχείο.
Όρια χαρακτήρων στα πρότυπα .csv
Μερικά πεδία στα πρότυπα .csv έχουν όρια για τον αριθμό των επιτρεπόμενων χαρακτήρων.
Όνομα χαρακτηριστικού | Πρότυπα | Όριο χαρακτήρων |
|---|---|---|
Apple: first_name OneRoster: givenName | Apple: Μαθητές, Προσωπικό OneRoster: Χρήστες | 32 |
Apple: middle_name OneRoster: middleName | Apple: Μαθητές, Προσωπικό OneRoster: Χρήστες | 32 |
Apple: last_name OneRoster: familyName | Apple: Μαθητές, Προσωπικό OneRoster: Χρήστες | 64 |
Apple: grade_level OneRoster: grades | Apple: Μαθητές OneRoster: Χρήστες | 64 |
Apple: email_address OneRoster: email | Apple: Μαθητές OneRoster: Χρήστες | 256 |
Apple: person_number OneRoster: identifier | Apple: Μαθητές, Προσωπικό OneRoster: Χρήστες | 64 |
Apple: person_id OneRoster: sourcedId | Apple: Μαθητές, Προσωπικό, Τάξεις, Κατάλογοι OneRoster: Χρήστες, Τάξεις, Εγγραφές | 256 |
Apple: sis_username OneRoster: username | Apple: Μαθητές, Προσωπικό OneRoster: Χρήστες | 256 |
Apple: class_id OneRoster: sourcedID | Apple: Τάξεις, Κατάλογοι OneRoster: Τάξεις, Εγγραφές | 256 |
Apple: class_number OneRoster: classCode | Apple: Μαθητές, Τάξεις OneRoster: Τάξεις | 64 |
Apple: course_id OneRoster: sourcedID | Apple: Μαθήματα, Τάξεις OneRoster: Μαθήματα, Τάξεις | 256 |
Apple: course_name OneRoster: title | Apple: Μαθήματα OneRoster: Μαθήματα | 128 |
Apple: course_number OneRoster: courseCode | Apple: Μαθήματα OneRoster: Μαθήματα | 64 |
Apple: location_name OneRoster: name | Apple: Τοποθεσίες OneRoster: Οργανισμοί | 256 |
Apple: location_id OneRoster: sourcedID | Apple: Μαθητές, Προσωπικό, Μαθήματα, Τάξεις, Τοποθεσίες OneRoster: Χρήστες, Μαθήματα, Τάξεις, Οργανισμοί | 256 |