E10 - Synchronisation to Jacaranda via Export

Modified on Mon, 22 Sep at 3:27 AM

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 Tes Timetable file are 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.

This document outlines the synchronisation process to Jacaranda.

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 exporting a csv file that has been correctly formatted, ready uploading into Jacaranda.

The Jacaranda export function will export only one TXT file:

JACARANDA.TXT

Which data is sent to the other system?

This table lists many of the data and features found in Tes and, where known by Tes specialists, whether they are also 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 feature	Notes on feature	Is this feature received by the other system?	Other Notes
Bell times		No
Classes	Classes as per Class data screens	Yes
Class lists		Yes
Composite (linked) classes	One teacher teaching more than one class at the same time	Yes
Duty roster		No
Faculty data		No
Grid structure codes		No
Multi-file	Two or more .etz timetable files	No
Multi-grid	More than one bell times structures set up	No
On-call roster		No
Priority classes	The chosen class on a student's timetable where they have class clashes.	No
Room data	Room Code, Name, Size, Campus, Comment	No
Rotation classes	Classes from particular rotations	Yes	Tes exports rotation based on current rotation in the settings->file->current rotations.
RTO roster		No
Student data	Last Name, First name, Year level, Email	Yes
Study roster	Study classes, staffing and rooming roster	No
Sub-classes		Yes
Teacher data	Last Name, First name, Email	Yes
Teacher days off (Unavailables)		No
Timetable data		Yes
Two (or more) rooms at once		No
Two (or more) teachers at once	A class with two or more teachers at the same time	No
Year levels	Year levels such as SPT, LSUP, ROLL 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 Jacaranda.

Steps to synchronise data

Step 1: Check if any Jacaranda set up is required

Many systems require some set up prior to receiving timetable data from Tes. Check with Jacaranda

Step 2: Configure the Timetable file

Open the relevant Tes timetable file, and go to File > Synchronise > Configure > Sync tab
Select the + button and choose 'Jacaranda' (csv) from the drop down menu.

Multiple systems can be set up to sync. It is common to have both the Edval webserver, the schools learning management system configured, along with any other systems the school wishes to regularly sync to.

Select the Configure button, which will move you to the Connection tab. A destination folder must be selected to direct where the .csv files will be saved. Select Browse and locate or create the desired location.

Select Connection:

Enter the name of the folder where the export csv is to be stored.

'Sync each time you save' - This means, sync will occur automatically on a ctrl-S save. In this case, data is first saved locally to disk, and then an attempt is made to sync with all external systems. This is simple, but you may want to disable this if the external systems or your network is slow to sync, or you want more control about 'when' you publish data through to other systems. No message is shown on a sync-on-save, as it is done quietly. Only active sync via menu/ctrl-K will show a completion message.

Step 3: Perform the sync export

Go to File > Synchronisation > Sync now.
Ensure ‘Jacaranda’ is selected from the dropdown in the top-right corner.
Select Create TT publish file
Choose your rotation to be exported.

Select OK

You can navigate to the file location to look at the data if desired.

The below table explains what type of csv file contains when exported:

File Name	Data column (A)	Data column (B)	Data column (C)	Data column (D)	Data column (E)	Data column (F)	Data column (G)	Data Column (H)	Data Column (I)
JACARANDA.TXT	As per Jacaranda's request this column is left blank.	Class Code	Email (Student &Teacher)	Jacaranda Password (This column is requested by Jacaranda to be left blank)	Last Name (Student &Teacher)	First Name (Student & Teacher)	Year Level	User Role (E.g. student & Teacher)	Class Name (Subject Name)

Step 4: Upload/Import the TXT files into Jacaranda

Please refer to Jacaranda documentation for instructions on how to upload/import the TXT files.

To import the file to Jacaranda, please follow their support statement below:

To provide to Jacaranda, please save the file name to include your school name and upload the export directly to Jacaranda here Once uploaded, email the Jacaranda Customer Success Team at custdev@wiley.com to arrange for user set up.