/
Appeals Process Beta Demo

Appeals Process Beta Demo

 

The aim of this development is for EPAOs to track Appeals from Candidates or Providers, so that they can ensure they are managed to a conclusion in a timely manner.

We have therefore created a new appeals process and window to allow these events to be tracked and reported on.

 

Once we have completed this review we will upload the recording of the User Group meeting that includes this demo to allow anyone not able to attend to review it and offer feedback.

You can locate the recording here

User Group Review Meeting 03.03.22

We also have some feedback questions we would like you to complete and send back to us.

This will allow you to suggest any changes that may be needed before the development is complete and it is loaded to your UAT.

Please return feedback to us by Mar 14, 2022 Feedback Form Link https://forms.office.com/r/vz16XEj3vs

 

Release Notes for Appeals Process - Phase 1

 

Appeals - Appeal Listing Screen

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.

The create screen introduces a new notification “Appeal Created” this is mentioned below but for more details on this new notification please read the release notes for Appeals - Notifications

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 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 appeals:

  • 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 Appeal - Details Screen.

    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 the 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.

Appeals - Appeal Detail Screen

 

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.

The create screen introduces a new notification “Appeal Updated” this is mentioned below but for more details on this new notification please read the release notes for Appeals - Notifications

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.

New Permissions

Five new permissions has been added to control this screen.

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:

o   awardingorganisation

o   owner

o   epa

o   epamanager

o   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:

o   awardingorganisation

o   owner

o   epa

o   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:

o   awardingorganisation

o   owner

o   epa

o   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:

o   awardingorganisation

o   owner

o   epa

o   epamanager

o   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:

o   awardingorganisation

o   owner

o   epa

o   epamanager

o   provider

o   employer

o   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.

·        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:

o   The appeal has no comments

o   The appeal has no files linked

o   The appeal has no element result adjustments linked

o   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.

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

A new notification has been added that is sent whenever the appeal has been updated. The notification is called “Appeal Updated” 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

Appeals - 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.

Appeals - ESFA Updates

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.

Appeals - 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 cannot be QAed if there is an open appeal.

Appeals - 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.

Appeals - 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.

This change stamps a last appeal date against the result when the QA is published. This means existing results have not been retroactively updated to have a last appeal date. These results will be assumed to have passed the appeal window.

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.

For certifications the appeals window uses the existing certification appeal window that is found within the Configuration → ESFA → Appeals setting.

Appeals - 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.

Appeals - Notifications

 

The appeals functionality has added two new notifications “Appeal Created” and “Appeal Updated”. Both them by default are In App notifications that will be sent to Providers, Awarding Organisations and the Subject user.

The subject user for both notifications is the EPA assigned to the element or the EPA assigned to the apprentice if the appeal is linked to a certification.

Both 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:

o   A new comment has been added, edited or deleted

o   A file has been linked or unlinked

o   The appeal’s basic details have been changed

o   The appeal has been closed or reopened

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

Email and SMS templates have also been given a new variable {{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.

Appeals - Summary Report

A new permission has been added to control visibility of this report.

A new report called “Appeal Summary” has been added to a new “Appeals” category within reporting.

 

This 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

A new permission has been added under the reporting heading called “Appeal Summary” this permission has been given to the “owner” and “awardingorganisation” roles by default