Facility: How to set up Facility integration

This article tells you what you need to do to sync data from Facility to SchoolCloud Parents Evening, both when setting your system up for the first time and when you later want to refresh the data.

Setting up Facility integration

Note: This section only needs to be followed if you are setting your system up for the first time or your Facility details have changed. If the integration is already set up please follow the Syncing your data from Facility section below.

Integration with Facility is done via the Facility Connect API. In order to do this you need to specify which IP addresses our data requests will come from. To do this please modify the API.xml file to allow requests from our IP addresses. The API.xml file can be found in C:\Facility\ePortal\conf\Catalina\localhost on the server where Facility is installed. 

Open the file in a text editor and locate the following section of xml:

<code><Valve className="org.apache.catalina.valves.RemoteAddrValve"

allow=""/> </Valve>

Change the contents of allow="" to a list (separated by the pipe character | ) of the required IP addresses. Our IP addresses are 3.11.136.51, 3.11.149.57, 3.11.229.108.

Therefore an example configuration which allows access to your Parents Evening and locally would be the following:

<code><Valve className="org.apache.catalina.valves.RemoteAddrValve"

allow="127.0.0.1|3.11.136.51|3.11.149.57|3.11.229.108"/> </Valve>

To verify these settings access https://localhost/API in a web browser, you should see the Facility Connect API page appear (please note an SSL certificate should also be set up in IIS).


Once you have completed the above return to your system and enter your Facility web address (either in the  Getting Started Wizard or in Settings > Data Input Source) making sure to include any final / at the end of it, along with any other details the page requires. 

Syncing your data from Facility

You can run a sync to load the current data from Facility into your system whenever you need to by going to the navigation bar, clicking on Data then the sync button: