Setting up and managing third-party API integrations in Arbor

Screenshot_2020-11-19_at_16.50.25.png

 

Please note

Arbor’s process to connect to apps requires you to contact the app's company directly before any integration can take place, regardless of whether the app is one of our current partners or not. For more information, see the section entitled ‘Connecting with new apps’.

 

What is an API?

An API is a method third-parties use to integrate with Arbor and access information, most will be a one-way integration (feeding data from Arbor into the third-party) but there are some that work both ways (information updated in one system will automatically update in the other).

There are lots of different API’s available to your school including Wonde, Groupcall, Parentpay, CPOMMS, LGFL. You can see a list of all the third parties that we work with below!

The way we connect with third-party apps gives you the ability to easily manage apps that can access your data. For each app, you can inspect what data it uses, what it can do with this data, and easily manage the apps that can access your data. 

If you are not happy with the data an app is requesting or would like to find out more about how and why this data is being used, please contact the app’s company directly.

Apps you can connect to using this process
  • ParentPay
  • EntrySign
  • Ami Education/Gladstone
  • WisePay (via Wonde)
  • Class Charts (via Wonde)
  • Biostore (via Groupcall)
  • B Squared
  • Classroom Monitor (via Wonde)
  • Chatter
  • CPOMS
  • Groupcall
  • GCSEPod (via Groupcall)
  • Hegarthy Maths (via Wonde)
  • Inventry 
  • Live Register
  • Teachers 2 Parents/T2P (via Wonde)
  • SalamanderSoft
  • School Booking
  • Show My Homework (via Groupcall)
  • Wonde
  • PrimarySite
  • BehaviourWatch (Eduspot) (Via Wonde)
Connecting to a new app

If you know the app is one of our current partners, please contact the app's company directly to let them know you would like to work with them. They will set up the new connection. 

If the app is not one of our current partners, or you're not sure, please let us know the name of this app, and contact the app's company directly to let them know you would like to work with them.

We will let you know if the app is a partner, and will ask you some additional questions about why you want to connect with this app to help us decide whether we would like to establish a connection with the app. If we do, we will work with the app's company to try and get you connected. The app will need to contact us by emailing api@arbor-education.com to begin the integration process.

Please note that our API is only available to apps that are not competitors to our products and that the process of making a connection can take some time, as the app will need to build their part of the integration before connecting.

Approving a third party connection 

Once the app's company have set up the connection to your Arbor site, you will be notified within Arbor that there is a pending request that requires your attention. Go to System > Partner Apps (API Users) on a school MIS site, or Administration > Partner Apps (API Users) on a Group MIS site and approve the request for it to be able to access your data.

For each 3rd party app that wants to connect, or is already connected with your data, you can:

  • View the details of what data the app is requesting access to or already uses.
  • Approve the app to enable it to access your data.
  • Reject the app, so it cannot access your data.

An explanation of key terms can be found at the bottom of the page.

To view an app that is trying to connect with you, select Pending requests from the left-hand menu.Screenshot_2020-08-27_at_13.36.35.png

Click the row containing the app in question and you will be presented with a slide-over showing the permissions requested.

Screenshot_2020-08-27_at_13.37.34.png

In this example, an app is requesting to be able to view and update all the data within the ‘Staff’ module, shown by ticks. However, it cannot delete the data, shown by a cross in the table. This means the app cannot create data, or delete any data that is in Arbor regarding staff.

If you are happy with the access the app is requesting, you can confirm the access of the 3rd party app by clicking Approve. If you do not want an app to access the data, click Reject. If you would like to put off the decision, simply click Cancel.

Top tip: You can download a list containing all the data the app is using or has requested to use. Helpful if parents are wondering what information about their child is available to partners!

Alternative Connection Option

Some third-party apps that have already established a connection with Arbor may offer you an alternative way of integrating with your MIS site. Using this method, there is no need for the app to send a request for your approval.

You will instead be sent a link by the app's developers, which will take you to a page where you can input your Arbor credentials (the email and password associated with your Arbor MIS account).

Screenshot_2020-08-27_at_13.39.26.png

After authorization, you will be able to check what data the App will be able to access and approve this. You will then be connected to the app, and the app will appear as an Approved app on the Approved Apps page. 

If you ever need to reject the connection, follow the instructions in the section below.

Managing existing connections

If you would like to revoke access or are no longer using an app, you can reject an app. This will immediately prevent it from using and accessing your data. To do this:

  1. Click the Approved Apps tab
  2. Select the app name
  3. Click the Reject button

The app will then move to your Rejected Apps list.

Screenshot_2020-08-27_at_13.39.26.png

You can also give access to an app you previously rejected. This will immediately enable the app to use and access your data. To do this:

  1. Click the Rejected Apps tab
  2. Select the app name
  3. Click the Approve button
  4. The app will then move to your Approved Apps listScreenshot_2020-08-27_at_14.01.49.png
Key Definitions

Data type - The group of data the app can access e.g. if an app can access the ‘staff’ entity, this could include staff name, contract details, timetables, etc.

Specific fields - What specific pieces of data the app will be able to access e.g. it may be able to access all data regarding staff, or perhaps only staff attendance.

Read - App can access this data e.g. a timetabling app can see what lesson a staff member is teaching next.

Write - App can create this data e.g. an app can add new staff members.

Update - App can edit data e.g. app can be used to update staff details.

Delete - App can delete data e.g. app can delete a staff member.

Top tips for managing your API's

If you're using Wonde

If you are using Wonde as a third party you need to have a subject set up for your courses, if you don’t have these setup you can do this in bulk by going to School > Programmes > into the current academic year courses > table view in the left-hand menu. You can assign subjects in bulk by using the pencil icon to select any with a missing subject and then select the tick boxes for any that will have the same subject click on the pencil icon then update subject. You will see a slide over screen on the right where you can select the subject from the dropdown menu or start typing in the subject then click bulk update. This will assign a subject to the selected courses.

If you're using Hodder

If you’re using Hodder the short name for registration forms must be used, if you need to add these in or update them you can do this by going to School > Programmes > Courses > Registration forms on the left-hand side menu. You can click into the registration form and then into the short name area to add or update the short name.

When will your sync start? 

If you want to know when your sync with the third party will start especially as you look towards a new academic year please contact the third party directly. They will be able to advise you on their first sync and what they may need from you.

Issues syncing data

If you are having issues with your sync, please check first that the information needed is in Arbor, this could be short names for forms, forms linked to a year group if the information is missing in Arbor then you will need to update this so that it can pull through your sync. If the information is showing then please contact your third party.

 

If you have checked with the third party but still need to contact us about your AP you can do so via email at myteam@arbor-education.com

Where possible include screenshots and as much information. In certain cases, we may advise you that you will need to speak to your third party directly.

 
Was this article helpful?
0 out of 0 found this helpful
I'm still stuck!

Comments

0 comments

Please sign in to leave a comment.