Skip to main content
Kinetic Community

4. Tracking Runs and Errors

Runs and Errors are part of any Development Process. We'll create some errors on the Onboarding template and dig into troubleshooting.

Run

There are four different elements that makeup a run, Triggers, Tasks, Errors, and Inputs.

When you first look at a Run, you get the Timeline view which is all elements in the order they were processed and the inputs. You can select the different elements to refine the view.

Example of an Onboarding template Run.

run example.png

Inputs are static once the run has started. They normally take the form of a json string or XML document. Here is a sample of the input for a Request CE submission:

"submission": {
    "anonymous": false,
    "closedAt": null,
    "closedBy": null,
    "coreState": "Submitted",
    "createdAt": "2018-04-05T15:45:50.093Z",
    "createdBy": "derick.larson@kineticdata.com",
    "currentPage": "Confirmation",
    "handle": "68E326",
    "id": "6a3fbc99-38e8-11e8-8569-4d124a68e326"
  },
  "values": {
    "Me or Someone Else": "Me",
    "Requested for User ID": null,
    "Requested For Name": null,
    "Requested For Email": null,
    "First Name": "Han",
    "Last Name": "Solo"

},

The source for the tree determines the input.

A trigger record tells the task engine that it needs to process the node (and following connectors). The most common trigger is for a Start node. Besides start nodes, triggers are used to complete a deferred node, fire Wait tasks, and during loop processing.

A task record is created for each node. It will show any outputs like deferred tokens, or compiled outputs. Depending on the type of task you can inspect the results or outputs. Here is the result of an Hardware Create task.

hardware order.png

In this case we get the Submission ID back as a result.

Error

Errors are listed with newest first, but the best way to see related errors is from the error on the Run which has a link.

Example of a simple Run with an Error.

run list with error.png

In the Error there is basic information, and a link to the specific error.

task error.png

Clicking on the link to the error takes you to the actual error.

error details.png

In this case a results field is not present in the tree. After you fix this error you can return to this dialog and the Additional Action drop-down lets you Retry the error. You must enter notes about the fix, and then click the resolve error button.

The most important part of this dialog is the details panel. it provides as much information as possible to help you troubleshoot the error.