Unit Testing Custom Rules, Actions, and Conditions with FakeDb – Part 2 – Testing Actions

In part 2 of this 3 part series, I will cover how to test a custom action using Sitecore FakeDb.

When testing a custom action, you are testing that action alone – so I am not testing the rules engine itself, nor am I testing a specific condition (that was covered in part 1 of the series).

Sample Test

view source
print?
1
private readonly ID _renderingOptionsId = new ID(ScoreConst.TemplateIds.RenderingOptions);
2
private readonly ID _viewRenderingId = ID.NewID;
3
private readonly ID _folderId = ID.NewID;
4
 
5
private Db BuildDb()
6
{
7
return new Db
8
{
9
new DbTemplate("Folder", _folderId),
10
new DbTemplate("Rendering Options", _renderingOptionsId),
11
new DbTemplate("View Rendering", _viewRenderingId)
12
{
13
BaseIDs = new[]
14
{
15
_renderingOptionsId
16
}
17
},
18
new DbItem("page", ID.NewID, new ID(ScoreConst.TemplateIds.HomePage)),
19
new DbItem("renderings", ID.NewID, _folderId)
20
{
21
new DbItem("outside rendering", ID.NewID, _viewRenderingId),
22
new DbItem("rendering folder item")
23
{
24
new DbItem("view rendering 1", ID.NewID, _viewRenderingId),
25
new DbItem("view rendering 2", ID.NewID, _viewRenderingId),
26
new DbItem("rendering folder nested", ID.NewID, _folderId)
27
{
28
new DbItem("view rendering 3", ID.NewID, _viewRenderingId)
29
}
30
}
31
}
32
};
33
}
34
 
35
[Test]
36
public void AddDescendentRenderings()
37
{
38
using (var db = BuildDb())
39
{
40
Item page = db.GetItem("/sitecore/content/page");
41
Item folder = db.GetItem("/sitecore/content/renderings/rendering folder item");
42
var context = new PlaceholderSettingsRuleContext
43
{
44
Item = page
45
};
46
 
47
var action = new AllowDescendantRenderings<PlaceholderSettingsRuleContext>
48
{
49
ParentItemId = folder.ID.ToString()
50
};
51
 
52
// act
53
action.Apply(context);
54
 
55
// assert
56
context.PlaceholderRenderings.Should().NotBeNull();
57
context.PlaceholderRenderings.Should().HaveCount(3);
58
context.PlaceholderRenderings.Should().Contain(new List<Item>
59
{
60
db.GetItem("/sitecore/content/renderings/rendering folder item/view rendering 1"),
61
db.GetItem("/sitecore/content/renderings/rendering folder item/view rendering 2"),
62
db.GetItem("/sitecore/content/renderings/rendering folder item/rendering folder nested/view rendering 3")
63
});
64
}
65
}
 
Revolutionize Your Business With Generative AI
From product design and software development to virtual agents, content creation, and reporting, GenAI is transforming business.  Our AI experts help you unlock GenAI’s full potential and drive growth.
Let’s Get Started
 
There are a couple of things to note in this sample unit test.
 
First, when I create several tests of the same action, I might need to construct a structure of items using FakeDb – which in this case is extracted into a helper method called BuildDb(). Note in this example that the hierarchy created includes template inheritance which is needed for this particular test.
 
Second is the process to instantiate the action class using the context, and test the action. Testing the action involves creating the proper context for the rule (based on the rule type), then applying the action and testing the result by calling the action.Apply(context) method.
 
The act of applying the action to the context will yield some result – which can then be tested. In this example – we use fluent assertions to do so.
 
 
Tags
BrainJocks jockstothecore Sitecore