For å begynne å bruke Inspera-pluginen (kalt Proview) med Moodle, må du laste ned og sette opp to viktige plugins: quizaccess_proctor og local_proview. Disse pluginene tjener ulike formål. Quiz Access Proctor integrerer Proview-innstillinger for quiz i Moodle, og håndterer overvåkingstyper, kandidatinstruksjoner og aktivering av sikker nettleser (SB) for quizer. Local Proview injiserer Proview JavaScript ved oppstart av quizer og henter nettadresser for avspilling av sesjoner etter eksamen. Sammen sikrer de sømløs Proview-funksjonalitet i Moodle-quizer.

Forutsetninger

Før installasjon, vennligst sørg for at du har:

1. Aktivt Moodle-miljø: Tilgang til din Moodle-plattform med administratorrettigheter.
2. Kompatibel nettleser: Sørg for at kandidater bruker en kompatibel nettleser for de overvåkede prøvene.
3. Godkjenning av domene (Allowlisting): Det er nødvendig å ha ditt Moodle-domene autorisert og hvitelistet for å bruke Insperas overvåkingstjenester. Dette er et sikkerhetstiltak for å sikre at bare godkjente domener kan samhandle med tjenesten.

Sørg for at serveren og Moodle-miljøet oppfyller de nødvendige tekniske kravene for pluginene.

Quiz Access Proctor Plugin

1. Quiz Access Proctor-pluginen integreres direkte med Moodles quiz-modul, noe som gjør det mulig for undervisere å bruke spesifikke overvåkingsinnstillinger på sine quizer. Denne pluginen er en nøkkelkomponent i håndteringen av hvordan overvåking utføres under quizer, og tilbyr innstillinger for ulike typer overvåking og muliggjør bruk av Insperas sikre nettleser for å sikre et kontrollert prøvemiljø.

   Denne pluginen er påkrevd for installasjon av moodle-local_proview-pluginen

2.  

   1. Naviger til Nettstedsadministrasjon i administratorvisningen.
   2. Gå til Utvidelser (Plugins), og velg deretter Installer utvidelse (Install Plugin).
   3. Last ned pluginen fra https://github.com/talview/moodle-quizaccess_proctor/releases.
   4. Klikk på "Installer utvidelse" og følg instruksjonene på skjermen gjennom de påfølgende sidene.
   5. På siden for plugin-innstillinger:
      1. Aktiver konfigurasjoner for pluginen ved å merke av i avmerkingsboksen (standard er aktivert).
      2. Skriv inn callback-nettadressen
         1. Europa: https://moodle-proview-api.talview.com
         2. Australia: https://moodle-proview-api.talview.nz 
      3. Skriv inn brukernavnet oppgitt av Inspera for autentisering av callbacks.
      4. Skriv inn passordet oppgitt av Inspera for autentisering av callbacks.

   Installasjonsprosessen er nå fullført.

Local Proview Plugin

1. Local Proview-pluginen fungerer sammen med Quiz Access Proctor-pluginen for å injisere det nødvendige Proview JavaScriptet i Moodle-quizer. Denne pluginen sikrer at overvåkingssesjonen startes riktig når en quiz begynner, og håndterer integrasjonsaspekter som henting av nettadresser for avspilling etter eksamen for gjennomgangsformål.

2.  

   1. Gå til administratorvisningen og naviger til Nettstedsadministrasjon - Utvidelser - Installer utvidelse.
   2. Last ned pluginen fra https://github.com/talview/moodle-local_proview/releases.
   3. Klikk på "Installer utvidelse" og følg de påfølgende sidene for å fullføre installasjonsprosessen.
   4. Utfør følgende trinn på siden for plugin-innstillinger:
      • Aktiver Proview ved å merke av i avmerkingsboksen (standard er deaktivert).
      • Skriv inn Proctor Token oppgitt av Inspera (abonnementsbasert).
      • Skriv inn CDN-nettadressen oppgitt av Inspera (abonnementsbasert).
      • Skriv inn Proview Admin-nettadresse oppgitt av Inspera, f.eks., https://appv7.proview.io/embedded.
      • Skriv inn kontonavnet (Account Name) oppgitt av Inspera.
      • Oppdater root_dir slik at den samsvarer med rotkatalogen for din Moodle-installasjon. 
        1. Merk: Rotkatalogen refererer til katalogen der Moodle er installert. Hvis du har tilgang til Moodle ved hjelp av en nettadresse som 'https://eksempel.domene.no/,’ er rotkatalogen '/,’ og ingen ytterligere konfigurasjon er nødvendig. Men hvis du har tilgang til Moodle ved hjelp av en nettadresse som 'https://eksempel.domene.no/moodle/,’ er rotkatalogen '/moodle/' og må konfigureres deretter i root_dir-feltet under installasjonen av Proview.

   Installasjonsprosessen er nå fullført.

   Merk: Når pluginen er installert, vennligst del domenenavnet der Moodle er vert for kandidatene med Inspera for å utføre domenegodkjenning (allowlisting).

Konfigurasjon på quiz-nivå

Etter installasjon av pluginen vil alle eksisterende quizer ha overvåking og sikker nettleser deaktivert som standard. For å aktivere overvåking for en spesifikk quiz, følg disse trinnene:

1. Gå til quizen der overvåking skal aktiveres.
2. På høyre side finner du et innstillingsikon; klikk på dette ikonet.
3. Velg "Rediger innstillinger."
4. Rull ned for å finne "Proview Proctoring Settings".
5. I denne seksjonen velger du type overvåking fra rullegardinmenyen. Inspera støtter tre typer overvåking:
   • AI-overvåking: Sesjonen evalueres av en AI-motor, som genererer en automatisert Proview-skåre.
   • Overvåking med opptak og gjennomgang: Sesjonen evalueres av en eksamensvakt etter at den er fullført, og vakten tildeler en Proview-vurdering.
   • Overvåking i sanntid: Sesjonen evalueres av en eksamensvakt mens den pågår, og vakten kan kommunisere med kandidaten ved behov. Vakten gir Proview-vurderingen.
6. For å aktivere sikker nettleser, merker du av for "Enable Secure Browser", men vær oppmerksom på at den sikre nettleseren bare vil startes hvis quizen har Proview-overvåking aktivert.
7. Ved konfigurering av quizer for "Open Book"-eksamener, er det nå mulig å inkludere en seksjon for referanselenker ("Reference Links"). Denne funksjonen lar eksaminatorer gi kandidater direkte tilgang til viktige ressurser under eksamen. I Proview Proctoring Settings kan referanselenker integreres sømløst. Bare sett inn lenken ved å bruke formatet [Linux](<https://www.linuxfromscratch.org/lfs/>). Dette vil sikre at lenken vises praktisk på kandidatens skjerm, ved siden av Proview-forhåndsvisningen, symbolisert med et lenkeikon. Ved å klikke på ikonet kan kandidater se lenkens tekst. Et påfølgende klikk på teksten vil åpne lenken i en ny fane, noe som muliggjør umiddelbar tilgang til referansematerialet uten å forlate eksamensmiljøet.

• Velg en av følgende verdier fra “Proview Proctoring Session” - “Select Proctoring Type” i vinduet for quiz-innstillinger for å sette opp en spesifikk overvåkingstype. De støttede overvåkingstypene er beskrevet nedenfor; deres tilgjengelighet er abonnementsbasert:
  • Ingen overvåking (No Proctoring): Verken overvåking eller sikker nettleser vil være aktivert for quizen.
  • Med opptak (Recorded): Sesjoner vurderes av en AI-motor, noe som genererer en automatisert Proview-skåre. Velg Recorded fra rullegardinmenyen.
  • Opptak og gjennomgang (Record and Review): Fullførte sesjoner gjennomgås av en eksamensvakt, som tildeler en Proview-vurdering. Velg Record and Review Proctoring i rullegardinmenyen.
  • I sanntid (Live Proctoring): Eksamensvakter vurderer pågående sesjoner og kan samhandle med kandidater ved behov. Vakten gir Proview-vurderingen. Velg Live Proctoring fra rullegardinmenyen.
    • Merk: For overvåking i sanntid, sørg for at tidsluker er bestilt, eller at tidsplanen er delt med Inspera.
• SB (Secure Browser) er en sikker nettleser kompatibel med Windows- og Mac-enheter. Aktivering av SB tvinger kandidater til å bruke denne under eksamen.
  Konfigurasjon: Fremtving SB ved å merke av for “Proview Proctoring Session” - “Enable Secure Browser” i vinduet for quiz-innstillinger.
  Aktivering: Når det er aktivert, blir kandidater sendt til en ekstern side for å laste ned den nyeste SB-versjonen og starte eksamen.

Aktivering av overvåking i sanntid med Proview i Moodle

Det starter med å etablere en ekstern webtjeneste i Moodle, noe som er nødvendig for å legge til rette for sikker datautveksling mellom Moodle og Proview. Deretter vil generering av et webtjeneste-token autentisere denne forbindelsen og muliggjøre en betrodd kommunikasjonskanal. Det siste trinnet, synkronisering av påmeldingsdetaljer, sikrer at hver kandidats informasjon blir nøyaktig parret med deres tilsvarende overvåkede eksamenssesjon.

• Opprette ekstern webtjeneste (External Web-service)
  • Trinn 1: Naviger til fanen Server under Nettstedsadministrasjon
  • Trinn 2: Klikk på Eksterne tjenester (External Services) under fanen Webtjenester
  • Trinn 3: Klikk på knappen Legg til (Add) for å opprette en ny webtjeneste
  • Trinn 4: Gi navn og kortnavn for webtjenesten, aktiver den og klikk på Legg til tjeneste (add service)
• Opprette webtjeneste-token (Web-service Token)
  • Trinn 1: Naviger tilbake til server-fanen og klikk på Administrer tokens (Manage Tokens) under Webtjenester
  • Trinn 2: Klikk på Opprett token (Create Token)
  • Trinn 3: Velg en bruker med administratorrolle og tjenesten som ble opprettet tidligere, og klikk på Lagre endringer
  • Trinn 4: Del tokenet og Moodles nettadresse med Inspera-teamet
    • Eksempel på nettadresse: https://din.moodle.instans/webservice/rest/server.php 
    • Eksempel på token: 004cf89383fc7390b8b7c92e0d27ehj2

Vise overvåkingssesjonen

Gjennomgangsprosessen etter eksamen har som mål å forenkle eksamensadministrasjon og studentvurdering gjennom LMS-et. Dette dokumentet skisserer den trinnvise prosedyren for administratorer for å få tilgang til og vurdere eksamensresultater, inkludert bruk av avspillingsvisning av opptak av studenter.

1.  
   1. Logg inn i Moodle LMS:
      • Logg inn på Moodle LMS-plattformen med din legitimasjon som eksamensadministrator.
   2. Velg emne og quiz:
      • Naviger til det spesifikke emnet der eksamen ble gjennomført.
      • Finn og velg den aktuelle quizen relatert til eksamenen.
   3. Få tilgang til eksamensresultater:
      • Inne i emnet navigerer du til fanen 'Resultater' tilknyttet den valgte quizen.
   4. Vis rapport:
      Klikk på valget 'Vis rapport' (Show Report) for å generere eksamensrapporten.
   5. Vurder studentresultater:
      • Gå gjennom eksamensresultatene som vises i rapporten.
      • Analyser individuelle studentprestasjoner, skårer og eventuell oppgitt statistikk.
   6. Bruk Proview-nettadresse:
      • Identifiser studenten hvis eksamensavspilling skal vurderes.
      • Klikk på den tilsvarende studentens detaljer eller navn i eksamensrapporten.
   7. Få tilgang til avspillingsvisning:
      • Finn 'Proview URL' tilknyttet den valgte studenten.
      • Klikk på den oppgitte Proview-nettadressen for å få tilgang til avspillingsvisning av opptakene fra studentens eksamenssesjon.
   8. Vurder opptak:
      • Når du har åpnet Proview-nettadressen, vil avspillingen av studentens eksamenssesjon vises.
      • Gå gjennom opptaket for å observere studentens handlinger og adferd under eksamen.

Andre funksjoner og konfigurasjoner

Noen få funksjoner i pluginene krever tilpassede konfigurasjoner. Her er en liste over disse funksjonene med konfigurasjonsdetaljer:

• Deaktivere Proview for en gruppe
  
  En brukergruppe kan sikre at Proview ikke lastes for spesifikke kandidater i hvert emne.
  • Gå til det spesifikke emnet og naviger til Deltakere.
  • Klikk på innstillingsikonet på høyre side og velg "Grupper.”
  • Velg "Opprett gruppe.”
  • Sett gruppenavnet til "proview_disabled.”
  • Gå tilbake til emnet, klikk på innstillingsikonet på høyre side, og velg "Rediger innstillinger.”
• Merk: Enhver kandidat som legges til i denne gruppen vil ikke få Proview aktivert for seg i dette emnet.
   
  • Synkronisering av påmelding (Enrolment Sync)
    Ved planlegging av en sesjon med overvåking i sanntid, er det viktig å synkronisere Moodles detaljer for emnepåmelding med Insperas Proview-tjeneste for eksamensplanlegging og tildeling av eksamensvakter. Derfor må eksamensteamet dele detaljer om Quiz ID-tidsluker med Inspera.
    • Mottak av callback-data
      Ved opprettelse, oppdatering eller sletting av en quiz i Moodle, mottar vårt integrasjonslag callback-data som inneholder viktig informasjon om quizen. Callback-dataene består av følgende felt:
      • "quiz_title": Tittel på quizen
      • "action": Handlingstype (0 for nyopprettet quiz, 1 for oppdatering, og 2 for sletting)
      • "quiz_id": ID for Moodle-quizen
      • "course_id": ID for emnet der quizen er opprettet
      • "course_module_id": Emnemodul-ID for quizen
      • "proctoring_enabled": Overvåkingsstatus (true eller false)
      • "proctoring_type": Type overvåking
      • "tsb_enabled": TSB-status (Sikker nettleser)
      • "timeopen": Åpningstid for quizen
      • "timeclose": Stengetid for quizen
      • "timelimit": Tidsbegrensning for quizen
      • "timemodified": Siste endringstidspunkt for quizen
      • "timecreated": Opprettelsestidspunkt for quizen
    • Datalagring
      Den mottatte informasjonen fra trinn 1 lagres i vår database for videre planlegging og administrasjonsformål.
    • Henting av deltakerdetaljer
      For eksamener med overvåking i sanntid kaller vi opp en ekstern webtjeneste konfigurert på Moodle-plattformen for å hente deltakerdetaljer. Deltakerdetaljer inkluderer vanligvis:
      • Fornavn
      • Etternavn
      • E-postadresse
      • Moodle bruker-ID
      • Moodle Quiz-ID
      • Disse detaljene lagres i vår deltakertabell og knyttes til den respektive quizen.

    • Planlegging av hendelse

      Eksamenshendelsen settes opp på Proview-plattformen ved å legge inn kandidatinformasjonen hentet i trinn 3. Ved å koble deres Moodle bruker-ID med den tilsvarende quiz-ID-en, sikrer vi at eksamenshendelsen planlegges nøyaktig.

      Prosesser for planlegging av overvåking i sanntid

      • Synkronisering av data fra Moodle med Insperas integrasjonslag som nevnt i tidligere trinn.
      • Verifisering av data (valgfri prosess) i tråd med kundens spesifikke krav.
      • Etablering av hendelsen, tidsluker og tildeling av eksamensvakter før publisering.
    • Tilnærminger til planlegging av hendelser
      • Manuell planlegging: Når de første to trinnene er fullført, kan Insperas Managed Service-team gå videre til å manuelt organisere sesjonene for overvåking i sanntid.
      • Automatisert planlegging gjennom cron-jobber: Avhengig av kundens spesifikke behov, kan planlegging automatiseres ved å sette opp cron-jobber. For institusjonelle kunder, som høyskoler og universiteter, anbefales det å konfigurere cron-jobben til å kjøre én gang i døgnet. Dette intervallet kan imidlertid justeres til en kortere tidsramme etter kundens ønske.
    • Oppstart av eksamen
      Når en kandidat starter en quiz i Moodle, blir deres bruker-ID og quiz-ID overført til Proview for validering mot de planlagte kandidatdetaljene. Ved vellykket validering fortsetter kandidaten med sjekkene i Proview og begynner sin eksamen.

LMS-planleggingsvalideringer

• Synkronisering av quiz-data:

  I den integrerte arbeidsflyten synkroniseres data ved opprettelse, oppdatering eller sletting av en quiz i LMS-et. Følgende attributter behandles som en del av integrasjonen:

  • "quiz_title": Tittel på quizen
  • "action": Handlingstype (0 for nyopprettet quiz, 1 for oppdatering, og 2 for sletting)
  • "quiz_id": ID for quizen
  • "course_id": ID for emnet der quizen er opprettet
  • "course_module_id": Emnemodul-ID for quizen
  • "proctoring_enabled": Overvåkingsstatus (true eller false)
  • "proctoring_type": Type overvåking
  • "tsb_enabled": TSB-status (Sikker nettleser)
  • "timeopen": Åpningstid for quizen
  • "timeclose": Stengetid for quizen
  • "timelimit": Tidsbegrensning for quizen
  • "timemodified": Siste endringstidspunkt for quizen
  • "timecreated": Opprettelsestidspunkt for quizen

  Synkronisering av påmeldingsdata:

  Påmeldingsdata for quiz behandles bare hvis quizen er markert for overvåking i sanntid. Proview

  LMS-integrasjonslaget henter data basert på tidsplanen identifisert for kunden. Denne logikken kan endres basert på LMS-plattformen og dens funksjonalitet.

  Følgende attributter kan behandles:

  • Fornavn
  • Etternavn
  • E-postadresse
  • LMS bruker-ID
  • Status
  • Ekstra tid
  • Instruksjon til kandidat

  Merk: Hvis automatisert datasynkronisering ikke er en del av implementeringen, skal tidsplan- og påmeldingsdata sendes til Inspera i CSV-filformat med feltene nevnt ovenfor.

• VALIDERINGSTRINN FOR PLANLEGGINGSINFORMASJON

  Valideringsprosessen kan utføres av enten klienten eller Inspera, med to distinkte metoder: klientvalidering og Inspera-validering.

  Klientvalidering innebærer følgende trinn:

  • Opprettelse av quizer: Klienten oppretter quizer tilpasset sine spesifikke krav.
  • Datasynkronisering: Når quizene er opprettet, synkroniserer Inspera dataene.
  • Nedlasting av massedata: Inspera laster deretter ned de synkroniserte dataene samlet.

  Frakoblet validering: De synkroniserte dataene deles med klienten utenfor systemet, slik at de kan validere dataene når det passer dem.

  Inspera-validering innebærer følgende trinn:

  • Opprettelse av quizer: Klienten oppretter quizer basert på de gitte spesifikasjonene.
  • Informasjonsdeling: Klienten deler eksamensplanen og påmeldingslisten med Inspera i henhold til malen som er gitt.
  • Validering av tidsplan: Inspera utfører valideringssjekker på den oppgitte eksamensplanen for å sikre at alle quizer er nøyaktig opprettet og synlige i Insperas database.
  • Validering av påmelding: Inspera verifiserer påmeldingslisten for å bekrefte at alle tiltenkte deltakere er korrekt registrert for quizene.
• Når quizer er opprettet i LMS av klienten, og eksamensplanen er delt med Inspera, utføres følgende valideringstrinn:
  • Sjekk av Quiz-ID:
    • Verifiser om quiz-ID er synlig i Insperas database.
  • Overvåking aktivert:
    • Verifiser om "proctoring enabled" er satt til true.
  • Overvåkingstype:
    • Verifiser om riktig "proctoring type" er valgt: live_proctor/ai_proctor.
  • TSB aktivert (Sikker nettleser):
    • Verifiser at "TSB enabled" er false hvis eksamen er konfigurert uten sikker nettleser.
    • Verifiser at "TSB enabled" er true hvis eksamen er konfigurert med sikker nettleser.
  • Åpningstid for quiz:
    • Verifiser at "Quiz open time" er satt korrekt i henhold til tidsplanen, med minimum 30 minutter før planlagt tid i Proview.
  • Stengetid for quiz:
    • Verifiser at "Quiz close time" er satt korrekt i henhold til eksamens varighet.
  • Buffertid for onboarding:
    • Buffertiden for onboarding kan justeres for å sikre at studenter logger seg på i god tid før selve prøvestart, slik at de kan fullføre sjekker med eksamensvakten.

• Hvis påmeldingsinformasjon deles, kan vi validere denne mot dataene som behandles via integrasjonen.

  • Validere studentantall:
    • Bruk quiz-ID for å verifisere at antall påmeldte studenter samsvarer med synkronisert deltakerantall for hver quiz.
  • Identifisering av studenter:
    • Ved hjelp av studentenes e-post-ID eller unike ID-er, sjekk manuelt om alle studenter i påmeldingslisten samsvarer med de synkroniserte deltakerdataene.
  • Valideringsresultat:
    • Avvik i tidsplan og påmelding kommuniseres til klienten slik at de kan foreta nødvendige rettinger i LMS-plattformen og synkronisere dataene på nytt.

  Anbefalt valideringssyklus -

  • Data fra LMS vil bli synkronisert av Inspera med intervaller på 4 uker, 2 uker og 48 timer før start av hver eksamensdato.
  • Alle kanselleringer/omberamminger vil bli stengt 48 timer før prøvedato. Eventuelle kanselleringer eller endringer i bestillinger vil fortsatt resultere i en belastbar sesjon for klienten.
  • Mellom 2 uker og 48 timer fra eksamensdato kan ikke avviket på ekstra kandidatvolum være mer enn 5 %.

•  

  • Automatisert planlegging gjennom cron-jobber: Avhengig av kundens spesifikke behov, kan planlegging automatiseres ved å sette opp cron-jobber. For institusjonelle kunder, som høyskoler og universiteter, anbefales det å konfigurere cron-jobben til å kjøre én gang i døgnet. Dette intervallet kan imidlertid justeres til en kortere tidsramme etter kundens ønske.
  • Manuell planlegging: Når de første to trinnene er fullført, kan Insperas Managed Service-team gå videre til å manuelt organisere sesjonene for overvåking i sanntid.

  Viktige merknader:

  • Automatisk planlegging skjer uten manuell inngripen og igangsettes 48 timer før hendelsen.
  • Manuell planlegging krever tilgang til administratorportalen og innebærer manuell inntasting av hendelsesdetaljer.
  • Når en hendelse er planlagt og publisert, er det restriksjoner på endringer som endring av dato, tid eller deltakerliste.

Begrensninger

• Synkronisering av påmelding vil inkludere alle kandidater påmeldt emnet, selv om de har inaktiv status.
• Kompatibilitet med Moodle-temaet Adaptable. Når Adaptable-temaet er installert i Moodle, kan ikke Proview-pluginen strømme video, noe som hindrer brukeren i å fortsette med prøven. Vi har identifisert en løsning for dette. Løsning: Pace Js i Adaptable-temaet blokkerer for øyeblikket WebSocket-tilkoblingen, noe som hindrer videostrømmen.
  • Trinn 1: Naviger til seksjonen Utseende (Appearance) under Nettstedsadministrasjon i Moodle.
  • Trinn 2: Klikk på valget Ekstra HTML (Additional HTML)
  • Trinn 3: Legg til følgende kode under HEAD-seksjonen for Ekstra HTML.
    <script> var paceOptions = { ajax: { trackWebSockets: false } }; </script>
  • Trinn 4: Klikk på Lagre endringer.
• Unntak må håndteres manuelt (offline).