...

1. Install

The update site for GreenPepper's Eclipse development tools plugin is located at: http://www.greenpeppersoftware.com/greenpepper-eclipse.

Step 1

In Eclipse, choose Help/Software Updates/Find and Install.

Image Removed

Step 2

Select Add... button to add a new remote site.

Image Removed

Step 3

To update the plugin enter following link: http://www.novatec-gmbh.de/updatesite/aqe

Image Removed

Step 4

In the tree of available updates select GreenPepper Development Tools and click Next >.

Image Removed

Step 5

Click Next > button in the Install Details window.

Image Removed

Step 6

You have to accept the terms of the license agreement to be able to proceed with the installation. You are now ready for the installation, click Finish.

Image Removed

Step 8

Once the download manager has started downloading, you see the Security Warning popup. The authenticity of software can not be established. You have to click Ok to continue with the installation.

Image Removed

Image Removed

Step 9

After the installation you must restart the Eclipse workbench, for the plugin to be available within the application.

Image Removed

Checking the installation

You should now see the GreenPepper menu on the toolbar.

Image Removed

...

Image Removed

Updating

You can see the current installed version of the plugin and a link for checking for updates.

Image Removed

...

2. Configure

Following steps are needed to configure the GreenPepper Eclipse plugin.
Before you begin, you must verify:

• You have downloaded the binaries for GreenPepper Core Java version on your workstation.
• Confluence is well configured.

I. Workspace configuration

First, you have to configure where the plugin can find the GreenPepper Server.  This is done in Window >> Preferences.

Image Removed

Enter the URL for the server :

• For Confluence, it is the base url of Confluence (e.g. http: //domain:8080/confluence)

Enter the XML-RPC handler. (For now only greenpepper1 is available.)  You can test the connection by clicking on the Test Connection button.

Image Removed

II. Project configuration

Enable GreenPepper on a project by selecting GreenPepper/Project GreenPepperised.
You should see a check mark beside the menu option afterwards.

Image Removed

...

Image Removed

...

• Advanced settings
• Local repositories

  In the GreenPepper page, you will identify your Eclipse project to a System Under Test (under development).
  By doing so, you will see all the associated specification repositories. You will be able to enter your own credentials
  for each of these repositories. Optional
  You will also need to configure your runner location. Mandatory

Image Removed

...

Image Removed

...

Image Removed

...

3. Use

Running specifications

A GreenPepper project, inside Eclipse, is a JavaProject.
When you greenpepperised a Java project, you gain access to Run
To validate that your project developement code respect the example in the specifications, you create a new Run Configuration.

I. Run Configuration

The Debug configuration works the same way.  Then create a new GreenPepper Specification

Image Removed

II. Inputs

...

• com.greenpepper.repository.FileSystemRepository for files
• com.greenpepper.runner.repository.AtlassianRepository for Jira/Confluence
• com.greenpepper.runner.repository.VFSRepository for zip ...

...

Image Removed

III. Execute Document

Open the Repository View and click right to execute a certain document to run the tests.

Image Removed

IV. Results

  Running the specification will give you a result like this one

Image Removed
  Notice that the html result file was added to your project files.

V. Text Result

  If the window displayed shows html in a text format, check your Open With setting for the html file

Image Removed

...

Repository view

You can view all the specifications for your project using the repository view.

Show the repository view window

There is two ways to access the repository view.
1) From the GreenPepper menu

Image Removed

2) From the eclipse standard view selection.
    First choose Show View-Other
    Then choose GreenPepper RepositoryView

Image Removed

The Repository View

  The Repository view is a JUnit like view.
  You will be able to launch executions, view documents and results and work on both Implemented and Working copies of the documents.
  Careful ! the Green bar might be addictive after a while ...

Image Removed

project Image Removed GreenPepperised   Repositories Image Removed A JIRA Repository Image Removed A Confluence Repository Image Removed A Remote File Repository Image Removed A Local directory   Documents Image Removed Plain Image Removed Executable Image Removed Working differs from the Implemented copy Image Removed Working copy Image Removed Broken Reference

Actions Image Removed Will tell Eclipse to work on the Working copy of the Document(s) Image Removed Will tell Eclipse to work on the Implemented copy of the Document(s) Image Removed Will Ask the Repository to MERGE the Working copy with the Implemented copy of the Document(s) Image Removed Executes all the selected Documents Image Removed Executes The selected Document Image Removed Reloads The selected Document from the repository Image Removed Opens a Fixture class Creation Wizard to generate the Fixture and its needed components (v. BETA only) Image Removed Refreshes the Tree

Keyboard shortcuts

Image Removed

4. FAQ

I cannot see the GreenPepper property page for my project.

...

I cannot see my project in the projects combo when creating a Run Configuration.

...

Some of the pages I retrieved from Confluence have underlined macro errors.

To prevent deadlocks, we ask Confluence not to render the GreenPepper macros for third party applications witch result in an underlined error on the rendered page.