Siirry YuJaan
  1. YuJa-ohjekeskus
  2. Panorama-LMS-saavutettavuusalusta
  3. Canvas-integraatio
  4. Ylläpitäjät

Panoraman integrointi Canvasiin LTI 1.3:n avulla

Avatar
YuJa
  • Päivitetty

Tässä ohjeessa kerrotaan järjestelmänvalvojille, miten Panorama-saavutettavuusalusta integroidaan Canvasiin LTI 1.3:n avulla. Varmista ennen alla olevien vaiheiden aloittamista, että sinulla on täydet järjestelmänvalvojan käyttöoikeudet Canvas-ympäristöösi. Jos sinulla on kysyttävää prosessista, ota yhteyttä nimettyyn asiakkuuspäällikköösi.
 

Huomautus: Integraatiota varten on erittäin suositeltavaa luoda Canvasiin erillinen palvelutili. Näin on helpompi tunnistaa, mitkä toiminnot on tehnyt integraatio ja mitkä ihmisestä koostuva järjestelmänvalvoja, mikä auttaa välttämään sekaannuksia tai tahattomia muutoksia.

 

Panorama JSON -merkkijonon hankkiminen

Ennen kuin lisäät Panoraman Canvas-ympäristöösi, sinun on hankittava JSON-merkkijono. Päästäksesi käsiksi JSON-merkkijonoon sinun on täytynyt saada asiakkuuspäälliköltäsi sähköposti, jossa sinua pyydetään rekisteröimään Panorama-tilisi. Rekisteröi tilisi ja jatka sitten alla oleviin vaiheisiin. 

  1. Kirjaudu Panorama-tilillesi.
  2. Napsauta vasemmasta valikosta Konfigurointi ja valitse sitten Integraatioasetukset.
  3. Valitse LTI 1.3.
  4. Hanki Panorama JSON -merkkijonosi napsauttamalla Lataa LTI 1.3 JSON . 

Panoraman lisääminen Canvasiin

Kun olet hankkinut JSON-merkkijonosi, voit lisätä Panoraman Canvas-ympäristöösi. 

  1. Kirjaudu Canvasiin järjestelmänvalvojana. Napsauta vasemmasta sivupalkista Ylläpitäjä ja valitse oppilaitoksesi Canvas-tili.
  2. Valitse sivupalkista Ylläpitäjä > Kehittäjäavaimet.
  3. Napsauta + Kehittäjäavain > + LTI-avain.
  4. Valitse kohdan Menetelmä pudotusvalikosta Liitä JSON.
  5. Avaa edellisessä osiossa ladattu JSON-tiedosto millä tahansa tekstieditorilla, kuten Muistiolla, ja kopioi sen sisältö. Uudelleenohjauksen URL-osoitteet lisätään automaattisesti.
  6. Liitä sitten kopioitu sisältö kenttään LTI 1.3 -määritys.

  7. Anna haluamasi nimi kenttään Avaimen nimi ja napsauta Tallenna.

    Huomautus: Jos haluat, että LTI-työkalu on oletuksena pois käytöstä kurssin navigointipalkissa, lisää kurssin navigointia koskevaan osioon seuraava parametri: "default": "disabled".

    Parametri, jolla Panorama LTI -linkki asetetaan, on lisätty koodiin.

  8. Ota kehittäjäavaimen Tila-kytkin käyttöön.
  9. Napsauta Näytä Canvas-sovelluksissa. Uusi Canvas-ikkuna avautuu.
  10. Napsauta kynäkuvaketta.
  11. Vaihda tilaksi Käytettävissä ja napsauta sitten Tallenna.
  12. Kopioi asiakastunnus.
  13. Valitse seuraavaksi Asetukset navigointipalkista.
      
  14. Valitse ylärivistä Sovellukset ja valitse sitten Näytä sovellusmääritykset.
  15. Valitse +Sovellus näytön oikeasta yläkulmasta.
  16. Valitse kohdassa Määrityksen tyyppi vaihtoehto Asiakastunnuksen mukaan.
  17. Liitä aiemmin kopioimasi asiakastunnus kenttään. Kirjaa se muistiin, koska sitä tarvitaan vielä.
  18. Napsauta Lähetä luodaksesi sovelluksen.
  19. Valitse juuri luodun sovelluksen vieressä oleva Hammasratas-kuvake.
  20. Valitse pudotusvalikosta Käyttöönoton tunnus ja kopioi tunnus. Sitä tarvitaan tämän osion vaiheessa 24.
  21. Kirjaudu seuraavaksi Panorama-tilillesi.
  22. Napsauta vasemmasta valikosta Konfigurointi ja valitse sitten Integraatioasetukset.
  23. Valitse kohdan Valitse integraatio pudotusvalikosta LTI 1.3.
  24. Anna tarvittavat tiedot Panorama-ympäristösi (tilityypin) mukaan: 
    1. Tuotantoympäristö: 
      1. Asiakastunnus: Vaiheessa 12 kopioitu asiakastunnus. 
      2. Käyttöönoton tunnus: Vaiheessa 20 kopioitu käyttöönoton tunnus. 
      3. ISS: https://canvas.instructure.com
      4. OpenID Connect -päätepiste: https://canvas.instructure.com/api/lti/authorize_redirect
      5. JWKS-päätepiste: https://canvas.instructure.com/api/lti/security/jwks
         
    2. Testiympäristö:
      1. Asiakastunnus: Vaiheessa 12 kopioitu asiakastunnus. 
      2. Käyttöönoton tunnus: Vaiheessa 20 kopioitu käyttöönoton tunnus. 
      3. ISS: https://canvas.test.instructure.com
      4. OpenID Connect -päätepiste: https://canvas.test.instructure.com/api/lti/authorize_redirect
      5. JWKS-päätepiste: https://canvas.test.instructure.com/api/lti/security/jwks
         
    3. Beta-ympäristö:
      1. Asiakastunnus: Vaiheessa 12 kopioitu asiakastunnus. 
      2. Käyttöönoton tunnus: Vaiheessa 20 kopioitu käyttöönoton tunnus. 
      3. ISS: https://canvas.beta.instructure.com
      4. OpenID Connect -päätepiste: https://canvas.beta.instructure.com/api/lti/authorize_redirect
      5. JWKS-päätepiste: https://canvas.beta.instructure.com/api/lti/security/jwks
  25. Lisää Panorama Canvas-ympäristöösi napsauttamalla Tallenna muutokset ja siirry sitten tämän ohjeen seuraavaan osioon.

     
     

Asiakasavaimen ja asiakkaan salaisuuden luominen

  1. Napsauta + Kehittäjäavain > API-avain.
    1.png

  2. Anna seuraavat tiedot:

    • Avaimen nimi: Panorama API Integration
    • Uudelleenohjauksen URL-osoitteet: https://<zoneURL>/canvas-auth
      • Yhdysvaltain vyöhyke: https://panorama-api.yuja.com/canvas-auth
      • Kanadan vyöhyke: https://panorama-api-cz.yuja.com/canvas-auth
      • EU-vyöhyke: https://panorama-api-ez.yuja.com/canvas-auth
      • Australian vyöhyke: https://panorama-api-az.yuja.com/canvas-auth

    2.png

  3. (Valinnainen) Ota käyttöön Pakota käyttöalueet.
    Huomautus: Emme suosittele käyttöalueiden pakottamista. Se edellyttää, että Panorama integroidaan Canvas API:n kanssa uudelleen aina, kun Panoramaan lisätään uutta, rajapintaa käyttävää toiminnallisuutta. Jos et halua toimia näin, varmista, että Pakota käyttöalueet ei ole käytössä, ja siirry sitten vaiheeseen 5. 
  4. Valitse Salli sisällytysparametrit ja valitse sitten seuraavat parametrit:
    3.png
    • Tilit
      • url:GET|/api/v1/accounts
      • url:GET|/api/v1/accounts/:id
      • url:GET|/api/v1/accounts/:account_id/courses
      • url:GET|/api/v1/accounts/:account_id/sub_accounts
    • Ylläpitäjät
      • url:GET|/api/v1/accounts/:account_id/admins
    • Tehtävät
      • url:GET|/api/v1/courses/:course_id/assignments
      • url:GET|/api/v1/courses/:course_id/assignments/:id
      • url:PUT|/api/v1/courses/:course_id/assignments/:id
    • Kurssit
      • url:GET|/api/v1/courses
      • url:GET|/api/v1/courses/:id
      • url:GET|/api/v1/courses/:course_id/users
      • url:GET|/api/v1/courses/:course_id/users/:id
      • url:PUT|/api/v1/courses/:id
      • url:POST|/api/v1/courses/:course_id/files
    • Keskusteluaiheet
      • url:GET|/api/v1/courses/:course_id/discussion_topics
      • url:GET|/api/v1/courses/:course_id/discussion_topics/:topic_id
      • url:PUT|/api/v1/courses/:course_id/discussion_topics/:topic_id
      • url:PUT|/api/v1/courses/:course_id/discussion_topics/:topic_id/entries/:id
    • Ilmoittautumiset
      • url:GET|/api/v1/users/:user_id/enrollments
      • url:GET|/api/v1/courses/:course_id/enrollments 
    • Ilmoittautumisjaksot
      • url:GET|/api/v1/accounts/:account_id/terms
      • url:GET|/api/v1/accounts/:account_id/terms/:id
    • Tiedostot
      • url:GET|/api/v1/courses/:course_id/files
      • url:GET|/api/v1/files/:id
      • url:POST|/api/v1/files/:id
      • url:PUT|/api/v1/files/:id
    • Sivut
      • url:GET|/api/v1/courses/:course_id/pages
      • url:GET|/api/v1/courses/:course_id/pages/:url_or_id
      • url:PUT|/api/v1/courses/:course_id/pages/:url_or_id
      • url:POST|/api/v1/courses/:course_id/pages
    • Kokeet
      • url:GET|/api/v1/courses/:course_id/quizzes
      • url:GET|/api/v1/courses/:course_id/quizzes/:id
      • url:GET|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id
      • url:GET|/api/quiz/v1/courses/:course_id/quizzes
      • url:PUT|/api/v1/courses/:course_id/quizzes/:id
      • url:PATCH|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id
    •  Roolit
      • url:GET|/api/v1/accounts/:account_id/roles
      • url:GET|/api/v1/accounts/:account_id/roles/:id
    • Arviointimatriisit
      • url:GET|/api/v1/courses/:course_id/rubrics
      • url:GET|/api/v1/courses/:course_id/rubrics/:id
    • LTI-resurssilinkit
      • url:GET|/api/v1/courses/:course_id/lti_resource_links
      • url:GET|/api/v1/courses/:course_id/lti_resource_links/:id
  5. Napsauta Tallenna.
    4.png
  6. Etsi juuri luotu Panorama API Integration -kehittäjäavain ja kopioi Asiakastunnus kohdasta Tiedot.
  7. Napsauta Näytä avain ja kopioi Asiakkaan salaisuus.
  8. Kirjaudu Panoramaan ja napsauta vasemmasta valikosta Konfigurointi > Integraatioasetukset.
    7.png
  9. Valitse kohdan Valitse integraatio pudotusvalikosta LMS API yhteys.
  10. Napsauta Lisää pääsyavain.
    9.png
  11. Valitse Canvasin todennustavaksi Asiakastunnus.
  12. Kirjoita kenttään Asiakastunnus vaiheen 8 tunnus.
  13. Kirjoita kenttään Asiakkaan salaisuus vaiheen 9 asiakkaan salaisuus.
  14. Jos käytit pakotettuja käyttöalueita, ota käyttöön Käytä pakotettuja käyttöalueita. Muussa tapauksessa ohita tämä vaihe.
  15. Napsauta Todenna käyttäen Canvas.
    Huomautus: Varmista, että olet kirjautunut Canvasiin järjestelmänvalvojana, jolla on täydet oikeudet.
  16. Napsauta Valtuuta.
    13.png
  17. Kopioi todennusvastaus ja palaa Panoramaan. Liitä vastaus kenttään Canvas-todennuksen vastaus.
  18. Napsauta Lisää pääsyavain.
  19. Viimeistele asennus napsauttamalla Tallenna muutokset .
    15.png

LMS Visualizerin asentaminen 

LMS Visualizerin asentaminen saa Panoraman kuvakkeet näkymään kursseilla. Tämä vaihe edellyttää, että Canvas-ympäristössäsi on käytössä Mukautetut CSS/JavaScript-ohitukset -ominaisuus. Jos se ei ole käytössä, ota yhteyttä Canvasin asiakkuuspäällikköön.

  1. Kirjaudu Panoramaan.
  2. Napsauta vasemmasta valikosta Konfigurointi ja valitse sitten Integraatioasetukset.
  3. Valitse kohdan Valitse integraatio pudotusvalikosta LMS Visualizer ja napsauta Lataa Visualizer.
  4. Kirjaudu seuraavaksi Canvasiin ylläpitäjänä. Napsauta vasemmasta sivupalkista Ylläpitäjä ja valitse Tili, jolle haluat ottaa käyttöön YuJa Panorama - LMS Viewer.
  5. Valitse vasemmasta navigointipalkista Asetukset ja varmista, että Asetukset-välilehti on valittuna ylärivillä. 
  6. Napsauta seuraavaksi vasemmasta navigointipalkista Teemat ja napsauta sitten + Teema -painiketta. Valitse mikä tahansa teemamalli pudotusvalikosta.

  7. Siirry teemaeditorissa Lataa palvelimeen -välilehdelle ja valitse ladattu Visualizer-tiedosto. 

    Huomautus: Lataa palvelimeen -välilehti on käytettävissä vasta, kun Canvasin asiakkuuspäällikkö ottaa sen käyttöön.

  8. Napsauta seuraavaksi Esikatsele muutoksesi ja valitse sitten Käytä teemaa. Kun sinua pyydetään antamaan teemalle nimi, kirjoita Panorama Theme.

Aiheeseen liittyvät artikkelit

Ota yhteyttä tukeen