Πληροφορίες προτύπων για την εισαγωγή αρχείων στο Apple School Manager
Η Apple παρέχει έξι πρότυπα που μπορείτε να χρησιμοποιήσετε κατά την προσθήκη δεδομένων στην τοποθεσία σας:
Μαθητές: Περιέχει πληροφορίες για λογαριασμούς μαθητών.
Προσωπικό: Περιέχει πληροφορίες για λογαριασμούς προσωπικού, όπως εκπαιδευτές.
Σειρές μαθημάτων: Ορίζει σειρές μαθημάτων.
Τάξεις: Περιέχει πληροφορίες για σειρές μαθημάτων, εκπαιδευτές (προσωπικό).
Λίστες: Περιέχει πληροφορίες για τάξεις, μαθητές και τοποθεσίες.
Τοποθεσίες: Περιέχει πληροφορίες για τοποθεσίες.
Πρότυπα και Διαχειριζόμενα 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 ημέρες, εκτός εάν ο λογαριασμός έχει αγοράσει αρκετό περιεχόμενο.
Τα ονόματα των αρχείων .csv θα πρέπει να ταιριάζουν ακριβώς με το αρχικό όνομα αρχείου.
Όλα τα αρχεία πρέπει να συμπιεστούν σε ένα συμπιεσμένο αρχείο αρχειοθήκης (.zip) προς αποστολή.
Κανένα αρχείο δεν μπορεί να τοποθετηθεί εντός ενός φακέλου μέσα στο συμπιεσμένο αρχείο αρχειοθήκης.
Όλες οι αναφορές εξωτερικών κλειδιών σε άλλα αρχεία .csv πρέπει να οριστούν στο αναφερόμενο αρχείο.
Όρια χαρακτήρων στα πρότυπα .csv
Μερικά πεδία στα πρότυπα .csv έχουν όρια για τον αριθμό των επιτρεπόμενων χαρακτήρων.
Πεδίο | Πρότυπα | Όριο χαρακτήρων |
---|---|---|
first_name | Μαθητές, Προσωπικό | 32 |
middle_name | Μαθητές, Προσωπικό | 32 |
last_name | Μαθητές, Προσωπικό | 64 |
grade_level | Μαθητές | 64 |
email_address | Μαθητές | 256 |
person_number | Μαθητές, Προσωπικό | 64 |
person_id | Μαθητές, Προσωπικό, Τάξεις, Λίστες | 256 |
sis_username | Μαθητές, Προσωπικό | 256 |
class_id | Τάξεις, Λίστες | 256 |
class_number | Τάξεις | 64 |
course_id | Μαθήματα, Τάξεις | 256 |
course_name | Μαθήματα | 128 |
course_number | Μαθήματα | 64 |
location_name | Τοποθεσίες | 256 |
location_id | Μαθητές, Προσωπικό, Μαθήματα, Τάξεις, Τοποθεσίες | 256 |