Siirry YuJaan
  1. YuJa-ohjekeskus
  2. Lumina-videoalusta
  3. Hallintapaneeli
  4. LMS-alustaintegraatio
  5. Instructure Canvas -integraatio

Instructure Canvas API:n integroiminen Lumina-videoalustaan

Avatar
YuJa
  • Päivitetty

Tässä ohjeessa kerrotaan, miten Canvas Instructure API integroidaan Lumina-videoalustaan. Järjestelmänvalvojat voivat integroida Instructure Canvas API:n ja synkronoida kaikki tiedot Canvasista Luminaan automaattisesti. 

Canvas-asiakastunnuksen ja API-avainten luominen

Alla olevien ohjeiden avulla käyttäjät voivat luoda uuden Canvas-asiakastunnuksen ja API-avaimen, jota voidaan käyttää Luminaan integroimiseen.

  1. Kirjaudu Canvasiin järjestelmänvalvojana.

  2. Avaa välilehti Järjestelmänvalvoja ja valitse Kehittäjäavaimet. Napsauta + Kehittäjäavain-painiketta ja valitse + API-avain.

    Instructure Canvas Guide 1.png

  3. Syötä tiedot alla olevan kuvan mukaisesti ja napsauta sitten Tallenna.

    Enforces scope.png
  • Avaimen nimi: Canvas Auto Sync Key

  • Uudelleenohjauksen URI-osoitteet: https://<YOUR_YUJA_DOMAIN>/auth/Canvas

    • 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
    • (Valinnainen) Ota käyttöön Pakota käyttöalueet.

    Huomautus: Emme suosittele käyttöalueiden pakottamista. Se edellyttää, että Panorama integroidaan uudelleen Canvas API:n kanssa aina, kun Panorama lisää uutta toiminnallisuutta, joka käyttää API:a. Jos et halua edetä näin, varmista, että Pakota käyttöalueet on poistettu käytöstä. 

    Suositellut käyttöalueet: 

    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

    Users
    url:GET|/api/v1/accounts/:account_id/users
    url:GET|/api/v1/users/:id/profile

    Roles
    url:GET|/api/v1/accounts/:account_id/roles

    Enrollments
    url:GET|/api/v1/courses/:course_id/enrollments

    Groups
    url:GET|/api/v1/courses/:course_id/groups
    url:GET|/api/v1/groups/:group_id/users

    Assignments
    url:GET|/api/v1/courses/:course_id/assignments
    url:GET|/api/v1/courses/:course_id/assignments/:id

  1. Aseta tilaksi Päällä ja kopioi talteen Canvasin asiakastunnus myöhempää käyttöä varten.

    Instructure Canvas Guide 3.png

  2. Napsauta seuraavaksi Näytä avain ja kopioi talteen Canvasin API-avain myöhempää käyttöä varten.

    Instructure Canvas Guide 4.png

Canvas API:n integrointi videoalustaan

Seuraavissa vaiheissa juuri hankittu Canvas API -avain integroidaan videoalustaan.

  1. Kirjaudu videoalustaan järjestelmänvalvojana, ja siirry sitten kohtaan Hallintapaneeli.

    Videoalusta, jossa Hallintapaneeli-vaihtoehto näkyy päävalikkokuvakkeen alla.
  2. Napsauta Integraatiot, ja valitse sitten LMS API -yhteys avattavasta Valitse integraatio -luettelosta.
  3. Syötä seuraavat tiedot ja napsauta sitten Tallenna.
    • Valitse LMS: Canvas
    • LMS:n URL-osoite: https://<YOUR_CANVAS_DOMAIN> (Katso aluekohtaiset osoitteet edellisen osion vaiheesta 3.)
    • Asiakastunnus: Syötä yllä olevassa osiossa saamasi Canvas-asiakastunnus.

    • Asiakkaan salaisuus: Syötä yllä olevassa osiossa saamasi Canvas API -avain.

      Instructure Canvas Guide 6.png

  4. Napsauta Salli API-käyttöoikeus.

    Instructure Canvas Guide 7.png

  5. Kun olet kirjautuneena Canvasiin järjestelmänvalvojana, valitse Valtuuta antaaksesi Luminalle pääsyn Canvas API:in.

    Instructure Canvas Guide 8.png

Canvas API -kutsujen hallinta

Kun Canvas API on määritetty, järjestelmänvalvojat voivat mukauttaa, mitkä tiedot synkronoidaan Canvasista Luminaan. Yleisesti suosittelemme, että organisaatiot ottavat kaikki synkronointiasetukset käyttöön tämän toiminnon hyödyntämiseksi.

  1. Ota käyttöön haluamasi vaihtoehdot, jotka järjestelmänvalvojat voivat synkronoida Canvasista Luminaan.

    Instructure Canvas Guide 9.png
    • Ota käyttöön Canvas-kurssien synkronointi: Kaikki organisaatiosi Canvasin kurssit synkronoidaan videoalustaan päivittäin.
    • Ota käyttöön Canvas-käyttäjien synkronointi: Kaikki organisaatiosi Canvasin käyttäjät, jotka ovat ilmoittautuneet Canvas-kurssille, synkronoidaan videoalustaan päivittäin. Jos käyttäjällä on kaksi eri roolia Canvasissa, videoalusta antaa hänelle ylemmän roolin. 
    • Ota käyttöön Canvas-ilmoittautumisten synkronointi: Kaikki organisaatiosi Canvasin uudet käyttäjäilmoittautumiset synkronoidaan videoalustaan päivittäin.
    • Ota käyttöön Canvas-mukautettujen ryhmien synkronointi: Kaikki Canvas-mukautetut ryhmät tuodaan organisaatiosi Canvasista videoalustaan päivittäin.
    • Ota Canvas-alitilin synkronointi käyttöön: Kaikki organisaatiosi liittyvät Canvas-alitilit tuodaan videoalustaan päivittäin.
    • Aloita synkronoinnit: Synkronoi kaikki yllä olevat käyttöön otetut vaihtoehdot organisaatiosi Canvasista videoalustaan heti.
  2. Napsauta Tallenna muutokset ottaaksesi kaikki muutokset käyttöön.

Canvas API -kutsujen ilmoitusten määrittäminen 

Järjestelmänvalvojat voivat määrittää käyttäjän, joka saa kaikki Canvas API -kutsujen ilmoitukset.

  1. Anna Ilmoitukset-osiossa sen YuJa-käyttäjän tunnus, jonka kautta haluat vastaanottaa ilmoituksia.

    Instructure Canvas Guide 10.png
  2. Napsauta Tallenna muutokset ottaaksesi kaikki muutokset käyttöön.

Canvas API:n linkitysasetusten määrittäminen

Järjestelmänvalvojat voivat määrittää linkitysasetukset, jotta kurssit ja käyttäjät voidaan luoda Luminaan Canvasista Canvas API:n kautta. 

Instructure Canvas Guide 11.png

  1. Valitse kohdassa Canvas-kurssit Käytä kurssikoodia ja lukukautta varakenttinä, jos Canvas-kurssitunnusta ei löydy -valintaruutu.

    Huomautus: Jos haluat hakea vain LTI:n kautta luotuja videoalustan kursseja, valitse Jätä huomiotta ei-LTI-YuJa-kurssit synkronoitaessa Canvas-kursseja -valintaruutu.

  2. Valitse kohdassa Canvas-käyttäjät avattavasta valikosta Ensisijainen linkitysmäärite.

  3. Valitse Käytä käyttäjän sähköpostiosoitetta ja nimeä varakenttinä, jos Canvas-käyttäjätunnusta ei löydy -valintaruutu. 

    Huomautus: Jos haluat hakea vain LTI:n kautta luotuja videoalustan käyttäjiä, valitse Jätä huomiotta ei-LTI-YuJa-käyttäjät synkronoitaessa Canvas-käyttäjiä -valintaruutu.

  4. Napsauta Tallenna muutokset ottaaksesi kaikki muutokset käyttöön.

Aiheeseen liittyvät artikkelit

Ota yhteyttä tukeen