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

Panoraman integroiminen Canvasiin LTI 1.1:n avulla

Avatar
YuJa
  • Päivitetty

Tämä asiakirja sisältää ohjeet Panorama-alustan integroimiseen LTI 1.1 -pohjaiseen Canvas-oppimisenhallintajärjestelmääsi (LMS). Varmista ennen alla olevien vaiheiden aloittamista, että sinulla on ylläpitäjänä täydet käyttöoikeudet Canvas-ympäristöösi. Jos sinulla on kysyttävää jonkin tämän prosessin vaiheen osalta, ota yhteyttä nimettyyn asiakaspäällikköösi.

 

Kuluttaja-avaimen, LTI-salaisuuden ja XML-tiedoston hankkiminen integraatiota varten 

Ennen kuin jatkat alla oleviin vaiheisiin, sinun tulee olla saanut asiakaspäälliköltäsi sähköposti, jossa sinua pyydetään luomaan Panorama-tilisi. Luo tilisi ja jatka sitten alla oleviin vaiheisiin. 

  1. Kirjaudu Panorama-tilillesi.
  2. Napsauta Konfigurointi vasemmanpuoleisesta valikosta ja valitse sitten Integraatioasetukset.

  3. Valitse LTI 1.1.

  4. Napsauta Lataa LTI 1.1 XML, ja kopioi sitten Kuluttaja-avain ja LTI-salaisuus. Niitä tarvitaan tämän oppaan seuraavassa osiossa.

Asiakasavaimen ja 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 alue: https://panorama-api.yuja.com/canvas-auth
      • Kanadan alue: https://panorama-api-cz.yuja.com/canvas-auth
      • EU-alue: https://panorama-api-ez.yuja.com/canvas-auth
      • Australian alue: 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ää Panoraman integroimista Canvas API:in uudelleen aina, kun Panorama lisää uusia toimintoja, jotka käyttävät API:a. Jos et halua jatkaa tällä tavalla, varmista, että Pakota käyttöalueet on poistettu käytöstä, ja siirry sitten vaiheeseen 5. 
  4. Valitse Salli sisällytettävät parametrit ja valitse sitten seuraavat parametrit:
    3.png
    • Accounts
      • 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
    • Admins
      • url:GET|/api/v1/accounts/:account_id/admins
    • Assignments
      • 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
    • Courses
      • 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
    • Discussion Topics
      • 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
    • Enrollments
      • url:GET|/api/v1/users/:user_id/enrollments
      • url:GET|/api/v1/courses/:course_id/enrollments 
    • Enrollment Terms
      • url:GET|/api/v1/accounts/:account_id/terms
      • url:GET|/api/v1/accounts/:account_id/terms/:id
    • Files
      • 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
    • Pages
      • 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
    • Quizzes
      • 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
    •  Roles
      • url:GET|/api/v1/accounts/:account_id/roles
      • url:GET|/api/v1/accounts/:account_id/roles/:id
    • Rubrics
      • url:GET|/api/v1/courses/:course_id/rubrics
      • url:GET|/api/v1/courses/:course_id/rubrics/:id
    • LTI Resource Links
      • 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 vasemmanpuoleisesta valikosta Konfigurointi > Integraatioasetukset.
    7.png
  9. Avaa Valitse integraatio -pudotusvalikko ja valitse LMS API -yhteys.
  10. Napsauta Lisää pääsyavain.
    9.png
  11. Valitse Canvasin todennustavaksi Asiakastunnus.
  12. Kirjoita Asiakastunnus -kenttään vaiheen 8 tunnus.
  13. Kirjoita Asiakkaan salaisuus -kenttään 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 Canvasilla.
    Huomautus: Varmista, että olet kirjautunut Canvasiin ylläpitäjänä, jolla on täydet oikeudet.
  16. Napsauta Valtuuta.
    13.png
  17. Kopioi todennusvastaus ja palaa Panoramaan. Liitä vastaus Canvas-todennuksen vastaus -kenttään.
  18. Napsauta Lisää pääsyavain.
  19. Viimeistele määritys napsauttamalla Tallenna muutokset .
    15.png

Panoraman lisääminen Canvasiin

Kun olet saanut kuluttaja-avaimen, salaisen avaimen ja XML-määrityksen, voit lisätä Panoraman Canvas-ympäristöösi.

  1. Kirjaudu Canvasiin ylläpitäjänä. Napsauta vasemmasta sivupalkista Ylläpito ja valitse oppilaitoksesi Canvas-tili.
  2. Napsauta Asetukset > Sovellukset > Näytä sovellusmääritykset.
  3. Napsauta + Sovellus, täytä seuraavat tiedot ja viimeistele sitten Panoraman määritys Canvasille napsauttamalla Lähetä.
     
    • Määrityksen tyyppi: Liitä XML
    • Nimi: Panorama Configuration
    • Kuluttaja-avain: Saatu tämän oppaan ensimmäisessä osiossa.
    • Salainen avain: LTI-salaisuus, joka saatiin tämän oppaan ensimmäisessä osiossa.
    • XML-määritys: Avaa tämän oppaan ensimmäisessä osiossa ladattu XML-tiedosto. Kopioi sen sisältö tekstieditorissa, kuten Notepadissa, ja liitä se tähän.

LMS Visualizerin asentaminen

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ä Canvas-asiakaspäällikköösi. LMS Visualizer mahdollistaa Panoraman saavutettavuuskuvakkeiden näyttämisen. 

  1. Kirjaudu Panorama-tilillesi.
  2. Napsauta Konfigurointi > Integraatioasetukset.
  3. Valitse LMS Visualizer > Lataa Visualizer.
  4. Kirjaudu seuraavaksi Canvasiin ylläpitäjänä. Napsauta vasemmasta sivupalkista Ylläpito ja valitse tili, johon YuJa Panorama - LMS Viewer otetaan käyttöön.
  5. Valitse vasemmasta siirtymispalkista Asetukset ja varmista, että ylärivillä on valittuna Asetukset-välilehti.
     
  6. Vieritä alas Ominaisuudet -osioon.
    • Jos vaihtoehto Mukautetut CSS/JavaScript-ohitukset on käytettävissä, varmista, että se on valittuna. Vieritä sitten alas ja napsauta Päivitä asetukset.
    • Jos vaihtoehto Mukautetut CSS/JavaScript-ohitukset ei ole käytettävissä, pyydä Canvas-asiakaspäällikköäsi ottamaan Mukautetut CSS/JavaScript-ohitukset käyttöön teemaeditorissa.
  7. Napsauta seuraavaksi vasemmasta siirtymispalkista Teemat ja valitse sitten + Teema -painike. Valitse mikä tahansa teemapohja pudotusvalikosta.
  8. Siirry Canvas-teemaeditori-työkalussa Lähetä -välilehdelle ja valitse vaiheessa 3 lataamasi Canvas Visualizer-tiedosto. Tärkeää: Lähetä -välilehti on käytettävissä vasta, kun asiakaspäällikkösi ottaa sen käyttöön.
  9. Napsauta seuraavaksi Esikatsele muutoksia, ja valitse sitten Käytä teemaa. Kun sinua pyydetään antamaan teemalle nimi, kirjoita Panorama Theme.

Panoraman poistaminen Canvas-ympäristöstä

Jotta Panorama voidaan poistaa Canvas-ympäristöstä, ylläpitäjän on poistettava LTI-sovellus ja LMS Viewer. Ohjeet näiden ominaisuuksien poistamiseen ovat alla. 

  1. Kirjaudu Canvasiin ylläpitäjänä. Napsauta vasemmasta sivupalkista Ylläpito ja valitse organisaatiosi Canvas-tili.
  2. Valitse Asetukset vasemmasta siirtymispalkista.
  3. Valitse ylärivistä Sovellukset -välilehti ja napsauta sitten Näytä sovellusmääritykset.
  4. Valitse LTI Panorama -sovelluksen rataskuvake ja napsauta Poista.
  5. Vahvista työkalun poisto ja poista Panorama-integraatio käytöstä LTI 1.1:lle valitsemalla Poista . 
  6. Lopuksi ylläpitäjänä sinun on poistettava LMS Viewer napsauttamalla siirtymisvalikosta kohtaa Teemat .
  7. Valitse seuraavaksi Panorama-teema, ja napsauta Avaa teemaeditorissa.
  8. Napsauta vasemmasta paneelista Lähetä.
  9. Napsauta kohdassa JavaScript-tiedosto, olevaa X -merkkiä poistaaksesi Panoraman komentosarjan.
  10. Napsauta Tallenna teema. Panorama on nyt poistettu onnistuneesti Canvas-ympäristöstä.

Aiheeseen liittyvät artikkelit

Ota yhteyttä tukeen