How to LISS Sync with Timetabling Solutions for Daily Room Changes & Teacher Substitutions
This article outlines the process for LISS synchronising Daily Room Change and Daily Teacher Substitution data between Timetabling Solutions and TASS.web.
This LISS integration allows push-button or automatic synchronisation between TASS.web and Timetabling Solutions, without the need for .csv file exports/uploads.
LISS sync is only available to schools running a Unitised Timetable.
In Timetabling Solutions, the Global Administrator role is required to configure LISS integrations. Once established, the synchronisation process can be scheduled or manually triggered in Daily Organiser by clicking the sync button on the Daily Organiser Home Page.
Step | Menu Path | Details | ✅ | |||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | TASS.web System Admin > Utilities > API Gateway Maintenance on the ‘External APIs’ tab. | Set up your LISS Integration Gateway in TASS.web. Select ‘View’ in the same row as ‘LISS Integration APIs’ and enter your LISS Integration Details. Refer to the 'LISS Integration APIs’ article for more information. The School, Username, and Password fields are used solely to authorise synchronisation between TASS.web and Timetabling Solutions; they do not affect any other TASS information or settings. | 🔲 | |||||||||||||||||||||||||||||
2 | TASS Knowledge Base > How To / Checklists > HOW - Timetable | Ensure your TASS.web data is properly formatted for transfer to and from Timetabling Solutions. See ‘How to Upload Timetable and Subject Data from Timetabling Solutions’ for more information about how certain TASS.web programs and fields need to be set up to facilitate the sync. You must have Subject Class Translations in place to enable the sync. A manual timetable import may help verify data quality. If an errors occur during the manual upload, check the TASS.web System Admin > Utilities > Exception Log for details. | 🔲 | |||||||||||||||||||||||||||||
3 | Timetabling Solutions | Ensure you are running Timetabling Solutions software version number 10.1.0.104 or later. | 🔲 | |||||||||||||||||||||||||||||
4 | Timetabling Solutions Knowledge Base > Technical Support - Desktop | Before syncing LISS, Timetabling Solutions recommends performing a LISS Pre-Export Compliance Check to ensure your timetable data is in the correct format. | 🔲 | |||||||||||||||||||||||||||||
5 | Timetabling Solutions Management Portal > [2] Configuration > [2A] Manage School | In Timetabling Solutions, open the Management Portal, then, in the right-hand task tree, go to [2A] Manage School. Ensure your school has both ‘School’ and ‘Campus’ information entered. If your school has multiple timetables, assign a separate campus to each timetable and complete the following steps for each timetable. | 🔲 | |||||||||||||||||||||||||||||
6 | Timetabling Solutions Timetable Development and Timetabling Solutions Daily Organiser | Ensure your timetable is up to date and has been published to the Timetabling Solutions Daily Organiser. Published Timetables appear in Timetabling Solutions Daily Organiser. From here, select Open, then choose the relevant ‘Campus’ and ‘Academic Year’. | 🔲 | |||||||||||||||||||||||||||||
7 | Timetabling Solutions Management Portal > [6] Daily Organiser > [6A] Organisers. | In Timetabling Solutions, open the Management Portal, then, in the right-hand task tree, go to [6A] Daily Organiser. Right-click the file you want to use for syncing, then select ‘Mark Published'. A 'globe’ icon will appear on the file to indicate it will be used with endpoints for the sync. | 🔲 | |||||||||||||||||||||||||||||
8 | Timetabling Solutions Management Portal > [7] Integrations > [7A] SIF/LISS Integrations | In Timetabling Solutions, open the Management Portal, then, in the right-hand task tree, go to [7A] SIF/LISS Integrations. In the top left corner of the screen, click ‘+ Add', then select ‘LISS Provider’. Enter the settings below:
When doing this for the first time, click 'Save and Validate'. After clicking ‘Save and Validate’, a new row of buttons should appear at the bottom of the screen for ‘Validate’, ‘Syncronise’ and ‘View Log’. If you have done this process before, click ‘Save’. Then, click the ‘Validate’ button to confirm that the service account details are able to connect. You will receive an email from Timetabling Solutions within minutes confirming if the details are correct. If you receive the successful validation email, proceed to the next step. If validation fails, ensure the details exactly match the instructions above and try again. The ‘Timetable Structure’ field only appears after you have connected TASS.web to Timetabling Solutions. After a successful validation, review this field and enter the relevant ‘Timetable ID’ number from TASS.web. Then, click ‘Synchronise’. During peak times, if several schools are syncing at the same time, you may experience delays of up to 20 minutes. However, most syncs are complete within a few minutes. After a few seconds, click ‘View Log’ to view the progress of each call. Check that the ‘Publish Classes’ endpoint has successfully synchronised. Review the 'Select the integration calls you want to perform with this LISS partner' field in Integration Details, and select the endpoints relevant to the LISS sync you want to implement. Daily Room Changes To sync Daily Room Changes between Timetabling Solutions Daily Organiser and TASS.web Student Admin > Timetable > Timetable Information > Daily Room Changes, you must select these endpoints:
Click ‘Save’. Daily Teacher Substitutions To sync Daily Teacher Substitutions between Timetabling Solutions' Daily Organiser and TASS.web Student Admin > Teacher Records > Leave & Substitutions > Leave & Substitutions > Daily Substitutions, you must select these endpoints:
Click ‘Save’. Then click ‘Synchronise'. After a few seconds, you can click ‘View Log’ and view the progress of each call. Check that the selected endpoints have synchronised. The ‘Publish Daily Data’ endpoint is not available for this LISS integration. | 🔲 | |||||||||||||||||||||||||||||
9 | Timetabling Solutions Daily Organiser | In Daily Organiser, select ‘Open’, then choose the ‘Campus’ and ‘Academic Year’ for the timetable. Complete a test room change and/or teacher substitution to test synchronisation with TASS.web, following your usual processes. Then, from the Daily Organiser Home Page, select ‘Publish Daily Organiser,' then ‘Sync.' | 🔲 | |||||||||||||||||||||||||||||
10 | TASS.web Student Admin > Timetable > Timetable Information > Daily Room Changes and/or TASS.web Student Admin > Teacher Records > Leave & Substitutions > Leave & Substitutions > Daily Substitutions | Go to TASS.web and check that your test data has synchronised as expected from Timetabling Solutions. If you configured Daily Room Changes, check the data in TASS.web Student Admin > Timetable > Timetable Information > Daily Room Changes. If you configured Daily Teacher Substitutions, check the data in TASS.web Student Admin > Teacher Records > Leave & Substitutions > Leave & Substitutions > Daily Substitutions. | 🔲 | |||||||||||||||||||||||||||||
11 | Timetabling Solutions Management Portal > [7] Integrations > [7A] SIF/LISS Integrations | Optional. After setting up synchronisation, you can schedule sync times if desired. In Timetabling Solutions, open the Management Portal, then, in the right-hand task tree, go to [7A] SIF/LISS Integrations. Select the LISS Provider setup that you completed earlier. Enter a sync time into the ‘Sync at specific time’ field and click ‘Save’. You can then check the synchronisation status of your programs and perform a manual sync in Timetabling Solutions Daily Organiser by navigating to the Home Page, selecting ‘Publish Daily Organiser,’ then ‘Publish On/Off’ or ‘Sync.’ | 🔲 | |||||||||||||||||||||||||||||
12 | TASS Knowledge Base > How To / Checklists > HOW - Timetable | If your school has multiple timetables, complete steps 6 to 11 of the checklist above for each timetable that you want to sync. | 🔲 |