Kayıtları Apple Okul Yönetimi’ne içe aktarmak için şablon bilgileri
Apple, konumunuza veri eklerken kullanılacak altı şablon sunar:
Öğrenciler: Öğrenci hesabı bilgilerini içerir.
Personel: Öğretmenler gibi personel hesabı bilgilerini içerir.
Dersler: Dersleri tanımlar.
Sınıflar: Ders, öğretmen (personel) bilgilerini içerir.
Öğrenci Listeleri: Sınıf, öğrenci ve konum bilgilerini içerir.
Konumlar: Konum bilgilerini içerir.
Şablonlar ve Yönetilen Apple Kimlikleri
person_number veya sis_username gibi isteğe bağlı bir alan, Yönetilen Apple Kimliği biçiminizin bir parçasıysa zorunlu bir alan haline gelir. Boş bırakırsanız SFTP yüklemesi MANAGED_ID_GENERATION_FAILED hatasıyla başarısız olur.
Şablonları hazırlama
Şablon hazırlarken aşağıdaki kriterler karşılanmalıdır:
Students.csv ve staff.csv şablonlarında her konum için person_id farklı olmalıdır.
Önemli: Yeni bir kullanıcı yüklemek için SFTP kullanıyorsanız ve atadığınız person_id başka bir kullanıcıya zaten atanmışsa yeni kullanıcı, Apple Okul Yönetimi’ndeki mevcut kullanıcının üzerine yazılır. Üzerine yazma tamamlandıktan sonra, ilgili kullanıcıyı yalnızca SFTP aracılığıyla güncelleyebilirsiniz.
Şablonları düzenlerseniz örnek verileri kendi verilerinizle değiştirin. Hiçbir dosyada başlık satırındaki içerikleri değiştirmeyin. Hiçbir dosyada mükerrer sütunlar oluşturmayın. Belirli şablonlara sütun ekleyebilirsiniz.
Tüm şablonlarda her satır benzersiz bir değer içermelidir. Örneğin, students.csv dosyasında her satırda farklı öğrenci olmalıdır. Öğrencinin bazı değerleri boş olabilir. Değişmez değerler (ör. satır atlatma veya ad içindeki tırnak işareti karakterleri) önlerine ters eğik çizgi (\) konularak kullanılmalıdır. Örneğin: \". Girilen tanımlayıcılar alfanumerik olmalıdır ve kısa çizgi (-) içerebilir.
Değeriniz boşluk ( ) veya virgül (,) içeriyorsa düz tırnak (") içine alın. Değerinizde bu özel karakterlerin hiçbiri bulunmuyorsa tırnak işareti kullanmayın. Gerekli yerlerde tırnak işareti kullanılmazsa veya kıvrımlı tırnak işareti kullanılırsa yüklerken hata oluşur.
Dosyalarınızı nasıl oluşturmuş olursanız olun dosyalarınızdaki değerler virgül (,) veya noktalı virgül (;) ile ayrılmalıdır. Virgül veya noktalı virgül ve sonrasındaki değer arasında boşluk veya tab karakteri kullanmayın. Tüm dosyalar UTF-8 olarak kodlanmalıdır. Satır sonunu temsil etmesi için UNIX yeni satır kodlamasını (\n) kullanın.
Önceki bir yüklemedeki bir giriş eksikse ve hesap toplu içerik satın alımı yapmamışsa hesap devre dışı bırakılır ve 120 gün sonra otomatik olarak silinir.
.csv dosyalarının adı orijinal dosya adıyla tam olarak eşleşmelidir.
Yüklenecek tüm dosyalar tek bir arşiv dosyasına sıkıştırılmalıdır (.zip).
zip arşivinin içindeki bir klasöre dosya eklenemez.
Diğer .csv dosyalarına verilen tüm yabancı anahtar referansları, referans verilen dosyada belirtilmelidir.
.csv şablonlarındaki karakter sınırları
.csv şablonlarındaki bazı alanların izin verilen karakter sayısı sınırlıdır.
Alan | Şablonlar | Karakter sınırı |
---|---|---|
first_name | Öğrenciler, Personel | 32 |
middle_name | Öğrenciler, Personel | 32 |
last_name | Öğrenciler, Personel | 64 |
grade_level | Öğrenciler | 64 |
email_address | Öğrenciler | 256 |
person_number | Öğrenciler, Personel | 64 |
person_id | Öğrenciler, Personel, Sınıflar, Öğrenci Listeleri | 256 |
sis_username | Öğrenciler, Personel | 256 |
class_id | Sınıflar, Öğrenci Listeleri | 256 |
class_number | Sınıflar | 64 |
course_id | Dersler, Sınıflar | 256 |
course_name | Dersler | 128 |
course_number | Dersler | 64 |
location_name | Konumlar | 256 |
location_id | Öğrenciler, Personel, Dersler, Sınıflar, Konumlar | 256 |