Table of Contents

Vad är SUNETs Ladokadapter?

SUNETs Ladokadapter är en tjänst som alla lärosäten inom ramen för SUNET kan beställa. Den hjälper lärosätet att erhålla händelser från sin Ladokinstans som XML-meddelanden enligt industristandarden LIS (Learning Information Services). Adaptern är utvecklar utvecklad för att fungera gentemot Ladok 3.

Tjänsten är händelsebaserad - det betyder att adaptern kontinuerligt lyssnar på er Ladokinstans, och när en händelse inträffar i Ladok, så kommer Ladokadaptern att uppfatta detta, berika händelsen med information om objektet som händelsen inträffade för, och publicera det resulterande objektet som ett XML-meddelande. Exempel på hur sådana meddelanden ser ut hittar ni i adapterns dokumentation.

Vad är SUNETs Canvasadapter?

...

Om man väljer att konfugera upp båda ovanstående adaptrar för sitt lärosäte så får man en helhetslöning för att hålla Canvas i synk med Ladok3. Viktigt att komma ihåg är att ingen data flödar åt andra hållet (i dagsläget), dvs en ändring i Canvas reflekteras inte i Ladok, och t.ex. resultat som registreras i Canvas förs INTE automatiskt över till Ladok.

Även om SUNETS Ladok- och Canvasadaptrar är två separata bitar mjukvara och kan användas helt och hållet på egen hand, så har de utvecklats samtidigt och aktiva val har tagits för att de ska fungera väl ihop.

Personal

Personal finns ej i Canvas och måste föras över av lärosätet själv. Det enklaste sättet är att skapa en CSV-fil som laddas upp manuellt i Canvas. Om lärosätet har ett personalsystem eller integrationsplattform som kan producera LIS-meddelanden för sina anställda så kan lärosätet välja att skicka dessa till sin Canvasadapter hos SUNET. Detaljerna kring hur man gör detta hittar ni här: (WIP) Användningsfall: Använd Canvasadaptern för att synka användare från ert personalsystem till Canvas

...

Ett kursrum skapas i Canvas för varje kurstillfälle som skapas i Ladok3. Det går att styra flera kurstillfällen till samma kursrum för att hantera samlästa kurstillfällen utan att skapa duplicerade kurstum i Canvasscenarion där flera kurstillfällen ska ges i kursrum i Canvas, men det blir ingen 100%-ig lösning utan viss handpåläggning kan fortfarande krävas. Följande information förs över till Canvas om ett kurstillfälle

• KurstillfällesID (Ladok)
• Termin
• Tillfällesskod
• Kurskod
• Kursnamn
• Poäng
• Undervisningstakt
• Undervisningstid
• Studieort
• Startdatum
• Slutdatum

...

• Antagning
• Registrering
• Studieavbrott
• Uppehåll 

...

Vid dessa händelser (samt deras inverser, t.ex. antagning borttagen), så skickas ett meddelande till Canvas. Vilken Ladok-händelse som leder till vilken Canvas-status hittar ni under Canvasadapterns dokumentation.

Sammanfattning meddelanden

• Kolumn Ladok avser de meddelanden som kommer från Ladokden händelse i Ladok som Ladokadaptern lyssnar på
• Kolumn LIS avser vilket LIS-meddelande som skapas utifrån Ladok händelsenLadokhändelsen.
• Kimono/Canvas avser vilken SOAP metor metod som används i Canvas LIS implementation.effekt LIS-meddelandet får i Canvas (OM man inte har begärt specialmappningar i Kimono - mer om det senare).

Normalprocess

...

Kort om processen

Processen går att navigera i. Klicka på objekten för korta beskrivningar. Små pilar indikerar att processen är nedbruten, klicka på pilen för att navigera in i processen.

Processen beskriver de viktigaste händelserna från att  ett kurstillfälle skapas i Ladok3 till att kursen är klar i Canvas. Den visar också vad man behöver göra manuellt.

Konfigurering av Processen

SUNETs Ladok3-adapter Canvasadapter skickar standardiserade meddelanden till Canvas. Det går dock att i samråd med Instructure anpassa hur man vill mappa informationen i meddelandet till Canvas för det enskilda lärosätet. Detta görs i ett integrationsverktyg som heter Kimono av personal från Instructure. Nedan beskrivs några typfall av mappningar som styr beteendet i Canvas.

...

Värden som Instructure ska sätta i Kimono:

Tjänstearkitektur

Tjänstearkitekturen bygger på att vi skapar så kallade integrationskontrakt till tjänster definierade i Ladok-adaptern. Tjänsten ritas som en klubba (lollipop) och kontraktet som en konnektor som "griper" om tjänsten. Sync är ett verb som betyder att information synkroniseras ut till potentiellt många informationslavar. Ladok3 är master för samtliga integrationer i denna lösning. Ladok3-adaptern lyssnar på relevanta meddelanden i Ladok3 och sätter ihop en sammansatt meddelande som motsvarar ett helt informationsobjekt, tex studiedeltagande. Meddelandet formateras till ett LIS-meddelande och publiceras på en sk. Topic. Canvas-adaptern lyssnar på Ladok3-adaperns publiceringar och anropas Canvas LIS-API som tar emot meddelandet och gör en sista mappning från LIS till Canvas proprietära format. Detta sker i en produkt som kallas Kimono. I Kimono kan Instructure styra hur informationen mappas - se (WIP) Användningsfall: Använd Ladok- och Canvasadaptern för att synka data från er Ladokinstans till er Canvasinstans.

Image Removed

Lösningsarkitektur

...