Versions Compared

Key

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

By following the steps below, you can ensure that escalation actions are triggered appropriately, enhancing the efficiency and responsiveness of the approval process. The process includes

  • Creating escalation policies,

  • Adding them to the approval steps

tip

This document provides instructions for creating, adding, and verifying escalation policies in the approval flow. First, you will create the policies, then add them to approval steps, and finally verify them. If you are using the "Notify" escalation action, you will need to perform additional configurations.

Tip
  • Please refer to the Business Request Escalations document for an overview of the escalation policy.

  • While you have the option to create new policies, EmpowerID offers a Default Escalation Policy for your convenience. This default policy includes predefined actions and escalation cutoff days. The default policy for escalation is discussed here in Business Request Escalations

  • To use these policies, you need to create and add them to the approval steps. However, you must make additional configurations if you plan to use the Notify escalation action type to send email notifications. It is important to note that failure to configure these settings will result in the notifications not workingre-notifications. More information about the additional configurations can be found in this documentationthe section below, Additional Configuration for Notify Escalation.

    • Create and set up Notification Policies for Renotification for each participant type configured in escalation steps. You have the ability to modify important settings such as the email to be sent (Email Template), recipient of the email (Participant Type), and the Business Request level in which the Notification Policies will be triggered.

    • Ensure that Notification Preferences are configured and stored in the database. It's important to note that these preferences are currently created from the database and not through a user interface (UI).

Step 1: Creating Policies

Creating an escalation policy is the first step in managing business requests that haven't been acted upon within a specified timeframe. This policy outlines the actions and timeframes for escalations. Once created, these policies can be applied to multiple approval steps with similar escalation situations. Follow the instructions below to create an escalation policy.

Note

Please note that policies need to be published for them to work.

  1. Navigate to Low Code / No Code Workflows and click on the Approval Policies.

  2. Click on the Escalation Policies Tab.

    image-20240705-053524.png

  3. Click on the Create New ➕ icon.

  4. Provide a Name and Display Name for the escalation policy and click on Save.

    image-20240705-054421.png

  5. Search for the recently saved policy and click on the link to open the view one page.

    image-20240705-054725.png


  6. In the View One Page, Find the accordion for Escalation Actions and click on the Add icon.

    image-20240705-090344.png

  7. Provide the necessary values and click on Save.

    image-20240705-092832.png

    • Escalation after X Days: Number of days after which the escalation action should execute.

    • Escalation Actions: Actions to be performed as part of the escalation. Escalation actions can include notifications, adding assignees, auto-closing items or steps, etc. Each type of action has specific configurations:

      • Notify: Select the participant type (e.g., potential approver, potential approver's manager) who will receive the notification.

      • Add Assignee: Define the type of assignee (person, group, management role) to be added after specified days.

      • Auto-Close Item: Define the decision action (approve, revoke, certify, convert to JT) to auto-close the item after specified days.

      • Auto-Close Step: Close a specific step in the approval flow, allowing the process to move to the next step.

    • Name: Name of the escalation step.

    • Display Name: Provide a user-friendly label or "Display Name."

To add more steps, repeat the same steps.

  1. Click on the Publish button on the display screen. Unpublished policies will not be available for mapping to approval steps.

    image-20240705-093315.png

Step 2: Adding Escalation Policies to Approval Steps

Info

Approval steps are part for configuring approval and routing in the approval engine. This section focuses solely on linking escalation policies to approval steps. Note that the approval step must also be added to policies and published. Please refer to the full documentation for comprehensive instructions on configuring approval steps and policies.

After creating an escalation policy, the next step is to map this policy to specific approval steps within your workflow. This ensures that each approval process step triggers the defined escalation actions appropriately. Follow the instructions below to add escalation policies to approval steps,

Note

Please note that approval steps must be published for the escalation policy to work once they are added to steps.

  1. Navigate to Low Code / No Code Workflows and click on the No Code Flows.

  2. Select the Approval Steps tab and click on the Add icon to create a new approval step.

    image-20240705-100202.png

  3. Provide the necessary details and click on Save to save the approval step. Please ensure that you select the desired escalation policy from the Escalation Policy dropdown, which we created earlier.

    image-20240705-095532.png

  4. After saving the approval step, we will need to publish it. Search the newly created record in the approval step tab and click on the link in the name column.

    image-20240711-113854.png

  5. In the View One Page, click on Publish to complete adding the escalation policy to the approval step.

    image-20240711-114059.png

  6. You have successfully created an approval step and published the escalation policy by following these steps.

Step 3: Verifying Escalations

When choosing a type of escalation action, the escalation process will vary based on the selected action, the timeframe, and the necessary steps. For instance, if you opt to add an assignee, the specific assignee should be added to the business request item after the configured escalation days. If you select the Notify action type, an email will be sent to the configured participant or participant type; please refer to the image below for reference.

image-20240711-104957.png

Anchor
additionalconfig
additionalconfig
Additional Configuration for Notify Escalation

You need to ensure the notify escalation action works in these additional configurations. Failing to configure this might result in its failure.

Ensure Notification Policies are Configured

If you are configuring the Notify escalation action type to send email re-notifications while creating the escalation action, you must ensure that the following configurations are done properly.

Notification Policies are Configured for Renotification

Notification policies in EmpowerID are essential configurations that define how notifications are sent within the system. You can customize who will receive the notifications and which email template will be used during the Renotification by configuring it in the notification policy. Please make sure that the following configurations are done correctly for the Re notification Escalation Action.

Tip

Notification policies for business request escalations are typically shipped with the product

; however, you must ensure they are configured correctly. These policies define who gets notified and when during an escalation triggered by inactivity in a workflow.
  • Navigate to Low Code / No Code Workflow → Notification Policies.

  • Click on the Notification Policies tab.

  • Verify that the notification policies are configured. The policies for

    and should already be configured for renotification.

    If you need to create new notification policies or verify existing one, please refer to the Notifications and Emails documentation for instructions. Please ensure that the configurations mentioned below are set up correctly for the existing policies or when creating new ones.

    • Supported Request Levels: Ensure that notification policy is created only for the “Business Request Approval Step” and “Business Request Item Approval Step” request levels.

    • Global Business Request Event Type: Configure the Business Request Event (Global) type

    should be set
    • to "Renotification

    ," and notification policies should be configured for each participant type (e.g., potential approver, target person manager) and used in the escalation steps.image-20240705-114130.pngImage Removed

    Email Templates for Escalation

    The Email Notification Policy should include an email template as the notification message. Currently, the out-of-the-box email template is being used for the notification policies. The template MyTasks_BusinessRequestTtem_ApprovalStep_Approval_Renotification is currently used for all re-notification policies and contains a general notification message.

    Ensure Notification Preferences are Configured

    Create notification preferences for each participant type to ensure users receive email notifications
    • ." for the Renotification Policies.

    • Email Template: Please select the email template you would like to use for the notification. Currently, the default email template for all notification policies is “MyTasks_BusinessRequestItem_ApprovalStep_Approval_Renotification”, which includes a general notification message. You can modify the existing email template; please refer to the Localizing Emails documentation for customizing the email template.

    • Add notification policies for each Participant Type (e.g., potential approver, target person manager) to be configured in the escalation steps. The type of participant determines who will receive the notification.

    image-20240807-100120.pngImage Added

    Notification Preferences are Configured

    Notification Preferences in EmpowerID allow users to customize how they receive notifications about various system events and actions. The notification preferences should also be configured for Renotification.

    Tip

    Notification preferences for business request escalations are shipped with the product and should already be configured for renotification. Note that these preferences are currently created from the database, not through a UI.

    Navigateto Low Code / No Code Workflow → Notification Policies.
  • Click on the Notification Preferences tab.

  • Ensure that the Notification Preferences are created for all participant types used in the escalation actions.

  • image-20240705-115417.pngImage Removed

    Please refer toConfigure Notification Policies and Preferences document for additional information about managing it.

    Please make sure the following configurations are done correctly for the notification policy,

    • Global Business Request Event Type: For the Renotification Preferences, configure the Business Request Event (Global) type to "Renotification."

    • Create notification preferences for each participant type to be configured in the escalation steps to ensure users receive email notifications.

    image-20240807-102029.pngImage Added

    Div
    stylefloat:left; position:fixed;
    idarticleNav

    IN THIS ARTICLE

    Table of Contents
    minLevel2
    maxLevel2
    outlinefalse
    stylenone
    typelist
    printablefalse