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;
- LiveZone > Wonde Integration
- Complete the Wonde integration contact details and provide your Wonde School ID, click "submit"
- 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
- 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.
- To complete the integration, navigate back to LiveZone > Wonde Integration and the appliance will load the API token from the licensing system
- 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;
- Go to Wonde Contact
- Complete the Contact Form
- Wonde will assist you with setting up the integration with your SIS
- 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;
- LiveZone > Wonde Integration
- 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;
- 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