Wonde Integration

Wonde Integration Overview

The collaboration between CyberEdge and Wonde allows schools to integrate timetable data into Classroom Control, providing a range of new features. This integration provides educators with enhanced flexibility and control, allowing them to manage and regulate access to internet-based content in their classrooms. The following guide details the capabilities of this integration, along with instructions for its setup and administration.

Classroom Control Feature Enhancements with Wonde

The features and functionalities provided by Classroom Control are outlined below following the successful integration with a supported timetable system via Wonde. These features include:

• An integrated Wonde sign up process can be completed within the CyberEdge management user interface
• Automated daily synchronization of timetable data
• Automated Wonde data synchronization retries in the event of network failure or systems outages
• Manual synchronization options in the event of unexpected timetable changes
• Timetable period data is now accessible within Classroom Control lessons. Period data can be used in addition to or in place of the standard lesson duration options
• Smart overrun feature allows lessons to automatically extend for up to 5 mins post the scheduled end of a lesson, removing the need for manual intervention
• Classroom Control lessons will automatically start and stop based on timetabling data configured by the user
• Classroom Control lessons can be manually configured to use specific time periods or all periods for that class
• Educators can add student to a lesson where that user may not by usually part of the class (providing that student is in a group managed by the user)

Supported Platforms

The CyberEdge/Wonde Classroom Control integration currently supports the following systems;

- **TASS**
- **Synergetic**

CyberEdge will add support for additional SIS systems as the data functionality become accessible through Wonde functionality.

Unsupported Platforms

The CyberEdge/Wonde Classroom Control integration is currently not supported for the following platforms. Areas highlighted in yellow are required for a complete integration.

Note

For updates on when the required data may be available via Wonde, please contact the respective solution providers for more information.

Wonde Platform Integration Guides

Wonde integration guides for the various supported platforms can be found here: Wonde Integration Guides. For assistance with enabling your specific platform, please contact Wonde.

How to find your Wonde ID

You can locate the Wonde ID for your school (whether it's existing or new) by visiting https://school.wonde.com/login and searching for your school name. It's important to verify that the school's postcode is correctly selected.

Wonde Data Handling and Privacy

Information on Wonde data handling and privacy policies can be found here: Wonde Security And Compliance. For any questions or assistance on Wonde data management, please contact Wonde.

Initial Setup

The initial configuration of the CyberEdge/Wonde integration varies based on whether you intend to use an existing Wonde tenancy or establish a new one for the first time.

In the first scenario, CyberEdge will initiate a request through our cloud service to Wonde, seeking permission to access an existing tenancy.

In the second scenario, you will first have to set up an integration with Wonde before continuing with the process on the CyberEdge.

Before attempting this setup, you should verify that your timetable system is a supported platform by Wonde and it can provide the data required to complete an integration with CyberEdge.

Setup Flow

The initial setup flow for each method is outlined below

Important note

• CyberEdge does not provide technical support for the Wonde platform or any of the data associated with the integrations between the timetable system and Wonde. For assistance, please contact Wonde directly. Contact information can be found here https://www.wonde.com/au/contact/
• For information pertaining to Wonde, the Wonde platform and data supported for your systems please contact Wonde directly. Alternatively, detailed integration guides for most platforms can be found here: Wonde Integration Guides. It is important to note that not all timetable systems currently provide sufficient data ti successfully integrate with CyberEdge's Classroom Control

Setup with an existing Wonde Tenancy

To configure the CyberEdge with an existing Wonde solution navigate to;

1. LiveZone > Wonde Integration
2. Complete the Wonde integration contact details and provide your Wonde School ID, click "submit"
3. A request will be made to Wonde to grant CyberEdge access to your tenancy. Once approved by Wonde, an email will be sent from Wonde to the authorized requester asking for approval. The email contains the data fields that can be used by the integration. More information on the data required is outlined below
4. Once the request has been approved by the user, Wonde will complete a data audit to ensure compliance. If approved, Wonde will generate a read only API token which is distributed to your CyberEdge appliance by CyberEdge licensing system.
5. To complete the integration, navigate back to LiveZone > Wonde Integration and the appliance will load the API token from the licensing system
6. Save and apply the change and the first sync of Wonde data will happen immediately

Note

• Wonde access requests for existing tenancies can take several hours to be reviewed and processed. For updates on the processing of an access request, please contact Wonde or track the progress via the Wonde portal
• Wonde may reject the integration where it fails to meet the required technical specifications. In this event, CyberEdge is unable to support an integration

Setup with a new Wonde Tenancy

To configure the CyberEdge with a new Wonde solution;

1. Go to Wonde Contact
2. Complete the Contact Form
3. Wonde will assist you with setting up the integration with your SIS
4. Once completed, proceed with the setup steps for an existing tenancy

Important note

• Before submitting a request, it is recommended to check the Wonde compatibility matrix
• Setup for a new Wonde tenancy may take several days to complete and is dependent on Wonde compatibility with the requested system
• More information on the setup process for Wonde can be found here: Wonde How It Works
• CyberEdge does not provide technical support for the setup or management of a Wonde tenancy

Wonde Data Sync

Automated Data synchronization occurs nightly at 12:00AM. If needed, there is an option to manually refresh the data. To manually refresh data navigate to;

1. LiveZone > Wonde Integration
2. Click "Sync Wonde"

More information on Wonde Data synchronization can be found via Classroom Control logs

Tip

• It is recommended to not manually refresh the underlying timetable data whilst Classroom Control lessons are active to avoid active lessons being interrupted.

Data Management

Outlined below is the data stored within the CyberEdge timetable database. Data is imported as configured by the network administrator via the Wonde API gateway directly to the CyberEdge device. No data outside what is listed below will be stored. CyberEdge's Wonde API access is read only and does NOT support any ability to write data to WondeAPI gateway or any subsequent backend systems.

Data Fields

Employees: active directory username (+UID) 
Employees: username  
Classes: class name 
Classes: description 
Classes: subject  
Classes: code 
Students: active directory username (+UID) 
Students: username  
Periods: start time 
Periods: end time 
Periods: name  
Periods: day 
Periods: day number  
Periods: description 
Periods: session 
Lessons: period   
Lessons: employee id  
Lessons: period instance id 
Lessons: start at 
Lessons: end at

In HA deployments, data will be synchronized between both CyberEdge nodes in a cluster. No mechanism is available to modify or export timetable data from the CyberEdge.

Classroom Control Logs

Classroom Control logs offer insights into the utilization and issues related to classroom control, as well as the synchronization of Wonde data.

To view Classroom Control and Wonde data sync logs navigate to;

1. Status > LogViewer > Classroom Control

The following logs options provides additional information on both Classroom Control and Wonde data when the integrations has been enabled.

Lesson Logs

Lesson logs can be used to identify when a lesson has started and is scheduled to end as well as when changes have been made to the lesson such as adding a domain to the allowed sites.

2023-11-24 07:07:45 INFO Lesson <lesson name> started. Set to expire on Fri Nov 24 07:09:45 2023
2023-11-24 07:07:55 INFO Lesson <lesson name> changed. Updating lesson parameters
2023-11-24 07:07:55 INFO Lesson <lesson name> ended

User Logs

User logs show events where a user was not able to be found from the configured authentication provider and as such cannot be used by Classroom Control. Check your authentication service provider to determine the cause for this user.

2023-11-27 09:10:12 INFO Looking up uncached users: didier_millhouse
2023-11-27 09:10:12 ERR  didier_millhouse was not found in Provider LocalProviderModel-<providerID> and could not be created

Network Connectivity Issues

The CyberEdge was unable to connect to the Wonde gateway to retrieve data due to a network connectivity issue. The system will automatically retry the Wonde data sync once per hour until data is returned. An email notification will be sent to the administrator when this error occurs

2023-11-27 08:59:39 ERR  Failed to fetch and aggregate Wonde data

Wonde Data Sync

A successful Wonde data synchronization provides information on the updated data and highlights the changes that have occurred

2023-11-27 09:10:15 INFO 4 Wonde Periods updated. 0 Wonde Periods removed. 0 Wonde Periods unchanged