The Successor Card is Updated Business rule will trigger a predefined action (move, update, or copy some of the card properties) whenever a successor card is updated.
A typical example would be to update a predecessor card if the updated successor card matches certain filters.
1. How to Create the Rule?
Only users with the "Account Owner" or "Manage Business Rules" roles can create business rules.
To configure the business rule, head to the Administration panel at the top right corner of your screen and open the Business rule tab. Click on the "Successor Card is Updated" rule option to set up the rule.
Note: If there is a set of predefined rules to your account, click on the Add new rule button at the upper right side of the panel.
2. How to Set Up and Enable the Rule?
The "Successor Card is Updated" configuration panel has the following fields and properties :
(1) Name — give a name of the rule to distinguish it.
(2) Description — provide a description of the rule behavior in the system.
Note: when a business rule is created, it will get a rule ID and will be made available in the Business rule panel under name and description.
PRO tip: You can specify the board name in the rule name in order to easily distinguish rules configured for each of your boards.
(3) Share with — this option allows you to share the rule with other users in the system so that they can edit/disable/enable the rule.
Every business rule has three main control settings: When; And; Then. It is a sort of "point-and-click" programming language with which you can automate any process. The way it works is based on the programming conditional statement “if this, then that.”
To save/enable a rule, click on the Save button at the bottom right corner of the configuration panel.
(4) WHEN: "Successor Card is Updated" is the event that will trigger an action.
(5) AND - define the filters and select the conditions under which the actions should be triggered.
- The "Board is” filter is а mandatory field for this rule.
Note: You can use "or" to add extra boards and optimize the scope of the rule. Use the delete sign to remove a board.
- Use "Add new property" to configure the automation further. Select a regular or custom field from the panel (for example, 'tag is' and choose a tag).
- If you want to move the predecessor card, click choose where to move. Define the board and specify the column/lane (for example: Done) where the system will move the predecessor card. You can select a cell or an entire column by clicking on the column's name from the board minimap.
- You can update the predecessor card with a predefined action when an update in the successor triggers it.
- You can copy card fields from the successor card onto the predecessor card by setting up which fields should be copied when triggered by an update.
As a result, whenever a successor card is updated, the predecessor card will be automatically moved or updated, depending on your configuration, or, alternatively, information can be copied to the predecessor card.
Note: The predecessor card must be in the 'Done' section of the board in order for the successor card to be moved to the 'In Progress' section.
Please, read more about predecessor/successor card links and how to create them.
3. Using the 'Successor Card is Updated' Rule to Copy Card Fields Into a Predecessor Card
This rule can be used to copy card fields (both regular and custom* fields) between cards. There is a configuration in the Then section that can be set up so that you can copy the values of the selected fields from the successor to the predecessor.
*Note for custom fields: In some cases, the copy operation between two cards on different boards might fail. This can happen if:
- a custom field is not enabled on the target board
- a custom field has an empty value on the trigger card but has an enforced value on the target card
- the custom field on the target card already has a value and it is immutable
- a custom field that has different min/max values on the two boards
- a custom field that has values that must be unique
- a custom field value that is not one of the allowed values on the target card
Important: For any of the above cases, the whole copy operation would fail which would also cause any other regular card fields, configured in the rule, to not be copied. You can learn more about copying card properties between linked cards here.