Exceptions are types of errors meant to help you debug a failure in the execution of a process.

Exceptions can be accessed from multiple places:

  • Failed process start tab from Active process menu in FlowX.AI Designer.
  • Process Status view, accessible from Process instances list in FlowX.AI Designer.

Exceptions data

When you click view button, a detailed exception will be displayed.

  • Process Definition: The process where the exception was thrown.
  • Source: The source of the exception (see the possible type of sources below).
  • Message: A hint type of message to help you understand what’s wrong with your process.
  • Type: Exception type.
  • Cause Type: Cause type (or the name of the node if it is the case).
  • Process Instance UUID: Process instance unique identifier (UUID).
  • Token UUID: The token unique identifier.
  • Timestamp: The default format is - yyyy-MM-dd'T'HH:mm:ss.SSSZ.
  • Details: Stack trace (a stack trace is a list of the method calls that the process was in the middle of when an Exception was thrown).

Possible sources

Exceptions type

Based on the exception type, there are multiple causes that could make a process fail. Here are some examples:

TypeCause
Business Rule EvaluationWhen executing action rules fails for any reason.
Condition EvaluationWhen executing action conditions.
Engine

When the connection with the database fails

when the connection with Redis fails

DefinitionMisconfigurations: process def name, subprocess parent process id value, start node condition missing.
NodeWhen an outgoing node can’t be found (missing sequence etc).
Gateway Evaluation

When the token can’t pass a gateway for any reason, possible causes:

  • Missing sequence/node
  • Failed node rule
SubprocessExceptions will be saved for them just like for any other process, parent process ID will also be saved (we can use this to link them when displaying exceptions).