Ladok LIS-adapter lyssnar på händelser från Ladok och konverterar dessa till LIS-meddelanden. Dessa kan lärosätena sedan ta del av via egen AMQP-kö, alternativt AMQP-kö som Ladokkonsortiet tillhandahåller. Inspera hämtar sedan meddelanden från denna kö och lägger in i systemet. För rapportering av resultat är flödet det omvända. LIS-adapter hämtar de LIS-meddelanden som Inspera lägger på en utgående kö, konverterar dessa och skriver sedan informationen till Ladok. De standarder som används är LIS (OneRoster/Learning Information Services/Edu-API | IMS Global Learning Consortium) och AMQP 1.0. För tillfället stöds endast uppkoppling mot lärosätets kö, från Inspera, med användarnamn/lösenord.

Vad krävs?

Lärosätet behöver vara anslutet till Ladok-LIS adapter (se: LIS-dokumentation - Ladok Integrationer, för åtkomst till denna del av Ladoks Confluence krävs ett supportärende till lärosätets Ladoksupport). För rapportering av resultat går det att välja om skrivningspoäng ska läggas in. 

AMQP-köer

Lärosätet behöver två köer för meddelandehantering, enligt AMQP 1.0. På den ena kön läggs meddelanden som kommer från Ladok (aktivitetstillfällen och anmälan på dessa). Se Teknisk beskrivning i dokumentet ovan för exempel på hur man kan filtrera ut endast dessa medelanden. På den andra kön läggs meddelanden som kommer från Inspera (resultat). Köerna kan antingen tillhandahållas, sättas upp och administreras av lärosätet, eller tillhandahållas av Ladokkonsortiet. Inspera autentiserar sig med användarnamn och lösenord.

• Om det på lärosätet finns en egen infrastruktur för att hantera AMQP 1.0-köer så kan det vara en fördel att tillhandahålla egna köer. Eller om det finns specifika behov kring egen övervakning eller andra tekniska krav.
• Om lärosätet inte har denna infrastruktur, eller tillräckliga incitament för att skapa en sådan, så kan köerna istället tillhandahållas av Ladokkonsortiet.

Studenter

För att studenten ska kunna matchas med anmälan på aktivitetstillfället behöver studentens Ladok UUID (StudentUid) knytas till studenten vid inloggningen i systemet. Detta värde kommuniceras via attributet norEduPersonLIN i samband med att attribut släpps. Se vidare SWAMIDs rekommendationer How-To - Ladok StudentUID vid attributerelease - Sunet Wiki. OBS: Inspera klarar bara av ett värde i detta attribut, trots att standarden säger det kan vara multipla värden. För befintliga kunder kan detta innebära att en konvertering av befintliga studentanvändare behöver utföras av Inspera!

Till lärosätets kö/Inspera inkommande meddelanden

• Nytt aktivitetstillfälle: groupRecord + lineItemRecord (OriginEvent = "LADOK.AddActivityOccasion")
• Ta bort aktivitetstillfälle: groupRecord + lineItemRecord (OriginEvent = "LADOK. RemoveActivityOccasion")
• Inaktivera aktivitetstillfälle: groupRecord + lineItemRecord (OriginEvent ="LADOK. ModifyActivityOccasionStatus", education.activityoccasion.status = "Inactive")
• Aktivera aktivitetstillfälle: groupRecord + lineItemRecord (OriginEvent = "LADOK. ModifyActivityOccasionStatus", education.activityoccasion.status = "Active")
• Anmälan till aktivitetstillfälle: membershipRecord (OriginEvent = "LADOK.AddActivityOccasionApplication", status = "Active")
• Avanmälan till aktivitetstillfälle: membershipRecord (OriginEvent = "LADOK. RemoveActivityOccasionApplication", status = "Inactive")
• Person i samband med anmälan på aktivitetstillfälle: personRecord (OriginEvent = "LADOK.AddActivityOccasionApplication")

Filtrering / Headers

Lärosätet filtrerar i sin inkommande kö, med hjälp av meddelandets header, så att endast de ovanstående LIS-meddelandena finns att hämta för Inspera.

...

<filter string="ladok_activityinstancetypeid='151856' OR ladok_activityinstancetypeid='151857'"/>

Från lärosätets kö/Inspera utgående meddelanden

Följande data skickas från Inspera:

...