OneRoster CSV
Tanım
ManageBac+, yöneticilerin OneRoster 1.2 standardının ManageBac+ bir sürümünü kullanarak kullanıcıları, sınıfları, kayıtları ve ilgili verileri içe ve dışa aktarmasına olanak tanır . Bu özellik Ayarlar > Veri Değişimi altında erişilebilir ve içe aktarmadan önce verilerin doğru olduğundan emin olmak için doğrulama raporları içerir.
OneRoster standardı, IMS Global Learning Consortium tarafından geliştirilmekte ve sürdürülmekte olup , bu veri alışverişi için bir çerçeve sağlamaktadır. Teknik uygulamayı açıklayan kaynağa buradan ulaşılabilir:
ManageBac+ OneRoster 1.2 CSV Özel Spesifikasyonu
İhracat
ManageBac+ te dışa aktarma, verilerin sistemden harici bir biçime aktarılması işlemidir ve kullanıcıların bilgileri diğer sistemlerle paylaşmasına, yedeklemesine veya entegre etmesine olanak tanır.
Dışa aktarma işlemine başlamak için Veri Değişim Yöneticisi'ndeki Dışa Aktar sekmesine gidin.
Eğer 2. Adım - Mod Seçenekleri (TOPLU ve DELTA) yazısını görüyorsanız, bu başka bir yöneticinin zaten bir dışa aktarma işlemi tamamladığı anlamına gelir. İstediğiniz dışa aktarma yöntemini seçin ve Dışa Aktarmaya Devam Et'e tıklayın.
ManageBac+ taki Toplu Dışa Aktarma ve Delta Dışa Aktarma, veri yönetiminde farklı amaçlara hizmet eder:
- Toplu Dışa Aktarma : Bu işlem, ilgili tüm kayıtları tek seferde dışa aktarır. Genellikle, ilk kurulum sırasında veya yeni bir sisteme geçiş yaparken olduğu gibi, eksiksiz bir veri kümesine ihtiyaç duyulduğunda kullanılır. Bu yöntem, mevcut tüm verilerin yakalanmasını ve aktarılmasını sağlar.
- Delta Dışa Aktarma : Bu işlem, son dışa aktarmadan bu yana değişen kayıtları (örneğin yeni oluşturulan, güncellenen veya silinen girişler) dışa aktarır. Tüm veri setini aktarmadan verilerin güncel kalmasına yardımcı olur ve devam eden senkronizasyon için daha verimli hale getirir. Delta dışa aktarma işlemi yalnızca toplu dışa aktarma tamamlandıktan sonra gerçekleştirilebilir.
"Dışa Aktarmaya Devam Et" seçeneğine tıklandıktan sonra, dışa aktarma işlemi arka planda başlayacak ve kullanıcıyı Exchange Geçmişi sekmesine yönlendirecektir.
İşlem tamamlandığında, en son dışa aktardığınız dosyayı bulun ve ZIP dosyasını indirmek için İndir düğmesine (aşağıya doğru ok) tıklayın.
İndirilen dosyayı inceleyin. Dosya içeriği, tüm varlıkları ve bunların ManageBac+ 'ın Özel Spesifikasyonunda nasıl temsil edildiğini içerecektir.
İthalat
Veri Değişim Yöneticisi aracılığıyla içe aktarma işlemine başlamak için, İçe Aktar sekmesinde ZIP dosyanızı seçin.
Bilgisayarınızdan OneRoster ZIP dosyasını seçin ve Kaydet'e tıklayarak yükleyin.
Gerekli alanları doldurun:
Eğer manifest.csv dosyanızda source.systemname ve source.systemcode alanları yer almıyorsa, yükleme alanının altında doldurmanız gereken iki alan görünecektir. Daha fazla bilgi için Dosya Özellikleri > manifest.csv bölümüne bakın.
Bu değerler manifest.csv dosyasında zaten mevcutsa , alanlar önceden doldurulacaktır ve bunları yeniden giremezsiniz.
Her şey ayarlandıktan sonra, alttaki Doğrulama İşlemine Devam Et düğmesine tıklayın. Bu, arka planda OneRoster ve ManageBac+ doğrulamalarını çalıştıran içe aktarma işlemini başlatır.
Aynı anda yalnızca bir OneRoster içe aktarma işlemi gerçekleştirilebilir.
Üst kısımdaki Exchange Geçmişi sekmesinden içe aktarma durumunu kontrol edin. İçe aktarma işlemi tamamlandıktan sonra, en son içe aktardığınız dosyayı bulun ve doğrulamaları inceleyin.
Exchange Raporu sayfası açılacak ve bir özet ile OneRoster ZIP dosyanızdan yüklenen tüm CSV dosyalarını gösterecektir.
Her CSV sekmesinde, hatalar ve uyarılar, sorunların bulunduğu hücrelerde ilgili renklerle vurgulanacaktır.
Üç sekme bulunmaktadır ve başlangıçta varsayılan olarak "Geçersiz" sekmesi seçilidir:
Geçerli — uyarı veya doğrulama hatası içermeyen tüm satırları içerir.
Uyarı — en az bir uyarı içeren tüm satırları içerir.
Geçersiz — en az bir geçersiz kayıt içeren tüm satırları içerir.
Uyarı veya geçersiz kılma ile ilgili mesajı anlamak için, satır bilgilerini genişletmek üzere tıklayın:
Uyarılar, içe aktarmayı engellemeyen potansiyel sorunlardır. Yöneticiler, duruma bağlı olarak uyarıyı görmezden gelebilir veya ayarlamalar yapabilirler.
Geçersiz kayıtlar işlevsel gereksinimleri karşılamadığından içe aktarma işlemi devam edemez.
Geçersizliğe yol açan tüm sorunları giderdikten sonra, güncellenmiş ZIP dosyasını kullanarak yeni bir içe aktarma işlemi gerçekleştirin.
Veri Varlıkları
Aşağıdaki tablo, ManageBac+ varlıklarının OneRoster 1.2 varlıkları ve CSV dosyalarıyla nasıl eşleştiğini ve veri modellerindeki farklılıkları dikkate alarak sorunsuz veri alışverişini nasıl sağladığını göstermektedir.
| OneRoster 1.2 Varlık(lar) | ManageBac+ Varlığı | OneRoster CSV dosyası(ları) |
| Organizasyonlar -> Bölge | Yok | örgütler |
| Organizasyonlar -> Okul | Okul | örgütler |
| Organizasyonlar -> Program Uzantısı | Programlar | örgütler |
| Akademik Dönemler -> Okul Yılı | Akademik Yıllar | akademik oturumlar |
| Kurslar | Konu Grupları | kurslar |
| Kurslar -> Konular | Konular | kurslar |
| Sınıflar | Sınıflar | sınıflar |
| Kullanıcılar, Roller -> Öğrenci, Demografik Bilgiler | Öğrenciler | kullanıcılar, roller, demografik bilgiler |
| Kullanıcılar, Roller -> Öğretmen | Öğretmenler | kullanıcılar, roller |
| Kullanıcılar, Roller -> Üst Öğe | Ebeveynler | kullanıcılar, roller |
| Kullanıcılar, Roller -> Yönetici | Yöneticiler | kullanıcılar, roller |
| Kullanıcılar -> Temsilciler | Ebeveyn/Çocuk İlişkisi | kullanıcılar |
| Kayıtlar | Sınıf Üyelikleri | kayıtlar |
Örneğin, ManageBac+ öğrencisi, OneRoster'da "Öğrenci" rolüne sahip bir kullanıcıya karşılık gelir . OneRoster'da kullanıcılar ve roller sırasıyla users.csv ve roles.csv dosyalarında tanımlanır .
Veri Değişim Yöneticisi yalnızca yukarıda listelenen kayıtları günceller ve diğer verilerde herhangi bir değişiklik yapmaz.
Delta İthalat vs Toplu İthalat
Veri alışverişi sürecindeki en önemli ayrımlardan biri , delta içe aktarma ile toplu içe aktarma arasındaki farktır .
- Delta İçe Aktarma :
- Mevcut ManageBac+ kayıtlarıyla eşleşir ve bunları günceller.
- Eğer mevcut değilse yeni kayıtlar oluşturur.
- Kaynak verilerde yer almayan kayıtlar olduğu gibi kalır .
- Toplu İthalat :
- Delta içe aktarma işlemiyle aynı eylemleri gerçekleştirir (kayıtları eşleştirme, güncelleme ve oluşturma).
- Ek olarak, ManageBac+ ta kaynak verilerde bulunmayan tüm aktif kayıtları arşivler .
- Örneğin, ManageBac+ ta "IB Biyoloji" gibi bir ders aktifse ancak kaynak verilerde yoksa, içe aktarma işlemi tamamlandıktan sonra arşivlenecektir .
Özetle, toplu içe aktarma işlemi yalnızca kaynak verilerden kayıtlar oluşturup güncellemekle kalmaz, aynı zamanda eksik olan kayıtları da arşivler .
Akademik yıl geçişi sırasında toplu içe aktarma işlemi yapıyorsanız , OneRoster'ın yıl gruplarını içermediğini ve bu nedenle bunların ayrı olarak yönetilmesi gerektiğini lütfen unutmayın .
İçe Aktarma Sırasında Kayıt Eşleştirme
Hem delta hem de toplu içe aktarma işlemlerinde ManageBac+ , kaynak verilerdeki kayıtları sistemdeki kayıtlarla eşleştirmek için iki ana strateji kullanır:
- Eğer bir sourcedId daha önce kullanılmışsa, bir sonraki maddede açıklanan eşleştirme yöntemi kullanılarak doğrudan ilgili kayıtla eşleştirilir.
- Kaynak kimliklerine göre eşleştirme mümkün değilse veya ilk karşılaşma ise, aşağıdaki tablo her varlık için eşleştirme stratejisini özetlemektedir:
| Varlık | Kaynak Sütunu (VEYA) | (MB) ile eşleştirildi |
| Okul | organizasyon türleri == "okul" | Mevcut okulla eşleştirildi (sadece 1 kayıt) |
| Program | orgs.sourcedId , ilk alt çizgiden sonraki sonekle eşleşiyor. | Program koduna uygun (örneğin abc-dedf_diploma, IB Diplomasıdır ) |
| Akademik Oturumlar | akademikDönemler.başlangıçTarihi , akademikDönemler.bitişTarihi | Yıl/dönem başlangıç/bitiş tarihlerine göre eşleştirilmiştir. |
| Kurslar | kurslar.başlık | Konu Grubu Başlığıyla Eşleştirildi |
| Konular | dersler.dersler[] | Dizideki her bir dize, Konu Başlığı ile eşleştirilir. |
| Sınıflar | sınıflar.sınıf kodu | Sınıf Kimliğiyle eşleştirildi |
| Kullanıcılar | kullanıcılar.kullanıcı adı | Öğrenci/Öğretmen/Veli E-postasıyla Eşleştirildi |
Sıkça Sorulan Sorular
Soru: OneRoster nedir ve ManageBac+ neden onun özel bir sürümünü kullanıyor?
OneRoster, IMS Global Learning Consortium tarafından farklı sistemler arasında öğrenci bilgileri, ders verileri ve kayıtlar gibi eğitim verilerinin alışverişini standartlaştırmak için geliştirilmiş, yaygın olarak benimsenen bir spesifikasyondur. ManageBac+ 'ın OneRoster 1.2 uygulamasında, temel OneRoster spesifikasyonunun veri modeli ManageBac+ 'ın işlevsel gereksinimlerinden farklı olduğu için " ManageBac+ OneRoster Lehçesi" (MB OR Lehçesi) olarak adlandırılan özel bir spesifikasyon kullanılmaktadır. Bu özelleştirme, ManageBac+ kayıtları kendi iç veri yapısı ve özellikleriyle uyumlu bir şekilde içe ve dışa aktarmasına olanak tanır.
Soru: ManageBac+ OneRoster içe/dışa aktarma işlemine hangi dosyalar dahil edilir ve hangileri zorunludur?
ManageBac+ OneRoster verileri, CSV dosyaları içeren bir zip arşivi olarak paylaşılır. manifest.csv dosyası zorunludur. Aşağıdaki dosyalar isteğe bağlıdır ancak ilgili varlıklar dahil edilmişse arşivde bulunmalıdır: academicSessions.csv, orgs.csv, courses.csv, classes.csv, roles.csv, users.csv, enrollments.csv ve demographics.csv. Boş isteğe bağlı dosyaların gerekli sütun başlıklarını içermesi gerektiğini unutmayın.
Soru: Her dosyanın hangi sütunlara ihtiyacı var ve geçerli değerler nelerdir?
Bu ayrıntılar , teknik uygulamayı açıklayan ve buradan erişilebilen kaynakta yer almaktadır :
ManageBac+ OneRoster 1.2 CSV Özel Spesifikasyonu
Soru: OneRoster verilerini ManageBac+ a aktarırken geçerli doğrulama kuralları nelerdir?
ManageBac+ içe aktarılan tüm CSV dosyalarına çeşitli evrensel doğrulamalar uygular. Bu doğrulamaların sonuçları Veri Değişimi geçmişi sekmesinde raporlanır. Her varlığın bir dizi doğrulaması vardır ve bunların ayrıntıları, teknik uygulamayı açıklayan ve burada referans verilebilen kaynakta verilmiştir :
ManageBac+ OneRoster 1.2 CSV Özel Spesifikasyonu
Soru: ManageBac+ ile OneRoster 1.2 uyumlu diğer sistemler arasında veri alışverişi yapılırken ne gibi farklılıklar ve olası uyumsuzluklar ortaya çıkar?
ManageBac+ tan standart OneRoster 1.2'yi uygulayan üçüncü taraf bir sisteme veri aktarırken, dışa aktarma işlemi genellikle uyumludur. ManageBac+ Kullanıcılar, Kurslar ve Sınıflar gibi dosyalarda ek meta veri sütunları içerir ve bunlar genellikle alıcı sistem tarafından göz ardı edilebilir.
Ancak, üçüncü taraf bir sistemden ManageBac+ a veri aktarılırken, ManageBac+ 'ın özel spesifikasyonu nedeniyle belirli gereksinimlerin karşılanması gerekir. Örneğin, Sınıflar ve Kurslar belirli bir türe (ext:program) sahip kuruluşlarla ilişkilendirilmelidir ve Kullanıcı, Kurs ve Sınıf dosyalarında ek meta sütunlar gerekebilir. Akademik Oturumlar da içe aktarılırken kısmi uyumluluğa sahiptir.
Soru: ManageBac+ Veri Değişim Yöneticisi'nde "Toplu" ve "Delta" dışa aktarma arasındaki fark nedir? Toplu dışa aktarma, seçilen verilerin tam bir dışa aktarımıdır ve ManageBac+ daki mevcut bilgilerin eksiksiz bir anlık görüntüsünü sağlar. Bu genellikle ilk dışa aktarma olarak gerçekleştirilir. Öte yandan, Delta dışa aktarma yalnızca son başarılı Toplu dışa aktarmadan bu yana meydana gelen değişiklikleri (eklemeler, düzenlemeler ve silmeler) dışa aktarır. Delta dışa aktarma işlemi gerçekleştirmek için, önceden en az bir Toplu dışa aktarma işlemi tamamlamış olmanız gerekir.
Soru: OneRoster ZIP dosyasını ManageBac+ a aktarırken kaynak sistem adını ve kodunu nerede belirtmeliyim?
ManageBac+ özellikle birden fazla Öğrenci Bilgi Sisteminden veri alırken, OneRoster verilerinin kaynağını belirlemek için source.systemname ve source.systemcode alanlarına ihtiyaç duyar. Bu alanlar manifest.csv dosyanızda zaten yoksa, ZIP dosyasını Veri Değişim Yöneticisine yükledikten sonra bunları manuel olarak girmeniz istenecektir. Bu değerler, aynı kaynak sistemden yapılan içe aktarmalarda tutarlı olmalıdır.
Soru: Dışa aktarma işlemi için neden Delta yöntemini seçemiyorum?
Cevap: Delta yöntemini etkinleştirmek için ilk toplu dışa aktarma işlemini tamamlamanız gerekir. İlk toplu dışa aktarma işlemi tamamlandıktan sonra Delta yöntemi kullanılabilir hale gelir. Delta yöntemi, son tam toplu dışa aktarma işleminden bu yana yapılan değişiklikleri dışa aktarır.
Soru: ManageBac+ 'ın Özel OneRoster Spesifikasyonunda Yıl Gruplarını nerede belirtmeliyim?
Yanıt: Şu anda Yıl Grupları desteklenmemektedir, ancak ManagaBac'ın işlevsellik gereksinimlerini karşılamak için gerekli uzantıları desteklemek üzere OneRoster ile birlikte çalışmayı araştırıyoruz. Yıl Grubu üyeliğini Ayarlar -> Kadro -> Üyelikler üzerinden yönetmeniz önerilir.
Soru: Exchange Geçmişi sayfasındaki durum ne anlama geliyor?
Cevap: ManageBac+ ın aşağıdaki açıklamalarla birlikte dört farklı durumu vardır:
Planlandı - Bu, sistemin içe aktarma işlemini başarıyla planladığı ve daha sonraki bir zamanda başlatılmak üzere sıraya alındığı anlamına gelir. Başlatıldığında, İşlem Aşamasına geçecektir.
İşlemde - Bu, sistemin şu anda dışa aktarma veya içe aktarma işleminiz için arka planda çalıştığı anlamına gelir. Bu geçici bir durumdur ve aşağıdaki durumlardan birine dönüşecektir.
Başarısız - Bu durum görünürse, arka plan görevinin tamamlanamadığı anlamına gelir. Dışa aktarma hataları için lütfen ManageBac+ Destek ekibiyle iletişime geçin ( Talep gönderin ). İçe aktarma hataları için, Rapor Görünümü sayfasını açmak üzere Göz simgesine tıklayın, doğrulama hatalarını kontrol edin ve bir sonraki içe aktarma işlemi için düzeltin.
Başarılı - Bu, görevin hatasız tamamlandığı anlamına gelir.