The SITS - Brunel integration client is still maintained, but the recommended way to integrate with WISEflow is to use the WISEflow API
SITS - Brunel is an integration client that fetches data directly from SITS to WISEflow. The data is automatically synchronised once every 24h.
In this article:
The SITS - Brunel 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 SITS - Brunel
Set up flow
To set up a flow with data from SITS two sources can be used to set up the flow: 'SITS class-list' and 'SITS - assessments': 
Depending on the information available, you can either choose 'Choose from list' or 'Enter code':
SITS assessment
If SITS assessments are used to create a flow there are two options; 'Choose from list' and 'Enter code': 
To build a list of fetchable assessment use 'Choose from list' the following parameters must be entered; 'Module code', 'Year', 'Occurrence', 'PSL code', and 'Resit': 
If an assessment in returned, it is possible to fetch the additional data from the list by selecting the source
To fetch a single assessment with 'Enter code' the following parameters must be entered: 'Module short', 'Year', 'Occurrence', 'PSL code', 'Map code', 'Sequence' and 'Resit'. These parameters make the unique exam identifier used to fetch the correct data: 
This will return a single assessment
SITS class-list
If SITS class-list is used to create a flow, a class will be fetched from SITS and added to the flow. To fetch a class-list the following parameters must be entered: 'Module short', 'Year', 'Occurrence', 'PSL code', and 'Resit'. These parameters make the unique exam identifier used to fetch the correct data: 
| WISEflow Resit parameter | Function from SITS - Brunel |
|---|---|
| Ordinary If Resit = false |
SAS |
| Resit If Resit = true |
RAS |
This will return a single class.
Import (SITS assessment)
The following data is fetched from SITS when creating a flow:
Assessment info
| Response to WISEflow | Value from SITS - Brunel | Reference field in WISEflow |
|---|---|---|
| examId | module year occurrence period assess_pattern assess_item |
MOD_CODE AYR_CODE MAV_OCCUR PSL_CODE MAP_CODE MAB_SEQ ORDINARY (not used in the request) |
| title | moduleTitle | Flow title |
| examType | 0 if ordinary, 1 if resit | Type |
| gradeType | markScheme | Grade type |
Participant info
| Response to WISEflow | Value from SITS - Brunel | Reference field in WISEflow |
|---|---|---|
| organisationId | organisationId | Organisation Id |
| firstName | forname1 forname2 forname3 | First name |
| lastName | surname | Last name |
| emails | Email address | |
| userAlias | name | Alias |
| uniqueExamId | ||
| name | BrunelExamId | |
| value | uniqueExamId.examId | |
| dispensation | ||
| gradeType | uniqueExamId.stuMarkScheme | Individual participant grade type |
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.
The following data is fetched from SITS when creating a flow:
Assessment info
| Response to WISEflow | Value from SITS - Brunel | Reference field in WISEflow |
|---|---|---|
| title | moduleTitle | Flow title |
| examType | 0 if ordinary, 1 if resit | Type |
Participant info
| Response to WISEflow | Value from SITS - Brunel | Reference field in WISEflow |
|---|---|---|
| organisationId | organisationId | Organisation Id |
| firstName | forname1 forname2 forname3 | First name |
| lastName | surname | Last name |
| emails | Email address | |
| userAlias | name | Alias |
| uniqueExamId | ||
| name | BrunelExamId | |
| value | uniqueExamId.examId | |
| dispensation | ||
| gradeType | uniqueExamId.stuMarkScheme | Individual participant grade type |
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
When grades are exported from WISEflow to SITS, the following data is sent on an ordinary assessment:
| Response from WISEflow | Value to SITS - Brunel | Tag in SITS - Brunel |
|---|---|---|
| examId | module year occurrence period assess_pattern assess_item |
MOD_CODE AYR_CODE MAV_OCCUR PSL_CODE MAP_CODE MAB_SEQ |
| reexam | false | |
| endDate | UNIX timestamp from WISEflow for participation period | |
| gradeExports | ||
| exportName | exportName | SURN1 |
| uniqueExamId |
student |
|
| grade | ||
| grade | mark (Following assessment types are available for export: Passed/Not passed, Percentage, F-A*) | |
| date | originalDate + originalTime | |
| individualEndDate | extensionDate + extensionTime | |
| submissionDate | submissiondate + submissionTime |
Note
Only the administrative assessment type NS (non-submission) is available for export.
Resit
| Response from WISEflow | Value to SITS - Brunel | Tag in SITS - Brunel |
|---|---|---|
| examId | module year occurrence period assess_pattern assess_item |
MOD_CODE AYR_CODE MAV_OCCUR PSL_CODE MAP_CODE MAB_SEQ |
| reexam | true | |
| endDate | UNIX timestamp from WISEflow for participation period | |
| gradeExports | ||
| exportName | exportName | SURN1 |
| uniqueExamId |
student |
|
| grade | ||
| grade | mark (Following assessment types are available for export: Passed/Not passed, Percentage, F-A*) | |
| date | originalDate + originalTime | |
| individualEndDate | extensionDate + extensionTime | |
| submissionDate | submissiondate + submissionTime |
Note
It is not possible to export to SITS if the type SITS class-list has been used.
The article on Grade Export: Rules and Technical Setup describes the grade export in detail.