UI Testing with Eclipse Jubula: Executing the Tests (3)

In my last blog post, everything was pure theory (if you’re looking for the start of the Jubula series, look here): I specified a few tests, but there’s no connection yet to any real application under test. Let’s rectify this!

Before starting up Jubula today, look for the “AUT Agent” service and start it. The AUT Agent is our connection to the “real world”. It takes commands from Jubula and executes them on the application under test (you can even run Jubula and the agent on different boxes for distributed testing). On Windows, you might have to start the agent via “Run as Administrator”.

Next, start Jubula and open your project. Now, look for the “Connect to AUT Agent” toolbar button and press it in order to establish the connection to the agent we started before:

Next, start the test object via the “Start AUT” toolbar button. You should then see its ID listed in the “Running AUTs” view:Running the application under test

The application under test is running now, and you can view it on your screen. However, we still can’t run any tests, as the logical components we specified last time are not yet mapped to their real component counterparts within the RPC application. Let’s fix this by starting the “Object Mapping Mode”, again from the toolbar:Starting the Object Mapping

Now activate the test object and move the mouse around within it. Notice the green borders around the various components? That’s the Jubula Object Mapper showing you the components it has detected. In order to add any of these to your object mapping, you have to press Ctrl-Shift-Q.

You can collect all components at once like that if you want to, but I’d advice against it because it can get crowded and confusing quickly in Jubula when you do that. Instead, start with the few components we currently require for our tests to run. In my case, this would mean capturing the mail icon in the toolbar, and – after clicking it – the dialog message text and the dialog “Ok” button.

When done, switch back to Jubula. You should see a new editor called “OM / <something>”, already containing your logical components on the left side, and the newly recorded test object components on the right side:Unmapped components

All that’s left to do now is to map the logical to the technical component names. You can do this by dragging each logical component name over the respective technical one and drop it there. The editor will change into this:All objects mapped

Aaand… – we’re done with the object mapping. Your “Problems” view should be empty. This means that we can run our tests, at last! – Ok, nearly. First, we have to stop the object mapping mode again. I’m sure you’ll find the respective toolbar button by yourself. :)

Select your “System Test” test suite in the “Test Suite Browser” view and run it:Running the Test Suite

Hopefully, your automated tests will run now. – You can switch into the Test Execution afterwards and check the results of the test run:

Oops, my tests failed. What’s the matter?

I’ll go check the screenshot Jubula captured when the “wait for window” action failed. It shows a second message tab being open, and zero “Open Message” dialogs. Hmmm…

Oh right, I accidentally mapped the wrong toolbar button to my logical “Open Message” component… – I should have mapped the mail button to it, instead of the green plus sign.

I’ll correct that (for some reason, I had to restart Jubula before it accepted my fixed object mapping), and maybe you’ve got a few things to correct, too, and then we’re done!

You’ll notice that there will always be some debugging of your test specifications going on here, unfortunately, but that’s to be expected: Specifying tests is like developing in a lot of ways. Also, finding out what exactly made your tests fail can sometimes be harder than it looks, screenshots or not.

Alright, let’s summarize what we’ve achieved up to here:

  • In the first part of my blog series, there was some configuration to do in order to get the application under test to cooperate with Jubula. A one time effort.
  • In the second part, we specified a few tests. This is the part you’ll have to put the most effort into. You absolutely want to get your test specifications right: Clear, concise, complete, robust, maintainable. This is always difficult to get right. However, in my humble opinion, Jubula gives you a lot of good tools for structuring and refactoring your test specifications to simplify this.
  • In the third part, we mapped the components and executed the tests. Yay!

This should be enough about Jubula to get you started with your own experiments. I hope I tempted you into trying it out! – It’s a tool with a lot of potential, at the least.

Before using Jubula in a real-world project, there’s still a lot of things to clarify, of course, like:

  • What kind of database should you use with Jubula (it defaults to an embedded H2)?
  • How well does it cope with multiple team members specifying tests at the same time?
  • How to integrate it into an Ant/Maven/SBT/Gradle/Buildr/whatever build?
  • How to run it on an Continuous Integration server?
  • How well do the exported test specifications play together with version control systems?
  • … and probably more stuff like that…

But it’s a start. :)

Posted in Eclipse, Java, Testing by jmhofer at May 17th, 2011.
Tags: , , , ,

12 Responses to “UI Testing with Eclipse Jubula: Executing the Tests (3)”

  1. Do you want to have your blog syndicated on PlanetEclipse.org? I think it would benefit the community, especially your writing about Jubula. If you do, please file a bug here:


  2. […] More here: Joachim Hofer: UI Testing with Eclipse Jubula: Executing the Tests (3) […]

  3. Alexandra Imrie says:

    Hi! Nice blog series, thanks! I’ll take a few of the open points and get some blogs done on them from our side. Keep us updated with your progress 😉

    • jmhofer says:

      Thanks. I was thinking about researching the open points, too (for trying to write some tests against eCobertura with the help of Jubula). – But I guess I want to do some kind of comparison to SWTBot and maybe WindowTester, first.

  4. Alexandra Imrie says:

    Sounds cool :) Perhaps you’d like to report on your results at the Eclipse Testing Day? 😉

  5. Tcharl says:


    Nice blog post, nice tool!
    Does it work with all kind of Ui: like Gwt and Flex?
    flex integration plus maven will let me adopting this project for sure!

  6. matfsw says:


    I’ve written a post on how to automate Jubula Test Runs with Jenkins in case you’re interested:


  7. Erwan Bousse says:

    Thanks for this tutorial! I’ve managed, at last, to execute a simple test on a Java Swing application!

    Quick question: is there a way to record a series of actions, like it was possible with Google Window Tester Pro ?


    • Erwan Bousse says:

      Answering myself: there a “Start Observation Mode” button on the top for that. It observes actions performed on the GUI, and creates an equivalent Test Case when the button “Stop Observing Test Case” is pressed.

      This feature works like a charm, and is really handy (even though you loose the benefit of abstractions).

  8. Alex says:

    Nice tutorial, one question, i have a big rcp application and there are more tables and linked lists, would be much easy if i start mapping all my app?

  9. Sachin Daniel Varkey says:

    Can you please tell,how to drag and drag a menu(tree) to a table .Because the green colour is not highlighting in my menu items.Only standard buttons its highlighting during object mapping.

Leave a Reply