Skip to main content

D2L Brightspace İçin Ally Entegrasyonu

Ally'ı D2L Brightspace örneğinizle entegre etmek için şu adımları izlemeniz gerekir:

  1. Kullanıcı ve Rol oluşturma. Bunun, Anthology Ally desteğini aramadan önce yapılması gerekir.

  2. Ana yapılandırma

  3. LTI'yi yapılandırma

    • İstemci yapılandırması

    • Kurum raporu

    • Kurs Erişilebilirlik Raporu

Kullanıcı ve rol oluşturma

  1. Yeni bir rol yarat 

    1. Ayarlar menüsünden (dişli simgesi) Roller ve izinler sayfasına geçin 

    2. Rol oluşturma sürecini Yarat/Kopyala butonunu seçerek başlatın 

    3. Başla Yeniden butonunu seçerek yeni bir boş rol oluşturun 

    4. Rol ayarları: 

      • İsim: Ally REST Rol 

      • Açıklama: Ally'nin Brightspace REST API'leriyle güvenli iletişim kurmasına izin veren izinler kümesi 

      • Cascading Role etkinleştirin 

        Birincil Kolaylaştırıcı seçeneğini devre dışı bırakın, çünkü artık gerekli olmayabilir

      • Rol takma ad: müttefik 

      • Araç Davranış Seçenekleri altında değişiklik yapılmasına gerek yok, her şey devre dışı kalabilir 

      • Sınıf Listesi Görüntüleme Seçenekleri altında değişiklik yapılmasına gerek yok, her şey devre dışı kalabilir 

      • Kurs Erişim Seçenekleri altında: 

        • Tüm erişim seçeneklerini etkinleştirin: 

          • Aktif olmayan kurslara erişim 

          • Geçmiş kurslara erişim 

          • Gelecek kurslara erişim 

        • Bölümler ve Gruplar yukarıdakilerin hiçbiri olarak ayarlanabilir 

    5. Rol etkileşimleri: 

      1. Ally REST Rolünü Kaydet altında, Yönetici satırı ile Organizasyon sütununun kesişimindeki onay kutusunu seçin. Bu, daha sonra bu rolü taşıyan bir kullanıcı yaratmanıza olanak tanır. 

      2. Ally REST Rolünü Ara altında, Yönetici satırı ile Organizasyon sütununun kesişimindeki onay kutusunu seçin. Bu, daha sonra bu rolde bir kullanıcı aramanıza olanak tanır. 

      3. Başka değişiklik gerekmez.

  2. Rolün izinlerini yapılandırma 

    Kaydedildikten sonra, yeni Müttefik REST Rolü rol listesinin en altında görünecektir. Açılır menüyü açın ve İzinleri Düzenle'yi seçin. Bu ekranda, aşağıdaki izinlerin verilmesi gerekir. 

    1. İçerik aracıyla filtreleyin ve Kurs Teklifi sütununda aşağıdaki izinleri verin: 

      • Kurs İçeriğini Görüntüle 

      • İçerik Derleyin ve İndirin 

      • İçerik Konularını İndir 

      • Yayınlanmayan İçerik Görüntülen 

      • İçerik Yönetimi 

      • Modüller ve Konular Oluştur ve Düzenle 

      • Modülleri ve Konuları Sil (potansiyel nöbet yaratan görüntüleri silmek için gereklidir)

    2. Kurs Yönetimi Konsolu

      • Ders Bilgisi (Kurs Teklifi) bölümüne bakınız. Bu izin, Ally'ın departmana ait organizasyon birimlerini alması için gereklidir.

    3. Sınıf Listesi

      • Sınıf Listesine Erişimi Var

    4. Tartışmalar 

      • Tartışmaları görüntüle (Ders Sunulması)

        Bu, bir dersteki tartışma konularına ve içindekilere bağlantıları listelemek için gereklidir. 

    5. Kısa Sınavlar 

      • Bilgi yarışmalarını görüntüleyin (Ders Sunulması)

        Bu, kursun içindekilerinde bilgi bağlantılarını listelemek için gereklidir. 

    6. Org Unit Düzenleyicisi 

      • Kuruluş Birimi Düzenleyicisi (Organizasyon) Görüntüleyin  

      • Org. Birimi Türleri ekleyebilir ve düzenleyebilir (Organizasyon).

        Dönemleri listelemek için bu role ihtiyacımız var. Maalesef "salt okunur" izni yoktur. Ally asla organizasyon birim türü bilgi oluşturmaz veya düzenlemez.

    7. Güvenlik 

      • Rolleri ve İzinleri Görüntüle (Organizasyon)

    8. Kullanıcı Bilgileri Gizliliği

      1. Kullanıcı Adı (Kurs Teklifi) Hakkında Bkz.

        Bu izin, Ally'nin Kullanıcının tanımlayıcısını görmesini sağlar, ancak başka hiçbir şey olmaz. Bu bilgiler hiçbir zaman saklanmaz, ancak teknik sebeplerden dolayı bir kursa kaç öğrencinin kayıtlı olduğunun belirlenmesi gerekir.

      2. İlk İsimler (Organizasyon)

        Yardım istediğinde kullanıcının adını ve e-posta adresini almak için gereklidir. Bu bilgiler hiçbir zaman Ally'ın sistemlerinde saklanmaz ve yalnızca yardım e-postalarında iletilir.

      3. Soyadlar (organizasyon)

        Yardım istediğinde kullanıcının adını ve e-posta adresini almak için gereklidir. Bu bilgiler hiçbir zaman Ally'ın sistemlerinde saklanmaz ve yalnızca yardım e-postalarında iletilir.

      4. E-posta Adresleri (Organizasyon)

        Yardım istediğinde kullanıcının adını ve e-posta adresini almak için gereklidir. Bu bilgiler hiçbir zaman Ally'ın sistemlerinde saklanmaz ve yalnızca yardım e-postalarında iletilir.

    9. Kullanıcılar

      1. Kullanıcı Kayıt İşlemlerini Görüntüle (Kurs Özel Paketi)

      2. 'Öğrenci' (Kurs Teklifi) araması

        Öğrenci rolü için varsayılan isimdir. Kurumunuz bu kullanıcı türü için farklı bir ad kullanıyorsa bunun yerine '...' araması ögesini etkinleştirin. Bu, bir kurs özel paketindeki öğrenci sayısını almak için gereklidir. Gönderilen veriler anonimleştirilir.

      3. Kullanıcıların e-posta adresini (organizasyon) görüntüleyin

        Kullanıcı yardım istediğinde e-posta adresini geri almak gereklidir. Bu bilgiler hiçbir zaman Ally'ın sistemlerinde saklanmaz ve yalnızca yardım e-postalarında iletilir.

      4. Kullanıcı Yönetim Aracı (Organizasyon) bölümüne bakınız

        Kullanıcı yardım istediğinde onun adını ve e-posta adresini almak gereklidir. Bu bilgiler hiçbir zaman Ally'ın sistemlerinde saklanmaz ve yalnızca yardım e-postalarında iletilir.

  3. Kullanıcı oluşturma

    Rol yapılandırıldıktan sonra, bu sınırlı yetinler setiyle yeni bir kullanıcı oluşturulabilir. 

    1. Ayarlar menüsünden (dişli simgesi) Kullanıcılar'a geçin 

    2. Yeni Kullanıcı butonunu seçerek rol oluşturma sürecini başlatın 

    3. Ayarlar: 

      • Adı MütfİK 

      • Soyad: Kullanıcı 

      • Rol: Müttefik REST Görevi 

      • Kullanıcı adı: allyuser 

      • Şifreyi manuel olarak ayarla ögesini seçin ve Şifre alanına, uygun şekilde güvenli bir şifre girin. Bu şifrenin yeterince güvenli olması çok önemlidir çünkü daha sonra şifreyi değiştirmek için her şeyin yeniden ayarlanması gerekecektir.

      • Kullanıcıyı Kaydet butonunu seçerek kaydet 

Ana yapılandırma

Önemli

Önce Kullanıcı ve Rol yapılandırmasının gerçekleştirildiğine emin olun. Aşağıdaki yapılandırma, bir Anthology Ally desteğiyle yapılan telefon görüşmesiyle gerçekleştirilir. Önce yapılandırma ile ilgili görüşmenin planlandığına emin olun.

  1. Ayarlar menüsünden (dişli simgesi) Genişletilebilirliği yönet ögesine gidin

  2. OAuth 2.0 sekmesinde olduğunuza emin olun

  3. Bir Uygulama KaydEt butonunu seçin

  4. Formu aşağıdaki gibi doldurun:

    • İsim: Ally

    • Yönlendirme URI: <Yönlendirme URI Anthology bağlantısı tarafından sağlandı>

      örneğin https://[Ally env]/api/v1/d2l/callback?clientId=[Ally istemci Kimlik]

    • Kapsam: content:*:read content:file:write core:*:* custom:contentaccess:read kayıt:orgunit:read

    • Kullanıcı onayı için istek: Hayır

    • Yenileme belirteçlerini etkinleştirin: Evet

    • Ticari Olmayan Geliştirici anlaşmasını kabul ediyorum: Evet

  5. Kayıt butonunu seçin

  6. Yeni oluşturulan uygulamanın ayrıntıları size sunulur. İstemci kimliğini ve gizli anahtarı kopyalayın, ardından bunları Anthology Ally desteğiyle paylaşın.

  7. Anthology Ally onayı alındıktan sonra Güncelleştir'i seçin

  8. Brightspace'te allyuser olarak oturum açın

  9. Anthology Ally desteği tarafından sağlanan URL'ye gidin (Ally yöneticisi İstemci entegrasyonu ayrıntıları altında). Ana bilgisayar adı .ally.ac ile biten bir URL olmasına rağmen, otomatik olarak Brightspace örneğinize yönlendirilirsiniz. Brightspace, Ally'ın REST API ile etkileşim kurması için izninizi isteyen bir ekran görüntüler. Kabul Et'i seçin.

  10. Her şey yolunda giderse, aşağıdaki başarı mesajı gösterilmelidir: REST entegrasyonu başarıyla kuruldu!

  11. Ayarlar menüsünden (dişli simgesi), Yapılandırma Değişkeni Tarayıcısı'na gidin

  12. Soldaki ağaç menüsünü kullanarak Müttefik yapılandırmalarını bulun: 3rdParty > Müttefik

    Müttefik entegrasyonu d2l.3rdParty.Ally.*'da yaşar

  13. Konfigürasyon değerlerini, Blackboard bağlantınızın size sağladığı değerlerle ekleyin

    • ClientId

    • ClientSecret – Brightspace, iki giriş sağlar. Her iki giriş için de LTI parolasını kullanın.

    • ScriptUrl

  14. Ayarlar menüsünden (dişli simgesi), Organizasyon Araçları'na gidin

  15. Ally Entegrasyonu satırını bulun ve onay kutusunu işaretleyerek etkinleştirin

LTI'yi yapılandırma

LTI'yi yapılandırmak ve Ally araçlarını kaydettirmek için bu adımları izleyin.