Sentral - Atlantis Integration

Overview

The Atlantis - Sentral integration enables schools to synchronise timetable, class, and student data between systems.

Key capabilities

• Import student enrolments from Sentral into Atlantis
• Publish timetable and class structure from Atlantis to Sentral
• Send daily timetable changes (via Atlantis Covers)

How data flows

• Pull from Sentral to Atlantis: students, enrolments
• Push from Atlantis to Sentral: timetable, classes, daily changes

Systems Involved/Prerequisites

• Atlantis Timetable
• Atlantis Covers
• Sentral 

How to set up the Atlantis - Sentral integration in Sentral

Overview

Configure the Atlantis-Sentral integration by enabling LISS settings and creating a service account for synchronisation.

Prerequisites

• Permission to access Setup and manage service accounts
• JSON Payloads enabled. Follow these steps:

       1.  Go to Setup > Integrations
       2.  Locate GenericLISS

             
       3. Select Configure. The LISS Settings screen displays
       4. Set Accept JSON Payloads to Yes.

      5. Select Save.

Steps to set up Service Account

If you do not have a service account configured for timetable integration, follow these steps:

1. Go to Setup > User Accounts.
2. Select Manage Service Accounts.
   
3. Select New Service Account. The Service Account Details screen displays.
   
4. Enter a username. You will use this username to set up the integration in Atlantis.
5. Enter other relevant details.
6. Set Restricted Function to LISS Synchronisation in the dropdown menu.
7. Select Save. The Manage Service Accounts screen displays. A green banner at the top displays the generated password for the new service account.
   
8. Record the generated password.

IMPORTANT: Ensure the password is stored safely because it cannot be retrieved later.

You can now set up the integration in Atlantis.

How to set up the Atlantis - Sentral integration in Atlantis

Overview

Create a Sentral integration in Atlantis to connect your system and synchronise data

Prerequisites

• Sentral service account username and password

Steps to follow in Atlantis

To set up an integration in Atlantis with Sentral:

1. Go to File > Integrations.
2. Select Add integration.
   
3. Select Sentral from the list of systems displayed
4. Select Add. Sentral displays in the list of integrations
5. Select Sentral. The Sentral configuration screen displays in the Configure & Run tab
   
6. Enter the Sentral URL
7. Enter the Sentral username.
8. Enter the Sentral password.
9. Enter your Sentral school code.
10. Make sure Use XML-RPC is not checked.
11. If you are using Covers and want that information to be sent automatically to Sentral when publishing, check the box for Auto-publish covers data.
    
12. Select Test to test the connection
13. Select Save.

The integration is now complete. 

IMPORTANT: After setup, perform an initial pull of students and enrolments.

How to sync data from Atlantis to Sentral

Overview

• Integration with Sentral configured

Steps

1. Go to File > Integrations.
2. Select Sentral. The Sentral dialog displays in the Configure & Run tab.
3. Select Sync now. A new dialog displays. 
4. To receive data from Sentral. find the Pull section.
   
5. Select the data you want to receive from Sentral. 
6. To send data to Sentral, find the Push section.
   
7. Select the data you want to send to Sentral. Typically, this is
   a) Classes
   b) Classlists
   c) Timetable
    
8. Select the required date range
   
    
9. Select Send/Receive.

The data you selected will be synced with Sentral. You can find it in the Timetables module.

IMPORTANT: The sections DANGER ZONE can be useful when doing the initial data migration into an empty data set. Otherwise you should only use it if advised by Atlantis.

How to sync data manually from Sentral Timetables to the rest of Sentral

Prerequisites

• Access to Sentral Setup

Steps

1. Go to Timetables. Review the Last Synchronised time.
   
2. Select Setup > Data Synchronisation. The Sentral Data Sources screen displays.
3. Review the time of Last Synchronisation, on the left. 
   
4. Select Synchronise Now if there has been an update from Atlantis since the last synchronisation.
5. Check the confirmation checkbox to confirm that you want to do a manual synchronisation. 
6. Select Confirm.

Once the manual synchronisation is completed, the time of Last Synchronisation is updated, and data from the Timetables module is available in the rest of Sentral. 

How to publish daily covers to Sentral

Overview

Publish daily covers changes from Atlantis Covers so updates are visible to teachers and sent to Sentral.

NOTE: The Covers product is dependent on the Timetable product for data. The Covers product gets data about the cyclical timetable from the “official Timetable version” i.e. the one whose name equals the academic year e.g. “2027” for a Southern Hemisphere school or “2027-28” if you’re a northern hemisphere school.

The Covers product needs to be kept up-to-date with changes to the Timetable product. This happens automatically within 10 minutes of a change being made in the Timetable product, but you can also invoke it immediately in the Covers product via “File > More > Pull data from timetable”.

Prerequisites

• Access to Atlantis Covers
• Integration with Sentral configured
• (Optional) Auto-publish covers data to Sentral enabled
• Atlantis Covers is in sync with Atlantis Timetable: In Covers, select File > Pull data from timetable, if an immediate update is required.

Steps

Either

1. Go to File > Integrations within Covers or Timetable. Both options lead to the same screen. 
2. Select Sentral then select Sync now. 
3. On a regular basis you can now
   1. Pull students from Sentral to get new enrolments/disenrolments
   2. Push the Timetable to Sentral any time the cyclical timetable has changed
   3. Push classlists to Sentral with date ranges
   4. Push daily data to Sentral

Or

1. Go to the main screen of Covers.
2. Select the Publish changes button. The button will be red if there are pending changes. This makes the changes visible to teachers in Atlantis. If you have enabled Auto-publish covers data in the Sentral Integration, it will also push the changes to Sentral. 
   

Trouble Shooting in Atlantis

Overview

Resolve missing or incorrect data in Sentral by verifying timetable sync, publishing updates, and reviewing integration logs within Sentral.

Symptoms

• Sentral does not display expected timetable data
• Students appear in incorrect lessons
• Teachers appear in incorrect lessons
• Recent timetable updates do not appear in Sentral

Causes

• Atlantis Covers and Atlantis timetable might be out of sync.
• Data from Atlantis has not been pushed to Sentral.
• Other

Resolution

1. In Atlantis Covers, select File > More > Pull data from timetable. (This synchronises the two Atlantis products with each other. It should be unnecessary to ever do this, because it happens automatically every 10 minutes, but if there’s any doubt, use it.)
2. Manually sync in Sentral and see if that resolves the issue.
3. If not, go to File > Integrations within Covers or Timetable 
4. Select Sentral, then select Sync now. 
5. Push the data you need to Sentral.
6. Manually sync in Sentral and see if that resolves the issue. If not, you can be your own detective and look at exactly what Atlantis is sending Sentral.  

• Go to File > Integrations
• Select the Logs tab
• Download the latest transcript
• Examine the text file which was downloaded to your Downloads folder

7. Notify the Atlantis team at:  help@atlantis.education. 

1. Provide date
2. Provide period
3. Provide class code
4. Provide any students or teachers that are not displaying correctly
5. Provide expected result in Sentral

They will help you resolve the issue.

Troubleshooting in Sentral

Overview

Resolve missing or incorrect data in Sentral or Atlantis.

Symptoms

• Priority in clash
• JSON
• Two files into one Sentral
• Sync from timetable to PxP
• multi-file/campus support

Causes

• JSON Payloads not enabled
• Data from the Sentral timetables module has not been synchronised to the rest of Sentral
• Other

Resolution

1. Go to Setup > Integrations.
2. Locate GenericLISS.
3. Select Configure. The LISS Settings screen displays. 
4. Set Accept JSON Payloads to Yes.
5. Manually sync in Atlantis and see if that resolves the issue.
6. Manually sync data in Setup > Data Synchronisation.
7. Lodge a Support Case through the Sentral Help Centre in Sentral.

FAQs

Do “Events” in Atlantis Covers go into Sentral PxP for roll marking?

Currently, no. (There has been some discussion about sending Atlantis events into the Sentral “Activities” module using the “liss.publishEventsAndAbsences()” call, and if done then this would enable roll marking, but this is not implemented.)