Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Production Release Date:

Version: 5.17.0

UAT Release Date:

Info

The Release webinar is will be available from here (following the Friday demo meeting);

Note: you can copy and share this link with other people in your organisation

Note

We have added a new column on the table below called “Action Required” this shows several new status labels:

Status
colourRed
titleSETUP_REQUIRED
- some setup will be required to use this element

Status
colourRed
titleNEW_PERMISSIONS
- new permissions have been added

Status
colourYellow
titleRECOMMEND_TRAINING
- training is recommended - usually for new major features.

🆕

Status
colourBlue
titlescreen_changes
- changes have been made to existing screens

This is to help highlight to you anything you need to ensure is set up for the day of release or in advance of this. We do still recommend that all of the release notes are read.

Status
colourGreen
titlelow impact
Status
colourYellow
titlemedium impact
Status
colourRed
titlehigh impact
We are also adding a column for Potential Impact to you our customers, this is an estimation of any impact to your businesses the work may have. This is just offered as a guideline, as we appreciate you all use EPAPro slightly differently.

Tip

We recommend you check any Comms settings with the release notes, as whilst newly introduced comms will be listed in them, we may not mention if an existing comm needs to be enabled, which we assume may be on from previous releases.

What you have enabled can be seen via the System Management → Communications .

Epic

Key

Type

Action Required

Summary

Release Notes Description

Potential Impact

EP-4284

Status
colourGreen
titleTASK

Reporting - Assessment 1st Time Pass/Fail - amend to include cancelled plans

Overview

Amended the result selection criteria for the Assessment → Assessment 1st Time Pass report & updated report descriptions to detail this.

Changes to Functionality

Updated the Assessment → Assessment 1st Time Pass report to include results from cancelled plans. This brings the report in line with the Assessment → Assessment Pass/Fail report.

The report descriptions for both the above reports have been updated to highlight that results from cancelled plans are included.

Impacted Areas

  • Reporting → Assessment → Assessment 1st Time Pass

  • Reporting → Assessment → Assessment Pass/Fail

Permissions

  • None

Status
colourGreen
titlelow impact

EP-4237

Status
colourGreen
titleTASK

Reporting - Apprentice Completions Report

Overview

The Apprentice Completions report has been extended to include apprentices at a status of “Completed”. This is so that the report correctly captures all apprentices that are going through assessment and are prior to certification.

Impacted Areas

  • Reporting

Status
colourGreen
titlelow impact

EP-4236

Status
colourGreen
titleTASK

Reporting - Certification Billing report

Overview

A new certification billing report has been added to epaPRO within the finance category of reporting.

The contract lookup for this report uses the apprentice’s start date and the price used is the certification_price against the standard assigned to the contract.

Impacted Areas

  • Reporting

Status
colourYellow
titleMedium Impact

Suggest training and testing hence medium if you use Contracts

EP-3815

Status
colourGreen
titleTASK

Status
colourRed
titleNEW_PERMISSIONS

Status
colourYellow
titlerecommend Training

Status
colourRed
titlesetup required

Overview

We have added new features to the assessment component milestones functionality within epaPRO. The highlights of this include:

  • being able to assign a milestone to a user within epaPRO

  • notifications/email and SMS comms being sent on milestone assignment/un-assignment/cancellation

  • integrating milestones within My To-Do's

  • including pending milestones in the alerts that appear on the assessment profile and the element side drawer.

Changes to Functionality

Milestone assigned user

We have added functionality that allows an assessment component milestone to be assigned to a user as the component is being booked via the assessment plan screen. The assignment can also be undertaken using the element side drawer from the assessment profile screen, where the component has already been booked. As part of this work, we have also added a tooltip to the milestone display on the assessment profile screen that when clicked on will show the user that is assigned to the milestone.

Info

Only the following users can be assigned to a milestone:

  • Element EPA

  • Element EPAM

  • Apprentice EPA

  • Apprentice EPAM

  • Apprentice

  • Provider users

The assignment for the element side drawer is a two step process, where a limited number of users in the system are returned in the initial dropdown. By selecting “other” from the results that are returned, it is possible to enter a search criteria in the text field that appears under the initial dropdown that will then return any matching users in a dropdown that will appear under the text box.

The ability to assign milestones to other users is controlled by the Assign Assessment Element Milestone found under the Assessment section on the user permissions screen. This has been assigned to Awarding Organisation, EPA Manager and EPA roles by default.

We have also added the following notifications, which are only sent to the person that is the subject of the milestone assignment:

  • Assessment Element Milestone Assigned - sent when a milestone is first assigned or reassigned

  • Assessment Element Milestone Cancelled - sent when an assessment plan is cancelled, or when an apprentice has a Change of Circumstance that causes the assessment plan to be cancelled. Only sent for milestones that have not been completed.

  • Assessment Element Milestone Unassigned - sent when a milestone is unassigned.

Milestone alerts

The assessment alerts that are shown on the Assessment profile, Element side drawer and the counts for which are shown on the Assessment progress listing screen have been updated to include milestones. These alerts will be included where the milestone has not been assigned or the milestone is overdue.

Milestone My To-Dos

We have integrated milestones into the user My To-Do’s task list, so that any outstanding milestones assigned to that user can be seen along with their due dates. As part of this, we have also added milestone tasks to the Digest email. This information can be added by using the {{milestone_details}} email variable. As with the other digest information, this will show the number of milestones the user has outstanding, the number about to breach and the number that have breached their due dates.

Milestone default assigned

We have added the ability to set which user type a milestone will default to when booking an element. This can be configured within the schedule milestone configuration per component, allowing for a different default per-schema/assessment plan. The options are Apprentice, Provider, and Element EPA.

Info

The default only applies to attendees of the element, so if Provider is set as the default when a provider attendee is added, the screen will update any relevant milestones and set that provider user as the assigned user.

If a milestone is manually edited, then it will no longer be recalculated when the attendees or element EPA is changed. Editing

a

an existing booking

and

will not

take

trigger the milestone

defaults into account, these will always be kept

assignments to be recalculated based on the configured defaults. The assignments already against the milestone, if any, will be left as they are. If multiple provider users have been added as attendees then the first in the list will be used.

Additional feature

We have also added the functionality for milestones to be copied over to a rescheduled/resit/retake element booking (on the assessment plan screen). This will copy the person assigned, the file that was used, and the completed date as well as the person that it was completed by. The copy switch will be “on” by default for all milestones, but can be turned off allowing a complete fresh-start for that milestone under the new element booking. Where the copy switch has been turned on, any custom selection in the assigned user drop down will be ignored.

Info

The copy functionality is not available for Assessment milestones.

Impacted Areas

  • Assessment plan

  • Assessment profile

  • My To-do’s

  • Assessment components

  • Change of Circumstances

  • Assessment Schema

  • Notifications

  • Digest communication

  • These changes have also had a minor impact on the following due to updated to shared components:

    • Manage Planning Capacity

Permissions

Assign Assessment Element Milestone - controls the ability to assign milestones to other users. This has been assigned to Awarding Organisation, EPA Manager and EPA roles by default.

Status
colourYellow
titlemedium impact

Recommend testing and training. This isnt High as you dont have to use these.

EP-3691

Status
colourGreen
titleTASK

Status
colourYellow
titletraining recommended

Authentication - epaPRO Account Switching

Overview

User account switching has been introduced into epaPRO to allow users who perform multiple business roles to switch seamlessly between their accounts.

Changes to Functionality

User Profile

The existing “Linked accounts” tab has been renamed to “External Calendars & SSO”, as this helps differentiate from the new functionality and also gives a better description of the contents within that tab.

A new tab has been introduced called “Associated epaPRO Accounts”. This tab can be used to keep track of the accounts linked to the logged in user, as well as link new accounts.

Note that adding a linked account from within this screen will label the current logged in account as the “primary” account. Once this has been done, only the primary account can make changes to linked accounts. Because of this, please be sure to link accounts from the account you use most often.

Associating a new user account

A new user account can be linked by clicking the “Associate epaPRO User” from within the new “Associated epaPRO Accounts” tab. Clicking this button will open a new modal, with the following options to link accounts:

  • Via SSO

    • This section (if applicable) will show any epaPRO accounts that share any SSO login as the logged in user.

    • Users will be able to associate a user by clicking the “Associate” button within the “Actions” column. Note that this button will be greyed out in the following scenarios:

      • The user is already associated with the logged in epaPRO account

      • The user is already associated with a different epaPRO account.

      • The user shares an SSO login with the logged in user, but the user is currently not logged in with that SSO login (i.e. the user shares a Microsoft login, but the user is currently logged in with Google).

  • Via User Authentication

    • This section allows a user to be linked by providing the username and password credentials of another epaPRO account.

    • If enabled against the account, the system will also request MFA verification in addition to the username and password.

In both of the methods above, the user will need to tick the confirmation boxes at the bottom of the modal, to confirm that:

  • Neither this account, nor the account being linked, are shared accounts

  • Understanding that this will allow both accounts to switch between each other without authentication

Note that an account cannot be linked under the following situations:

  • The user account is already linked to the logged in epaPRO account

  • The user account is already linked to a different epaPRO account.

Viewing/removing associated accounts

Once an account has been linked, it will display in the main table within the “Associated epaPRO Accounts” tab.

If logged in with the primary account, the user can unlink an account by using the three dot menu within the Actions column and selecting “Delete”. A user account can be re-linked at any time should it be needed in the future.

The table also shows three status columns which contain the following information:

  • Status

    • Shows whether the user account is active.

  • MFA Enabled

    • Shows what MFA methods are enabled against the user account.

  • Can Login

    • Shows whether the account can be switched to.

    • Note that an account cannot be switched to unless the following criteria is met:

      • The user account is active

      • The user account is not locked

      • The user account has MFA enabled (note this only applies if the primary account has MFA enabled)

Top menu

The user dropdown in the top-right corner of the epaPRO window has been enhanced with the following:

  • The username of the logged in user is now displayed below the user’s name

  • The user type is displayed in brackets next to the user’s name, in an abbreviated format - these will show as:

    • Awarding Organisation → EPAO

    • Provider → TP

    • Employer → EMP

    • EPA Manager → EPAM

    • EPA → EPA

    • Quality Manager → QA

    • Apprentice → APP

  • Styling changes have been made to make the menu more compact, as more information is now shown here.

  • Any associated epaPRO accounts that can login will be shown under the new “Switch Account” menu sub-section.

    • Clicking on any user account will automatically log into that account, without the need for user authentication.

QA checks

As part of this development, the QA engine has been updated to prevent users from QAing their own work when associated accounts are in use.

If a user has an EPA(M) account that has completed an assessment and a Quality Manager user that passes other QA rules, the QA user will no longer be able to perform the QA - this is because the QA engine is now aware that this user is the same person, and therefore prevents them from QAing their own work.

Impacted Areas

  • User Profile

  • Login

  • External calendars & SSO

  • QA

Permissions

None

Status
colourRed
titlehigh impact

Testing and training recommended

EP-4277

Status
colourRed
titleBUG

Login - Error when logging in with a deleted username

Overview

Fixed a bug where when trying to log in with a username that has been deleted, the user was presented with an error page rather than a validation message.

EP-4271

Status
colourRed
titleBUG

Issue with duplicating entries from saving and exiting or continuing

Overview

Fixed a bug that could occur on any saving screen across epaPRO. Before this fix it was possible to create duplicate entries of entities by double clicking either the save and exit button or save and continue buttons within a very short window. This is now no longer possible and the entities will not be duplicated.

EP-4268

Status
colourRed
titleBUG

Assessment Progress - EPA can see apprentices from cancelled plans

Overview

Fixed a bug where an apprentice would show for an EPA/EPAM when that EPA/EPAM is assigned to an element on a cancelled assessment plan.

EP-4264

Status
colourRed
titleBUG

Employer - Unable to deactivate

Overview

Fixed a bug where users were unable to deactivate an employer entity.

EP-4251

Status
colourRed
titleBUG

Assessment Progress - Memory issue

Overview

Fixed a memory issue on the assessment progress screen for EPA/EPAM users that were assigned to many apprentices.

EP-4239

Status
colourRed
titleBUG

Dashboard Targets - Error on empty

Overview

Fixed a bug where an empty value in a dashboard target would cause the dashboard to error on load. Empty values are now valid and handled properly.

EP-4231

Status
colourRed
titleBUG

Assessment Plan - Teams meetings error when changing organiser

Overview

Fixed an issue where a Teams meeting connected to an assessment booking would not be updated properly if the organiser was changed. Now if the organiser is changed the original Teams meeting is cancelled and a new one is created. This is because Microsoft do not allow the organiser to be altered.

EP-4230

Status
colourRed
titleBUG

Gateway Billing - Possible for duplicate transactions to be added

Overview

Fixed an issue where it was possible to create a duplicate transaction at gateway.

EP-4229

Status
colourRed
titleBUG

Reporting - Milestone reports error for provider users

Overview

Fixed an issue where milestone reports were not able to be ran by a provider user.
Also fixed an issue where rows were being duplicated on the Assessment Element Milestones report.

Impacted areas

  • The following reports

    • Assessment Component Milestones

    • Assessment Schema Element Milestone Rules

    • Assessment Element Milestones

EP-4227

Status
colourRed
titleBUG

Start New Programme - Errors when not passing in epa_date

Overview

Fixed a bug where not passing an epa_date when starting a new programme caused an error. This occurred via the API, bulk upload, or screen.

EP-4217

Status
colourRed
titleBUG

Assessment Milestone - due date update prior to plan completion

Overview

Fixed a bug that caused the assessment milestones due date to not be updated with a new date or time when an assessment plan element was updated prior to plan completion. The assessment milestones due date will now update as expected.

EP-3447

Status
colourRed
titleBUG

Assessment Profile - admin user should not be able to upload assessment info for elements pending approval

Overview

Fixed a bug that allowed the admin user to upload assessment info against elements pending approval.

Changes to Functionality

The element side drawer has been updated to ensure that the admin user cannot upload assessment info files against elements that are pending approval.

Impacted Areas

  • Assessment Element side drawer

Permissions

None

Jira Legacy
serverSystem JIRA
columnsEpic Link,key,type,Action Required,Release Notes Title,Release Notes Description,Potential Impact
columnIdscustomfield_10014,issuekey,issuetype,customfield_10079,customfield_10038,customfield_10039,customfield_10080
maximumIssues50
jqlQueryproject = EP AND status in (Done, "Next Release") AND fixVersion = 5.17.0 AND ( ( not ("Epic Link" = EP-1373) or "Epic Link" is empty ) and ( labels not in ('Internal') or labels is empty ) ) ORDER BY 'Epic Link', issuetype DESC, created DESC
serverIda2269739-3244-3b4d-bb8f-c582148d7bba