Overview

With the new Synergetic integration, Orah can provide an in-depth integration that will help ensure your data is consistent and accurate across the board.

What data can you sync?

Orah is capable of syncing a range of school information from Synergetic. See below for the information that can be integrated.

One-way (read-only) sync from Synergetic

Student information
Student contacts information
Houses (dorms) & student assignments
Groups (academics & non academics) & staff to student mappings
Staff information
Attendance history

Enabling in Synergetic

Synergetic API Overview

Orah's most recent Synergetic integration uses the Synergetic (RESTful) API.

Setting up the Orah integration in Synergetic

Follow the getting started instructions at https://developer.synergetic.net.au

In SynWeb, go to System > Interface Settings and select +.
Enter the Client Name (Orah Sync), make sure the client is enabled and then select Create.
Select Continue. The new client is created and a GUID and Shared Secret is generated.
On the new client, select > (next to the Client is Enabled switch) to access and define permissions and add permissions to Services/Types.
This allows you to control in detail which data and actions the users with access permissions will be able to perform. For security reasons, we recommend you give as few permissions as possible. The required permissions for Orah are as below.
Copy the GUID and the Shared Secret and keep these securely for loading into Orah

Orah required API permissions

Service	Method	Endpoint
Address	GET	/apiportal/v1/community/{id}/address
Attendance	GET	/apiportal/v1/studentattendance/student/{id}
Attendance	GET	/apiportal/v1/studentattendance/student/{id}/attendance/{attendanceseq}
Community	GET	/apiportal/v1/community
FileSemesters	GET	/apiportal/v1/FileSemester
LookupTables	GET	/apiportal/v1/lookuptables/{entityname}
Staff	GET	/apiportal/v1/staff
Staff	GET	/apiportal/v1/Staff/Class/{subjectClassesSeq}
StudentContact	GET	/apiportal/v1/studentcontact
StudentContact	GET	/apiportal/v1/StudentContact/{id}
Student	GET	/apiportal/v1/student
Student	GET	/apiportal/v1/student/{studentid}
Student	GET	/apiportal/v1/Student/Campus/{campus}
Student	GET	/apiportal/v1/Student/Class/{subjectClassesSeq}
Student	GET	/apiportal/v1/Student/{id}/class
Timetable	GET	/apiportal/v1/Timetable/{timetableSeq}
Timetable	GET	/apiportal/v1/Timetable/Staff/{staffID}
Timetable	GET	/apiportal/v1/Timetable
TimetableDefinition	GET	/apiportal/v1/TimetableDefinition
TimetableDefinition	GET	/apiportal/v1/TimetableDefinition/{timetableDefinitionSeq}

Network security

For added security, traffic to your API can be restricted as follows for schools in Australia and New Zealand:

All of the calls from our server come from this domain:
https://outbound-api-sydney.orah.com
Ideally that domain can be used as the exact ip addresses may be subject to change in the future

If you require specific IP addresses or your school is not based in Australia or New Zealand, please contact the support team further assistance.

Configuring in Orah

As an admin user, navigate to App Directory -> Integrations and select the 'Synergetic' integration:
Click the 'Connect to Orah' to configure the integration as follows:

The settings / fields are as follows:
1. Client ID: this is the Client ID as configured in Synergetic for this API application
2. Client secret: this is the 'shared secret' as configured in Synergetic for this API application
3. School route: this is the web accessible URL that is used by Orah to reach the Synergetic API. It may be similar to: https://myschooldomain.com/CoreAPI

How it works

By enabling this integration, your Synergetic API credentials will be authenticated and saved to our Orah database. An initial sync will take place to import all students from your Synergetic database and merge any existing students in the Orah database.

Managing your data

Syncing your data

You can set the automatic sync to occur once every 24 hours (generally overnight) or alternatively, you can perform a manual sync with a single click which will sync your student information instantly.

Writeback timings

When Orah writes data back, this is queued to send immediately but may take 5-10mins to complete depending on the amount of date to be sent to your school instance of Synergetic.

Attendance dashboard

Attendance data for attendance insights and alerts is scheduled to sync hourly. In the event the sync cannot be completed within the hour, the data will sync intra-day at 11am and 2pm (local times to your school).

Student Syncing

Filter options

You can define what students are imported into Orah based on two filter options.

Student type
This can be set to day students, boarders or both. Not using this filter option will mean all students will be imported.

Grade levels
This can be set to any grade or year level defined in your Synergetic instance.

Supported fields & mapping options

All the fields and mapping options available can be viewed and configured (if possible) from the integration settings page. For example, the Student sync object details all supported fields in the 'field mapping' panel.

Existing students

If you already have students in your Orah account, we do our best to automatically link existing students via individual matching references from within Orah and Synergetic. If we are unable to match your students, you will find these students are listed on the debugger page where you can search and match these students.

Deleting students

As Synergetic will manage your core information, you will need to mark a student as inactive in Synergetic in order to remove them from your Orah account. We offer the option of deleting students, which will permanently remove all records associated with this student, or a deactivate option which will archive their records. The deactivate option is applied by default.