# Approval Actions

## Overview

'Approval' Actions enable an approval request flow to be added into the Case.

Often within the Case flows of business processes which are built in Enate there are points where external people (i.e. people working **outside** Enate - this could be business managers within your company or the relevant client company) need to sign off on activities before the process can continue. Payroll processes are good examples of such processes, where client management need to sign off on payroll reports before the process can be allowed to continue.

Enate's Approval Action is built to specifically support these scenarios in a more integrated way - to ensure that this 'approval cycle' is tightly managed and visible within the flow of activities in Enate. When an Enate Case reaches an Approval Action in a flow, things then work as follows:

* Enate uses uploaded business rules to **determine the Approvers** to whom approval request emails should be sent (standard email templates are available, but these can be modified to contain information sufficient for approver to review what is being requested). See dedicated section describing how your approver business rules can be uploaded into Builder.
* Once the approvers are determined, **Enate sends out Approval Requests** and then **Waits for their response**. Depending on the type of approval defined, this might send out one request after another (awaiting approval from the first) in a multilevel request, or might send the request to a group of people in one go, waiting for either one or all to approve before continuing.\
  &#xNAN;_&#x4E;ote: While this is happening, the Approval Action in Work Manager sits in a state of '**Wait for more Information**'_
* Those **approvers can then approve or decline**, via a link in the email sent to them which takes them to an online form.
* Once all required Approvals have been received, **the Case process can continue again\***.&#x20;

{% hint style="info" %}
\*Important note: If the approval action times out with no or insufficient responses, current system behaviour is that the Case flow will recommence as if full approval was received.
{% endhint %}

To use 'Approval' Actions, you need to create an 'Approval' Action type and then add the Action into your Case flows.&#x20;

## Creating an Approval Action Type

You can either create an Approval Action type in the Service Line section of Builder, or directly from your Case flow.

### From the Service Lines Page

Creating an Approval Action type from the Service Lines page adds the Action type to your menu of available Actions when you're building flows subsequently in Cases.&#x20;

To do this, in the Service Line page, select which service line you would like to add the Approval Action to and then click on the plus symbol next to the 'Process Search' box. This will bring up a drop down menu where you can select an Action.

<figure><img src="https://3859925423-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MWYnDNwe3Cuo4zlGbs5-887967055%2Fuploads%2FJp1yrAaBkAVm0QNnAgIa%2Fimage.png?alt=media&#x26;token=464c4f7c-7881-40cb-ba4a-ae79e94f5056" alt=""><figcaption></figcaption></figure>

This will open up a new Action for you to create. &#x20;

Add a name and description to your Action and then in the type drop down select 'Approval Action'.&#x20;

Once you are happy with your Action, hit save to create it. This Action can now be added to new and existing business processes by selecting it from the dropdown list when adding a new Action to a Case.

### From a Case Flow

Alternatively you can add an Approval Action type directly from the Case flow itself.

To do this, open a Case flow in edit mode, click on an Action's menu and then instead of clicking to add an existing Action, select to create a new Action by clicking the '+' icon.

<figure><img src="https://3859925423-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MWYnDNwe3Cuo4zlGbs5-887967055%2Fuploads%2FN4hHRy8IINdDAEfq10O6%2Fimage.png?alt=media&#x26;token=9f8477ce-4b5f-4f93-9d90-5b9e0412c7ca" alt=""><figcaption></figcaption></figure>

Give the Action a name, add a description if you wish and for its type, select 'Approval Action'.

This will add the Approval Action to the Case flow.

## Configuring Approval Actions

You now need to configure the settings for the new Action you have added to your Case. Click on the Action in the flow to highlight it in the info section.

In the Action Info tab, you need to add the usual following information for an Action:

| Setting            | Description                                                                                                                                                                                                       | Notes                                                                                                                                                                                              |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| When is it due?    | Select a value from the dropdown menu of Due Date ‘flavours’                                                                                                                                                      | <p>Mandatory to set live.</p><p>(See <a href="../../shared-standardised-settings-flavours/due-date-flavours">Due Date Flavours Settings</a> for more information).</p>                             |
| Who does it go to? | Select a value from the dropdown menu of Allocation ‘flavours’                                                                                                                                                    | <p>Mandatory to set live.</p><p>(See <a href="../../shared-standardised-settings-flavours/allocation-flavours">Allocation Flavours Settings</a> for more information). </p>                        |
| General Settings   | Select a value from the dropdown menu of Follow Up ‘flavours’                                                                                                                                                     | <p>Mandatory to set live.</p><p>(See <a href="../../shared-standardised-settings-flavours/general-settings-flavours-action-only">General Settings Flavours Settings</a> for more information).</p> |
| Main Card          | You can select a Custom Card to display on the main section of the Action screen.                                                                                                                                 | Optional. See here for more information about [Custom Cards](../../custom-data-and-custom-card-configuration).                                                                                     |
| Side Card          | You can select a Custom Card to display on the side panel of the Action screen.                                                                                                                                   | Optional. See here for more information about [Custom Cards](../../custom-data-and-custom-card-configuration).                                                                                     |
| Manual Creation    | Switching this setting on allows the Action to be started manually in Work Manager.                                                                                                                               | Optional. See [Adding Ad-hoc Actions](adding-ad-hoc-actions) section for more information.                                                                                                         |
| Checklist          | Here you can add local checks to the Action that help support 'custom' activities that take place for that specific Action. You can also edit the global checks for the Action type from here too, if it has any. | Optional. See here for more information about [adding checklists](checklists-on-actions).                                                                                                          |

Additionally, once an Approval Action has been added to your Case flow, a new 'Approval' tab will display in the info grid.

Here you need to add the following settings that are only relevant for Approval Actions.&#x20;

<table data-header-hidden><thead><tr><th width="188.33333333333331">Setting</th><th width="221">Description</th><th>Notes</th></tr></thead><tbody><tr><td>Setting</td><td>Description</td><td>Notes</td></tr><tr><td>Approval Type</td><td>Select an approval type.</td><td><ul><li><strong>Multilevel</strong> - More than one level of approval is required. Request is sent to the first-level approver and, only if approved, onto the next level, and so on, up to a maximum of three levels. If you've selected Multilevel, you will also need to add how many levels of approval are needed in the 'Approval Levels' column (maximum 3).</li><li><strong>Parallel Any</strong> - The approval request is sent to multiple people at the same time, and the decision is taken from the first one to respond. A maximum of 5 approvers can be specified at runtime.</li><li><strong>Parallel All</strong> - The approval is sent to multiple people at the same time, and approval is needed from all of them. If any decline, the approval is declined. A maximum of 5 approvers can be specified at runtime.</li></ul></td></tr><tr><td>Approval Levels</td><td>Enter the number of approval levels you would like the request to have, up to a maximum of 3.</td><td>Only relevant if you have selected 'Multilevel' as your approval type. If you have selected either of the two parallel approval types, the approval levels will automatically be set to 1.</td></tr><tr><td>Approval Request Email</td><td>Select which approval email template you would like to be sent out to the approvers</td><td>See <a href="../../email-template-configuration">this section</a> to find out how to create and adjust approval email templates.</td></tr></tbody></table>
