We have created a new Appeals process so that EPAOs can track Appeals from Candidates or Providers so that they can be managed and tracked.

A new appeal create screen has been added as part of the new Appeals functionality. This screen provides the relevant details about the entity (certification or element) that is being appeals along with the apprentice’s details and a form where basic information about the appeal can be entered. This screen is also used for editing an existing appeal via the “Edit Appeal” button when viewing the details.

Creating An Appeal

Appeals can be created from the Manage Element or Manage Certification side drawers. The following criteria are required for this button to show:

• Elements:

  • User has the “Create Element Appeals” permission

  • There is no currently “open” appeal, this includes the awaiting response statuses

  • The apprentice has not been submitted to the ESFA

  • For external users - the last appeal date has not passed, this uses the new Appeal Window field against components see the release notes for Appeals - Assessment Component Changes

  • QA has been published

• Certification:

  • User has the “Create Certification Appeals” permission

  • There is no currently “open” appeal, this includes the awaiting response statuses

  • The apprentice has not been submitted to the ESFA

  • For external users - the last appeal date has not passed, this uses the existing setting within EPAPro that controls the certification appeal window, found in Configuration → ESFA → Appeals

  • QA has been published

Element / Certification Details

This new screen has a very similar layout between an appeal for a certification or an element. The section at the top of the screen will change depending on the entity being appealed:

• Elements will show the “Element Details” box which contains summary information about the element and then a button to open the Manage Element side drawer

• Certifications will show the “Certification Details” box which, like the elements, will show summary information about the certification and a button to open the Manage Certification side drawer

Appeal Fields

This screen then allows the user creating the appeal to enter the following details:

• Title - this is a short title for the appeal and can be used for any purpose. This title will be shown in various places and can be used to identify the appeal. For example, some of our customers have multiple states of appeals so this could indicate a “Stage 1” or “Stage 2” appeal against an element.

• Summary - this is a summary of the appeal, it might include initial details about why it’s being raised and acts as a description. It has a character limit of 1000 characters.

• Status - internal users are able to edit the status when creating or editing an appeal. The status indicates where the appeal is and who needs to perform an action on it. External users will only be able to trigger the status change when adding comments - see the release notes for Appeals - New appeal Details Screen for details.

• Requested By - this is an informational field to indicate who requested the appeal, this is to account for the appeal being created by a user that did not request it. For example, a provider creates it on the apprentice’s behalf.

• Requested Date - this is the date the appeal was requested, again to account for it is different to when the appeal is created.

During the creation of the appeal, a user can also attach one or more files. The appeals system uses our recently release Apprentice Files system and so any file already uploaded can be linked or new ones uploaded and linked.

Alerts / Element & Certification Status

To make it clear when an element or certification has an open appeal the status of the element or certification will show as “Under Appeal”. An alert will also be shown indicating what elements/certification are under appeal and provide a link to “view details” if the user has permission.

Permissions

Two new permissions have been added to control who can create appeals. These new permissions are available under the “Appeals” heading and are called:

• Create Certification Appeals - This allows the user to create appeals against a certification. The following system roles will have this permission by default:

  • awardingorganisation

  • owner

  • epa

  • epamanager

  • provider

• Create Element Appeals - This allows the user to create appeals against an element. The following system roles will have this permission by default:

  • awardingorganisation

  • owner

  • epa

  • epamanager

  • provider

Notifications

A new notification has been added that is sent when a new appeal has been created. The new notification is called “Appeal Created” and by default is configured as an In App notification to the following users:

• Awarding Organisation

• Providers

• Subject - This is the EPA assigned to the element being appealed or the EPA assigned to the apprentice if a certification is being appealed

For more information on this notification please read the release notes for Appeals - Notifications.

The create screen has introduced two new permissions with have been given to some system roles by default. These are detailed below and will need to be applied to any custom roles as required.

A new appeal details screen has been added that allows for the full management of the appeal. This is where the bulk of the appeal process will be controlled with result adjustments being used to link back up the changes with the appeal.

This new screen has four main tabs; Details, Comments, File Uploads and Activity. These will be detailed below. Similar to the create appeal screen, the top section of this screen also contains the apprentice’s details and the element or certification details, depending on which the appeal is linked to. A shortcut “Result Adjustment” button is also shown which will automatically select the adjustment reason to “Appeal” and select this appeal.

When an appeal has been closed a box will show at the top of the appeal details screen indicating the appeal has been resolved. It’ll show the date it was resolved along with who and the description they entered. This box will be collapsed on mobile but can be expanded by tapping.

New Permissions

The details and default roles for each are below:

• Add/Edit Own Appeal Comments - This provides the user the ability to add, edit and delete their own comments on the appeal. By default the following roles have this permission:

  • awardingorganisation

  • owner

  • epa

  • epamanager

  • provider

• Delete Appeals - Allows the user to delete an appeal, see below for the other criteria needed to delete an appeal. By default the following roles have this permission:

  • awardingorganisation

  • owner

  • epa

  • epamanager

• Update Appeals - Allows the user to update the base details of an appeal, including the title, summary, requested by, requested date and the status (for internal users). By default following roles have this permission:

  • awardingorganisation

  • owner

  • epa

  • epamanager

• Update/Delete Own Appeal Files - Similar to comments this permission allows the user to upload/link and delete files they’ve uploaded. By default the following roles have this permission:

  • awardingorganisation

  • owner

  • epa

  • epamanager

  • provider

• Read Appeals - This allows the user to read details about an appeal including access to the listing screen (which will pre-filter based on the ones they should see), access to the details screen and the appeals widget on the Manage Element and Manage Certification side drawers. By default the following roles have this permission:

  • awardingorganisation

  • owner

  • epa

  • epamanager

  • provider

  • employer

  • apprentice

Details Tab

This tab provides some useful actions for the appeal along with the base information about the appeal, as entered when creating it. This is the first tab shown when viewing the details of an appeal.

The available actions are:

• Close Appeal - This will change the appeal's status to “Closed”. This button will only be shown when the appeal’s status is not “Closed” and if the user has the “Update Appeals” permission. A resolution will need to be provided and similar to the summary this is a text field with a maximum character count of 1000. Once the appeal has been closed an “Appeal Closed” notification is sent to relevant users via the methods configured.

• Reopen Appeal - This will change the appeal’s status back to “Open”. This button will only be shown when the appeal’s status is “Closed” and if the user has the “Update Appeals” permission.

• Edit Appeal - This will take the user to the edit appeal screen, which is the same as the create appeal screen. This will only be shown if the user has the “Update Appeals” permission and the status of the appeal is not “Closed”.

• Delete Appeal - This will permanently delete an appeal. This will only be shown if the user has the “Delete Appeals” permission and the appeal meets the following criteria:

  • The appeal has no comments

  • The appeal has no files linked

  • The appeal has no element result adjustments linked

  • The appeal has no certification result adjustments linked

Comments Tab

The comments tab is an area where all parties involved will be able to comment on the appeal. Each comment can be up to 1000 characters long and the current length of the message is indicated by the counter under the field.

The list of comments can be sorted with the newest shown first (default) or the newest shown last. The add comment form will also move to the top/bottom of the list depending on the sort. As you can see from the image below they appear similar to text messages with your comments “right justified” and the responder “left justified”.

When adding a comment an internal user can choose to automatically toggle the status of the appeal to “Awaiting Provider Response” and external users can automatically toggle the appeal to “Awaiting EPAO Response”. If a comment needs to be added but the user still needs to action something they can untick the box to keep the status of the appeal the same.

File Uploads Tab

This tab will be familiar to those that have been using the result, certification or QA screens with the recently released apprentice files work. This allows the user to attach files to the appeal using the same apprentice file system.

Activity Tab

An appeal requires an audited trail of changes and so this activity tab will keep track of everything that happens with the result. It’ll be shown with the newest first and display what happened, who did it and when. The following activity will be logged against an appeal and shown on this tab:

• When the appeal is created

• When the appeal is updated

• When the status of the appeal has changed

• When a comment has been added, deleted or edited

• When a file has been linked or unlinked

• When a result adjustment has been linked

Notifications

Two new notifications have been added that are sent whenever the appeal has been updated or closed. The notifications are called “Appeal Updated” and “Appeal Closed” by default both are configured as an In-App notification to the following users:

• Awarding Organisation

• Providers

• Subject - This is the EPA assigned to the element being appealed or the EPA assigned to the apprentice if a certification is being appealed

For more information on these notification please read the release notes for Appeals - Notifications

Assessment Element Changes

A new “Appeals” widget has been added to the manage element side drawer. This widget provides a way to create an appeal for the element, providing the creation criteria has been met, and also see a history of past appeals linked to the same element.

Each appeal row in the side drawer will display the title and current status and then when clicked on will also show the following details:

• Requested Date

• Requested By

• Closed Date

• Closed By

• Created Date

• Created By

The list of past appeals are shown in order with the most recent first.

This widget will also show an info box at the top informing the user of the date the appeal window ends and that the appeal window has finished.

The view adjustments section of the manage element drawer has also been updated to include a link to an appeal if the type of change is “Appeal”.

Assessment Component Changes

This change requires the assessment components to be updated with the relevant appeal window. By default this value will be 0 days when deployed and so external users will not have the ability to raise an appeal against an element.

A new Appeals Window field has been added to the assessment components. This is the number of days after the QA has been published that an external user can raise an appeal. Once this date passes external users will lose access to the create appeal button. Internal users will still have access to this button.

When a QA is published for the result the current date plus the defined appeal window will be used to calculate the final date. Once this final date has arrived external users will lose the ability to create an appeal.

If the appeal window has passed and an appeal is still created a warning will be shown indicating the window has passed.

Result Adjustment

The result adjustment functionality has been extended to integrate into the new appeals system. Past adjustments will be unaffected by these changes. A result adjustment for any reason other than an appeal will still work as it did before, no changes have been made for these.

When selecting “Appeal” as the reason for a result adjustment a second dropdown will now be shown, allowing an appeal to be selected from the list. By default the result adjustment screen will automatically select the most relevant appeal, i.e. one that is linked to the element/certification being adjusted, however, the adjustment can be linked to any appeal if needed.

The new dropdown will show all open (including awaiting response status) appeals for the apprentice and will show the title of the appeal, the component name or “Certification” it’s linked to and the current status of the appeal.

A result adjustment due to an appeal will now require an appeal record to have been created and not be in a closed status.

When saving the adjustment this will trigger the adjustment to be linked up to the appeal and will automatically add a new activity entry on the appeal indicating a result adjustment has been linked.

When the result adjustment is saved EPAPro will automatically change the apprentice’s status as required based on the new state of their assessments and certification.

Certification Changes

The criteria around when a certification can be QAed has been updated to now take into account the new appeals system. A certification can not be QAed if there is an open appeal.

Manage Certification Changes

A new “Appeals” widget has been added to the manage certification side drawer. This widget provides a way to create an appeal for the certification, providing the creation criteria has been met, and also see a history of past appeals linked to the certification.

Each appeal row in the side drawer will display the title and current status and then when clicked on will also show the following details:

• Requested Date

• Requested By

• Closed Date

• Closed By

• Created Date

• Created By

The list of past appeals are shown in order with the most recent first.

This widget will also show an info box at the top informing the user of the date the appeal window ends and that the appeal window has finished.

The view adjustments section of the manage certification drawer has also been updated to include a link to an appeal if the type of change is “Appeal”.

ESFA Submission Screen

The ESFA screen has been updated to exclude any apprentices that have an appeal in a non-closed state. Once the appeal has been closed they will then show on the screen.

Appeal Notifications

These notifications have some special conditions when a provider or employer triggered the notification. In this instance, the notification will not be sent to the other users of the provider or employer. The notification will also not be sent to the user that triggered the notification.

• Appeal Created - This is sent when an appeal has been created against a certification or element result.

• Appeal Updated - This is sent when an appeal has been updated in any way. This includes:

  • A new comment has been added, edited or deleted

  • A file has been linked or unlinked

  • The appeal’s basic details have been changed

  • The appeal has been reopened

  • A result adjustment has been made against any element or certification and linked to the appeal

• Appeal Closed - This is sent when the appeal has been closed.

Email and SMS templates have also been given two new variables:

• {{appeal_entity_name}} this will either be “Certification”, if the appeal is linked to a certification, or the component name if it is linked to an element.

• {{appeal_resolution_text}} this is only available on the “Appeal Closed” notification and will contain the resolution text that was entered when the appeal was closed.

Appeals Summary Report

A new report has been added to a new “Appeals” category within reporting. The new report is called “Appeal Summary” and will provide summary details about an appeal. This report can also be filtered by the usual reporting filters, standard, provider, specialism, employer and via a new “Appeal Status” filter.

Permissions