Difference between revisions of "Custom Expression Builder"

From Hornbill
Jump to navigation Jump to search
 
(21 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{bluebanner|[[Main Page|Home]] > [[Configuration]] > [[Business Process Designer]] > Custom Expression Builder|[[:Category:Administration|Index]]}}
+
This document can now be found at its new location in the [https://docs.hornbill.com/servicemanager-config/customize/workflows/decision Hornbill Document Library].
{{IntroAndLinks|[[File:bpmdecisionexpression.png|right|300px]]
 
Following a decision node in a business process it is possible to branch on the outcomes of the node preceding the decision node. Default outcomes are presented as options, and these may include:
 
  
* No Match
+
[[file:hornbill-document-library.png|Decision Node and Custom Expressions|link=https://docs.hornbill.com/servicemanager-config/customize/workflows/decision]]
* Expiry
+
<!--
* Task or Authorisation outcomes
 
  
In addition to the default options which you can branch on, you can also build your own custom expressions (rules) and branch on these using the custom expression builder.  To access the Custom Expression Builder, click on the description box for each connector that exits a Decision Node and from the pick list, select Custom Expression.|
+
 
 +
{{breadcrumb|[[Main Page|Home]] > [[Configuration]] > [[Business Process Designer]] > Custom Expression Builder|Administration}}
 +
{{Section|
 +
==Introduction==
 +
[[File:bpmdecisionexpression.png|right|300px]]
 +
A Decision Node within a Workflow allows the workflow to branch down different paths based on the outcomes of previous nodes within the workflow stage. Default outcomes are available to test the outcomes of the node that immediately precedes the decision node. The outcomes available will depend on the node that precedes the decision node and may include:
 +
 
 +
:* Failure
 +
:* Success
 +
:* No Match
 +
:* Expired
 +
:* Task or Authorisation outcomes
 +
 
 +
In addition to these default options, you can also build your own custom expressions using the Custom Expression Builder. Custom Expressions will allow you to evaluate the outcomes of any node that precedes the decision node within the same stage.|
 +
{{rightBox|Related Articles|
 
:* [[Variable Picker]]
 
:* [[Variable Picker]]
 
:* [[Business Process Designer]]
 
:* [[Business Process Designer]]
 
:* [[BPM Authorization]]
 
:* [[BPM Authorization]]
 
}}
 
}}
 
+
}}
==What is the Custom Expression Builder==
+
{{Section|
 +
==What is a Custom Expression==
 
[[File:bpmcustomexpress.png|right|350px]]
 
[[File:bpmcustomexpress.png|right|350px]]
Think of the custom expression builder as a rules engine, what you are defining are rules / conditions, if these rules / conditions are met the expression is met and it's path out of a decision node will be followed. Each path out of a decision node that is added will contain a default condition.  The first path will start with '''No Match''' which is a path that would be followed if none of the other expressions on the other paths don't match.  Each additional path added will have a '''??''' displayed, indicating that the expression needs to be set.
+
A Custom Expression consists of one or more tests that evaluate the outcomes of nodes within the current stage. If the tests within the expression are met, that path out of the decision node will be followed. To add a Custom Expression, click on the description box of a connector that exits a Decision Node and in the ''Goto If'' dialog box, select ''Custom Expression'' from the list of outcomes.
 +
|}}
  
==Building Rules (Expressions)==
+
==Building Expressions==
 
[[File:custom_expression_builder.png|right|500px]]
 
[[File:custom_expression_builder.png|right|500px]]
The custom expression builder provides the ability to create one or multiple rules which can be evaluated when a process reaches the decision node.
+
The custom expression builder allows you to create one or more tests which can be evaluated when a workflow reaches the decision node.
  
===Adding your first Rule===
+
===Adding your first Expression===
  
 
Following a decision node, draw out a line and add a new node.  On the line you have drawn out you will see '''??''' icons.  Click on the icons and a pop up window is presented, this will contain a drop down with default outcomes and an option for '''Custom Expression'''.   
 
Following a decision node, draw out a line and add a new node.  On the line you have drawn out you will see '''??''' icons.  Click on the icons and a pop up window is presented, this will contain a drop down with default outcomes and an option for '''Custom Expression'''.   
Line 56: Line 69:
 
* Use the '''Delete All''' option to delete all the rules (expressions)  
 
* Use the '''Delete All''' option to delete all the rules (expressions)  
  
 
+
-->
[[Category:Administration]] [[Category:Service Manager]]
+
[[Category:HDOC]]

Latest revision as of 23:46, 31 May 2024

This document can now be found at its new location in the Hornbill Document Library.

Decision Node and Custom Expressions