Rule Tags
*Applies to all Rule types - Decision Tables, Decision Trees, Scripting Rules and Rule Flows.
Tags provide a simple way to keep track of your rules and filter them in search results.
Every rule can be labeled by an arbitrary set of tags. These come in several colors to enable simple visual identification of distinct rules (as well as their versions). Tags contain arbitrary text of your choice. The management and usage of tags, although intuitive, is described in detail below.
Manage & Use Rule Tags
Tags can be managed either separately for each version of a given rule, or for all rule versions at once. Let us describe these two cases separately.
On Rule versions
The tags belonging to a certain rule version can be managed either in the rule list or inside the rule settings of the respective version. The operations performed in these two places have the exact same effect.
The management of tags belonging to individual rule versions involves the following operations.
Adding a tag
Removing a tag
Click on the tag you wish to remove next to a version and select the "Remove from this version" option. Your tag should be now removed from the rule version.
Changing tag color
Tag color can only be changed globally for all tags in your space that have the same text. To do that, click on the tag whose color you wish to change (anywhere in the respective space) and choose the new color under the "Change color globally" option.
Note that tags exist on the level of the space, i.e., different kinds of rules may be labeled by the same tags. For example, if you create a tag for a Decision Rule, you may as well use it to label your Rule flows.
It is suggested that you choose the text of your tags carefully, as it cannot be globally changed later. If you need to change the text of a tag used to label a certain set of rules, you need to remove it from each of the rules separately and then add new tags that replace the removed one.
On Rules themselves
Aside from the tags labeling the individual rule versions, there is also a tag list visible in every rule header within the rule list.
This overall tag list contains the set of all tags used in any of the versions of the respective rule. It allows you to perform the same tag operations like the one described above (Adding a tag, Removing a tag, Changing tag color), only with different effects of the first two:
Adding a tag will result in adding the tag to all versions of the respective rule.
Removing a tag will result in removing the tag from all versions of the respective rule.
The effect of changing the tag color in the rule header remains the same.
Use tags to search
Aside from allowing for a clear visual differentiation and classification of your rules and rule versions, tags may be also used to filter search results.
When you start typing in the search bar, the existing tags are suggested to you in a dropdown menu. Upon selecting some tag from the menu, it is placed into the search bar and used to filter your search results. A rule enters the search results only if at least one of its versions contains the specified tags. The versions themselves are not filtered (you can see all of them in search results).
The functionality of searching by text is of course preserved. You may enter search text simply by typing the desired phrase and pressing Enter without selecting any tags.
Note that there is a separate thin #tag-api within our Management API allowing you to manage tags on your rules and reach out for rules with a specified collection of tags.
Last updated
