YuJa Panoraman integrointi D2L Brightspaceen LTI 1.3:n avulla – YuJa-ohjekeskus

Tässä ohjeessa kerrotaan, miten Panorama-saavutettavuusalusta integroidaan D2L-oppimisenhallintajärjestelmääsi (LMS). Varmista ennen alla olevien vaiheiden aloittamista, että sinulla on täydet järjestelmänvalvojan käyttöoikeudet D2L Brightspace -ympäristöösi. Jos sinulla on kysyttävää tämän prosessin vaiheista, ota yhteyttä nimettyyn asiakkuuspäällikköösi.

YuJa Panoraman lisääminen D2L Brightspaceen

Ensimmäinen vaihe YuJa Panoraman integroinnissa on tehdä YuJa Panoraman LTI-linkki saataville D2L Brightspace -ympäristössäsi.

Kirjaudu D2L Brightspaceen järjestelmänvalvojana.
Napsauta oikeassa yläkulmassa Hammasratas-kuvaketta.
Napsauta kohdassa Organisaatioon liittyvät vaihtoehtoa Hallitse laajennettavuutta.
Napsauta yläpalkissa kohtaa LTI Advantage.
Napsauta Rekisteröi työkalu.
Valitse kohdassa ”Miten haluat rekisteröidä työkalusi?” Vakio napsauttamalla sen vieressä olevaa valintanappia. Tämä laajentaa rekisteröintilomakkeen.
Anna työkalusi nimeksi YuJa Panorama LTI 1.3.
Tietyt kentät edellyttävät vyöhykkeesi URL-osoitteen antamista. Katso oikea vyöhyke-URL alla olevasta luettelosta:
- Yhdysvaltain vyöhyke: https://panorama-api.yuja.com
- Kanadan vyöhyke: https://panorama-api-cz.yuja.com
- EU-vyöhyke: https://panorama-api-ez.yuja.com
- Australian vyöhyke: https://panorama-api-az.yuja.com
Anna toimialueeksi https://<YOUR_ZONE_URL>/lti/lti-app-1.3-entry
Anna alla oleviin kenttiin seuraavat URL-osoitteet ja napsauta sitten Rekisteröi.
- Uudelleenohjauksen URL-osoitteet: https://<YOUR_ZONE_URL>/lti/lti-app-1.3-entry
- OpenID Connect -kirjautumisen URL-osoite: https://<YOUR_ZONE_URL>/lti/lti-app-1.3-oidc-initiation
- Kohdelinkin URL-osoite: https://<YOUR_ZONE_URL>/lti/lti-app-1.3-entry
- Avainjoukon URL-osoite: https://<YOUR_ZONE_URL>/lti/lti-app-1.3-jwk
Kirjoita muistiin kaikki ikkunassa näkyvät Brightspacen rekisteröintitiedot. Sinun on annettava nämä tiedot YuJa Panorama -tililläsi tämän ohjeen seuraavassa osiossa.
Siirry Ulkoiset oppimistyökalut -sivulle napsauttamalla Näytä käyttöönotot.
Napsauta Uusi käyttöönotto.
Valitse, kytketäänkö päälle asetus Siirrä linkit automaattisesti. Ota asetus käyttöön, jos haluat sisällyttää tämän työkalun vanhat LTI-linkit kurssin kopiointiin ja painikesiirtoon.
Valitse kohdan Työkalu pudotusvalikosta aiemmin luotu LTI-työkalu: YuJa Panorama LTI 1.3.
Anna kenttään Nimi työkalun nimi, esimerkiksi YuJa Panorama.
Valitse kohdassa Turva-asetukset seuraavat valintaruudut:
- Käyttäjätiedot
- Nimi
- Etunimi
- Toinen nimi
- Sukunimi
- Sähköposti
- Käyttäjätunnus
- Käyttäjänimi
- Organisaation määrittelemä tunnus
Valitse kohdassa Määritysasetukset vaihtoehto Avaa ulkoisena resurssina.
Napsauta Lisää organisaatioyksiköt lisätäksesi kurssit, joilla haluat LTI-sovelluksen toimivan.
Valitse avautuvassa ikkunassa kurssit, jotka haluat lisätä, ja napsauta Lisää.
Kun olet lisännyt kaikki haluamasi kurssit, napsauta Luo käyttöönotto.
Kopioi ikkunassa näkyvä Käyttöönoton tunnus. Sinun on annettava nämä tiedot YuJa Panorama -tililläsi tämän ohjeen seuraavassa osiossa.
Napsauta Näytä linkit.
Napsauta Uusi linkki.
Anna kenttään Nimi linkin nimi, esimerkiksi YuJa Panorama.
Anna kenttään URL-osoite, vyöhykkeesi mukainen URL-osoite.
- Yhdysvaltain vyöhyke: https://panorama-api.yuja.com/lti/lti-app-1.3-entry
- Kanadan vyöhyke: https://panorama-api-cz.yuja.com/lti/lti-app-1.3-entry
- EU-vyöhyke: https://panorama-api-ez.yuja.com/lti/lti-app-1.3-entry
- Australian vyöhyke: https://panorama-api-az.yuja.com/lti/lti-app-1.3-entry
Valitse kohdan Tyyppi pudotusvalikosta Peruskäynnistys.
Napsauta Tallenna ja sulje ja siirry sitten tämän ohjeen seuraavaan osioon.

YuJa Panoraman määrittäminen D2L Brightspacea varten

Ennen kuin jatkat alla oleviin vaiheisiin, sinun on täytynyt saada asiakkuuspäälliköltäsi sähköposti, jossa sinua pyydetään rekisteröimään YuJa Panorama -tilisi. Rekisteröi tilisi ja jatka sitten alla oleviin vaiheisiin.

Kirjaudu YuJa Panorama -tilillesi.
Napsauta Konfigurointi ja valitse sitten Integraatioasetukset.
Valitse kohdan Valitse integraatio pudotusvalikosta LTI 1.3.
Anna tiedot alla olevan mukaisesti:
- Asiakastunnus: Tämän ohjeen edellisen osion vaiheessa 11 saatu asiakastunnus.
- Käyttöönoton tunnus: Tämän ohjeen edellisen osion vaiheessa 22 saatu käyttöönoton tunnus.
- ISS: Tämän ohjeen edellisen osion vaiheessa 11 saatu myöntäjä (Issuer).
- OpenID Connect -päätepiste: Tämän ohjeen edellisen osion vaiheessa 11 saatu OpenID Connect -todennuspäätepiste.
- JWKS-päätepiste: Tämän ohjeen edellisen osion vaiheessa 11 saatu Brightspacen avainjoukon URL-osoite.
Napsauta Tallenna muutokset.

YuJa Panorama LTI 1.3 -linkin lisääminen navigointipalkkiin

Jatka tähän ohjeen osioon, kun YuJa Panorama on lisätty onnistuneesti D2L Brightspace -ympäristöösi.

Kirjaudu D2L Brightspaceen järjestelmänvalvojana tai opettajana ja siirry kurssille, johon haluat lisätä YuJa Panorama LTI -linkin.
Napsauta seuraavaksi Lisää toimintoja -kuvaketta > Muokkaa tätä navigointipalkkia.
Kirjoita kenttään Nimi navigointipalkin nimi.
Napsauta Lisää linkit.
Napsauta Luo mukautettu linkki.
Kirjoita Nimi -kenttään YuJa Panorama ja napsauta sitten Lisää pikalinkki.
Etsi ja valitse Ulkoiset oppimistyökalut kurssimateriaalien luettelosta.
Etsi YuJa Panorama -työkalu hakupalkin avulla.
Lisää työkalu mukautettuun linkkiin napsauttamalla sitä.
Aseta toiminnaksi Sama ikkuna.
Napsauta Luo lisätäksesi YuJa Panorama -työkalun navigointipalkkiin.
Kun Lisää linkit -ikkuna avautuu uudelleen, napsauta Lisää.
YuJa Panorama -linkin pitäisi nyt näkyä kohdassa Linkit. Tallenna linkki navigointipalkkiin napsauttamalla Tallenna ja sulje.

Roolin luominen käyttöoikeuksilla

YuJa Panorama tarvitsee käyttöoikeustunnuksen (access token) tiedostojen skannaamiseen ja lataamiseen D2L Brightspacesta. Jotta käyttöoikeustunnus toimii, järjestelmänvalvojien on ladattava vähimmäisvaatimusten luettelo ja lähetettävä se palvelimeen D2L Brightspace -vyöhykkeelleen. Ennen vähimmäisvaatimusten luettelon lähettämistä suosittelemme luomaan vaatimuksiin liittyvän uuden roolin, jotta muihin käyttäjiin ei vaikuteta.

Kirjaudu D2L Brightspaceen järjestelmänvalvojana.
Napsauta Hammasratas-kuvaketta.
Valitse kohdassa Suojaus Roolit ja käyttöoikeudet.
Napsauta Luo/Kopioi.
Napsauta Aloita alusta. (Valinnainen) Voit halutessasi luoda kopion olemassa olevasta roolista.
Täytä tiedot alla olevan mukaisesti.
- Nimi: Mikä tahansa valitsemasi tunnistettava nimi.
- Kaskadoiva: Varmista, että tämä on valittuna.
- Kurssin käyttöoikeusvaihtoehdot
  - Pääsy ei-aktiivisiin kursseihin: Varmista, että tämä on valittuna.
  - Pääsy menneisiin kursseihin: Varmista, että tämä on valittuna.
  - Pääsy tuleviin kursseihin: Varmista, että tämä on valittuna.
  - Osiot: Pääsy kaikkiin kurssin osioihin
  - Ryhmät: Pääsy kaikkiin kurssiryhmiin
Napsauta Tallenna.
Valitse Muokkaa roolin vuorovaikutuksia -sivulla kaikki ruudut kohdasta Järjestelmänvalvoja.
Napsauta Tallenna luodaksesi roolin.

Vähimmäisvaatimusten luettelon lähettäminen palvelimeen

Ennen kuin jatkat alla oleviin vaiheisiin, voit avata ja ladata vähimmäisvaatimusten luettelon täältä.

Kirjaudu D2L Brightspaceen järjestelmänvalvojana.
Napsauta Hammasratas-kuvaketta.
Valitse kohdassa Suojaus Roolit ja käyttöoikeudet.
Etsi tämän ohjeen edellisessä osiossa luomasi rooli ja valitse roolin nimen vieressä oleva pudotusvalikon nuoli.
Valitse Tuo käyttöoikeudet.
Napsauta Valitse tiedosto ja valitse tiedosto, jonka latasit täältä. Etsi tiedosto laitteeltasi ja lähetä se palvelimeen valitsemalla se.
Napsauta Seuraava.
Viimeistele prosessi napsauttamalla Tuo.

YuJa Panoraman rekisteröinti D2L Brightspace -sovellukseksi

Rekisteröi YuJa Panorama sovellukseksi D2L Brightspaceen saadaksesi sovellustunnuksen ja sovellusavaimen, joita käytetään D2L Brightspacen integroinnissa YuJa Panoramaan.

Kirjaudu D2L Brightspaceen järjestelmänvalvojana.
Napsauta oikeassa yläkulmassa Hammasratas-kuvaketta.
Valitse kohdassa Suojaus vaihtoehto Roolit ja käyttöoikeudet.
Napsauta kohdassa Roolilista, roolia Järjestelmänvalvoja.
Valitse kohdan Suodata työkalun mukaan pudotusvalikosta Sisältö ja napsauta Käytä suodatinta.
Valitse ylimmältä riviltä Organisaatio, Kurssimalli, Kurssitoteutus, Ryhmä, Lukukausi, Osio ja Osasto.
Napsauta Tallenna.
Toista vaiheet 5-7 valitsemalla Kurssin rakentaja, Kurssinhallintakonsoli, ja Ulkoiset oppimistyökalut kohdan Suodata työkalun mukaan pudotusvalikosta.
Napsauta seuraavaksi oikeasta yläkulmasta Hammasratas-kuvaketta.
Napsauta kohdassa Organisaatioon liittyvät, vaihtoehtoa Hallitse laajennettavuutta.
Varmista, että välilehti ID-avaintodennus on valittuna, ja napsauta Rekisteröi sovellus.
Anna kenttään Sovelluksen nimi, nimi, esimerkiksi YuJa Panorama.
Kopioi ja liitä kenttään Luotettu URL-osoite, vyöhykkeesi mukainen oikea URL-osoite:
- Yhdysvaltain vyöhyke: https://panorama-api.yuja.com/d2l-auth
- Kanadan vyöhyke: https://panorama-api-cz.yuja.com/d2l-auth
- EU-vyöhyke: https://panorama-api-ez.yuja.com/d2l-auth
- Australian vyöhyke: https://panorama-api-az.yuja.com/d2l-auth
Valitse Ota tämä sovellus käyttöön ja Hyväksyn API-kehittäjäsopimuksen.
Napsauta Rekisteröi sovellus.
Kun olet rekisteröinyt YuJa Panorama -sovelluksen, sinut ohjataan juuri luotuun sovellukseen. Kirjoita muistiin Sovellustunnus ja Sovellusavain, koska niitä tarvitaan tämän ohjeen seuraavassa osiossa.

D2L Brightspacen integroiminen YuJa Panoramaan

Kun olet kirjoittanut muistiin sovellustunnuksen ja sovellusavaimen edellisestä osiosta, viimeinen vaihe on muodostaa yhteys D2L Brightspace -ympäristösi ja YuJa Panoraman välille, jotta YuJa Panorama voi hakea tietoja.

Kirjaudu YuJa Panorama -tilillesi.
Napsauta Konfigurointi ja valitse sitten Integraatioasetukset.
Valitse kohdan Valitse integraatio pudotusvalikosta LMS API yhteys.
Napsauta Lisää pääsyavain.
Liitä kenttiin Sovellustunnus ja Sovellusavain vaiheessa 16 saamasi arvot ohjeen osiosta YuJa Panoraman rekisteröinti D2L Brightspace -sovellukseksi.
Napsauta Autentikoi sovelluksen kanssa.
Uusi välilehti avautuu, ja siinä näkyy JSON-vastauksesi. Kopioi vastaus ja liitä se tekstikenttään Sovelluksen todennuksen JSON-vastaus.
Napsauta Lisää pääsyavain.
Napsauta Tallenna muutokset. YuJa Panorama voi nyt hakea tietoja D2L Brightspace -ympäristöstäsi. Jotta YuJa Panoraman sisältö, kuten Vaihtoehtoiset muodot -valikko ja Saavutettavuusraportti, näkyy D2L Brightspacen sisällä, sinun on asennettava YuJa Panorama D2L Brightspace Visualizer.