This page contains all the overall documentation about the CubicEx project. From installation to building your own copy of the source code to the rules of participating in the project as a commiter.

• Installation
• Variables and how they are used
• Becomming a contributor to the project.

Installation

Part 1: Downloading

You can download CubicEx from the Downloads page.

Part 2: Creating a CubicTest project

To be able to use CubicEx you first need to create a new CubicTest project. If you have already don this the you can skip this section and go directly to part 3.

First start up your Eclipse which has the CubicTest plugin installed. Now go to File (menu bar) -> New -> Other... and in the window that appears choose CubicTest -> New CubicTest Project and click on Next

In the Wizard that appears enter the name of the project and click on Next. Now you get the option to directly create a new test or to just only create the project. Finally press Finish and the project will be created.

Part 3: Install CubicEx

Installing CubicEx is very simple, first you need to add the CubicEx library to you project, by default the wizard for creating a new CubicTest project creates a lib folder. Copy the CubicEx-x.x.x.jar file into this folder.

Now we need to add the jar file to the classpath, we can do this by selecting the project and choose Project (menu bar) -> Properties.

In the left part of the window select Java Build Path and click on the Libraries tab. Now click on the Add JARs... button and select the just added CubicEx-x.x.x.jar.

Now that we have added the library we only need to add the commands, copy the commands folder into you project, preferably on the highest level.

Now the installation is complete. When you have recorded a test and you want to add commands simply drag it from the commands folder directly into your test and it will be added.

Variables and how they are used

CubicEx makes extensive use of variables for storing and retrieving data. In general when a command has a value property then it can take the advantage of variables.

To store values in variables you have quite a number of possibilities, for example to just store a value from an HTML input field in memory you can make use of the StoreValue command, but you can also use the StoreAlert and StoreConfirmation to store the message from the JavaScript alert and confirm dialog.

To explain the mechanism we will look at the WriteValue command which has the value property.

Suppose we have stored a value from a field in the myVar variable, how can we use it in the WriteValue command? If we fill in the value property with ${myVar} then the value of the myVar variable will be written to the field. But there are other combination's possible.

Suppose we make the assumption that myVar is stored in memory with the hello contents. Here are some examples of combination's:

${myVar}, very nice person! would result in hello, very nice person! Please say ${myVar}! would result in Please say hello!

When you introduce more variables then they are all parsed, it is also allowed to use variables more then once.

Becomming a contributor to the CubicEx project.

Documentation is still being setup.. please wait...