Skip to main content

Anatomy of Sitecore Business Rules

A powerful part of Sitecore is the business rules engine. Many say it is an underutilized part of the platform. I think part of this is because it is not very well documented. I agree it is a very powerful part of Sitecore so I wanted to spend some time digging in and documenting more about how it works and how to utilize it.

First, let's level set at a high level on what this is. I don't want to rehash the intro stuff as Sitecore documentation does a good job at explaining it at a high level. The documentation that is slim is breaking down how it is configured and how to extend it.

There are a few blogs out there that show quick and dirty examples of how to create custom rules. Before we go there though I want to break down the anatomy of a rule that currently exists. I think this helps level set how a rule comes together. Once we understand its parts it is easier to create our own, and then the power is really unleashed.

Using a rule

There are many places where a business rule can be created, I will take just one example to work through. 

Here we are first, clicking on the default device. Then clicking on the "edit rule" link. This then brings up the "create rule" dialogue with a list of rules (both conditions and actions) we can configure to run. Again, there are a number of places you can access the "create rule" dialogue, this is just one example. For this post, we will be focusing on the "When query string matches value" rule. 

In the "edit rule" area you will notice I have selected it and set a value of "my test". You will notice in the choose condition area the word "value" is underlined. This means that field will be replaced with a value (in this case a string) and the condition will execute based on that value. 

Where is the rule defined in Sitecore

To start understanding how this rule works we need to dig into how it is set up in Sitecore. To find the above rule we navigate to  /sitecore/system/Settings/Rules/Definitions.

In this section is where all the configuration for rules are. If we open "Elements" and then "Device Detection" you will see a conditional rule called "Query string".

In the "Text" field you can see the sentence we saw before when we set up the rule to use. This time though the "value" area has some special syntax around it.

Then in the "Type" field the assembly and class that process this rule is called out.

We know this rule is a conditional rule via two methods. 1) If you look at the "template" field in the top it says it is using the "condition" template. Also, all conditional rules have a diamond icon. Actions will have a rectangle icon.

How are they categorized

If you move up the tree just a little you will notice there is an "ElementGroup" node. Under this node is all the groups we can organize our rules into. You can, of course, create a new grouping. Below you will see the rule we have been working with was configured to be in the "Device" group (bottom image). This, in turn, means when you open up the "Create rule" dialogue the rule shows up grouped under "Device".

So now we have seen how these show up in the rules editor based on how they are grouped. But how do we get the grouping we want to show up? This comes down to what you specify in the item template. Below the field "Rule" has a source defined as the Rule Group you want to have show up in the editor. 

With the rule source now in place the editor will open up and contain any rules that are part of that rule group. So let's look at the rule groups a bit more now. 

This all comes down to what the rule group and the rule is tagged to. You point to the rule field to a rule group. The rule group is linked to certain tags. Those tags are used to find all the rule elements that also have the same tags. 

In the image below you can see the tags configured for the group on the top left. Then each rule elements configured tags. If you remember from the first screenshot the rules that show up there. Here is a quick list of them (I left devices off because there is a long list and it is muddy up a little because of secondary tag groups).

Predefined Rules
- where predefined rule is true

- where the current database name compares to value
- where the current device compares to value
- where the current web site name compares to value

Hopefully that helps breakdown and explain some of the organizational and anatomy aspects of Sitecore Business Rules. 


Popular posts from this blog

Uniting Testing Expression Predicate with Moq

I recently was setting up a repository in a project with an interface on all repositories that took a predicate. As part of this I needed to mock out this call so I could unit test my code. The vast majority of samples out there for mocking an expression predicate just is It.IsAny<> which is not very helpful as it does not test anything other then verify it got a predicate. What if you actually want to test that you got a certain predicate though? It is actually pretty easy to do but not very straight forward. Here is what you do for the It.IsAny<> approach in case someone is looking for that. this .bindingRepository.Setup(c => c.Get(It.IsAny<Expression<Func<UserBinding, bool >>>())) .Returns( new List<UserBinding>() { defaultBinding }.AsQueryable()); This example just says to always return a collection of UserBindings that contain “defaultBinding” (which is an object I setup previously). Here is what it looks like when you want to pass in an exp

Excel XIRR and C#

I have spend that last couple days trying to figure out how to run and Excel XIRR function in a C# application. This process has been more painful that I thought it would have been when started. To save others (or myself the pain in the future if I have to do it again) I thought I would right a post about this (as post about XIRR in C# have been hard to come by). Lets start with the easy part first. In order to make this call you need to use the Microsoft.Office.Interop.Excel dll. When you use this dll take note of what version of the dll you are using. If you are using a version less then 12 (at the time of this writing 12 was the highest version) you will not have an XIRR function call. This does not mean you cannot still do XIRR though. As of version 12 (a.k.a Office 2007) the XIRR function is a built in function to Excel. Prior version need an add-in to use this function. Even if you have version 12 of the interop though it does not mean you will be able to use the function. The

MVVM light and Model Validation

I have been using the MVVM light toolkit for a project recently. It is a great toolkit but is missing a couple things and Laurent Bugnion does a good job trying to cover those holes. One of the things the toolkit does not support is Validation. The good news is there is a great CodePlex project out there call Fluent Validation that makes this pretty easy to add and really powerful. My objective was to add validation to my model so I could call “IsValid” on the model itself (similar to the MVC attribute approach). Fluent Validation has you create a new class file that holds you validation rules for a given model. This is the approach I took to enable each model to have an “IsValid” property and a “Errors” property that returns the validation errors. First I setup my ValidationFactory: public class ValidatorFactory : FluentValidation.ValidatorFactoryBase { public override FluentValidation.IValidator CreateInstance(Type validatorType) { return SimpleIoc.Default.G

WPF Localization - RESX Option

About a year ago I was building a WPF project in .Net 3.0 and Visual Studio 2005. I wanted to revisit this subject and see what has changed in .Net 3.5 and Visual Studio 2008. I will make a few of these posts to try and cover all the different options (RESX option, LocBaml option, Resource Dictionary Option). In this blog I will focus on using a resx file to localize an application. To show how the resx option is done I created a WPF form with three labels on it. The first label has is text set inline in XAML, the second has it text set via code behind from the resx file and the third has its text set via XAML accessing the resx file. The first thing that needs to happen to setup a project for localization is a small change to the project file. To make this change you will need to open the project file in notepad (or some other generic editor). In the first PropertyGroup section you need to add the follow XML node <UICulture>en-US</UICulture>. So the project file node w

Create Web Forms for Marketers Custom Save Action and Edit Screen

I was recently working on a project where I needed to create a custom save action to add to my Web Forms for Marketers module.  I needed a custom save action to push the data to salesforce and I also needed a custom edit screen so the author could setup some configuration values the action needed. Here are the details of what I did starting with the save action. Save Action The first thing you need to do is create a new class that inherits the “ISaveAction” interface (Sitecore.Form.Submit.ISaveAction) and implement the Execute method.   public class SalesforceSaveAction : ISaveAction { public string FormKey { get; set; } public string FieldsToSend { get; set; }   void ISaveAction.Execute(ID formid, AdaptedResultList fields, params object [] data) { // Code to execute here } } That is really all you need. Now it all becomes about custom code and configuration.  To configure the save action to show up you need to go to Modules –> WFM –> Sett