Naar YuJa
  1. YuJa Helpcentrum
  2. LMS-toegankelijkheidsplatform Panorama
  3. Canvas-integratie
  4. Beheerders

Panorama integreren in Canvas met LTI 1.1

Avatar
YuJa
  • Bijgewerkt

Dit document bevat instructies voor het integreren van het LMS-toegankelijkheidsplatform Panorama in uw Canvas-leeromgeving (LMS) met LTI 1.1. Zorg er voordat u verdergaat met de onderstaande stappen voor dat u als beheerder volledige toegang hebt tot uw Canvas-instantie. Neem bij vragen over een van de stappen in dit proces contact op met uw vaste accountmanager.

 

Uw consumentensleutel, LTI-geheim en XML-bestand voor uw integratie verkrijgen 

Voordat u verdergaat met de onderstaande stappen, moet u een e-mail van uw accountmanager hebben ontvangen met het verzoek om u aan te melden voor uw Panorama-account. Meld u aan voor uw account en ga vervolgens verder met de onderstaande stappen. 

  1. Meld u aan bij uw Panorama-account.
  2. Klik in het menu aan de linkerkant op Configuraties en selecteer vervolgens Integratie-instellingen.

  3. Selecteer LTI 1.1.

  4. Klik op LTI 1.1-XML downloaden, en kopieer vervolgens uw Consumentensleutel en LTI Geheim. Deze hebt u nodig in het volgende gedeelte van deze handleiding.

Een clientsleutel en client secret genereren

  1. Klik op + Ontwikkelaarssleutel > API-sleutel.
    1.png

  2. Voer de volgende gegevens in:

    • Sleutelnaam: Panorama API Integration
    • Omleidings-URL's: https://<zoneURL>/canvas-auth
      • VS-zone: https://panorama-api.yuja.com/canvas-auth
      • CAN-zone: https://panorama-api-cz.yuja.com/canvas-auth
      • EU-zone: https://panorama-api-ez.yuja.com/canvas-auth
      • AUS-zone: https://panorama-api-az.yuja.com/canvas-auth

    2.png

  3. (Optioneel) Schakel Toegangsrechten afdwingen in.
    Opmerking: Wij raden af om toegangsrechten af te dwingen. U moet Panorama dan opnieuw integreren met de Canvas API telkens wanneer Panorama nieuwe functionaliteit toevoegt die gebruikmaakt van de API. Als u hier niet voor kiest, zorg er dan voor dat Toegangsrechten afdwingen is uitgeschakeld en ga vervolgens verder met stap 5. 
  4. Schakel Include-parameters toestaan in en selecteer vervolgens de volgende parameters:
    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
    • Beheerders
      • url:GET|/api/v1/accounts/:account_id/admins
    • Opdrachten
      • 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
    • Cursussen
      • 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
    • Discussieonderwerpen
      • 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
    • Inschrijvingen
      • url:GET|/api/v1/users/:user_id/enrollments
      • url:GET|/api/v1/courses/:course_id/enrollments 
    • Inschrijvingsperioden
      • url:GET|/api/v1/accounts/:account_id/terms
      • url:GET|/api/v1/accounts/:account_id/terms/:id
    • Bestanden
      • 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
    • Pagina's
      • 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
    • Quizzen
      • 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
    •  Rollen
      • 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-resourcelinks
      • url:GET|/api/v1/courses/:course_id/lti_resource_links
      • url:GET|/api/v1/courses/:course_id/lti_resource_links/:id
  5. Klik op Opslaan.
    4.png
  6. Zoek de zojuist aangemaakte ontwikkelaarssleutel Panorama API Integration en kopieer het Client-ID onder Details.
  7. Klik op Sleutel weergeven en kopieer het Client secret.
  8. Meld u aan bij Panorama en klik vervolgens in het menu aan de linkerkant op Configuratie > Integratie-instellingen.
    7.png
  9. Selecteer in het vervolgkeuzemenu Selecteer integratie de optie LMS API.
  10. Klik op Toegangssleutel toevoegen.
    9.png
  11. Kies bij de Canvas-authenticatiemethode voor Client-ID.
  12. Voer in het veld Client-ID het ID uit stap 8 in.
  13. Voer in het veld Client secret het client secret uit stap 9 in.
  14. Als u afgedwongen toegangsrechten hebt gebruikt, schakelt u Gebruik afgedwongen toegangsrechten in. Sla deze stap anders over.
  15. Klik op Authenticeer met Canvas.
    Opmerking: Zorg ervoor dat u bent aangemeld bij Canvas als beheerder met volledige rechten.
  16. Klik op Autoriseren.
    13.png
  17. Kopieer de authenticatierespons en ga terug naar Panorama. Plak de respons in het veld Canvas authenticatie respons.
  18. Klik op Toegangssleutel toevoegen.
  19. Klik op Wijzigingen opslaan om de installatie te voltooien.
    15.png

Panorama toevoegen aan Canvas

Nadat u uw consumentensleutel, geheime sleutel en XML-configuratie hebt verkregen, kunt u Panorama toevoegen aan uw Canvas-instantie.

  1. Meld u aan bij Canvas als beheerder. Klik in de zijbalk links op Beheerder en selecteer het Canvas-account van uw instelling.
  2. Klik op Instellingen > Apps > App-configuraties weergeven.
  3. Klik op + App, vul de volgende gegevens in en klik vervolgens op Indienen om de Panorama-configuratie voor Canvas te voltooien.
     
    • Configuratietype: XML plakken
    • Naam: Panorama Configuration
    • Consumentensleutel: Verkregen in het eerste gedeelte van deze handleiding.
    • Geheime sleutel: Het LTI-geheim dat u in het eerste gedeelte van deze handleiding hebt verkregen.
    • XML-configuratie: Open het XML-bestand dat u in het eerste gedeelte van deze handleiding hebt gedownload. Kopieer de inhoud ervan naar een teksteditor zoals Kladblok en plak deze hier.

De LMS Visualizer installeren

Voor deze stap moet de functie Aangepaste CSS/JavaScript-overrides zijn ingeschakeld in uw Canvas-instantie. Als deze functie niet is ingeschakeld, neemt u contact op met uw Canvas-accountmanager. Dankzij de LMS Visualizer kunnen de toegankelijkheidspictogrammen van Panorama worden weergegeven. 

  1. Meld u aan bij uw Panorama-account.
  2. Klik op Configuraties > Integratie-instellingen.
  3. Selecteer LMS Visualizer > Visualizer downloaden.
  4. Meld u vervolgens aan bij Canvas als beheerder. Klik in de zijbalk links op Beheerder en selecteer het account waarop u de YuJa Panorama - LMS Viewer wilt toepassen.
  5. Selecteer Instellingen in de navigatiebalk links en controleer of het tabblad Instellingen in de bovenste rij is geselecteerd.
     
  6. Scrol omlaag naar het gedeelte Functies .
    • Als de optie Aangepaste CSS/JavaScript-overrides beschikbaar is, controleert u of deze is ingeschakeld. Scrol vervolgens omlaag en klik op Instellingen bijwerken.
    • Als de optie Aangepaste CSS/JavaScript-overrides niet beschikbaar is, neemt u contact op met uw Canvas-accountmanager om Aangepaste CSS/JavaScript-overrides in te schakelen in de Thema-editor.
  7. Klik vervolgens in de navigatiebalk links op Thema's en kies de knop + Thema. Selecteer een willekeurige themasjabloon in de vervolgkeuzelijst.
  8. Ga in de Canvas Thema-editor naar het tabblad Uploaden en selecteer het bestand Canvas Visualizer dat u in stap 3 van dit gedeelte hebt gedownload. Belangrijk: Het tabblad Uploaden is pas beschikbaar nadat uw accountmanager dit heeft ingeschakeld.
  9. Klik vervolgens op Voorbeeld van uw wijzigingen, en kies daarna Thema toepassen. Wanneer u wordt gevraagd uw thema een naam te geven, typt u Panorama Theme.

Panorama verwijderen uit een Canvas-instantie

Om Panorama uit een Canvas-instantie te verwijderen, moet de beheerder de LTI-app en de LMS Viewer verwijderen. Volg de onderstaande stappen om te leren hoe u deze onderdelen verwijdert. 

  1. Meld u aan bij Canvas als beheerder. Klik in de zijbalk links op Beheerder en selecteer het Canvas-account van uw organisatie.
  2. Selecteer Instellingen in de navigatiebalk links.
  3. Selecteer in de bovenste rij het tabblad Apps en klik vervolgens op App-configuratie weergeven.
  4. Selecteer het tandwielpictogram van de LTI-app Panorama en klik op Verwijderen.
  5. Selecteer Verwijderen om het verwijderen van de tool te bevestigen en de Panorama-integratie voor LTI 1.1 uit te schakelen. 
  6. Ten slotte moet u als beheerder de LMS Viewer verwijderen door in het navigatiemenu op Thema's te klikken.
  7. Selecteer vervolgens het thema voor Panorama, en klik op Openen in Thema-editor.
  8. Klik in het linkerpaneel op Uploaden.
  9. Klik onder JavaScript-bestand, op de X om het Panorama script te verwijderen.
  10. Klik op Thema opslaan. Panorama is nu verwijderd uit de Canvas-instantie.

Verwante artikelen

Neem contact op met support