Skip to main content

Challenge

Designing a case life cycle

Scenario

The mayor of MyTown wants to increase resident engagement and improve the town’s responsiveness to issues raised by residents.

To achieve this goal, the services coordinator wants residents to submit service requests that available city services can resolve. To begin the process, the mayor and the services coordinator have outlined a workflow for submitting, reviewing, and resolving service requests and want to design a case type to manage such requests.

In MLP1, residents create service requests from the user portal, service coordinators review the requests from the user portal, and department managers and service coordinators resolve the requests from the user portal. In MLP2, residents, services coordinators, and department managers have the option to interact with service request cases from the mobile channel.

The following table provides the credentials you need to complete the challenge.

Role User name Password
Application Developer author@mytown pega123!

Challenge Walkthrough

You must initiate your own Pega instance to complete this Challenge.

Initialization may take up to 5 minutes so please be patient.

Detailed Tasks

1 Create a Service Request case type

  1. In the Welcome to your new application window, click Create case type to display the Create case type dialog box.
    Welcome to your new application window
  2. In the Create case type dialog box, in the Case type name field, enter Service Request
  3. Click Next.
    Create case type modal dialog
  4. On the Workflow tab, in the upper-right, click the configuration issues icon to display the Draft process warnings dialog box.
    Configuration issue icon
    Note: The dialog displays a warning for each step with an incomplete configuration in the workflow. The number of warnings varies as you configure the case life cycle.
  5. Click Close to return to the case life cycle.
  6. Under Case life cycle, click the View: Steps, Personas, Data, Releases menu to display a list of check box items.
    Steps, Personas, Data, Releases list on the case life cycle
    Note: As a best practice, first define the case life cycle at a high level to help you determine the personas, channels, and data objects. Hide Personas and Data for now.
  7. Clear the Personas check box to hide the Personas & Channels section in the case life cycle.
  8. Clear the Data check box to hide the Data & Interfaces section in the case life cycle and automatically clear the Releases check box.
  9. Click outside the menu to hide the View: Steps, Personas, Data, Releases menu.

2 Add the Review and Resolution stages

  1. To the right of the Create stage, click Stage to add a second stage.
    Add a stage to the case life cycle
  2. In the text box that is displayed, enter Review to add the second stage name and display the contextual property pane on the right.
  3. In the General tab of the contextual property pane, select Automatically move to next stage to enable the case to advance automatically when the Review stage is complete.
    Stage transitions
  4. To the right of the Review stage, click Stage to add a third stage.
  5. In the text box that is displayed, enter Resolution to add the third stage name and display the contextual property pane on the right.
  6. In the General tab of the contextual property pane, select Resolve the case to resolve the case automatically when the Resolution stage is complete.

3 Build the Create stage

  1. On the Workflow tab, in the Create stage, in the Create process, click Create to rename the first step of the Create process. 
    Rename the first step of the Create process
  2. In the field that is displayed, enter Report problem.
  3. Click Form Step to add a step to the multi-step form.
  4. In the field that is displayed, enter Identify location.
  5. Click Form Step to add a step to the multi-step form.
  6. In the field that is displayed, enter Request updates.
  7. Click the Create process to display the contextual property pane on the right.
  8. In the contextual property pane, under Horizontal navigation, click Change to select the navigation template.
    Change the navigation template on a multi-step form
  9. In the Select a template window, click Vertical navigation to display the navigation menu vertically.

4 Build the Review stage

  1. Under the Review stage, hover over Process, and then click Step to choose a step type.
  2. Click Collect information to add a step that collects user input.
  3. In the Collect information field, enter Schedule repair to name the step.
  4. Click the Review process and enter Review submission to replace the process label.
    Note: When a new process is created, Pega Platform™ automatically assigns the process name based on the stage name. You can change the default process name after creating the first step in that process.
    Rename the review submission process

5 Build the Resolution stage

  1. In the Resolution stage, hover over Process, and then click Step to choose a step type.
  2. Click Collect information to add a step that collects user input.
  3. In the Collect information field, enter Perform repair to name the step.
  4. Click the Resolution process and enter Resolve issue to replace the process label.
  5. Click Step > Approve/Reject to add a decisioning task to display an Approve/Reject step under Perform repair and add an alternate stage to the case life cycle.
    Add an Approve/Reject step
  6. In the Approve/Reject field, enter Review repair to name the step.
  7. Click Step to add the third step to the Resolution stage.
  8. Click More to display three step type categories: Processes, User actions, and Automations.
  9. Click Automations to display steps that are automatically performed or processed by the system.
    Add an automation step
  10. Click Send email > Select to add a step that automatically sends preconfigured emails.
    Add Send email automation
  11. In the Send email field, enter Send repair confirmation to name the step.
  12. In the upper right, click Save. The Service Request case life cycle is displayed with the stages and steps created.
    Service Request case life cycle
Note: The number of warnings increases to 6 due to incomplete configuration of the Collect information steps and Send email step. Disregard the warnings, as these issues are addressed in subsequent challenges.

6 Identify the personas and channels for MLP 1

  1. In the upper-left corner of the case life cycle, click the View: Steps menu to display a list of check box items.
  2. Select the Personas and Releases check boxes to display the Personas & Channels section in the case life cycle.
  3. In the Personas & Channels section, in the Create stage, click Persona > New persona to display the New persona dialog box.
    Add a new persona from the case life cycle
  4. In the Persona name field, enter Resident.
  5. Click Submit to dismiss the New persona dialog box and display the Resident persona and User Portal channel, which is added by default.
  6. Click the User Portal channel to display the configuration pane on the right.
  7. In the configuration pane, to the right of Additional details, click Configure release to display the Edit details window.
    Configure the release for the user portal from the case life cycle
  8. In the Release list, select MLP 1, and then click OK to dismiss the Edit details window. The MLP 1 tag is displayed on the User Portal channel in the Case Designer.
    Edit details dialog with the Release MLP 1 selected
  9. Repeat steps 3-8 to add a new persona named Services coordinator to the Review stage and tag the User Portal with MLP 1.
  10. In the Resolution stage, click Persona > Manager to add the Manager persona.
  11. Repeat steps 6-8 to tag the Manager User Portal channel with MLP 1.
  12. In the Resolution stage, click Persona > Services coordinator to add the Services coordinator persona.
  13. Repeat steps 6-8 to tag the Services coordinator User Portal channel with MLP 1.
    Personas for MLP1 added

7 Identify the personas and channels for MLP 2

  1. In the Create stage, in the Resident persona, click Channel > Mobile to add the mobile channel to the Resident persona.
  2. With the User Mobile App channel selected, in the configuration pane, to the right of Additional details, click Configure release to display the Edit details window.
  3. In the Release list, select MLP 2, and then click OK to dismiss the Edit details window.
  4. Repeat steps 1-3 to add and tag the mobile channel for each persona with MLP 2.
    Personas and channels for MLP 2 added to the case life cycle

8 Identify the data objects for MLP 1

  1. In the upper-left corner of the case life cycle, click the View: Steps, Personas, Releases menu to display a list of check box items.
  2. In the list, select the Data check box to display the Data & Interfaces section in the case life cycle.
  3. In the Data & Interfaces section, in the Create stage, click Data > Data object > New data object to display the New data object dialog box.
    Add a new data object to the case life cycle
  4. In the Name field, enter Request type.
  5. Click Submit to dismiss the New data object dialog box and display the Request type data object and Pega system of record, which is added by default.
  6. Click Pega to display the configuration pane on the right.
  7. In the configuration pane, to the right of Additional details, click Configure release to display the Edit details window.
    Configuration pane for the Pega SOR with Configure release icon highlighted
  8. In the Release list, select MLP 1, and then click OK to dismiss the Edit details window.
  9. Repeat steps 3-8 to add the Submitter information and Previous issues at this location data objects to the Create stage with the MLP 1 tag.
    Data objects added to the Create stage with MLP 1 tagged

9 Confirm your work (section not graded)

  1. On the Workflow tab, in the upper right, click Save and run to save changes and create a new Service Request case type instance.
  2. In the Report problem view, click Advance this case to proceed to the next view. 
    Note: Views in the Create process are displayed as a modal.
    Report problem view
    Note: App Studio prompts you to configure views for each step in the case life cycle because you have not yet configured views. Disregard the message.
  3. On the Identify location step, click Advance this case.
  4. On the Request updates step, click Advance this case.
  5. In the To do section of the case, to the right of Schedule repair, click Go to display the Schedule repair view.
    Service request case instance with To do section of the case
  6. On the Schedule repair view, click No, advance the case.
  7. On the Perform repair view, click No, advance the case.
  8. On the Approval step, click Approve to complete the case.
    Approval step at runtime


Available in the following mission:

If you are having problems with your training, please review the Pega Academy Support FAQs.

Did you find this content helpful?

53% found this content useful

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice