Skip to main content
Skip table of contents

LISS Integration API

Overview

The ‘LISS Integration API’ is used for timetable integration with LISS-compatible timetable products.

To use this API, the school must hold a ‘Premium' TASS license or a 'Basic’ license + additional cost. See API Pricing for details.

Important!

LISS integration is only available where a unitised timetable is used.

Important!

The school, username and password must match those in the external timetabling software.

To enable LISS synchronisation, you must enter the following information into the LISS area of your external timetabling software:

  • School, according to the information entered on the ‘General’ tab of this program.

  • Username, according to the information entered on the ‘General’ tab of this program.

  • Password, according to the information entered on the ‘General’ tab of this program.

  • URL: [domain]/tassweb/api/liss/index.cfm

When setting up LISS synchronisation for TES Timetable (formerly Edval), refer to How to Upload Timetable and Subject Data from TES Timetable via LISS Sync.

General Tab

LISS Integration

* School

Enter a school name and ensure it matches the one in your external timetabling software when setting up the LISS synchronisation.

* Username

Enter a username and ensure it matches the one in your external timetabling software when setting up the LISS synchronisation.

* Password

Enter a password and ensure it matches the one in your timetabling software when setting up the LISS synchronisation.

The School, Username and Password are for syncing authorisation purposes between TASS and your external timetabling software. They do not relate to any other information or settings in TASS.

Include Duty

Select the ‘Include Duty’ checkbox to import duties from your timetabling software into TASS.web.

* Default Duty Room Code

This field only becomes active and mandatory when the ‘Include Duty' checkbox is selected.

Select a room to set as the default for all duties.

A room is required to map to duties, as every duty must display a room on timetables, even if no room is actually needed. This may require setting up a dummy room in TASS.web Student Admin > Timetable > Setup Information > Timetable Setup on the ‘Rooms’ tab.

To prevent room clashes in TASS and synchronise all duties, go to the TASS web Student Admin > Timetable > Setup Information > Timetable Setup. On the ‘Timetable Definitions’ tab, set the 'Clash Flag' to 'Yes'. This tells TASS not to manage room or teacher clashes, whether perceived or actual.

Include Staff Meetings

Select the ‘Include Staff Meetings’ checkbox to import Staff Meetings from your timetabling software into TASS.web.

Staff Meetings can sync to TASS, as long as each meeting is set up as a Subject, with a Subject/Class Translation. Only one Subject/Class Translation needs to be set up for each staff meeting code.

* Default Staff Meeting Room Code

This field only becomes active and mandatory when the ‘Include Staff Meetings' checkbox is selected.

Select a room to set as the default for all staff meetings.

A room is required to map to Staff Meetings, as every incoming staff meeting must display a room on the timetables, even if no room is actually needed. This may require setting up a dummy room in TASS.web Student Admin > Timetable > Setup Information > Timetable Setup on the ‘Rooms’ tab.

Student Subject Import Option

Preserve existing data

Select this option to preserve existing subject data in TASS.web. This will only add new subject records that do not currently exist for each student.

Examples

Student changes From 11BUS To 11LEG:

  • 11BUS will be retained on the Student Record 'Subjects' tab, and 11LEG will be added, as they are different subjects.

  • Both subject classes will appear on the student's timetable for the entire timetable definition timeframe, regardless of sync dates.

Student changes From 9ENG  Class A To 9ENG Class B:

  • 9ENG Class A will be retained on the Student Record 'Subjects' tab, as 9ENG is an existing subject. Class level changes will not occur.

  • The student's timetable will display class 9ENGA for the entire timetable definition timeframe, regardless of sync dates.

Overwrite existing with new data

Select this option to overwrite existing data with new data.

Example

If a student’s TASS.web record shows English Class A and the upload file has English Class B, then the TASS.web record will be updated to English Class B.

It will also add new subject records that do not currently exist for each student.

Examples

Student changes From 11BUS To 11LEG:

  • 11BUS will be retained on the Student Record 'Subjects' tab, and 11LEG will be added, as they are different subjects.

  • Both subject classes will appear on the student's timetable for the entire timetable definition timeframe, regardless of sync dates.

Student changes From 9ENG  Class A To 9ENG Class B:

  • 9ENG Class A will be removed from the Student Record 'Subjects' tab, and 9ENG Class B will be added. Different classes of the same Subject cannot both be recorded within the same timetable definition.

  • The student's timetable will display class 9ENGB for the entire timetable definition timeframe, regardless of sync dates.

Remove ALL existing and create new

Select this option to initially delete all TASS.web subject records for the chosen year and timetable semester for each student in the API request. It will then upload new subject records.

Examples

Student changes From 11BUS To 11LEG:

  • 11BUS will be removed from the Student Record 'Subjects' tab, and 11LEG will be added.

  • 11BUS will appear on the student's timetable for the entire timetable definition timeframe, regardless of sync dates.

Student changes From 9ENG  Class A To 9ENG Class B:

  • 9ENG Class A will be removed from the Student Record 'Subjects' tab, and 9ENG Class B will be added.

  • 9ENGB will appear on the student's timetable for the entire timetable definition timeframe, regardless of sync dates.

Click ‘Save’ when complete.

Related Resources

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.