Skip to main content

Challenge

Debugging application errors

4 Tasks

20 mins

Visible to all users
Beginner Pega Platform 8.4 Low-Code App Development English

Scenario

As part of processing an assistance request case, the Roadside Assistance application copies the services performed from the child Services case to the Assistance Request case. While testing the configuration of this feature, you notice that Assistance Request cases include service items not indicated on the child case, as shown in the following screenshot. Use the Tracer tool to debug the issue and resolve it. 

Side-by-side of Assistance Request case and Service case showing different selected services

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

Role User name Password
Application Developer author@gogoroad 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 Configure Tracer settings

  1. In the footer of Dev Studio, in the Developer Toolbar, click the Tracer icon to display the Tracer window.
    Tracer icon in the developer toolbar
  2. In the Tracer window, in the toolbar, click Settings to check the Tracer tool settings. The Tracer Settings window is displayed.
    Settings button in the Tracer toolbar
  3. In the Tracer Settings window, verify that the following events to trace and break conditions are selected.
    Tracer Events to Trace and Break Conditions section
  4. In the Rulesets to Trace section, click Deselect All.
  5. Select the GoGoRoad check box to trace rules in the GoGoRoad ruleset.
    Tracer Rulesets to Trace section
  6. Click OK to dismiss the Tracer Settings window.

2 Start the Tracer tool and identify candidate events

  1. In the Tracer window, in the toolbar, click Clear to clear any previous logs.
    Clear button on the Tracer toolbar
  2. Click Pause to pause the Tracer tool. To reduce the number of irrelevant events the Tracer records, play the Tracer before you encounter the error.
  3. Minimize the Tracer window.
  4. Create a new Assistance Request case.
  5. Advance the case to the Select services view.
  6. Open the Tracer window, and then click Play to start the Tracer tool.
  7. Minimize the Tracer window.
  8. In the Unlock and Replacement key rows, in the Quantity fields, enter a value of 1.
    Selected services view
  9. Click Submit. The Review service summary view is displayed.
  10. Open the Tracer window, and then click Pause to pause the Tracer tool. In the Tracer results, the following events set the values of SelectedServices(1) and SelectedServices(2)
    Tracer results
    Note: Your line numbers may differ.
     
  11. In the Tracer results, click a line of interest in the STEP METHOD column to view more details. The Properties on Page TraceEvent window is displayed. The Event Key row shows the class and rule name, which is TESTVALUESFORINVOICING
    Properties on Page TraceEvent window for event 36
  12. Close the Properties on Page TraceEvent window.
  13. Close the Tracer window.

3 Locate and correct the source of the error

  1. In the header of Dev Studio, in the search bar, enter TestValuesforInvoicing, and then press the Enter key. The search results are displayed.
    Search results for testvaluesforinvoicing
    Note: If the system fails to return a search result, use either the App Explorer to locate the rule in the AssistanceRequest class, or the Records Explorer to locate the rule in the Data Transform rule category.
  2. Click the TestValuesForInvoicing data transform. The Test values for Invoicing data transform has hard-coded values for the first two Selected Services line items. The data transform was included for testing purposes and should be removed. 
    Test values for invoicing data transform
  3. Click Actions > View references to see where the rule is referenced. In the pane on the right, in the Referencing rules tab, the InvoiceCustomer flow is displayed.
    Data transform testvaluesforinvoicing referencing rules
  4. Hover over GoGo-GoGoRoad-Work-AssistanceRequest-InvoiceCustomer, and then click the Edit icon to open the flow rule
  5. Between the start shape and the Review service summary assignment, right-click the connector, and then click View properties.
    View properties in the first connector of the Invoice Customer flow rule
  6. In the Connector properties window, in the Set properties section, verify that the TestValueForInvoicing data transform is executed from this connector.
    Connector properties with test values for invoicing data transform applied
  7. Clear the Data transform field, and then click Submit to dismiss the window.
  8. Click Save to save the flow rule.

4 Confirm your work

  1. Create a new Assistance Request case.
  2. Advance the case to the Select services view.
  3. In the Unlock and Replacement key rows, in the Quantity fields, enter a value of 1.
  4. Click Submit. The Review service summary view is displayed.
  5. Verify that the correct services are displayed.
    Review service summary displays the correct values


Available in the following missions:

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

Did you find this content helpful?

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