Let the platform do the work

Stock SugarBPM - Case Follow-Up Date Management

Overview

Sugar has several stock SugarBPM™ templates available to users based on their license type. Three of these are Sugar Serve templates that work together to automate customer service processes:

  • Case Follow-Up Date Management V2
  • Case Status Update on Inbound Customer Note
  • Customer Notification of Case Status Change

The primary one of these is Case Follow-Up Date Management V2, which manages the Service Level Agreement (SLA) on new and existing cases. To use this process definition in your Sugar instance, you must first create and configure items outside of SugarBPM such as business centers and case status values to suit your business needs. These steps are covered in the Getting Started With SugarBPM for Sugar Serve article. Then, you must configure the Case Follow-Up Date Management V2 process definition and its two helper process definitions to work with your organization's business processes. Examples of what may need to be configured include case statuses, SLA times, business centers, and email templates.

This article outlines everything you may need to change to make the process definitions work in your instance. Note that it is recommended to always test new configurations in a sandbox development environment before using them in your live Sugar instance.

Prerequisites

  • Your user profile must have a Sugar Serve license because the stock SugarBPM records discussed in this article can only be edited by Sugar Serve users. For more information on license types, refer to the License Types Matrix documentation.
  • You must be an administrator or have developer-level role access to the Cases module in Sugar to create and manage SugarBPM records for cases.
  • Before performing the steps in this article, it is recommended that you have a basic understanding and knowledge of SugarBPM.
  • Schedulers, specifically the SugarBPM™ Scheduled Job, must be running.
  • A manager-subordinate relationship should exist for all users who may be assigned cases. This relationship is established on user records via the "Reports To" field.

For more information on these items, please refer to the User Management, Role Management, SugarBPM, and/or Schedulers documentation.

Understanding Stock Templates When Upgrading Sugar

If you adopted Sugar Sell using some older, unsupported versions of Sugar, then you will find two similarly-named SugarBPM templates for the Cases module: "Case Follow-Up Date Management" and "Case Follow-Up Date Management V2". The original version of the template is obsolete and should not be used. If you previously configured the original version to work in your instance, you must follow the Steps to Complete below to apply all the same changes to V2 in addition to configuring the new elements. Alternatively, you could choose to add the new V2 elements to your existing template and leave the V2 version disabled. The new elements in V2 are marked with an asterisk in the table below.

Note that the V2 version of the template will be disabled until you configure and enable it. It is important to only enable one version of the template at a time to avoid unexpected behavior.

Steps to Complete

Case Follow-Up Date Management V2

The table below lists every element in the Case Follow-Up Date Management V2 process definition and the changes that may be needed to work with your instance. Note that some steps may not be required if you have not made certain changes to your instance.

Keep in mind that this SugarBPM template is a revision of an old one that was included in a previous version of Sugar Serve. The V2 version is available in Sugar Serve and includes new functionality. Elements that are new in V2 are marked with an asterisk in the table below. Refer to the Understanding Stock Templates When Upgrading Sugar section above for how to proceed after an upgrade.

Note that elements with names that have "V2" at the end did not change from the original version. They simply use the V2 copies of the process business rules and process email templates, which are identical to their original counterparts.

Element Element Type Steps to Configure

1-TerminateProcess

Process Definition Settings If you have changed the list of values available for the Status field on the Cases module, right-click anywhere in the designer canvas and select "Process Definition". From here, update the Terminate Process criteria to use the correct statuses instead of "Closed", "Rejected", and "Duplicate".
TerminateProcessSettings
2-NewCase Start Event If you have changed the list of values available for the Status field on the Cases module, update this Start event's criteria to filter on the correct status instead of "New".
NewCaseSLAV2 Business Rule Action

The New Case SLA process business rule uses the Priority and Service Level fields on the Cases module; if you have changed the list of values available for either of those fields, update the matrix accordingly. Either way, you will need to set up the business rule to match your organization's Service Level Agreements (SLAs). You can do this by adjusting the combinations of priority and service level in the Conditions section if needed, then changing what the Follow Up Date field is set to in the Conclusions section according to your organization's SLAs.

In addition, you must also ensure that every account has a business center assigned. The business hours used when calculating SLAs are taken from the account's business center. If you would prefer to manually specify a business center instead of requiring it to be set on every account record, follow these steps to ensure the specific business center is used:

  1. Right-click the designer canvas and select "Process Definition". In the Terminate Process field, remove the last evaluation and the OR that joins it to the other criteria by clicking the X icon for each.
    TerminateProcessRemove
  2. Update the three Change Field events that set the Follow Up Date field using business hours to use a business center of your choice instead of the one from the target module. Note that you will have to remove the existing evaluation and replace it with your own. The three events that need to be changed are: "Follow-Up: RunTime+8bh", "Follow-Up: RunTime+16bh", and "Follow-Up Extension".
    ChooseBusinessCenter
  3. Update all of the conclusions in the New Case SLA process business rule in the same way as above to replace the existing business hour evaluation with your own. The new evaluation should use the specific business center you would like to use instead of the one from the target module.

Note: The process definition does not evaluate the return values so updating them does not impact the process.

4-RoundRobinAssignTheCase Round Robin Action

Set the team from which the process user should be selected. By default, it is set to the Global team.

If your organization has multiple teams to which new cases are assigned based on certain criteria (e.g. region), update the round-robin assignment to map to the correct team. This can be done using the following steps:

  1. Create a new process business rule with the Cases module as the target.
  2. Add an "is" condition for each possible category used to route cases. For example, add a condition on the related account's Billing Country field for each country in which your organization does business. Set the return value to a string that represents the team or region to which the case should be routed.
    New Case Region
  3. After the New Case SLA V2 action in the process definition, add another Business Rule action that evaluates the business rule you just created.
  4. Next, add a diverging exclusive gateway that splits the flow into Round Robin actions for each team to which cases can be routed. Configure all Round Robin actions to update the Assigned To field on the record. Optionally, you can configure them to only assign records to users who are available for work; see the Process Definitions documentation for more details.
  5. Choose a default flow for the gateway and set the criteria for all remaining paths using the return values of the business rule.
  6. Lastly, add a converging exclusive gateway to which all the Round Robin events connect. This gateway rejoins the original flow at the Provide Case Details to New Owner event.

After completing the above steps, the changes should look similar to the following, depending on how many regions your organization has:
CaseFollowUpRoundRobinPD copy

5-ProvideCaseDetailsToNewOwner Send Message Event If desired, update the wording and details included in the Case Assigned process email template.
6-SLAExpires Event-Based Gateway No configuration required.
7-SLAChange Receive Message Event If you have changed the list of values available for the Status field on the Cases module, update this Receive Message event's criteria to listen for the correct status instead of "New".
8-Follow-UpDate Wait Event No configuration required.
SLAMetNo2 Change Field Action* No configuration required.
NotifyManagerSLAMissedV2 Send Message Event If desired, update the wording and details included in the Notify Manager: SLA Missed process email template.
StatusFromNew Receive Message Event* If you have changed the list of values available for the Status field on the Cases module, update this Receive Message event's criteria to listen for the correct status instead of "New".
FirstResponseSentYes Change Field Action* No configuration required.
11-UpdatedOpenCase Start Event If you have changed the list of values available for the Status field on the Cases module, update this Start event's criteria to filter on the correct statuses instead of "Closed", "Rejected", and "Duplicate".
12-Status Exclusive Gateway If you have changed the list of values available for the Status field on the Cases module, update both Criteria fields to filter on the correct statuses instead of "Pending Input", "Closed", "Rejected", and "Duplicate".
13-Follow-UpRunTime8bh Change Field Action If customer service representatives should have more or less than the default eight business hours to follow up on a case, update the calculated formula for the Follow Up Date field. Be sure to also update the name of the event to match the change.
14-Follow-UpRunTime16bh Change Field Action If clients should have more or less than the default sixteen business hours to follow up on a case, update the calculated formula for the Follow Up Date field. Be sure to also update the name of the event to match the change.
15-ClientFollow-Up Event-Based Gateway No configuration required.
16-InboundEmailReceivedWhilePendingInput Receive Message Event If you have changed the list of values available for the Status field on the Cases module, update this Receive Message event's criteria to filter on the correct status instead of "Pending Input".
17-ChangeStatusAndUncheckPendingProcessing Change Field Action If you have changed the list of values available for the Status field on the Cases module, update the value to which the event changes the Status field to the correct status instead of "Assigned".
10-StatusChange Receive Message Event No configuration required.
18-Follow-UpChange Receive Message Event If you have changed the list of values available for the Status field on the Cases module, update this Receive Message event's criteria to filter on the correct status instead of "Pending Input".
19-ClientDidNotFollow-Up Wait Event No configuration required.
20-Follow-UpExtension Change Field Action If the follow-up date should be extended for clients by more or less than the default sixteen business hours, update the calculated formula for the Follow Up Date field.
FollowUpWarningV2 Send Message Event If desired, update the wording and details included in the Follow-Up Warning process email template.
22-ClientResponse Event-Based Gateway No configuration required.
23-ChangeOfFollow-Up Receive Message Event If you have changed the list of values available for the Status field on the Cases module, update this Receive Message event's criteria to filter on the correct status instead of "Pending Input".
24-NoResponse Wait Event No configuration required.
25-CloseCase Change Field Action If you have changed the list of values available for the Status field on the Cases module, update the value to which the event changes the Status field to the correct status instead of "Closed".
26-End End Event No configuration required.

*Elements marked with an asterisk in the table are new additions in the V2 version of the SugarBPM template, available in Sugar Serve.

Case Status Update on Inbound Customer Note

"Case Status Update on Inbound Customer Note" is a helper process definition for "Case Follow-Up Date Management". The table below lists each of its elements and which steps may be needed to configure it to work with your instance. Note that some steps may not be required if you have not made certain changes to your instance.

Element Element Type Steps to Configure
CaseStatus1-NewNote Start Event If you have changed the list of values available for the Status field on the Cases module, update this Start event's criteria to filter on the correct status instead of "Pending Input".
CaseStatus2-StatusAssigned Change Field Action If you have changed the list of values available for the Status field on the Cases module, update the value to which the event changes the Status field to the correct status instead of "Assigned".
CaseStatus3-End End Event No configuration required.

Customer Notification of Case Status Change

"Customer Notification of Case Status Change" is a helper process definition for "Case Follow-Up Date Management". The table below lists each of its elements and which steps may be needed to configure it to work with your instance. Note that some steps may not be required if you have not made certain changes to your instance.

Element Element Type Steps to Configure
CustomerNotification1-StatusUpdate Start Event No configuration required.
CustomerNotification2-NotifyContacts Send Message Event If desired, update the wording and details included in the Customer Notification of Case Status Change process email template.
CustomerNotification3-End End Event No configuration required.

Enabling the Process Definitions

New process definitions are set to "Disabled" by default. This is a preventative feature that ensures a process instance is not triggered inadvertently during the design phase. After all three process definitions are fully configured, exit the Visual Designer and set each process definition to "Enabled" via the Process Definitions dashlet or list view. For more information, please refer to the Process Definitions documentation.