Siirry YuJaan
  1. YuJa-ohjekeskus
  2. Verity-koevalvonta-alusta
  3. Integraatiot

YuJa Verity -koevalvonta-alustan integrointi Canvasiin

Avatar
YuJa
  • Päivitetty

Tämä asiakirja sisältää järjestelmänvalvojille ohjeet Verity-koevalvonta-alustan integroimiseen Canvasiin LTI 1.3:a käyttäen. Varmista ennen alla olevien vaiheiden aloittamista, että sinulla on järjestelmänvalvojana täydet käyttöoikeudet Canvas-instanssiisi. Jos sinulla on kysyttävää prosessista, ota yhteyttä omaan asiakkuuspäällikköösi.

Huomautus: Integraatiota varten on erittäin suositeltavaa luoda Canvasiin erillinen palvelutili. Tämä helpottaa sen tunnistamista, mitkä toimet on tehnyt integraatio ja mitkä ihmisen toimiva järjestelmänvalvoja, mikä auttaa välttämään sekaannuksia tai tahattomia muutoksia.

 

Verityn lisääminen Canvasiin

Järjestelmänvalvojana voit integroida Verityn Canvasiin lisäämällä JSON-URL-osoitteen kehittäjäavaimiin.

  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. Kirjoita Avainasetukset-sivulla avaimelle nimi (esim. YuJa Verity).
  5. Valitse Menetelmä-pudotusvalikosta Syötä URL-osoite.

  6. Kirjoita JSON-URL-osoite-kenttään jokin seuraavista URL-osoitteista sijaintisi mukaan: 

    Yhdysvaltain alue: https://zone1.verity.yuja.com/api/verity/lti/config/canvas.json 

    Australian alue: https://az.verity.yuja.com/api/verity/lti/config/canvas.json 

  7. Napsauta Tallenna.
  8. Etsi Kehittäjäavaimet-sivulta lisäämäsi Verity-avain.
  9. Varmista, että Tila-kentän kytkin on asennossa Päällä. Jos näkyviin tulee ponnahdusikkuna Ota kehittäjäavain käyttöön, napsauta Vaihda tilaan Päällä. 
  10. Napsauta Näytä Canvas-sovelluksissa. Uusi Canvas-ikkuna avautuu.
    toggle and view in canva app.png

  11. Napsauta Avaa sovelluksen lukitus.

  12. Napsauta ponnahdusikkunassa Avaa lukitus.

  13. Napsauta seuraavaksi kuvaketta Muokkaa saatavuutta (kynä). 
  14. Vaihda tilaksi Saatavilla, ja napsauta sitten Tallenna. Siirry osioon API-avaimen salaisuuden luominen viimeistelläksesi integroinnin.

API-avaimen salaisuuden luominen

  1. Napsauta + Kehittäjäavain > API-avain.
    API key.png
  2. Kirjoita seuraavat tiedot:
    • Avaimen nimi: Verity API Integration
    • Uudelleenohjauksen URL-osoitteet: https://<zoneURL>/api/verity/oauth/callback
      • Yhdysvaltain alue: https://zone1.verity.yuja.com/api/verity/oauth/callback
      • Australian alue: https://az.verity.yuja.com/api/verity/oauth/callback

  3. (Valinnainen) Ota käyttöön Pakota laajuudet.
    Huomautus: Emme suosittele laajuuksien pakottamista. Se edellyttää, että Verity integroidaan Canvas API:in uudelleen aina, kun Verity lisää uutta, API:a käyttävää toiminnallisuutta. Lisäksi jos laajuudet ovat käytössä, Verity Mobile Lockdown -sovellusta ei tueta. Jos oppilaitoksesi käyttää Verity Mobile Lockdown -sovellusta, laajuudet on poistettava käytöstä. 

    Jos et halua jatkaa tällä tavalla, varmista, että Pakota laajuudet on poistettu käytöstä, ja siirry sitten vaiheeseen 5. 

  4. Valitse Salli sisällytysparametrit ja valitse sitten seuraavat parametrit:
    • Tilit: 
      • url:GET|/api/v1/accounts
      • url:GET|/api/v1/accounts/:id
      • url:GET|/api/v1/manageable_accounts
      • url:GET|/api/v1/course_creation_accounts
      • url:GET|/api/v1/course_accounts
      • url:GET|/api/v1/accounts/:account_id/sub_accounts
      • url:GET|/api/v1/accounts/:account_id/permissions
      • url:GET|/api/v1/accounts/:account_id/courses
    • Tehtävät: 
      • url:GET|/api/v1/courses/:course_id/assignments
      • url:GET|/api/v1/courses/:course_id/assignments/:id
      • url:POST|/api/v1/courses/:course_id/assignments
      • 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/accounts/:account_id/courses/:id
      • url:GET|/api/v1/users/:user_id/courses
      • url:GET|/api/v1/courses/:course_id/users
      • url:GET|/api/v1/courses/:course_id/users/:id
    • Ulkoiset työkalut: 
      • url:GET|/api/v1/courses/:course_id/external_tools/:external_tool_id
      • url:GET|/api/v1/courses/:course_id/external_tools
      • url:GET|/api/v1/courses/:course_id/external_tools/sessionless_launch
      • url:GET|/api/v1/accounts/:account_id/external_tools/sessionless_launch
    • Uuden tentin kohteet: 
      • url:GET|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id/items/:item_id
      • url:GET|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id/items
      • url:POST|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id/items
      • url:PATCH|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id/items/:item_id
    • Tentit: 
      • url:GET|/api/v1/courses/:course_id/quizzes
      • url:GET|/api/v1/courses/:course_id/quizzes/:id
      • url:POST|/api/v1/courses/:course_id/quizzes
      • url:PUT|/api/v1/courses/:course_id/quizzes/:id
      • url:GET|/api/v1/courses/:course_id/quizzes/:quiz_id/questions
      • url:GET|/api/v1/courses/:course_id/quizzes/:quiz_id/questions/:id
      • url:POST|/api/v1/courses/:course_id/quizzes/:quiz_id/questions
      • url:PUT|/api/v1/courses/:course_id/quizzes/:quiz_id/questions/:id
      • url:POST|/api/v1/courses/:course_id/quizzes/:id/validate_access_code
      • url:GET|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id
      • url:GET|/api/quiz/v1/courses/:course_id/quizzes
      • url:POST|/api/quiz/v1/courses/:course_id/quizzes
      • url:PATCH|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id
    • Tentin kysymykset: 
      • url:GET|/api/v1/courses/:course_id/quizzes/:quiz_id/questions
      • url:GET|/api/v1/courses/:course_id/quizzes/:quiz_id/questions/:id
      • url:POST|/api/v1/courses/:course_id/quizzes/:quiz_id/questions
      • url:PUT|/api/v1/courses/:course_id/quizzes/:quiz_id/questions/:id
    • Käyttäjät: 
      • url:GET|/api/v1/users/:id
      • url:GET|/api/v1/accounts/:account_id/users

  5. Napsauta Tallenna oikeassa alakulmassa.

  6. Kopioi API-avaimen salaisuus, joka näkyy Kehittäjäavain luotu -ponnahdusikkunassa, ja napsauta sitten Sulje.

  7. Varmista, että vasta lisätyn API-avaimen Tila-kytkin on otettu käyttöön.

  8. Ota yhteyttä asiakkuuspäällikköösi ja toimita API-avaimen salaisuus Verityn LMS-määritysten viimeistelemiseksi.

YuJa Verityn API-käyttöoikeuden testaaminen

Kun asiakkuuspäällikkösi on viimeistellyt integroinnin, voit testata REST API:a varmistaaksesi, että opettajat voivat poistaa Verity-kokeita ja luoda Verity-harjoituskokeita Canvasissa.

  1. Avaa Verity-portaali napsauttamalla Canvasin sivupalkissa olevaa linkkiä YuJa Verity.
  2. Valitse Verityssä sivuvalikosta Asetukset > Integraatioasetukset.
  3. Valitse LMS API yhteys pudotusvalikosta Valitse integraatio.
  4. Napsauta Pääsyavaimet-osiossa Testaa oppilaitoksen käyttöoikeus varmistaaksesi, että Canvas-tilisi on integroitu API:in.
    Valitse integraatio- ja Pääsyavaimet-kentät on korostettu.
  5. Varmista, että API-käyttöoikeus onnistuu sekä Lue tilejä- että Lue kurssit-käyttöoikeuksilla.
    Huomautus: Jos API-käyttöoikeus epäonnistuu, ota yhteyttä asiakkuuspäällikköösi oppilaitoksesi API-avaimen päivittämiseksi.
  6. Napsauta Sulje.
    Testaa API-käyttöoikeus -ponnahdusikkuna.

LMS Visualizerin lisääminen Canvasiin

Järjestelmänvalvojana voit lisätä JavaScript-koodin teemaeditorissa Verity-selainlaajennuksen valvomiseksi. Kun JavaScript-koodi on käytössä, kokeen suorittajia ohjataan lataamaan Verity-selainlaajennus ennen kokeen avaamista. He eivät pääse kokeeseen, ellei selainlaajennusta ole asennettu.  

  1. Avaa Verity-portaali napsauttamalla Canvasin sivupalkissa olevaa YuJa Verity -linkkiä.
  2. Valitse Verityssä sivuvalikosta Asetukset > Integraatioasetukset.
  3. Valitse LMS Visualizer pudotusvalikosta Valitse integraatio.
  4. Napsauta Näytä Visualizer.
    LMS Visualizer on valittuna.
  5. Kopioi uudelle välilehdelle ilmestyvä JavaScript-koodi. 
  6. Valitse Canvasissa sivuvalikosta Teemat.
  7. Vie hiiri teemasi päälle ja napsauta Avaa teemaeditorissa.
    Teemat-osio on valittu Canvasin sivuvalikosta.
  8. Napsauta vasemmasta paneelista Lähetä -välilehteä.
  9. Etsi kenttä JavaScript-tiedosto , napsauta sitten Näytä tiedosto avataksesi JavaScript-koodisivun.
    Näytä tiedosto -painike on korostettu.
  10. Napsauta JavaScript-koodisivua hiiren kakkospainikkeella ja valitse Tallenna nimellä tallentaaksesi tiedoston laitteellesi. 
    JavaScript-koodin tallentaminen uutena tiedostona.
  11. Avaa tiedosto tekstieditorissa (esim. Muistiossa) ja liitä vaiheessa 5 kopioitu JavaScript-koodi loppuun. 
    Kopioidun JavaScript-koodin lisääminen tiedostoon.
  12. Tallenna tiedosto tekstieditorissa. 
  13. Etsi teemaeditorissa kenttä JavaScript-tiedosto ja napsauta Valitse lähettääksesi tiedostosi. 
    Valitse-painike on korostettu JavaScript-tiedosto-kentässä.
  14. Etsi kenttä Mobiilisovelluksen JavaScript-tiedosto , napsauta sitten Näytä tiedosto avataksesi JavaScript-koodisivun.
    Näytä tiedosto -painike on korostettu Mobiilisovelluksen JavaScript-tiedosto -kentässä.
  15. Napsauta JavaScript-koodisivua hiiren kakkospainikkeella ja valitse Tallenna nimellä tallentaaksesi tiedoston laitteellesi. 
    JavaScript-koodin tallentaminen uutena tiedostona.
  16. Avaa tiedosto tekstieditorissa (esim. Muistiossa) ja liitä vaiheessa 5 kopioitu JavaScript-koodi loppuun. 
    Kopioidun JavaScript-koodin lisääminen tiedostoon.
  17. Tallenna tiedosto tekstieditorissa. 
  18. Etsi teemaeditorissa kenttä Mobiilisovelluksen JavaScript-tiedosto ja napsauta Valitse lähettääksesi tiedostosi.
    Valitse-painike on korostettu Mobiilisovelluksen JavaScript-tiedosto -kentässä.
  19. Napsauta Esikatsele muutoksia.
    Esikatsele muutoksia -painike on korostettu.
  20. Napsauta Tallenna teema.
    Tallenna teema -painike on korostettu.
  21. Lisää uusi teema-asetus napsauttamalla Käytä teemaa.

Aiheeseen liittyvät artikkelit

Ota yhteyttä tukeen