Dokumentation
Teknisk dokumentation
För dig som förvaltar Sundsvall lär eller ansvarar för kommunens lärplattform.
Koppla en utbildning till Moodle
Standarder som följs
Utbildningarna kopplas till Moodle med LTI 1.3 (Learning Tools Interoperability), 1EdTechs standard för att en lärplattform ska kunna starta ett externt verktyg och ta emot resultat. Två delar av standarden används:
- LTI Core 1.3 för själva starten. Moodle skickar användaren hit via en OpenID Connect-handskakning, och vi verifierar signaturen mot Moodles nyckeluppsättning. Ingen delad hemlighet skickas i webbläsaren.
- Assignment and Grade Services 2.0 (AGS) för resultatet. När en deltagare blir klar rapporterar vi tillbaka till Moodles betygsbok.
Deltagaren identifieras med ett pseudonymt id från Moodle. Vi begär varken namn eller e-postadress, och det finns ingen plats i vår databas för sådana uppgifter. Se Så hanterar vi dina uppgifter.
Varför inte SCORM?
SCORM-innehåll hittar lärplattformen genom att läsa en JavaScript-variabel i föräldrafönstret. Det fungerar bara om innehållet ligger på samma domän som Moodle. Eftersom utbildningarna bor på lar.sundsvall.dev skulle en SCORM-koppling starta kursen och registrera exakt ingenting – utan felmeddelande. Det är webbläsarens säkerhetsmodell, inte en inställning som går att ändra. LTI är den standard som är byggd för externt hostade verktyg.
Innan ni börjar
Registreringen görs en gång per Moodle-installation. Därefter kan vilken kurs som helst läggas till som en aktivitet, utan att något behöver göras om.
Detta ger ni oss
Hämtas i Moodle under Webbplatsadministration → Plugin → Aktivitetsmoduler → Externt verktyg → Hantera verktyg, via Visa konfigurationsdetaljer.
- Platform ID (utfärdare)
- Client ID
- Deployment ID
- Authentication request URL
- Access token URL
- Public keyset URL
Detta får ni av oss
Fyll in dessa när verktyget registreras. Adresserna matchas som exakta strängar – inget avslutande snedstreck.
- Tool URL
https://lar.sundsvall.dev- Initiate login URL
https://lar.sundsvall.dev/api/lti/login- Redirection URI
https://lar.sundsvall.dev/api/lti/lansering- Public keyset URL
https://lar.sundsvall.dev/api/lti/jwks
Steg för steg
Registrera verktyget (en gång per Moodle)
Gå till Hantera verktyg → Konfigurera ett verktyg manuellt. Välj LTI-version 1.3 och Public key type: Keyset URL. Fyll i adresserna ovan. Använd inte LTI 1.1 – den är föråldrad och stöds inte av oss.
Slå på betygstjänsten
Under Tjänster, sätt IMS LTI Assignment and Grade Services till ”Använd denna tjänst för betygssynk och kolumnhantering”. Väljer ni ”endast betygssynk” får vi ingen betygskolumn att skriva till, och klarmarkeringar kommer aldrig fram.
Stäng av delning av personuppgifter
Under Integritet, sätt både Dela launcherns namn med verktyget och Dela launcherns e-post med verktyget till Aldrig. Det är Moodles standardvärde och ska förbli så – vi behöver dem inte, och vi lagrar dem inte.
Lägg till utbildningen som en aktivitet
I kursrummet: Lägg till en aktivitet → Externt verktyg, och välj det registrerade verktyget. Sätt Verktygets URL till adressen för den utbildning ni vill ha, till exempel:
Varje utbildning läggs till som en egen aktivitet med sin egen betygskolumn.https://lar.sundsvall.dev/kurs/eneoKryssa i att betyg accepteras
I aktivitetens inställningar, under Betyg: kryssa i ”Acceptera betyg från detta verktyg”. Den är avkryssad som standard sedan Moodle 4.2, och måste kryssas för varje aktivitet. Det här är det överlägset vanligaste skälet till att allt ser rätt ut men inga resultat syns.
Sätt villkoret för genomförd
Under Aktivitetsslutförande, välj ”Studenten måste få ett betyg” med gränsen 100 %. Vi rapporterar antal klarade delar av totalt, så 100 % betyder att hela utbildningen är genomgången.
Kontrollera att det fungerar
Starta utbildningen som en testdeltagare och klicka igenom till slutet. Ett resultat ska då synas i betygsboken inom några sekunder. Gör om samma sak en gång till – ingenting ska hända, eftersom rapporteringen är idempotent.
Testa i Edge på Windows om det är den webbläsare medarbetarna använder. Utbildningen visas i en inbäddad ruta i Moodle, och webbläsares hantering av kakor i inbäddade sidor skiljer sig åt.
Om något inte fungerar
| Symtom | Nästan alltid orsaken |
|---|---|
| Allt ser rätt ut, men inga resultat syns i betygsboken | ”Acceptera betyg från detta verktyg” är inte ikryssad på aktiviteten. Den är avkryssad som standard. |
| Utbildningen startar, men en banner säger att resultat inte kan rapporteras | Betygstjänsten är satt till ”endast betygssynk”. Den måste vara ”betygssynk och kolumnhantering”. |
| Ett felmeddelande om att starten inte kunde verifieras | Servrarnas klockor skiljer sig åt. Moodles startbiljett är giltig i 60 sekunder – kontrollera tidssynkroniseringen på båda servrarna. |
| Moodle svarar med ett fel direkt vid start | Redirection URI matchar inte exakt. Kontrollera att det inte finns ett avslutande snedstreck eller fel protokoll. |
| Utbildningen visas inte alls i den inbäddade rutan | Vår adress är inte den registrerade, eller så filtrerar en brandvägg. Byt tillfälligt visningsläge till ”Nytt fönster” för att avgöra vilket. |
| Deltagarens framsteg försvinner mellan besöken | Sessionen har gått ut. Utbildningen säger det i klartext och ber deltagaren öppna kursen från Moodle igen – inget är förlorat. |
Får ni inte kopplingen att fungera: hör av er till den som förvaltar Sundsvall lär, och ta med tidpunkten för försöket. Varje misslyckad start loggas med en referenskod som visas för användaren, och den koden gör felet spårbart.