| Info |
|---|
Eclipse is an open source community. A large and vibrant ecosystem of major technology vendors, innovative start-ups, universities, research institutions and individuals extend, complement and support the Eclipse platform. |
| Table of Contents |
|---|
1. Install
The update site for GreenPepper's Eclipse development tools plugin is located at: http://www.greenpeppersoftware.com/greenpepper-eclipse.
| Warning | ||
|---|---|---|
| ||
The plugin has been tested on version from 4.3 to 4.4 |
Step 1
From Eclipse, choose Help/Software Updates/Find and Install.
Step 2
Select the Search for new features to install radio button Add... button to add a new remote site.
Step 3
...
Enter the name you want and, for the URLlocation,
http://www.novatec-gmbh.de/updatesite/aqe
Step
...
4
Select the GreenPepper development tools Development Tools in the tree of available updates and click Next >.
...
Step 5
Click the Next > button in the Install Details window.
Step 6
You must have to accept the terms of the licence agreement to be able to proceed with the installation. You are now ready for the installation; thus, click Finish.
Step 8
Once the download manager has finished started downloading, you see the 'Feature VerificationSecurity Warning' screen. Click Install All. The authenticity of the software cannot be established. You have to click Ok to continue with the installation.
Step 9
You After the installation you must restart the Eclipse workbench for the plugin to be available within the application.
Checking the installation
You should now see the GreenPepper menu on the toolbar.
You can select the Manage Configuration Installation Details menu from Help /Software Updatesto check the correct installation of the plugin.
Updating
You can see the actual version of the plugin and there is a link to check for any updates.
You can also check for updates by selecting the first option in step 2.
2. Configure
These are the steps needed to configure the GreenPepper Eclipse plugin.
Before you begin, you must verify the following:
- You have downloaded the binaries for GreenPepper Open Core Java version on your workstation.
- Confluence is well configured.
I. Workspace configuration
First, you have to configure where the plugin can find your GreenPepper Server.
This is done in the workspace preferences dialog box.
...
Enter the GreenPepper handler. (For now only greenpepper1 is available.)
You can test the connection by clicking on the Test Connection button.
II. Project configuration
Enable GreenPepper on a project by selecting GreenPepper/Project GreenPepperised.
You should see a check mark beside the menu option afterwards.
...
You are now ready to execute specification documents on your development code.
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
II. Inputs
- Project
Your eclipse project to launch the specification on. - Repository UID
The remote Repository UID (None if local) - Document Repository base URL
The Repository URL (Or directory path if local) - Document Repository Class
- com.greenpepper.repository.FileSystemRepository for files
- com.greenpepper.runner.repository.AtlassianRepository for Jira/Confluence
- com.greenpepper.runner.repository.VFSRepository for zip ...
- Username
If Authentication is need for the Repository access - Password
If Authentication is need for the Repository access - Specification
The Specification name (Document name) - Current Version
If versioning is handled, aim for the latest version of the document.
III. Results
Running the specification will give you a result like this one
Notice that the html result file was added to your project files.
IV. Text Result
If the window displayed shows html in a text format, check your Open With setting for the html file
You need the Browser support plugin to be able to see the html page inside an Eclipse Editor.
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
...
2) From the eclipse standard view selection.
First choose Show View-Other
Then choose GreenPepper RepositoryView
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 ...
...
| By default Eclipse will work on the Implemented copy of the document. |
Keyboard shortcuts
4. FAQ
I cannot see the GreenPepper property page for my project.
Make sure your project has been GreenPepperized using the option menu. Only projects with a GreenPepper nature have the GreenPepper property pages.
See Configure GreenPepper Eclipse plugin for more information.
I cannot see my project in the projects combo when creating a Run Configuration.
Make sure your project has been GreenPepperized using the option menu. Only projects with a GreenPepper nature can have a GreenPepper run configuration. See Configure GreenPepper Eclipse plugin for more information.
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.
...