Detroubulator version 1.1.0 is now available for download: detroubulator-1.1.0.zip

Unit testing your mapping programs is an important part of SAP XI development. However, unit testing manually in the Integration Builder is a time-consuming and error-prone task. Furthermore, it's a task that must, in an ideal world at least, be done every time a change is made to the mapping program.

Detroubulator lets you write your unit tests once and for all and run them at the press of a button. The minimal effort required to run your unit tests means that testing can become an integrated part of development rather than an effort that only takes place when development is complete. Having a suite of unit tests available also makes it easier and safer to make changes to an existing mapping program; running your test suite at each step of the way builds confidence that the changes made to the mapping program didn't inadvertently introduce errors.

Who is it for
Detroubulator is primarily aimed at developers. To make the most of the tool, you need to be comfortable working at the command line and editing XML documents. More importantly, in order to write your own test files, you need a good grasp of the XPath language. For information on how to get started with XPath, please see the Detroubulator FAQ (included in the download).

Getting started
You will find a link to the latest version of the Detroubulator software at the top of this page. To start using the tool, download the Detroubulator archive, unpack it into a directory of your choice and follow the installation instructions in the README.html file. To learn more about using Detroubulator, please refer to the documentation library, which you'll find in the docs folder below the installation folder.

About the authors
Detroubulator was developed by the members of the XI team at Applicon A/S. Working with XI on a daily basis, we needed a tool that would take some of the pain out of manually unit testing mapping programs in the Integration Builder. Such a tool did not exist, however, so we ended up writing it ourselves. Sharing our knowledge and experience is one of the core values at Applicon A/S, so releasing the finished tool as open source was a natural next step for us.

How does it work

Every test case that you want to execute is stored in the so-called test file, which is a simple XML document, that also holds information about the mapping program under test and the XI server it runs on. Each test case refers to an input document and contains a number of assertions about the result of executing the mapping program with the provided input.

When the Detroubulator tool is executed from the command line of your local machine, it reads the test file, passes each input document to the remote XI server and evaluates each assertion against the mapping program's output. If a test fails, its details will be reported. How they're reported is configurable. One option is to generate an HTML report containing the test results. Another option is to have the results output directly to the command line. You can even add your own reports written in the Java programming language.

License
Detroubulator is being released as open source under the GNU General Public License (GPL). For the full text of this license, please refer to the LICENSE file in the software archive. For more information on the GPL, please visit the GPL homepage. 

System requirementsDetroubulator works with SAP XI 3.0/PI 7.0 servers. In order to run the tool, you need a Java 6 runtime and the SAP JCo libraries installed on your system. For more information on installation and setup, please refer to the Detroubulator FAQ.