Eclipse Add-in

Launch Eclipse, go to the "Window" menu and choose "Open Perspective" and choose "Other".

Choose the "GForge Perspective".

You can now choose the "GForge" menu and "Login".

You will need a serial number in order to use the Add-in, and the serial number is only valid for a particular server hostname. If you change server hostnames, you will have to get an updated serial number from GForge Group.

On the server, make sure your user has access permissions to at least one project and that you are set with Assignee/Admin or higher permissions for each tracker that you wish to use. If you have no access to any trackers, you will not be able to use the Add-in.

The screenshot above shows the Add-in interface from inside Eclipse. Enter your hostname and login information, then click the "Log in" button. You will be prompted to enter a serial number if you have not done it already.

• NOTE: To use SSL, your server must be set up properly and must have a valid SSL certificate issued by a recognized authority. Self-generated SSL certificates will not work.

Once you have logged in, you will be presented with a list of your projects, which you can expand to show a list of trackers in the selected project. Click on a tracker to view a list of items in the tracker.

The browse screen has filters for assignee and status to make it easy to find items quickly. You can also choose to edit or add complex queries using the "New Query" or "Edit Query" buttons. Complex queries are stored on the server and will be visible in the web interface as well as the Visual Studio Add-in. Each of these queries performs their work on the server side and can be used to limit the number of downloaded items. If you have a tracker with hundreds of items in it, it’s a good idea to filter the list to a small subset of items for best performance. Downloading hundreds of items from the tracker can be very time consuming.

You can choose to save your changes or delete the item from this screen or if you wish, you may monitor this item so you receive email notifications when it is changed.

As you can see, the item has multiple tabs just as the web interface does. Choose the "messages" tab to view follow up messages. "Files" shows any attached files. The "Changes" tab shows the audit trail for this item. "Commits" shows any files that have been modified in the SCM repository and linked to this item. "Dependencies" shows a list of any other items that this item is dependent on

© 2004-2009 GForge, LLC