Skip to main content
Kinetic Community

Testing & Troubleshooting

Using Consoles for Testing and Troubleshooting tasks

Management Console

Navigate to this console by clicking on the Kinetic Task Manager link found on the left side of the Service Catalog Console.  It may be convenient to bookmark this in your web browser page for even quicker access.  You will notice there are three consoles available.  In this chapter we will focus on the Task Management panel.

Task Management Executions.jpg

The Task Management console provides two views

  • Exceptions - List of Task Engine exceptions
    • Allows you to review the error message
    • Allows you to resend the trigger (after repairing the issue that caused the failure)
  • Executions - Ability to see all items related to a submission
    • Helpful for testing (review data outcomes)

Task Engine Processing Information by Form

  • Triggers will start out in a “New” status.  When the Task Engine picks up the trigger, it sets the status to “Work In Progress”.
  • The Task Engine will process the nodes on the Task Tree up to the point where it comes across a deferred node or the tree ends.
  • One Trigger can process one or many Nodes. 
  • If the Task Engine encounters an error, it will create a new Trigger with a “Failed” status.
  • If errors are encountered on one branch, the Task Engine will continue processing other branches.
  • When the Task Engine completes processing, it will set the Trigger status to “Closed”.

​KS_TSK_Instance

  • Task Engine processing will create an entry in this form for each Task Tree Node processed.
  • For deferred Nodes, the status will be set to “Work In Progress”.  For regular nodes the status will be “Closed”.
  • The task_return_variables field contains information returned by the Task Handler.
  • The task_deferred_variables field contains information from the completion Trigger.  For example when an approval is submitted, the approval or rejection choice is placed here.  

​Basic Troubleshooting

My triggers are stuck in New status

  • Open the Kinetic Task Manager Console and check on the status of the Task Engine.  Ensure that it is running. 
  • You will be able to Start/Stop the Engine from this console.
  • Download and look at the Task Engine logs.  Check for errors.

​I have a failed trigger, now what?

  • Open the Task Manager Console and review the Exceptions panel.  Or search for the outcome of a particular submission using the customer survey instance id
  • Errors can be due to the following:
    • Syntax errors on a Connector (make sure you used valid ERB syntax see chapter 6)
    • Syntax errors on Node configuration
    • Syntax errors or invalid fields in the Node mapping (the node.xml file)
    • Code errors occurring in the Task Handler.
  • After you locate and correct the error, the tasking process can be restarted on the Task Manager Console.