Create a Workflow
Discover how to navigate workflow features, understand its components, and follow a step-by-step guide to create a simple workflow rule.
Last updated
Discover how to navigate workflow features, understand its components, and follow a step-by-step guide to create a simple workflow rule.
Last updated
In this detailed end-to-end tutorial, weβll guide you through creating a simple workflow that processes order details to calculate the total price. This workflow integrates two decision tables: one that evaluates product details based on product IDs and branch, and another that applies customer discounts based on their loyalty class and credit status.
Both of those Decision Tables can be created as samples right in DecisionRules app
We'll cover navigating through the creation process, configuring workflow nodes, and generating the final output, which includes missing items, the total price payable, and a personalized message for the customer. At the end weβll test our new rule with several inputs to ensure it works as expected. This tutorial will help you understand key workflow components and data manipulation techniques.
Only a few node types are used in this tutorial. For a complete list of available workflow nodes, please refer to our dedicated .
Our input model captures key details of an order, including items, branch information, and customer details such as loyalty class and credit balance.
The output model includes calculated values like initialTotal
and totalPayable
, along with any missing items and a personalized message for the customer.
When designing the workflow as a decision process, establishing a logical flow ensures efficient processing of order details.
Initial Price Calculation: Start by calculating the initial price of the customerβs order as a baseline for any potential discounts. This requires evaluating the price catalog decision table first. At this stage, weβll also collect availability information for each item in the order to use later in the order message.
Discount Application: With the initial price determined, check if the customer qualifies for a discount by evaluating the loyalty discount decision table. Based on this, calculate the final price, either discounted or not.
Generating the Final Order: Use the values from the previous steps to populate the output properties specified in the output model. Additionally, if there are unavailable items, modify the order message accordingly.
Now that weβve outlined each step in the evaluation, itβs time to build our rule. In this section, weβll configure the IO model, add and connect nodes to create the workflow flow.
Create a new blank workflow. In the Settings tab set up the input and output models as described above. Once set, properties of the model can be easily used in the workflow.
Now it's time for adding first nodes to the canvas. Start by adding a Declare node to define initialTotal
. In this variable we will store the price of the order before potential discount. Simple drag and drop the node from the Palette tab on the right. When the node is on the canvas click the node open and set the variable. Save the modal and connect the Start node to it.
The next step is to add the first Business Rule node to evaluate the order's total price. Since orders often contain multiple items, we need to calculate the sum of each itemβs price to get the overall total. We will use the Foreach node to repeat this evaluation, eliminating the need to manually add multiple Business Rule nodes to the canvas.
Drag and drop the Foreach node onto the canvas, then click on it to open its configuration modal. In the modal, specify the list of order items that the node will process. You can do this by either manually entering the input property or by dragging it from the Data Dictionary tab.
Note that Data Dictionary tab and input whisperer store all already declared variables for easy access
Once the node is saved connect the node to Declare node. Now comes the part when we create a set of actions that will be performed for each item in the order. As mentioned we need to evaluate the Product Catalogue decision table to know and add the item price to total. In addition if the item is not available add it to the list of unavailable items.
Those mentioned actions, represented by individual nodes, must be connected to the "Loop" connector of the Foreach node. So all nodes that you connect in this way will be evaluated in each iteration of the Foreach node.
At the end of this part you will find picture to better understand the structure.
First place the Business Rule node on the canvas and open it. In the Business rule field select Product Catalogue Sample table, its input model shows. Now to the mapping to the business rule: for the productId we will use the item that will be provided be Foreach node as only price for one item will be evaluated at a time, branch - we want the property be passed right from the main workflow input.
When the Business Rule node retrieves the item price from the product catalog, we want to incrementally add this price in each iteration of the For Each loop. To set this up, add an Assign node to the canvas and open its configuration modal. In the Source field, create a formula that continuously updates the total by adding each item's price to the previous total. This formula will overwrite the initial price, increasing it as each itemβs price is processed. Then save the modal and connect new node to Business Rule node.
To collect the productId
of each unavailable product, start by adding a Switch node and an Append node. The Switch node will check each itemβs availability, and if the item is unavailable, the Append node will add its productId
to an array named items_unavailable
. This array will then be used in the order message to notify the customer about any items that are out of stock.
See that items_unavailable
array can be created in the Append node
Weβve now completed the first phase by calculating the initial order price (see the reference image below). With this foundation set, weβll move forward to evaluate whether the customer qualifies for a discount. This next step will involve applying the Loyalty Discount rule, factoring in customer-specific details such as loyalty class and credit, to determine the final payable amount. The next node will be added after the Foreach node, it will be connected to its "After Loop" connector, so we will continue in our process.
After calculating the initial order price, weβll use it as the baseline for applying the loyalty discount, taking into account the customer's credit to calculate the discounted total.
Add another Business Rule node to the canvas and select the Loyalty Discount decision table. Map the initialTotal
to the basicPrice
input field.
When mapping the customer's loyalty information, you have two options:
Map the entire customer object: Use this if you want to pass all customer properties without making any alterations.
or
Map properties individually: This is ideal if customer details are sourced from multiple variables, allowing you to map each property directly.
Both options work interchangeably, but note that they are mutually exclusive, as selecting one disables the other.
Now that we have gathered all the necessary values, we can create the final order, which will include the total payable price, any missing items, and a personalized message. To map these values for display in the workflow output, we'll utilize an Assign node. In the modal we will map all the information to output properties.
To personalize the message shown to the customer, we will use a Switch node that checks for any items in the array created by the Append node.
If any items are out of stock, their identifiers will be stored in this array. The Switch node will direct the flow of the process based on the content of the array. We will then use the contents of the array to craft a message for the customer, informing them about the unavailable items using Assign node to create tailored messages.
If all the items are available we can use message:
If any of the ordered items is missing, we can use the CONCAT function to generate a parameterized message that informs the customer specifically about the unavailable items:
To get a complete view of how data appears at the end of the workflow, add End nodes right after the Assign nodes. When you run the workflow, youβll see the final data in each Endβs Inspect tab, showing the actual results once the rule has fully executed. This provides a clear, final snapshot of all processed data.
Congratulations! π You've completed the workflow, which might look something like this:
In the next section, weβll test the workflow with some inputs to ensure itβs functioning correctly. Before proceeding, please double-check that all workflow nodes are fully configured and properly connected.
Testing your workflow with sample inputs is an essential step to confirm it works as expected. We will start with main cases that cover scenarios, such as orders with available items, orders with missing items, and orders eligible for discounts.
Run the workflow with these inputs and use the Inspect tab in the End nodes or Workflow Testbench to review the results. This allows you to verify that each node is executing correctly and that data flows through the workflow as intended.
In this tutorial, we built a workflow to process an order by calculating the initial price, checking for discounts, and identifying any out-of-stock items. We configured nodes to perform actions such as summing item prices, applying loyalty discounts, and generating a personalized message. Each node was mapped to the output model, giving us a complete order summary. Finally, we ran tests with sample inputs to validate the workflow, ensuring that each component works as intended and provides accurate, actionable output for the customer.
To wrap up, letβs go over a few best practices to enhance your workflowβs effectiveness and maintainability. These tips can help ensure smooth operation, improve readability, and make troubleshooting easier down the line:
rename nodes added to the canvas to better fit your process and increase the readability
test your workflow during the process of creation to discover potentials errors as soon as possible
use Sticky Notes to document the process for better understanding
See the workflow below that you can easily import into your environment. This completed workflow demonstrates all the processes weβve covered, providing a clear example of how to configure and connect everything for effective order processing.
Clicking the file below opens the file content in current tab. Once opened, right click and choose "Save as" option to save the content as json file. Then you can use such file for folder import.
Using the Foreach node, you can define a data set and specify the processing logic to apply to each element. This allows efficient way to manage complex, repetitive tasks across datasets. More details can be found in our .
To generate a simple order ID, we can utilize the , which combines today's date with the user's ID. This method ensures that each order ID is unique and easily traceable back to the specific user and the date of the order.
More about functions, their types and syntax can be found in .
Learn more about Workflow evaluation process .