Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Debugging When rules with the Tracer tool

Updated on May 31, 2022

If your When rule returns unexpected results, and you cannot determine the problem by running the rule and examining the clipboard pages, run the Tracer tool. Using Tracer, you can watch each step in the evaluation of a When rule, and as a result, you can find and then fix issues in your application faster.

For example, you can use Tracer if a When rule returns false but you expect the rule to return true.
  1. In the footer of Dev Studio, click Tracer.
  2. In the header of the Tracer window, click Settings.
  3. In the Events to trace section, select When rules:
    • To trace events when the rule starts running, select the checkbox in the Start column.
    • To trace events when the rule ends running, select the checkbox in the End column.
    You can select both Start and End checkboxes.
  4. In the Rulesets to trace section, select the ruleset that contains the rule that you want to trace.
  5. Optional: To avoid memory use from tracing events that occur in other rulesets, clear the checkboxes for other rulesets.
  6. Click OK.
  7. Return to Dev Studio, and then run the When rule.
    Note: Keep the Tracer window open by minimizing the window.
  8. In the Tracer window, watch the Tracer output as the rule runs.
  9. Optional: To obtain more information, click a row in the Tracer output.
  10. Analyze values and information present while the When rule runs, and then adjust relevant elements of your application.
    For more information, see Defining conditions for a When rule.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us