Skip to content
  • There are no suggestions because the search field is empty.

Add a SIS Source to a Flow and Synchronise

This case covers how you can use the WISEflow API to add an SIS source to a flow and synchronise.

Adding a SIS source to a flow requires that your institution have a custom integration with WISEflow. A custom integration ensures that data from your SIS system can be interpreted by WISEflow and vice versa.

A custom SIS integration is already automated to some extent; creating a flow in WISEflow from an SIS source will automatically fetch data from the source and keep it synchronised. 

You can read more on how WISEflow updates flow data and user data in these articles: Updating flow information and Updating user information

Adding a source to a flow

This example presumes that you have already created a flow (either directly in WISEflow or using the API).

Using the flowId from the newly created flow, the ​POST /flow​/{flowId}​/source​/add endpoint is used to attach a source to a flow.

In the body, you must enter the source code (the unique examination Id from the SIS source) and the integrationId, you can also choose if you want to replace the flow metadata (Title, Subtitle, Term, Examination type, Purpose, Grading scale, and ECTS) and dates with the data from the source. The integrationId is unique per licence, if you need to find the ID, you can use GET /license/sis/clients.

{
  "sourceCode": "UNIwise||001||2021",
  "integrationId": "29",
  "useSisMetaData": false,
  "useSisDates": false
}

When a source has been successfully added to the flow, an HTTP status code 204 will be returned.

Synchronise

On the flow management page in WISEflow, you can click Synchronise with SIS to instantly synchronise. As an alternative, flows will automatically be synced with their source every night.