Geeks With Blogs

@pliekhus
  • pliekhus @RoryBecker @MillerMark You guys rock! The wasted time was for not installing it sooner. The DuplicateCodeCheck is SWEET!!! about 963 days ago
  • pliekhus @MillerMark The shame on me was for not using it earlier. I love every minute of the tool. I should have installed it on release date. about 963 days ago
  • pliekhus #DevExpress DXv2 has been out for a little bit and I just installed it. Shame on me for wasting my own time. #Coderush is a must have! about 964 days ago
  • pliekhus @mikejmonahan Enjoy the turkey festivities. We are definitely on for ribs, fun and luminary walk. My peeps will contact your peeps. Thx about 979 days ago
  • pliekhus Looking for good deals and a TV and ran across this. You could win some new Samsung toys by following #SamsungBlackFriday about 979 days ago

Patrick's Blog Technical Ramblings and More

Let’s get started with using the SpecFlow BDD syntax for writing tests with the DevExpress XAF EasyTest scripting syntax.  In order for this to work you will need to download and install the prerequisites listed below.  Once they are installed follow the steps outlined below and enjoy.

Prerequisites

Install the following items:

  1. DevExpress eXpress Application Framework (XAF) found here
  2. SpecFlow found here
  3. Liekhus BDD/XAF Testing library found here

Assumptions

I am going to assume at this point that you have created your XAF application and have your Module, Win.Module and Win ready for usage.  You should have also set any attributes and/or settings as you see fit.

Setup

So where to start. Create a new testing project within your solution. I typically call this with a similar naming convention as used by XAF, my project name .FunctionalTests (i.e. AlbumManager.FunctionalTests).

image

Add the following references to your project.  It should look like the reference list below.

  1. DevExpress.Data.v11.x
  2. DevExpress.Persistent.Base.v11.x
  3. DevExpress.Persistent.BaseImpl.v11.x
  4. DevExpress.Xpo.v11.2
  5. Liekhus.Testing.BDD.Core
  6. Liekhus.Testing.BDD.DevExpress
  7. TechTalk.SpecFlow
  8. TestExecutor.v11.x (found in %Program Files%\DevExpress 2011.x\eXpressApp Framework\Tools\EasyTest

image

Right click the TestExecutor reference and set the “Copy Local” setting to True.  This forces the TestExecutor executable to be available in the bin directory which is where the EasyTest script will be executed further down in the process.

image

Add an Application Configuration File (app.config) to your test application.  You will need to make a few modifications to have SpecFlow generate Microsoft style unit tests.  First add the section handler for SpecFlow and then set your choice of testing framework.  I prefer MS Tests for my projects.

image

Add the EasyTest configuration file to your project.  Add a new XML file and call it Config.xml.

image

Open the properties window for the Config.xml file and set the “Copy to Ouput Directory” to “Copy Always”.

image

You will setup the Config file according to the specifications of the EasyTest library my mapping to your executable and other settings.  You can find the details for the configuration of EasyTest here.  My file looks like this

image

Create a new folder in your test project called “StepDefinitions”.  Add a new SpecFlow Step Definition file item under the StepDefinitions folder.  I typically call this class StepDefinition.cs.

image

Have your step definition inherit from the Liekhus.Testing.BDD.DevExpress.StepDefinition class.  This will give you the default behaviors for your test in the next section.

image

OK.  Now that we have done this series of steps, we will work on simplifying this.  This is an early preview of this new project and is not fully ready for consumption.  If you would like to experiment with it, please feel free.  Our goals are to make this a installable project on it’s own with it’s own project templates and default settings.  This will be coming in later versions.  Currently this project is in Alpha release.

Let’s write our first test

Remove the basic test that is created for you. We will not use the default test but rather create our own SpecFlow “Feature” files. Add a new item to your project and select the SpecFlow Feature file under C#. Name your feature file as you do your class files after the test they are performing.

image

Writing a feature file uses the Cucumber syntax of Given… When… Then.  Think of it in these terms.  Givens are the pre-conditions for the test.  The Whens are the actual steps for the test being performed.  The Thens are the verification steps that confirm your test either passed or failed.  All of these steps are generated into a an EasyTest format and executed against your XAF project.  You can find more on the Cucumber syntax by using the Secret Ninja Cucumber Scrolls.  This document has several good styles of tests, plus you can get your fill of Chuck Norris vs Ninjas.  Pretty humorous document but full of great content.

My first test is going to test the entry of a new Album into the application and is outlined below.

image

The Feature section at the top is more for your documentation purposes.  Try to be descriptive of the test so that it makes sense to the next person behind you.  The Scenario outline is described in the Ninja Scrolls, but think of it as test template.  You can write one test outline and have multiple datasets (Scenarios) executed against that test.  Here are the steps of my test and their descriptions

Given I am starting a new test – tells our test to create a new EasyTest file
And (Given) the application is open – tells EasyTest to open our application defined in the Config.xml
When I am at the “Albums” screen – tells XAF to navigate to the Albums list view
And (When) I click the “New:Album” button – tells XAF to click the New Album button on the ribbon
And (When) I enter the following information – tells XAF to find the field on the screen and put the value in that field
And (When) I click the “Save and Close” button – tells XAF to click the “Save and Close” button on the detail window
Then I verify results as “user” – tells the testing framework to execute the EasyTest as your configured user

Once you compile and prepare your tests you should see the following in your Test View.  For each of your CreateNewAlbum lines in your scenarios, you will see a new test ready to execute.

image

From here you will use your testing framework of choice to execute the test.  This in turn will execute the EasyTest framework to call back into your XAF application and test your business application.

Again, please remember that this is an early preview and we are still working out the details.  Please let us know if you have any comments/questions/concerns.

Thanks and happy testing.

Posted on Sunday, November 13, 2011 8:22 AM | Back to top


Comments on this post: Setup and Use SpecFlow BDD with DevExpress XAF

# re: Setup and Use SpecFlow BDD with DevExpress XAF
Requesting Gravatar...
give out Example
thanks!
Left by tonyyang on Jan 03, 2012 8:54 PM

# re: Setup and Use SpecFlow BDD with DevExpress XAF
Requesting Gravatar...
give out Example code download
thanks!
Left by tonyyang on Jan 03, 2012 8:55 PM

Your comment:
 (will show your gravatar)
 


Copyright © Patrick Liekhus | Powered by: GeeksWithBlogs.net | Join free