Overview
As an administrator with the Manage Tenant Settings role, you can set up the epaPRO integration. epaPRO is an End-point Assessment management tool developed to support End-point Assessment Organisations (EPAO).
Please note that this is a console-only feature.
Prior to setting up an epaPRO integration for your tenant, ensure you have an active epaPRO account with a Provider login you can use for integration. Standards must be assigned to your Provider account in order to allow Learners to register in epaPRO as Apprentices.
Enable End-Point Assessment
Click Settings on the left navigation bar. You can see this option when you have the Manage Tenant Settings role assigned.
- Use the navigation bar at the top and select Integrations.
- On the Integrations page, select the EPA-Point Assessment menu option.
- Use the toggle to set Enable End-Point Assessment to Yes. By default, this is set to No.
- Once you enable the integration, you can then add connections.
-
Optionally, you can toggle on the Enable Learners Registration Email option.
If on, all Learners registered for epaPRO as Apprentice accounts will receive a "New User Created" email from epaPRO with credential details so that they can activate their Apprentice account and log into epaPRO platform.
Add a connection
To add a connection, click +Add connection.
The Add Connection screen is displayed.
- In the EPA software provider field, select epaPRO from the dropdown list.
- Specify a Connection name.
- Enter your epaPRO username and password. These are your epaPRO provider account credentials.
- Enter your End-Point Assessment ID. The ID must be unique - you cannot create more than one connection using the same ID.
- Enter the API endpoint - this is the URL that you typically use to access your instance of epaPRO, for example: {trainingprovider}.epapro.co.uk. The API endpoint must be unique - you cannot create more than one connection using the same API endpoint.
- To ensure that the two systems can talk to each other in a secure and trusted manner, you must provide a Client ID and Client Secret. The Client ID and Client Secret are case-sensitive alphanumeric strings, and can be obtained by contacting epaPRO through your EPAO.
- Add Standards and Specialisms as required. For details, see: Adding EPAPro Standards and Specialisms.
- Click Add.
NOTE: If you see a Client authentication failed error message, please correct API endpoint, ClientID and Client Secret provided for the connection.
Once the connection is successful, the connection details are added to the page.
The grid displays the EPA software provider, the connection name, the EPA ID, the API end point, the client ID and client secret. You can edit or delete connections using the respective columns.
You need to create one connection per end point assessment organisation. So, if you are using multiple end point assessment organisations, you will need to create multiple connections.
If you have multiple connections, they will be displayed in the order in which they were created.
You can edit or delete an existing connection.
Adding epaPRO Standards and Specialisms
Add a Standard
As a tenant administrator, you can define the standard mappings between an epaPRO instance and Aptem, so that you can register the learner correctly with the epaPRO instance.
- When adding a connection, click + Add Standard to add a standard.
- In the Standard code field, enter the IFA code of the standard you wish to add. This field accepts numeric values only.
- In the epaPRO standard code field, enter the epaPRO equivalent for the standard code. This field accepts alphanumeric values.
- Click Add.
After you have added the Standard, it will be displayed in the Standards section as shown below.
You can have multiple standards added to your epaPRO connection. To add another standard, repeat the procedure.
Delete a Standard
Standards already entered can be deleted. Note - these standards can only be deleted not edited.
- Click the delete icon to delete a standard.
- Confirm to delete.
- The Standard will be deleted.
Add Specialism
As a tenant administrator, you can define the specialisms mappings between an epaPRO instance and Aptem, so that you can register the learner correctly with the epaPRO instance.
Where the learner is on an apprenticeship programme where there is a specialism involved, you can add the specialism. Make sure the corresponding Standard is also added to the Connection - otherwise, the mapping will be considered incomplete and the Learner registration will not succeed.
- When adding a connection, click + Add Specialism to add a mapping.
- To add a specialism, you must specify the Programme and Specialism ID fields.
- Select the Programme from the dropdown list of delivery programme/sub-programmes. Programmes you have already selected for specialisms for will not appear in the dropdown list.
- Enter the Specialism ID. The Specialism Id field allows any alphanumeric value to be entered. This must relate to one of the standards added to the connection.
- Click Add.
- After you have added the Specialism, it will be displayed in the Specialisms section as shown below.
To add another specialism, repeat the procedure. It is possible to add one or more specialism mappings when adding a connection.
Delete Specialism
Specialisms already entered cannot be edited but can be deleted.
- Click the delete icon to delete a specialism.
- Confirm to delete.
- The Specialism will be deleted.