EduHub Writeback Setup - CASES21 Schools

This article will talk about how to install the EduHub Writeback sync for a school using CASES21 as its student information system (SIS).

Part 1

1. Log in to XUNO as an Administrator.
2. Go to Options > Software Settings > Import & Export Data.
3. Click the text to download the EduHub data transfer tool under Tools & Utilities.
4. Open the downloaded .bat file in a text editor to ensure the following:
   1.  XUNO_INSTANCE= - Make sure this is equal to your Instance ID on the Options > Software Settings > Licence & School Information page.
   2. XUNO_URL= -  Make sure this is the same as the external URL that is used to access XUNO.
   3. XUNO_SCHOOLID= - Make sure that this is the 4 digit school number
   4. Normally, none of the values above need to be changed, but a quick check will help to ensure a smooth installation.
5. Once you have made sure the .bat file has the correct information, you will need to copy this file over to the Admin File Server (AFS). Placing it any where will be ok as long as it is on the AFS.
6. Once copied to the AFS, simply double click to run the .bat file.
7. The .bat file will do the following:
   1. Download the latest version of EduHub Writeback from the XUNO server.
   2. Extract it to a temp directory.
   3. Install the script with the school's details.
   4. Create one scheduled task to run automatically every 30 mins to an hour. 
   5. Starts the task to import data into the XUNO database.
   6. Once done, the setup has been completed successfully.

Part 2 (ON PREMISES SCHOOLS ONLY)

Here we will walk through how to set up the automatic import from the XUNO server to the XUNO database.
This part can be skipped if you have already set up EduHub previously, and configured the Autoimport.bat to run automatically on the XUNO Server.

Set up the scheduled task

1. Open the Task Scheduler (or Scheduled Tasks) on your XUNO server.
2. Right click on the Task Scheduler Library and choose Create Task…
3. Change the user running the task to SYSTEM.
4. Enter “XUNO CASES Import” as the name of the task. Tick the options Run whether the user is logged on or not, and Run with highest privileges.
5. Click on the Triggers tab to continue, then click on the New button.
6. Change the options to Weekly and set the Start time to 6:30:00AM. Tick the days Monday, Tuesday, Wednesday, Thursday and Friday, then tick the Stop task if runs longer than... checkbox and set the duration to 1 hour. It is best to run this task every hour on the half hour, as that is when XUNO News items can be scheduled for, and this is the same process that send these out via email and push notification.
7. Tick the Repeat task every checkbox, and set its frequency to every 60 minutes. Do not specify how long to repeat this task - it needs to run 24/7 in order to process important tasks overnight (such as direct debits).
8. Click the OK button to continue.
9. Click on the Actions tab, then on the New button.
10. In the Program/script field enter the name autoimport.bat.
11. Enter the path to the .bat file into the Start in (optional) field, but this time without the talking marks and remove the autoimport.bat part at the end, something like C:\Websites\XUNO\secure\. It is important that you keep the last backslash in the path.
12. Click OK to continue.
13. Click the OK button to save the new scheduled task.
14. You have now completed setting up your automated CASES21 export. Please follow the next steps to test that your export works correctly

Testing the import (ON PREMISES SCHOOLS ONLY)

1. Open the Task Scheduler (or Scheduled Tasks) on your XUNO server.
2. Right click on the XUNO CASES Import task and click on Run.
3. The import will take approximately 30-90 seconds to complete.
4. Open the autoimportlog.log file in Notepad (in the same directory as the autoimport.bat file) and check for any errors. Contact our support team if there are any errors when running this import.
5. That's it! Great work, you've successfully set up the EduHub sync.