Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Här samlar vi teknisk information om adaptern som kan vara bra för lärosätet att känna till, om ni funderar på att ansluta er till tjänsten eller håller på att göra det.

Studenter

Studenter skapas av adaptern med följande data: sis_user_id=ladok uid, name = för och efternamn,
email sätts om konfigurationsparametern UpdateEmailFromLadok är true, login_id sätts till antingen
persnr eller ladok uid beroende på konfigurationsparametern UseAsLoginId.


Terminer

Terminer skapas automatiskt av adaptern om dom inte redan finns. Namn tas då från Ladok och det
namnet sätts som både namn och sis id för den nya terminen. Namnet på en termin kan sedan
ändras i Canvas då terminen fortsättningsvis identifieras med sis id. Vid migration kan en befintlig
termin kompletteras med sis id som då matchas med terminsnamnet från Ladok. Lämpligtvis testas
detta i testmiljön. Adaptern sätter inga datum för terminen.


Organisationer

Organisationer hanteras som Canvas underkonton (subaccounts) och dessa skapas av adaptern om
de inte redan finns. De identifieras av en Ladok uid som sätts på underkontots sis id. Namnet på
underkontot kan ändras, underkontot kan också flyttas, om man flyttar kontot bör även underkonto
för kurs och program följa med (gäller om UseSubaccountsForProgramAndCourses är satt).
Underkonton flyttas med sis import eller via Rest API. Vid migrering ser man till att komplettera
eventuella befintliga underkonton med korrekta sis id. Detta testas lämpligen i testmiljön.


Canvaskurser

När en kurs skapas i Canvas av adaptern sätts namn, kurskod (short_name), startdatum, slutdatum
och sis id. Kurskoden sätts till kurskod + kurstillfälleskod. Start och slutdatum sätts med data från
Ladok men kursen ges inga inställningar som påverkas av dessa datum. Sis id för kursen sätts till
Ladok uid för kurstillfället (eller programtillfället/programinriktningstillfället). Radering av kurser i
Canvas bör vara avstängt i gränssnittet eftersom det annars kan bli problem med krockar i sis id.


Sektioner

Sektioner skapas när kursen skapas och namnsätts med kurskod:kurstillfälleskod:termin och sis id
sätts till ladok uid för kurstillfället. Radering av sektioner skapade av adaptern bör undvikas för att
inte få problem med krockar i sis id.


Enrollments

Adaptern hanterar studenter på Canvaskurser genom enrollments på sektioner, de läggs in med
enroll och tas bort med unenroll. Adaptern använder inte begreppen aktiv/inaktiv.
Om UseAdmitted används och Ladokhändelsen ForvantatDeltagandeSkapad inträffar så läggs
studenten in som antagen och om ForvantatDeltagandeBorttaget inträffar tas studenten bort.
Om någon av följande Ladok händelser inträffar för en student Registrering, Omregistrering,
AvbrottBorttaget, UppehallBorttaget eller PaborjatUtbildningstillfalle läggs studenten in som
registrerad. Om någon av följande händelser inträffar för en student AterkalladRegistrering,
Aterbud, AterkalladOmregistrering, Avbrott, AterkallatPaborjatUtbildningstillfalle tas studenten bort
från kursen.

Vid Ladok händelse Uppehåll tas inte studenten bort utan ligger kvar på kursen.


Tidig Åtkomst

Tidig åtkomst (early access) innebär att studenter får åtkomst till Canvaskursen när de antas till
kurstillfället istället för när de registrerar sig. Eftersom antagningen sker tidigare än registreringen
kan detta användas till kurser där man måste få ut information i ett tidigt skede. Om lärosätet vill
använda sig av tidig åtkomst konfigureras detta och lärosätet kan då välja att antingen styra detta
per kurs genom att det slås på manuellt via administrationsapplikationen eller att alla kurser skapas
med tidig åtkomst. När en kurs får tidig åtkomst sätts ett datum som innebär att vid detta datum så
tas studenten bort automatiskt om denne inte ännu har registrerat sig, detta kan också stängas av i
lärosätets konfiguration.


Samläsning

I den gamla adaptern kunde man använda den i Canvas inbyggda funktionaliteten cross-listing för att
flytta en sektion till en annan Canvaskurs och på så sätt låta två kurstillfällen samlas i en Canvaskurs.
Den nya adaptern är bakåtkompatibel med detta men den har också en ny samläsningsfunktionalitet
där man istället för att flytta sektioner kopierar dessa. Ett kurstillfälle kan då få tillgång till flera
Canvaskurser samtidigt, till exempel om man vill dela upp ett kurstillfälle på flera Canvaskurser.
Den nya samläsningen styr man i administrationsapplikationen genom att söka upp och välja vilka
sektioner som ska samläsa i den Canvaskurs där man startat administrationsapplikationen.


Konfiguration

Varje lärosäte har sin egen konfiguration av adaptern, följande konfigurationsparametrar finns och
dessa sätts för hela lärosätet, det går inte att använda olika konfigurationer för vissa organisationer
(underkonton) för lärosätet.


NamnMöjliga värdenFörklaring
UseAsLoginId ”ssn”/"ladokuid" Väljer vad som ska användas för
LoginId på personens konto i
Canvas. Skall personnummer
användes väljer man här ssn och
ska Ladok uid användas skriver
man in ladokiud.
UpdateEmailFromLadokTrue/falseOm email för studenter ska
uppdateras med information från
Ladok, Om true så skapas
studenter utan email.
UpdateNameFromLadokTrue/falseOm namn på studenter ska
uppdateras med information från
Ladok
UpdateSsnFromLadokTrue/falseOm personnummer för studenter
ska uppdateras med information
från Ladok
UseSubaccountsForProgramAndCoursesTrue/falseOm underkonton på organisation
ska användas. Denna sätts till True
om man vill att det skall skapas upp
ytterligare en nivå med två
underkonton (kurs och program)
under organisationen i samband
med att kursen skapas. Finns redan
dessa konton läggs alla nya
kurser/program i dessa.
SubAccountNewOrganisationsCanvas idSub-account där ev nya
organisationer skapas. Här skriver
man in det Canvas id som
identierar det konto där man vill
att nya organisationer ska skapas.
Har man inget speciellt konto för
detta kan 1 användas, då skapas
dessa direkt under lärosätets
huvudkonto.
CourseNameFormat1, 2, 3, 4Format på Canvaskursens namn. 1
= Namn, 2 = Namn + Termin, 3 =
Namn + Kurskod + Termin, 4 =
Namn + Kurskod + Kurstillfälleskod
+ Termin
UseAdmittedTrue/false

Detta är “Tidig åtkomst” (early
access). Om en student som blivit
antagen men ännu inte registrerad
ska läggas till på Canvaskursen.
Sätts till False om endast
registrerade studenter ska läggas in
på Canvaskursen, studenter
kommer då att läggas in med
standardrollen student på kursen.
Om denna sätts till True kommer
två nya roller att behöva skapas i
Canvas baserade på rollen student.
Studenten då att läggas till med
någon av dessa baserat på vilken
händelse som inträffat (antagen
eller registrerad) en student kan ha
båda rollerna samtidigt.

RoleIdRegisteredCanvas idCanvas id på roll (behövs om
UseAdmitted är påslagen) Rollen
kan ha samma behörigheter som
standardrollen för student men
behövs för att kunna särskiljas på
namn. Denna kan också vara
standardrollen för student men då
kan inte namnet ändras utan den
måste heta Student.
RoleIdAdmittedCanvas idCanvas id på roll (behövs om
UseAdmitted är påslagen) Rollen
kan ha samma behörigheter som
standardrollen för student men
behövs för att kunna särskiljas på
namn.
UpdateCourseFromLadokTrue/falseOm uppdateringar från Ladok skall
skriva över kursen i Canvas, dvs
namn, kurskod, datum. Om lärare
tillåts ändra denna information i
Canvas rekommenderas att denna
sätts till False, annars kan adaptern
skriva över de ändringar som
läraren gjort på kursen.
EarlyAccessOnCreateCourseTrue/falseOm UseAdmitted är påslagen och
om man vill att Tidig åtkomst
automatiskt ska sättas när kurserna
skapas. Detta gäller då alla kurser
för lärosätet.
EarlyAccessDisablePurgeTrue/falseOm UseAdmitted är påslagen och
om man inte vill att studenter ska
tas bort per automatik.