BeanShell Decision

Introduction

The BeanShell Decision runs a Java script after a task completes and uses the result to determine whether the agent continues, jumps to a different task, or stops entirely.

Get started

How to use it

To use the BeanShell Condition Element, follow these steps:

1. Locate the BeanShell Condition element under the Decisions section in the palette.
2. Drag and drop the element into the Drop a decision rule to here section.
   

Configure Form Properties

To properly integrate and configure the Beanshell, set the following fields:

• Personalized Names: Specify a name for the BeanShell condition.
• Purpose: A label describing what this decision does. Not evaluated at runtime.
• Script: The BeanShell script that determines the routing outcome. Required field.

Samples

import org.json.JSONObject;
JSONObject obj = new JSONObject(response.getContent());
String status = obj.optString("status", "unknown");
if ("error".equals(status)) {
    return DecisionResult.abort();
} else if ("pending".equals(status)) {
    return DecisionResult.goToLabel("Escalate to Manager");
}
return DecisionResult.continueExecution();

import org.json.JSONObject;
JSONObject obj = new JSONObject(response.getContent());
double score = obj.optDouble("confidence", 1.0);
if (score < 0.5) {
    return DecisionResult.abort();
}
return DecisionResult.continueExecution();

Best Practices

• Use DecisionResult as an instance, not a class. BeanShell in an OSGi environment cannot dispatch static methods on the class directly. Always call DecisionResult.abort(), DecisionResult.continueExecution(), and the other methods on the injected variable, not on a static reference.
• Script errors halt the decision. A runtime exception in the script is treated as an agent error. Test your script logic thoroughly, especially around JSON parsing, where keys may be absent.
• goTo requires the exact task ID. Task IDs are the internal identifiers set when the task was created, not the display labels. Use goToLabel when the label is more stable, or check the agent definition for the correct ID.
• goToLabel is case-insensitive but literal. Spaces and punctuation in the label must match exactly.
• Pair with a BeanShell Enhancer to prepare the response. If the response needs parsing or transformation before routing, run an enhancer first on the same task. The decision runs after all enhancers have completed.