Use the Interface Settings window to configure Synergetic to interface with external systems including:

Australian Curriculum and Assessment Authority (ACARA)
myEdOnline Learning Management System
Queensland Curriculum and Assessment Authority (QCAA), a statutory body of the Queensland Government
Quick Address Systems (QAS), a real-time address validation tool
Systems Interoperability Framework (SIF), an open, industry-supported standard used to link together data systems within the school sector.

For each external system you can configure:

Configuration settings without using Configuration File Maintenance. See Configuring external system settings.
Lookup table mapping. See Configuring external system lookup table mapping.

Important: You must have access to the SYS|Interface Settings security resource to access the Interface Settings window. See Group_User Security Maintenance - Groups View.

Opening the Interface Settings window

To open the Interface Settings window:

Click Module > System > Interface Settings.
The Interface Settings window is displayed.
Select the external system from the drop-down list.

The Interface Settings window is displayed.

Tip: Some settings are duplicated in different sections of the settings tree. You will see multiple settings highlighted in green when a setting with a duplicate is selected.

Interface Settings window key fields and buttons

Fields

Field

Description

Select the external system from the drop-down list.

Note: The external systems displayed depends on the state where your organisation is located and the modules purchased.

Selecting an external system populates the page tree with all the settings for the selected external system. For information about the settings in each external system, see the relevant sections below.

External system

Description

ACARA - Australian Curriculum and Assessment Authority

Select this external system to map Synergetic lookup table values to values included in the Student Background Data File export. See Exporting the Student Background Data file.

Click to view ACARA settings

Field	Description
Outbound	Lists the outbound lookup tables used for mapping outbound Synergetic lookup table values to ACARA values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luGender	See luGender lookup table.
	luLanguage	See luLanguage lookup table.
	luYearLevel	See luYearLevel lookup table.

ACTEDUDIR - ACT Government Education Directorate

Select this external system to map Synergetic lookup table values to Australian Capital Territory Education Directorate values.

Note: You can view this external system by configuring:

• CountryCode configuration setting to AU. See CountryCode configuration setting.
• RegionCode configuration setting to ACT. See RegionCode configuration setting.

Click to view ACTEDUDIR settings

Field	Description
Outbound	Lists the outbound lookup tables used for mapping outbound Synergetic lookup table values to ACT Government Education Directorate values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luGender	See luGender lookup table.

ACTGOVDEMO - ACT Government Demographic Data Collection

Select this external system to map Synergetic lookup table values to values included in the ACT Demographic and NAPLAN exports. See:

Click to view ACTGOVDEMO settings

Field	Description
Outbound	Lists the outbound lookup tables used to map outbound Synergetic lookup table values to ACT Demographic export values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luGender	See luGender lookup table.
	luYearLevel	See luYearLevel lookup table.

APIClients - API Clients

Select this external system to configure clients that allow users to access the Synergetic API Portal. See /wiki/spaces/SYNWEB/pages/2290128237.

Click to view APIClient settings

Fields

Field

Description

Name

Name of the API client. This field is editable.

GUID

Unique identifier.

The GUID and shared secret values (see below) are submitted as parameters in POST Authentication requests to return an authentication token that is used to validate API calls.

Important: You must ensure the security of these values. If these values are leaked, people outside your organisation can submit POST Authentication requests to gain access to your data.

Shared secret

Unique cryptographic key.

The GUID and shared secret values (see below) are submitted as parameters in POST Authentication requests to return an authentication token that is used to validate API calls.

Important: You must ensure the security of these values. If these values are leaked, people outside your organisation can submit POST Authentication requests to gain access to your data.

Buttons

Buttons and sliders	Description
	Click to enable or disable the selected API client.
	Click to copy the shared secret.

AUSGOVNGSC - Department of Education, Skills and Employment (Schools Hub) - NGSC

Select this external system to map Synergetic lookup table values to values included in the Student Census - Australian Non-Governmental Schools report.

Click to view AUSGOVNGSC settings

Field	Description
Outbound	Lists the outbound lookup tables used to map outbound Synergetic lookup table values to Student Census - Australian Non-Governmental Schools values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luYearLevel	See luYearLevel lookup table.

AUSGOVSTATS - Commonwealth Governments Student Attendance Collection

Select this external system to map Synergetic lookup table values to values included in the STATS export. See Import_Export Student Data - STATS tab.

Click to view AUSGOVSTATS settings

Field	Description
Outbound	Lists the outbound lookup tables used to map outbound Synergetic lookup table values to STATS values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luGender	See luGender lookup table.
	luYearLevel	See luYearLevel lookup table Note: You need to clear the IncludeInCensusFlag on the luYearLevel lookup table for Preparatory and Senior Kindergarten prior to running the STATS export.

CESA - Student Religion Census

Select this external system to map Synergetic lookup table values to values included in the CESA export. See Import_Export Student Data - CESA tab.

Click to view CESA settings

Field	Description
Outbound	Lists the outbound lookup tables used to map outbound Synergetic lookup table values to CESA values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luReligion	See luReligion lookup table.
	luYearLevel	See luYearLevel lookup table.

CSNSW

Select this external system to map Synergetic lookup table values to values included in the CSNSW export. See Import_Export Student Data - CSNSW tab.

Click to view CSNSW settings

Field	Description
Outbound	Lists the outbound lookup tables used to map outbound Synergetic lookup table values to LEA values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luReligion	See luReligion lookup table.
	luYearLevel	See luYearLevel lookup table.

LEA

Select this external system to map Synergetic lookup table values to values included in the LEA export. See Import_Export Student Data - LEA tab.

Click to view LEVNT settings

Field	Description
Outbound	Lists the outbound lookup tables used to map outbound Synergetic lookup table values to LEA values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luReligion	See luReligion lookup table.
	luYearLevel	See luYearLevel lookup table.

myEdOnline - myEdOnline

Select this external system to configure access to the myEdOnline eLearning platform.

Click to view myEdOnline settings

Field

Description

myEdOnline School Code

Used to define the school code supplied by myEdOnline for identifying your organisation.

Note: This is the same functionality as the myEdOnline:SchoolCode configuration setting. See MyEdOnline:SchoolCode configuration setting.

myEdOnline URL

Used to store the callback endpoint used when launching MyEdOnline via Synergetic.

Important: This topic is for reference purposes only. You must not change this value as it may affect how Synergetic integrates with MyEdOnline.

Note: This is the same functionality as the myEdOnline:URL configuration setting. See MyEdOnline:URL configuration setting.

myEdOnline Authorisation Token

Used to generate and store the myEdOnline authorisation token.

NSWGOVDEMO - New South Wales Government Demographic Data Collection

Select this external system to map Synergetic lookup table values to values included in the NSW Demographic and NAPLAN exports. See:

Click to view NSWGOVDEMO settings

Field	Description
Outbound	Lists the outbound lookup tables used to map outbound Synergetic lookup table values to NSW Demographic values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luGender	See luGender lookup table.

NTGOVDEMO - NT Government Demographic Data Collection

Select this external system to map Synergetic lookup table values to values included in the NT Demographic and NAPLAN exports. See:

Click to view NTGOVDEMO settings

Field	Description
Outbound	Lists the outbound lookup tables used to map outbound Synergetic lookup table values to demographic values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luGender	See luGender lookup table.
	luRelationship	See luRelationship lookup table.
	luYearLevel	See luYearLevel lookup table.

NZMOE - New Zealand Ministry of Education

Select this external system to map Synergetic lookup table values to values included in the MOE exports. See Import_Export Student Data - MOE tab.

Click to view NTGOVDEMO settings

Field	Description
Outbound	Lists the outbound lookup tables used to map outbound Synergetic lookup table values to NZMOE values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luGender	See luGender lookup table.

QAS - QAS Validation Provider

Select this external system to configure address validation using the Quick Address System (QAS).

Click to view QAS settings

Base Address Validation Settings

Field	Description
Address Validation Confirmation Alert	Determines whether confirmation messages are displayed when addresses are validated. Note: This is the same functionality as the AddressValidation:ConfirmOnValidation configuration setting. See AddressValidation:ConfirmOnValidation configuration setting.
Address Validation is Enabled	Determines whether address validation is enabled. Note: This is the same functionality as the AddressValidation:EnabledFlag configuration setting. See AddressValidation:EnabledFlag configuration setting.
Address Validation is Enabled for Community Portal	Determines whether address validation is enabled for the Community portal. Note: This is the same functionality as the Module:CommunityPortal configuration setting. See Module:CommunityPortal configuration setting.
Address Validation is Enabled for Online Applications	Determines whether address validation is enabled for Online applications. Note: This is the same functionality as the Module:OnlineApplications configuration setting. See Module:OnlineApplications configuration setting.
Address Validation is Enabled for SynWeb	Determines whether address validation is enabled for SynWeb. Note: This is the same functionality as the Module:SynWeb configuration setting. See Module:SynWeb configuration setting.
Address Validation is Enabled for Windows	Determines whether address validation is enabled for Windows. Note: This is the same functionality as the Module:Windows configuration setting. See Module:Windows configuration setting.

Address Validation Provider settings

Field	Description
Address Validation Provider Authorisation Token	Defines the authorisation token of the address validation provider. Note: This is the same functionality as the Provider:AuthToken configuration setting. See Provider:AuthToken configuration setting.
Address Validation Provider Name	Defines the name of the address validation provider. Note: This is the same functionality as the Provider:Name configuration setting. See Provider:Name configuration setting.
Address Validation Provider Password	Defines the password of the address validation provider. Note: This is the same functionality as the Provider:Password configuration setting. See Provider:Password configuration setting.
Address Validation Provider Result Limit	Defines the number of results returned from the address validation search. Note: This is the same functionality as the Provider:ResultLimit configuration setting. See Provider:ResultLimit configuration setting.
Address Validation Provider Timeout	Defines the amount of time in milliseconds before the address validation search is aborted. Note: This is the same functionality as the Provider:Timeout configuration setting. See Provider:Timeout configuration setting.
Address Validation Provider URL	Defines the URL of the address validation provider. Note: This is the same functionality as the Provider:URL configuration setting. See Provider:URL configuration setting.
Address Validation Provider UserName	Defines the username of the address validation provider. Note: This is the same functionality as the Provider:AuthToken configuration setting. See Provider:Username configuration setting.

QAS Versions settings

Field	Description
Outbound	Lists the outbound lookup tables used to map outbound Synergetic lookup table values to QAS values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luCountry	See luCountry lookup table.

QCAA - Queensland Curriculum and Assessment Authority

Select this external system to map Synergetic lookup table values to values included in the QCAA export and QLD Demographic export. See:

Click to view QCAA settings

Field	Description
Outbound	Lists the outbound lookup tables used to map outbound Synergetic lookup table values to QCAA values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luCountry	See luCountry lookup table.
	luGender	See luGender lookup table.
	luLanguage	See luLanguage lookup table.
	luLearningPathway	See luLearningPathway lookup table.
	luState	See luState lookup table.

QCAANAPLAN - Queensland Curriculum and Assessment Authority - for NAPLAN

Select this external system to map Synergetic lookup table values to values included in the QLD NAPLAN export. See Import_Export Student Data - NAPLAN tab.

Click to view QCAANAPLAN settings

Field	Description
Outbound	Lists the outbound lookup tables used to map outbound Synergetic lookup table values to NAPLAN values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luGender	See luGender lookup table.

SACE - South Australian Certificate of Education

Select this external system to map Synergetic lookup table values to values included in the SACE export. See Import_Export Student Data - SACE tab.

Click to view SACE settings

Field	Description
Outbound	Lists the outbound lookup tables used to map outbound Synergetic lookup table values to SACE values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luGender	See luGender lookup table.

SAGOV - South Australian Government

Select this external system to map Synergetic lookup table values to values included in the Persistent Non-Attendance report. See Import_Export Student Data - SA GOV tab.

Click to view SAGOV settings

Field	Description
Outbound	Lists the outbound lookup tables used to map outbound Synergetic lookup table values to demographic values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luAbsenceType	See luAbsenceType lookup table.

SAGOVDEMO - South Australian Government Demographic Data Collection

Select this external system to map Synergetic lookup table values to values included in the SA Demographic and NAPLAN exports. See:

Click to view SAGOVDEMO settings

Field	Description
Outbound	Lists the outbound lookup tables used to map outbound Synergetic lookup table values to demographic values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luGender	See luGender lookup table.

SIF - Systems Interoperability Framework

Select this external system to configure Synergetic to access data using the Systems Interoperability Framework (SIF).

Click to view SIF settings

Base SIF settings

Field	Description
Enable the SIF Consumer Service	Determines whether Synergetic can request data from other applications in SIF format.
Default Data Model Version	Defines the data model version used if no version is provided by the consumer application when requests are made to the SIF Provider Service.
Maximum Record to Retrieve	Defines the maximum number of records to retrieve in a single request.
SIF Provider Service	Display SIF Provider Service settings. See SIF Provider Service settings (below).
SIF Architecture	Defines the system architecture used for SIF requests.
SIF is Enabled	Determines whether SIF is enabled. Note: This is the same functionality as the SIF:Enable configuration setting. See SIF:Enable configuration setting.

SIF Provider Service settings

Field	Description
Person Picture	Defines the picture of a student, student contact or a staff member. Note: Pictures are saved in the Synergetic Photo Maintenance window. See Photo Maintenance window.
Enable the SIF Provider Service	Determines whether the SIF Provider Service is enabled to allow other applications to request data in the SIF format.
SchoolInfo	View school information settings.
	SchoolInfo Settings
	Enable SchoolInfo	Used to determine whether details about your organisation and its campuses can be provided to other applications.
StaffAssignment	View staff assignment (job position) settings.
	StaffAssignment settings
	Enable StaffAssignment	Used to determine whether details about staff member job positions within your organisation can be provided to other applications. Note: This does not provide personal details.
StaffPersonal	View personal settings for staff members.
	StaffPersonal settings
	Full Name for StaffPersonal	Used to define the field used to populate requests for staff member names. You can select: LegalFullName NameInternal NameExternal MailNamePrimary.
	Enable StaffPersonal	Used to determine whether personal details of staff members employed at your organisation can be provided to other applications.
StudentAttendanceTimeList	View student attendance time settings.
	StudentAttendanceTimeList settings
	Enable StudentAttendanceTimeList	Used to determine whether more detailed information about student attendance throughout the day can be provided to other applications.
StudentContactPersonal	View student contact personal settings.
	StudentContactPersonal settings
	Full Name for StudentContactPersonal	Used to define the field used to populate requests for student contact names. You can select: LegalFullName NameInternal NameExternal MailNamePrimary.
	EnableStudentContactPersonal	Used to determine whether personal details of student contacts of students attending at your organisation can be provided to other applications.
StudentContactRelationship	View relationship settings for student contacts.
	StudentContactRelationship settings
	Enable StudentContactRelationship	Used to determine whether personal details of staff members employed at your organisation can be provided to other applications.
StudentPersonal	View personal settings for students.
	StudentPersonal settings
	Full Name for StudentPersonal	Used to define the field used to populate requests for students.
	Enable StudentPersonal	Used to determine whether details about relationships between students and student contacts can be provided to other applications. Note: This does not include personal details of the student or student contact.
StudentSchoolEnrolment	View student enrolment settings.
	StudentSchoolEnrolment settings
	Enable StudentSchoolEnrolment	Used to determine whether details about student enrolment at your organisation can be provided to other applications.
TeachingGroup	View teaching group settings that relate to classes and the students and teachers involved in each class.
	TeachingGroup settings
	Enable TeachingGroup	Used to determine whether details about classes taught at your organisation including teachers and students involved in each class can be provided to other applications.

School-Info settings

Field	Description
Local ID	View settings related to your organisations local ID. Note: This is the CEOM number for Catholic schools.
	Local ID settings
	Enable StudentSchoolEnrolment	See the StudentSchoolEnrolment setting.
Ref ID	View settings related to your organisation's unique reference identifier.
	Ref ID settings
	Full Name for Student Personal	See the Full Name for StudentPersonal setting.
	Enable StudentPersonal	See the Enable StudentPersonal setting.
School Sector Type	View settings related to your organisation's school sector. For example, Non-Government.
	School Sector Type settings
	Enable Teaching Group	See the Enable TeachingGroup setting.

SIF Versions settings

Field	Description
SIF Consumers	Lists SIF consumers registered to request your organisation's mapped lookup table values.
Inbound	Lists the inbound lookup tables used to map inbound SIF values to Synergetic lookup tables values. See Configuring external system lookup table mapping.
	Inbound lookup tables
	luAbsenceReason	See luAbsenceReason lookup table.
	luAbsenceType	See luAbsenceType lookup table.
	luGender	This lookup table is not editable in Lookup Table Maintenance.
Outbound	Lists the outbound lookup tables used to map outbound Synergetic lookup table values to SIF values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luAbsenceReason	See luAbsenceReason lookup table.
	luAbsenceType	See luAbsenceType lookup table.
	luBoarder	See luBoarder lookup table.
	luCitizenshipStatus	See luCitizenshipStatus lookup table.
	luCountry	See luCountry lookup table.
	luESLProficiencyLevel	See luESLProficiencyLevel lookup table.
	luEthnicGroup	See luEthnicGroup lookup table
	luGender	See luGender lookup table.
	luImmunisationFormStatus	See luImmunisationFormStatus lookup table.
	luLanguage	See luLanguage lookup table.
	luMaritalStatus	See luMaritalStatus lookup table.
	luOccupationPosition	See luOccupationPosition lookup table.
	luQualificationLevel	See luQualificationLevel lookup table.
	luRelationship	See luRelationship lookup table.
	luReligion	See luReligion lookup table.
	luStaffCategory	See luStaffCategory lookup table.
	luState	See luState lookup table.
	luStudentLeavingReason	See luStudentLeavingReason lookup table.
	luStudentStatus	See luStudentStatus lookup table.
	luVisaSubClasses	See luVISASubclasses lookup table.
	luYearLevel	See luYearLevel lookup table.

TASGOVDEMO - Tasmanian Government Demographic Data Collection

Select this external system to map Synergetic lookup table values to values included in the TAS Demographic and NAPLAN exports. See:

Click to view TASGOVDEMO settings

Field	Description
Outbound	Lists the outbound lookup tables used to map outbound Synergetic lookup table values to demographic values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luGender	See luGender lookup table.

VCAAVASSVSN - Victorian Curriculum and Assessment Authority for VASS and VSR

Select this external system to map Synergetic lookup table values to values included in the VASS export. See Import_Export Student Data - VASS tab.

Click to view VCAAVASSVSN settings

Field	Description
Outbound	Lists the outbound lookup tables used to map outbound Synergetic lookup table values to VASS values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luGender	See luGender lookup table.

VICGOVDEMO - Victorian Curriculum Demographic Data Collection

Select this external system to map Synergetic lookup table values to values included in the VIC Demographic and NAPLAN exports. See:

Click to view VICGOVDEMO settings

Field	Description
Outbound	Lists the outbound lookup tables used to map outbound Synergetic lookup table values to VIC demographic values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luGender	See luGender lookup table.

WAGOVDEMO - Western Australian Government Demographic Data Collection

Select this external system to map Synergetic lookup table values to values included in the WA Demographic and NAPLAN exports. See:

Click to view WAGOVDEMO settings

Field	Description
Outbound	Lists the outbound lookup tables used to map outbound Synergetic lookup table values to WA demographic values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luGender	See luGender lookup table.

WASCSA - WA School Curriculum and Standards Authority

Select this external system to map Synergetic lookup table values to values included in the WA SCSA export. See Import_Export Student Data - WA SCSA tab.

Click to view WASCSA settings

Field	Description
Outbound	Lists the outbound lookup tables used to map outbound Synergetic lookup table values to SCSA values. See Configuring external system lookup table mapping.
	Outbound lookup tables
	luGender	See luGender lookup table.

Filter the displayed settings based on an entered search term. Matching results are highlighted in bold.

Note: You must select an external system from the drop-down list above to view this field.

Buttons

Buttons	Description
	Expand or collapse the list of settings for the selected external system.
	Go back to the previously selected setting.
	Add a new record to the Interface Settings window. Note: You can currently only add SIF Consumers. See Adding SIF consumers.
	Refresh the displayed external system settings.
	Save changes to the displayed external system settings. Note: You are prompted to save changes before navigating to a different set of external system settings.
	Display a help tip for the selected external system setting.

Lookup table mapping fields

Note: These fields are displayed once an Outbound or Inbound lookup table is selected in the settings tree.

Field	Description
Active Only	Select to only display lookup table records with the ActiveFlag field selected in Synergetic.
Code	Code of the lookup table record. Refer to the selected lookup table in Lookup Table Maintenance.
Description	Description of the lookup table record. Refer to the selected lookup table in Lookup Table Maintenance.
Active	Whether the selected lookup table record is active.
Interface Code	Code mapped to the selected lookup table record.

Lookup table mapping buttons

Button	Description
	Edit mapping for the selected lookup table record.

Browser not supported