Help

Integration with iSAMS

Contents [hide]

iSAMS partner

Import

To import (export) data from (to) iSAMS, Skolaris connects via a secure channel to your school's dedicated REST API using specific credentials obtained from iSAMS.

The REST API is only available to iSAMS Partners on the Developer Standard and Enterprise plans and requires the iSAMS client school to have an active subscription to the API Services Manager. 3rd party software suppliers must make it clear to schools that do not currently subscribe to the API Services Manager that this is a chargeable extra that must be budgeted for each year.

Source: iSAMS support website

The credentials with which Skolaris can connect to your iSAMS instance are unique. Please contact iSAMS support to generate them for you.
Never enter your iSAMS username and password into the form!

Open the Import screen via the main navigation's Data section. Click Import from MIS, then the iSAMS icon.

Enter the network address of your iSAMS instance into the School URL field and the credentials obtained from iSAMS into the Client ID and Client Secret fields.

Enter the starting date of the academic term which you want to create the timetable for into the From field.

Click Import to start the import.

After your data has been imported, don't forget to configure your class groups and teachers before proceeding with the timetable creation.

What data does Skolaris import?

Skolaris only downloads data relevant to the timetable creation. These are namely:

  • School name
  • List of subjects
  • List of buildings
  • List of rooms
  • List of year groups
  • List of employees (aka Teachers in Skolaris) marked as teaching staff containing:
    • Forename
    • School initials
    • Surname
    • Title
  • List of forms (Class groups)
  • List of students (Subgroups) (for the purpose of subject options and identifying the composition of class groups and teaching groups in order to recognize clashes in the schedule) containing:
    • Forename
    • Form
    • Surname
    • Code
    • School e-mail (specifically for the purpose of authentication for confirmation of the chosen optional subjects)
  • List of teaching sets (Teaching groups) with lists of included students
  • Active term determined by the From field in the import form
  • Timetable structure, namely:
    • Weeks
    • Days
    • Periods
  • Current timetables for subjects and teachers (if any) in the form of lists of events (scheduled Lessons)

Our certified partnership and non-disclosure agreement with iSAMS ensure the safety of your data. We do not collect non-relevant information or provide school data to other parties.

Export

Using a CSV file

To export the timetable data to iSAMS, go to the list of timetables and click the Actions (three vertical dots) button on the right of the timetable row. Click Export to iSAMS. The CSV file will be downloaded. Upload this file to iSAMS using their timetable import functionality.

What data does Skolaris export?

Using API

To export data of a previously imported organisation back to iSAMS, go to the list of organisations and click the Actions (three vertical dots) button on the right of the organisation row. Click Export to iSAMS. Supply the credentials you used for the import and click Export. After the operation has completed, a summary will be displayed.

The information transferred this way is severely limited.

Please contact us immediately if an error occurs at any point. Mapping data between two different systems automatically is difficult and each school has its own specifics which might require corrections to the importing procedure.

What data does Skolaris export?

Skolaris exports data supported by iSAMS REST API. These are namely:

Unfortunately iSAMS REST API does not support importing the curriculum structure, days, periods or timetables.