E10 - Synchronisation to Posimente via Direct Connection

Modified on Mon, 2 Mar at 6:59 PM

TABLE OF CONTENTS

Preamble
Type of sync
Which data is sent to the other system?
Steps to Synchronise data

Preamble

Timetabling data that exists in timetable files is usually sent on to one or more other non-Tes systems, such as student learning management systems, reporting systems, administration systems, and many more. The Tes integration team works with other systems to make sure that the data required to be sent is in the correct format. The Posimente platform is designed in collaboration with whole school communities to support, manage and improve the well-being of their unique students

This document can be referenced for:

new school file set up
synchronisation processes
synchronisation troubleshooting

While Tes takes all care to ensure any mention to the other system is correct and up to date, it is the user's responsibility to check with the other system prior to an initial sync. If the user becomes aware of any changes to the other system, we would very much appreciate this feedback.

Type of sync

This sync is performed by a 'LISS' sync, which is a sync that sends and receives data at the push of a button with no need to manually upload data into the other system.

Which data is sent to the other system?

This table lists many of the data and features found in Tes and whether they are understood by the other system.

Note that Tes builds many excellent features to help users build high-quality timetables, and while these features can be sent onto the other system through the synchronisation process, not all systems have built the capability on their end to receive/display these features.

Tes Timetable feature	Notes on feature	Is this feature received by the other system?	Other notes
Bell times	Bell times as per the Grid structures	Yes
Campuses	Campuses and their associated rooms	Yes
Classes	Class code, GUID, Faculty, Course Name, Assigned teacher	Yes
Class lists		Yes
Composite classes (linked classes)	One teacher teaching more than one class at the same time	Yes
Duty roster		Yes
Faculty data		Yes
Grid structure codes		Yes	As part of a multigrid structure.
Multi-file	Two (or more) timetable files	Yes
Multi-grid	Multiple grids with different bell times	Yes
On-call roster		Yes
Priority classes	The priority class that shows on students' timetables where they have class clashes	Yes
Room data	As per the room data screen.	Yes
Rotation classes	Classes from particular rotations	Yes	Only shows current rotation classes that are selected in Settings>File>Current rotation
RTO roster		Yes
Student data	Student Code, Name, Preferred name, Year level, Gender, Email	Yes
Study roster	Study classes, staffing and rooming roster	Yes
Sub-classes		Yes	Note: send a sample file with subclasses to be tested.
Teacher data	Teacher Code, Name, Preferred name, Faculty, Gender, GUID	Yes
Teacher's Days Available'		Yes
Timetable data		Yes
Two (or more) rooms at once		Yes
Two (or more) teachers at once		Yes
Year levels (non-numeric)	Year levels such as SPT, LSUP, ROLL, Yr9+10, etc.	Yes

Yes - The data is sent from our end and is being received and processed by 3rd party system.

No - The data is not supported by 3rd party systems and is not sent from Tes.

Unsure - The data is being sent from Tes, but we are unsure if it is being processed and supported by 3rd party system.

Steps to Synchronise data

Step 1: Check if any Posimente setup is required

Many systems require some setup prior to receiving timetable data from Tes. Check with the Posimente Team.

Step 2: Configure the Tes timetable file

Go to File > Synchronise > Configure
Select the ‘Sync’ sub-tab
Click the '+' and select "Posimente" from the dropdown

Go to the ‘Connection’ sub-tab
Ensure that “Posimente” is selected in the top-right corner
Input your credentials. Posimente will provide you with the URL, Username, Password, School code, Client Id, and Client Secret.
Proxy - Not usually required. See your school network administrator if a proxy message appears after testing your connection.
Test Connection - Click "Test Connection" to confirm if the connection is successful.

9. Go to the ‘Other sub-tab and change any options to your preference.

Option	Details
Sync timetable & class lists every time you save	This will send only the timetable and class membership data to Posimente each time you save the file
Exclude Yard duties	When ticked, Yard duties will be ignored for syncing purposes
Exclude Study classes	When ticked, Study classes will be ignored for syncing purposes
Exclude On-calls	When ticked On-calls will be ignored for syncing purposes
Accept Statewide IDs that are sent to Tes	This allows for importing the student's statewide ID in the Student Data > Statewide ID column
Which years?	This option allows you to select the specific year levels to send to Posimente. Please leave all of the year levels unticked if you want all year levels to be synced. Note. This function will only appear if the timetable file is Multi grid.

Step 3: Perform the sync

Basic Sync

To perform a Basic sync:

Go to File > Synchronise > Sync Now, and select the ‘Basic’ sub-tab
Ensure “Posimente” is selected from the dropdown in the top-right corner
Input the date range you wish to update the Posimente data in and select the rotation you wish to sync
Click “Go” to sync

Check course codes: This option will flag classes that have the same course codes but different subject names. Posimente will process both courses as one subject. E.g. 12ENG1 - English and 12ENGA - Engineering. Course code for both classes is '12ENG', and Posimente would label both as either 'English' or 'Engineering'.

Advanced Sync

To perform an advanced sync:

Go to File > Synchronise > Sync Now, and select the ‘Advanced’ sub-tab
Ensure “Posimente” is selected from the dropdown in the top-right corner
Select which data you wish to sync with Posimente
Input the date range you wish to update the Posimente data in and select the rotation you wish to sync
Click “Go” to sync

Create support log file: Occasionally, Tes specialists may ask you to perform a sync and tick this box, which will create a text file in the same location as the timetable file. This file can be sent to Tes to help with troubleshooting.