Surfacing Review responses in OData

Accessing the Review Responses OData feed

Access to this feature will be granted by request only. Please request access to this feature via the Support team or your Customer Success Manager.

Review responses for the mentioned question types will be available in OData for reviews which are started after the feature has been enabled on the individual tenant.

 

Availability of sections

Review Responses are available for questions of the following type:

  • Custom sections (Custom, IAG, Workplace Induction Checklist, Learner Satisfaction Survey)
  • Comments (as of 30/04/2025)
  • Individual Support Needs / Requirements
  • Core Topics (as of 30/04/2025)
  • EPA Gateway (as of 30/04/2025)
  • Short and Long Term Goals (as of 30/04/2025)

 

Using Review Responses

The Review Responses is displayed via a new table – customers can access this table in the same way they access other tables in OData. For more information please see this collection of articles.

When a learner, tutor, or employer clicks Start on the review, the configuration of the review including any custom section(s) will be available in the OData feed (the answers at this point will be empty).

When a learner, tutor or employer saves the review section, the answers will be available in the OData feed.

The OData feed will be updated asynchronously and will be available within 15 minutes of the review being started or answer being saved.

The Reviews Responses table is linked to the Reviews table via the Review ID. For more information please see the diagram in the OData dictionary.

There is a paging limitation of 5000 rows. Please see an example of a looped query to support loading the data efficiently in this article: Retrieving Review responses via OData.

4f7ffbc8-7a4a-4a20-b079-88ce42e9dcfa.png

 

Using Review Responses for custom questions

Amendments made to reviews in the reviews token once the review instance has been started will not be reflected in the OData feed. Amendments are described as:

  • Changes made to the title of a custom question
  • A new question is added to a custom section
  • A new section is added to an existing review

Note that reviews started after the amendment has been made will include the amendments. Also note that reviews which are deleted from the UI will also have associated responses deleted from the OData feed, ensuring the OData feed is consistent with data in UI.

 

Historic Review Responses data

Customers can request access to historic review responses - i.e. responses to reviews which were started before the customer enabled the review responses feature.

Historic data is migrated by request only. Customers can request either just the current funding year, or current and 1 previous funding year, by raising a support ticket. Once requested, we will plan the migration and inform you of the timeframe by which you can expect to receive your historic data.

Was this article helpful?
0 out of 0 found this helpful