In this article, we will help you to understand how to design the layout of the Business Rules Listing page.
|
Skip Ahead to: Business Rule with Single Condition and Action Business Rule with Multiple Conditions or Actions Executing a Business Rule Repeatedly (Recurring Business Rules) |
Business Rule with Single Condition and Action
Consider a scenario where a parent card (Epic) is blocked with a condition set on its Size attribute as XL, then all its child cards (user stories, technical stories, and so on) should be blocked automatically.
This process can be automated easily! Here, blocking the parent card (epic) having the Size attribute set as XL is the condition.
When this condition is fulfilled, a Business Rule (let’s say – Block Child Cards upon Blocking of Parent Card) will be triggered and as a result, all the cards tagged to that epic will be blocked automatically. Here, blocking the child cards is the event.
Please note that you can easily create new Business Rules by copying an existing one using the ‘Copy’ feature located in the ‘Action’ column on the Business Rules listing page. This feature saves you time and effort by allowing you to quickly duplicate a rule with similar criteria or actions and make any necessary adjustments.
Steps to Build Business Rule
- Click the Add button to create a new Business Rule.
- The page is divided into two sections. The left section shows a step-by-step visualization of the Business Rule that you are building by adding the details on the right section of the page. Note: You can expand any of these sections by clicking the small arrow placed in between both these sections as highlighted above.
- Add Name and Description to the Rule that would help you to refer whenever a rule gets executed and click Next.
The steps section expands, which includes the 3 stages of your rules as shown below.
- In the first stage, you have the option to select the trigger.
- For the first scenario, as we want the Business rule to trigger when the card is blocked, select Card is blocked trigger.
- Select the Epic card type, and click Next.
- Now, add the conditions in the second stage of the rule.
- Select the Data Condition that expands the right section as shown below.
- For our scenario, select the Size attribute which “is” set as “XL” and click Next. Note: The “{” open bracket, “}” close bracket, “OR”, “AND” operators, available on the screen are explained in the second scenario, where we are adding multiple conditions. For the current scenario, these options are not required.
- Now, you need to set the action that needs to be performed once the trigger and condition are full-filled.
- Select the Action on the right section that expands the right section as shown below.
- For our scenario, we want to have the “Child Card” context to set the action as “Block Card” add “Insufficient Information” as the Blocking Reason, and click Save or Next to set the frequency. In this scenario, we are not setting a recurring trigger.
- In case, if you want to make any changes to the configuration in Triggers or any other step, you can click on the visual map or the steps in the left part of the Business Rules screen, which will navigate you to the specific configuration that you select.
- Lastly, if you want to set the frequency, select the frequency stage.
- In our scenario, we are not selecting the next step of frequency and so the frequency will be kept Off for this Business Rule. Finally, click Save and navigate back to the Business Rules listing page.
- The newly created Business Rule gets listed on the listing page. By default, the rule is enabled. If you want to edit or make any changes to the rule, click the Edit icon. Also, the frequency is kept Off.
Next, let’s check the Execution part of the above rule on the Execution board of your project.
- Consider we have an Epic card EPC236 having two user stories linked to UST1419 and UST1420.
- The Epic card has the Size attribute set to “XL”.
- Now, once you block this epic card, you will be able to see the linked child cards UST1419 and UST1420 get blocked.
NOTE: To unblock all child cards at one go, you can create a new rule and perform similar actions as explained above. Use the Card is unblocked trigger, and select the same card type EPIC, having the same condition, which is the Size attribute set as XL. In this case, the action will be to unblock all the child cards.
Business Rule with Multiple Conditions or Actions
A Business Rule can have multiple conditions or actions in it. To understand the configuration of a multi-condition / multi-action rule, let’s consider another scenario.
For example, if the Module of a defect is ECR Framework and the priority is critical, then the card should be assigned to a specific team member (having expertise in that field) and also should be moved to a specific column in the Execution Board.
So for this Business Rule, we have multiple conditions and actions as shown below.
Conditions
When Module = Product Details and Priority = Critical OR Priority = High
Actions
Set Card Owner = Khushboo, Team = Magic Squad, lane = Expedite, and Column = Ready
Steps to Build this Business Rule
- In the Business Rules screen, click the Add button to create a new Business Rule.
- Under the Rule Details, enter the Name and Description for the Rule.
Note: The name of the Rule should define the condition and the action of the rule so that by seeing the Rule in the Activity log, Comments section, or notification for a workitem, you will understand the possible changes in the workitems. - Click Next and click Event triggers to select the trigger for your Rule. For our scenario we want the card to be updated so the trigger would be the Update Card.
- Select the Defect Card Type on which the condition will be checked and fulfilled.
- Click Next and click Data Condition to define the condition for the Business Rule.
- The Data Condition expands towards the right side and covers the full screen.
- Since we have two combinations of conditions with AND and OR operators, we will use curly brackets ({) to define the conditions as shown below –
- Select ‘{{‘ from the first drop-down list, Attribute as ‘Module’, Condition as ‘is’, Module Name as ‘Product Details’.
- Select ‘}’ in front of the drop-down list
- Click the Add icon and select the And operator from the drop-down list before the Add icon.
- Select ‘{’ in front of the drop-down list.
- Select Attribute as ‘Priority’, Condition as ‘is’, and Priority as ‘Critical’. Select the ‘}’ from the drop-down since the first condition is completed.
- Click the Add icon and select the Or operator from the drop-down list before the Add icon to add the second condition.
- Select Attribute as ‘Priority’, Condition as ‘is’, and Priority as ‘High’.
- Since our condition is completed, select the ‘}}’ from the drop-down to close the second condition as well as the entire condition.
Note: You can add or delete any condition by clicking the Add or Delete icon at the end of every condition row. If you add a new row, you have to define the And/Or operator for the new condition.
- Click Next and click Actions to define the actions for our Rule as shown below.
- Select Context as ‘Current Card’, Action as ‘Update Card’, Card Type as ‘Defect’, Attribute as ‘Card Owner’, and Card Owner Name as ‘Khushbu Kadam’.
- Since the context, action, and card type for our action will be the same, you can click the Copy Action icon on the right side to copy these three values in the new row.
- In the next row/action, select Attribute as ‘Team’ and Team Name as ‘Magic Squad’ and click the Copy Action icon to add a new row.
- In the next row, select Attribute as ‘Lane: Column’ and Lane: Column value as ‘Enhancement: Ready’.
- Since we don’t want this Business Rule to be run after a specific period of time with Frequency, click Save to save this Business Rule.
- The Business Rule is created successfully and you can see the visualization of the rule on the right side to see the holistic flow of the rule as shown below.
- Once the Rule is saved, it becomes enabled by default and will be triggered if the condition is met. You can disable this rule by clicking the Enable/Disable toggle on the Business Rules screen.
Note: The rule will be saved and work only if all three sections – Event trigger, Data Condition, and Action are defined and saved in one flow. If any one of them is not available or saved, the rule will not work.
Executing a Business Rule Repeatedly (Recurring Business Rules)
In Nimble, you can execute a Business Rule repeatedly and frequently on a fixed date or day of a week/month/year without meeting any conditions. This will help you perform repetitive tasks automatically like the generation of a Weekly Status Report on a particular day, updating some information on cards every month or quarter, etc.
To define a recurring rule, you need to specify the time period for the rule to be executed as mentioned in the steps below. For creating a recurring card, you need to define the frequency.
Steps to define a recurring rule:
- In the Business Rules screen, click the Add button to create a new Business Rule.
- Under the Rule Details, enter the Name and Description for the Business Rule.
- Click Next and click Event triggers to select the Create a recurring card trigger.
- Select the Card Type on which the rule will be triggered.
- Click Next and click Data Condition to define the condition for the Business Rule.
- The Data Condition expands towards the right side and covers the full screen.
- In the Data Condition, either select the existing card by entering the 3 letters of that card or create a new card by selecting the Create a new recurring card option from the drop-down.
- With this, a new card will be created with the name you have given here after the defined time like 3 days, 1 week, etc.
- Click Next to select the action to be performed on the selected card type when the rule is triggered.
- If you have selected an existing card, then it will by default show the mandatory attributes (Name, Card Owner, Board Lane: Board Column) of that card and its values. It means when the rule will be triggered, a new card will be created with the given name and attributes set in the Action.
Note: If Name, Card Owner, Board Lane: Board Column are selected as mandatory attributes on a card then these attributes will be pre-populated in the Action screen. - If you have selected the Create a new recurring card option in the Data Condition screen, then you can select the new attributes and values for the card that will be created on the set date/day (when the rule will be triggered.)
- Click Next to select the frequency for the Business Rule.
- In the Frequency screen, select the frequency when the rule should be executed as described here.
Note: The recurring rule gets executed on the defined day/date no matter what, so you won’t get the Frequency Enabled option for a recurring rule. While in a non-recurring rule (with frequency enabled, you get the option to turn On or Off the frequency as per your business need.) - Click Save. The Business Rule is created successfully and you can see the visualization of the rule on the right side to see the holistic flow of the Business Rule.
Activity Log and Comments Section
When a Business Rule is triggered on a card and performs the defined actions on it then the execution of the Business Rule is recorded in the activity log of the workitem to let the user know about the execution of the rule.
Also, if a Business Rule is triggered but the given action is not performed for any reason (like if the attributes on the card or value in the attribute of the card are invalid OR when a Business Rule is trying to block an already blocked card) then comment for the same is published in the Comments section of that card. The comment includes the name of the rule and the reason why the Business Rule couldn’t be performed.
Bulk Update
If you do any bulk update on your Execution Board, you will receive an upfront notification on the number of Business Rules that have been executed. On clicking the snack bar notification, a pop-up window opens that shows the Item ID, the Title of the cards, and the Business Rule executed on that card.