Engagen integrointi Canvasiin LTI 1.3:n avulla – YuJa-ohjekeskus

Ylläpitäjät voivat integroida Engagen Canvas-oppimisenhallintajärjestelmäänsä (LMS). Integraation avulla kyselyt voidaan luoda, julkaista ja arvioida suoraan Canvas-kursseilla, ja ylläpitäjät, opettajat ja opiskelijat voivat tarkastella niitä. Jos sinulla on kysyttävää tämän prosessin vaiheista, ota yhteyttä omaan asiakkuuspäällikköösi.

Engagen integrointi Canvasiin

Integrointiprosessi lisää Engagen kaikkiin Canvasin kursseihin. Varmista ennen integroinnin aloittamista, että olet saanut asiakkuuspäälliköltäsi seuraavat tiedot: Uudelleenohjauksen URL-osoite, Kohdelinkin URL-osoite, OpenID Connect -aloitus-URL, ja Julkinen JWK.

Kirjaudu Canvasiin ylläpitäjänä.
Valitse sivupalkista Ylläpitäjä ja valitse sitten oppilaitoksesi.
Valitse sivupalkista Kehittäjäavaimet.
Napsauta + Kehittäjäavain > + LTI-avain.
Syötä Avaimen asetukset -osiossa tiedot alla olevan kuvan mukaisesti.
- Avaimen nimi: Mikä tahansa nimi, jonka avulla avain on helppo tunnistaa.
- Uudelleenohjauksen URL-osoitteet: Asiakkuuspäällikön antamat uudelleenohjauksen URL-osoitteet.
- Menetelmä: Valitse Manuaalinen syöttö.
- Otsikko: Mikä tahansa nimi, jonka avulla avain on helppo tunnistaa.
- Kuvaus: Avaimen kuvaus.
- Kohdelinkin URL-osoite: Asiakkuuspäällikön antama kohdelinkin URI.
- OpenID Connect -aloitus-URL: Asiakkuuspäällikön antamat OpenID Connect -aloitus-URL-osoitteet.
- JWK-menetelmä: Valitse Julkinen JWK URL-osoite.
- Julkinen JWK URL-osoite: Asiakkuuspäällikön antama julkinen JWK URL-osoite.
Ota LTI Advantage -palvelut -osiossa käyttöön alla olevat kytkimet.
- Voi luoda ja tarkastella tehtävätietoja työkaluun liitetyssä arvosanakirjassa.
- Voi tarkastella tehtävätietoja työkaluun liitetyssä arvosanakirjassa.
- Voi tarkastella työkaluun liitettyjen tehtävien palautustietoja.
- Voi luoda ja päivittää työkaluun liitettyjen tehtävien palautusten tuloksia.
- Voi hakea sen kontekstin käyttäjätietoja, johon työkalu on asennettu.
Siirry Lisäasetukset -osioon, ja syötä alla näytetyt tiedot Mukautetut kentät -kenttään:
- canvas_user_id=$Canvas.user.id
- canvas_course_id=$Canvas.course.id
- person_sourcedid=$Person.email.primary
Valitse Tietosuojataso -osiossa Julkinen.
Valitse avattavasta Sijoitukset-valikosta Kurssin navigointi ja Tehtävän valinta.
Syötä Tehtävän valinta -osiossa tiedot alla olevan kuvan mukaisesti ja napsauta sitten Tallenna.
- Kohdelinkin URL-osoite: Sama kuin yllä syötetty uudelleenohjauksen URL-osoite.
- Valitse viestityyppi: LtiDeepLinkingRequest
- Valinnan korkeus: Suosittelemme arvoa 600.
- Valinnan leveys: Suosittelemme arvoa 800.
Etsi juuri luotu kehittäjäavain.
Kirjoita muistiin kehittäjäavaimen Tiedot-sarakkeessa näkyvä Asiakastunnus. Sitä tarvitaan useissa vaiheissa.
Ota Tila-kytkin käyttöön.
Valitse sivupalkista Asetukset.
Valitse Sovellukset-välilehti > + Sovellus.
Valitse avattavasta Määritystyyppi-valikosta Asiakastunnuksen mukaan.
Liitä Asiakastunnus-kenttään vaiheesta 12 kopioimasi Asiakastunnus ja napsauta sitten Lähetä.
Etsi ulkoinen YuJa Engage -sovellus.
Napsauta Hammasratas-painiketta > Käyttöönottotunnus.
Kopioi Käyttöönottotunnus. Sitä tarvitaan kohdassa Engage API:n määrittäminen.

Engage API:n määrittäminen

Kun olet lisännyt Engagen Canvasiin, sinun on määritettävä Engage API, jotta tietoja voidaan siirtää Canvasin ja Engagen välillä.

Kirjaudu Canvasiin ja valitse kurssisi.
Siirry Engageen.
Huomautus: Jos et löydä kohtaa Engage, oppilaitoksesi on voinut asettaa linkin toisella nimellä. Pyydä lisätietoja ylläpitäjältäsi tai opettajaltasi.
Valitse sivupalkista Integraatiot.
Valitse avattavasta Valitse integraatiotyyppi -valikosta LMS LTI 1.3.
Valitse avattavasta Valitse LMS -valikosta Canvas.
Syötä API-määritykset-osiossa tiedot alla olevan kuvan mukaisesti käyttäen osiossa Engagen integrointi Canvasiin muistiin kirjattuja työkalun määritystietoja.
- ISS: https://canvas.instructure.com
- Asiakastunnus: Asiakastunnus, joka kopioitiin osiossa Engagen integrointi Canvasiin.
- OpenID Connect -päätepiste: https://canvas.instructure.com/api/lti/authorize_redirect
- JWKS-päätepiste: https://canvas.instructure.com/api/lti/security/jwks
- OAuth2-tunnuspäätepiste: https://canvas.instructure.com/login/oauth2/token
- Käyttöönottotunnus: Käyttöönottotunnus, joka kopioitiin osiossa Engagen integrointi Canvasiin.
Ota Käyttäjän määritteet ja Kurssin määritteet -osioissa kytkimet käyttöön.
Napsauta Tallenna muutokset.

Kurssin osallistujaluettelon synkronoinnin integrointi

Kun integrointi on valmis, voit ottaa käyttöön kurssin osallistujaluettelon synkronoinnin, jolloin Engagen osallistujaluettelo päivittyy automaattisesti tietyn kurssin opiskelijaluettelolla. Ennen alla olevia vaiheita sinun on lisättävä Canvasiin käyttöoikeustunnus. Seuraa Canvasin opasta ja opi, miten oman käyttäjätilin API-käyttöoikeustunnuksia hallitaan.

Kirjaudu Engageen ylläpitäjänä.
Valitse sivupalkista Integraatiot.
Valitse avattavasta Valitse integraatiotyyppi -valikosta LMS - API.
Valitse avattavasta Valitse LMS -valikosta Canvas.
Syötä API-yhteys-osiossa tiedot alla olevan kuvan mukaisesti.
- LMS API-linkki: https://<YOUR_CANVAS_DOMAIN>/api/v1
  - Esimerkki: https://evergreen.canvas.com/api/v1
- Käyttöoikeustunnus: Napsauta Ohita syöttääksesi tunnuksen, joka kopioitiin osiossa Engage API:n määrittäminen.
Säädä tarvittaessa muita linkityksen asetuksia alla olevan kuvan mukaisesti.
- Canvas-kurssi: Valitse Canvas-kurssitunniste.
- Canvas-käyttäjät: Valitse Canvas-käyttäjätunnus tai Ensisijainen sähköposti.
- Käytä sähköpostia varakenttänä: Ota käyttöön Käytä sähköpostia varakenttänä -kytkin.
Napsauta Tallenna muutokset.