Verileri Apple Okul Yönetimi’ne içe aktarmak için şablon bilgileri
Apple Okul Yönetimi’ne veri eklemek için Apple veya OneRoster tarafından biçimlendirilen .csv şablon dosyalarını kullanabilirsiniz.
Apple .csv şablon adları: Öğrenciler, Personel, Dersler, Sınıflar, Öğrenci Listeleri, Konumlar
OneRoster .csv şablon adları: Kullanıcılar, Kurslar, Sınıflar, Kayıtlar, Kuruluşlar
Apple dosya adı | OneRoster dosya adı | İçindekiler | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Apple: Öğrenci hesabı bilgilerini içerir. OneRoster: Öğrenci, öğretmen ve personel hesap bilgilerini içerir. | |||||||||||
Geçerli değil | Öğretmenler gibi personel hesabı bilgilerini içerir. | ||||||||||
Ders bilgilerini içerir. | |||||||||||
Sınıflar ve öğretmen (personel) bilgilerini içerir. | |||||||||||
Sınıf, öğrenci ve konum (öğrenci listesi) bilgilerini içerir. | |||||||||||
Konum (okul veya departman) 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.
Daha önceki bir yüklemeye ait bir giriş eksikse kullanıcı hesabı devre dışı bırakılır ve aşağıdaki durumlar haricinde 120 gün sonra otomatik olarak silinir:
Kullanıcı, toplu olarak uygulama veya kitap satın alımı yapmış bir göreve sahiptir.
Kullanıcı, 120 gün sınırından önce manuel olarak silinmiştir.
.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.
Özellik adı | Şablonlar | Karakter sınırı |
---|---|---|
Apple: first_name OneRoster: givenName | Apple: Öğrenciler, Personel OneRoster: Kullanıcılar | 32 |
Apple: middle_name OneRoster: middleName | Apple: Öğrenciler, Personel OneRoster: Kullanıcılar | 32 |
Apple: last_name OneRoster: familyName | Apple: Öğrenciler, Personel OneRoster: Kullanıcılar | 64 |
Apple: grade_level OneRoster: grades | Apple: Öğrenciler OneRoster: Kullanıcılar | 64 |
Apple: email_address OneRoster: email | Apple: Öğrenciler OneRoster: Kullanıcılar | 256 |
Apple: person_number OneRoster: identifier | Apple: Öğrenciler, Personel OneRoster: Kullanıcılar | 64 |
Apple: person_id OneRoster: sourcedId | Apple: Öğrenciler, Personel, Sınıflar, Öğrenci Listeleri OneRoster: Kullanıcılar, Dersler, Kayıtlar | 256 |
Apple: sis_username OneRoster: username | Apple: Öğrenciler, Personel OneRoster: Kullanıcılar | 256 |
Apple: class_id OneRoster: sourcedID | Apple: Sınıflar, Öğrenci Listeleri OneRoster: Dersler, Kayıtlar | 256 |
Apple: class_number OneRoster: classCode | Apple: Öğrenciler, Sınıflar OneRoster: Sınıflar | 64 |
Apple: course_id OneRoster: sourcedID | Apple: Dersler, Sınıflar OneRoster: Dersler, Sınıflar | 256 |
Apple: course_name OneRoster: title | Apple: Dersler OneRoster: Dersler | 128 |
Apple: course_number OneRoster: courseCode | Apple: Dersler OneRoster: Dersler | 64 |
Apple: location_name OneRoster: name | Apple: Konumlar OneRoster: Kuruluşlar | 256 |
Apple: location_id OneRoster: sourcedID | Apple: Öğrenciler, Personel, Dersler, Sınıflar, Konumlar OneRoster: Kullanıcılar, Dersler, Sınıflar, Kuruluşlar | 256 |