Debugging the rule engine workflow

Use the following steps to locate errors in the rule engine workflow.

Before you begin

Before you follow these steps to debug the Rule Engine Workflow, verify that the Asset Analytic Process and the rules configuration are correct, which means that the correct fact data is retrieved and the correct Rule Engine Workflow is run, but the analytic event is not generated as expected.

About this task

Although workflow recording is automatically created when there is an error in the workflow, you can also choose to activate workflow debug mode and trace the execution path of the workflow.

To simplify debugging a workflow, narrow down the retrieved records to retrieve one device or asset.

For more information, Application building for IBM Maximo Real Estate and Facilities.

Tip: Because workflow debug uses a lot of memory, disable workflow debugging as soon as possible.

Procedure

  1. Activate workflow debug.
    1. Log in to the Maximo Real Estate and Facilities Admin Console.
    2. In the Managed Object, select Workflow Agent Manager.
    3. In the Workflow Instance Recording, select Always and click Save.
      Now, a Workflow Instance record is created when workflows are run.
  2. Run the Asset Analytic Process and then click the Workflow Instance tab to view the recording and find the part of the workflow that is not running as expected.
    1. Track the execution path of the workflow.
    2. Check whether the workflow Pre conditions are as designed.
    3. Check whether the Retrieve Rule Parameters tasks are accurate.
    4. Check whether the rule conditions are as designed.
  3. To view a list of the Engine Workflow Instance records that are created when the engine workflow of a rule is called dynamically, click Tools > Builder Tools > Workflow Builder and then expand triAnalyticRule and click triAssetRule. Select the radio button for the workflow you want to check and click List All Instances and click an instance to open.