Ladok Integration

Ladok is an integration client that fetches data directly from Ladok to WISEflow. The data is automatically synchronised once every 24h.

In the article:

• Set up flow
• Import (LiU and OrU)
• Import (Borås)
• Export (LiU and OrU)
• Export (Borås)

Ladok is an integration used by some Swedish universities:

• Linköping University (LiU)
• Örebro University (OrU)
• University of Borås

The Ladok integration client is made from three parts: 

• List to show a list of fetchable assessments 
• Fetch to lookup information on a specific assessment
• Export to send grades back to Ladok

Set up flow

To set up a flow with data from Ladok choose the source correspomding to your university:

Depending on the information available, you can either choose 'Vålj från lista' (Choose from list) or 'Ange kod' (Enter code):

Choose from list 

To build a list of fetchable assessments, you must enter one parameter: 'kursKod':
If an assessment in returned, it is possible to fetch the additional data from the list 

 

Enter code

To fetch a single assessment, enter the UID from Ladok. This parameter make the unique exam identifier used to fetch the correct data:
This will return a single assessment

 

Import (LiU and OrU)

The following data is fetched from Ladok when creating a flow:

Assessment info  

LiU and OrU:

Response to WISEflow	Value from Ladok	Reference field in WISEflow
title	courseCode courseName	Flow title
subtitle	examCode examTitle	Subtitle
participantStartDate	examStartDate + startTime	Start date for Participants
participantEndDate	examEndDate + endTime	End date for Participants
assessmentEndDate	sensurfrist	End date for marking
gradeType	gradeScale	Grade type

Room information (LiU):

Response from WISEflow	Value from Ladok
id	campus
Room	campus

Participant info

LiU:

Response to WISEflow	Value from Ladok	Reference field in WISEflow
organisationId	LiUId	Organisation ID
nationalId	civicNumber	National ID
firstName	firstname	First name
lastName	lastname	Last name
emails	email	Email address
externalUserId	studentUID	Student number
uniqueExamId	uniqueExamId	Unique Exam ID
individualParticipantEndDate	endTime	Individual participation end date

OrU:

Response to WISEflow	Value from Ladok	Reference field in WISEflow
organisationId	studentuid	Organisation ID
nationalId	civicNumber	National ID
firstName	firstname	First name
lastName	lastname	Last name
emails	email	Email address
externalUserId	studentUID	Student number
uniqueExamId	uniqueExamId	Unique Exam ID
individualParticipantEndDate	endTime	Individual participation end date

Additional information

For a general guide on how WISEflow will synchronise data from a SIS system, please read the articles on Integration Logic and How Users are Synchronised During the Flow Lifecycle.

Import (Borås)

The following data is fetched from Ladok when creating a flow:

Assessment info  

Response to WISEflow	Value from Ladok	Reference field in WISEflow
title	kursKod, kursNamn	Flow title
subtitle	moduler, aktivitetsTillfallesNamn	Subtitle
participantStartDate	startDatum, startTid	Start date for Participants
participantEndDate	slutDatum, slutTid	End date for Participants
gradeType	betygskala	Grade type

Participant info

Response to WISEflow	Value from Ladok	Reference field in WISEflow
organisationId	federeradIdentitet	Organisation ID
nationalId	personnummer	National ID
firstName	fornamn	First name
lastName	efternamn	Last name
emails	epost	Email address
externalUserId	studentUID	Student number

Additional information

For a general guide on how WISEflow will synchronise data from a SIS system, please read the articles on Integration Logic and How Users are Synchronised During the Flow Lifecycle.

 

Export (LiU and OrU)

When grades are exported from WISEflow to Ladok, the following data is sent:

LiU:

Response from WISEflow	Value to Ladok
gradeExports
uniqueExamId	studentUid
organisationId	liUID
grade
grade	grade

LIU will always prefer the uniqueExamId in the export. If this is not possible (in the case of a manual creation of a participant), they will accept the organisationId.  

OrU:

Response from WISEflow	Value to Ladok
gradeExports
uniqueExamId	studentUid
organisationId	studentUid
grade
grade	grade

OrU will always prefer the uniqueExamId in the export. If this is not possible (in the case of a manual creation of a participant), they will accept the organisationId.  

The article on Grade Export: Rules and Technical Setup describes the grade export in detail.

Export (Borås)

When grades are exported from WISEflow to Ladok, the following data is sent:

Response from WISEflow	Value to Ladok
managers
organisationId	federeradIdentitet*
gradeExports
organisationId	federeradIdentitet
externalUserId	studentUID
nationalId	personnummer
grade
grade	betyg
points	poang

The article on Grade Export: Rules and Technical Setup describes the grade export in detail.

*Note that only some managers are allowed to export