The ESAS integration client is still maintained, but the recommended way to integrate with WISEflow is to use the WISEflow API
ESAS is an integration client that fetches data directly from ESAS to WISEflow. Danish University Colleges, Business Academies, and Maritime Institutions use ESAS. The data is automatically synchronised once every 24h.
In this article:
The ESAS integration client is made of two parts:
- Fetch to lookup information on a specific assessment
- Export to send grades back to ESAS
Set up flow
To set up a flow with data from ESAS choose 'esas' as a source:
To fetch a single assessment, enter the 'Assessment stage number' (Bedømmelsesrunde-nummer in Danish), this parameter makes the unique exam identifier used to fetch the correct data
Import
The following data is fetched from ESAS when creating a flow:
Assessment info
| Response to WISEflow | Value from ESAS | Reference field in WISEflow |
|---|---|---|
| title | esas_navn on Bedoemmelsesrunde | Flow title |
| subTitle | esas_navn on esas_planlaegningsuddannelseselement | Sub title |
| gradeType | esas_karakterskala on esas_planlaegningsuddannelseselement | Grade type |
| ectsWeight | esas_ects on esas_planlaegningsuddannelseselement | ECTS |
Note
We only import assessments that have status code = 0 and does not have status code = 742980000. This means that we only pull active students that have not already been graded. This also means if the student is set to be inactive or a grade has been set directly in ESAS, then the student will not be removed or deactivated in WISEflow. The synchronisation of participants follows the standard synchronisation rules and depends on the flow state and dates.
Participant info
| Response to WISEflow | Value from ESAS | Reference field in WISEflow |
|---|---|---|
| nationalId | esas_cpr_nummer on person | National Id |
| firstName | concatenated FirstName and MiddleName from person | First name |
| lastName | LastName from person | Last name |
| emails | esas_studiemail from personoplysning | Email address |
| additionalIds | esas_lokalt_studienummer from personoplysning | Student number |
| uniqueExamId | esas_bedoemmelseId from bedoemmelse | Unique exam Id |
Additional information
For a general guide on how WISEflow will synchronise data from an SIS system, please read the articles on Integration Logic and How Users are Synchronised During the Flow Lifecycle.
Export
When grades are exported from WISEflow to ESAS, the following data is sent:
| Response from WISEflow | Value to ESAS |
|---|---|
| gradeExports | |
| uniqueExamId | esas_bedoemmelseId |
| grade | |
| grade | esas_karakter_id |
| date | esas_bedoemmelsesdato |
| fields | |
| title | esas_titel (Only exported if added as a Cover sheet on the flow) |
| internationalTitle | esas_engelsk_titel (Only exported if added as a Cover sheet on the flow) |
The article Grade Export: Rules and Technical Setup describes grade export in detail.
Fetching participant Organisation IDs
Organisation ID is not fetched directly from esas, but added via the institution’s own user database. When users log in to WISEflow using the institution’s login method (WAYF) for the first time, the organisation ID is automatically added via the National ID (CPR) already fetched from ESAS.
For institutions that do not release or display National ID via login methods, like WAYF, WISEflow attaches organisation ID to users via other databases like UCFMD and MetaDIR. This happens automatically at user creation by the SIS integration.
When we fetch an Organisation ID from UCFMD or MetaDir it is always added to the user. If an ID is updated in UCFMD or MetaDir, the ID will not be updated in WISEflow but instead added to the user. This means that the user in WISEflow will have two IDs.
If WISEflow receives more than one ID from the source (only relevant on UCFMD) all IDs will be added to the user.
Read more on UCFMD and MetaDIR in this article: User Information Systems: UCFMD and MetaDir