From mylyn-mantis

Revision as of 10:47, 15 October 2009 by Rombert (Talk | contribs)

(diff) ← Older revision | Current revision (diff) | Newer revision → (diff)

Mylyn-Mantis Repository Connector

This project is an Eclipse Mylyn Repository plug-in for the Mantis Bug Tracking application using the Mantis Connect SOAP interface. This Repository Connector is beta quality. For the most part it works as advertised, it just needs testing and some refinements added. Should you need any help, use the forums to ask questions or the bug tracker to report problems.

Patches to improve the functionality would be appreciated -- see contributing to get started.

The following status will from now on reflect the 3.x. The 1.x, and 2.x series will be maintained to the extent that bug fixes are provided by the community. All new functionality will be implemented in the 3.x series.

Mylyn Version Compatibility:

The current version of the connector is known to work with the following Mylyn Version:

3.0.x
3.1.x
3.2.x

Developers monitor the Mylyn Integrators mailing list. Every effort is made to keep compatible with the N and N-1 versions of Mylyn. However we can not guarantee compatibility with a particular plugin combination as we do not test with all possible connector combinations.

Mantis BT compatibility

Known compatible Mantis versions:

1.0.5 - ¹
1.0.6 - ¹
1.0.7 - ¹
1.0.8 - ¹
1.1.0a4 - The version of mantis connect integrated with 1.1.0a4 is compatible with the connector.
1.1.x
1.2.0a3 and rc1 are partially supported
1.2.0rc2 and newer are completely supported

¹Note to non-english character sets, you may want to use 1.1.0a4 or later as there is a bug with accent characters that may cause download issues with tracking items. To lift your existing data to the new version just execute the admin/install.php script of your new mantis installation. But this could have only been verified for Latin1 character sets. Others may not work.

Installation

Update site installation

The recommended way of installing it using the Mylyn connector discovery, if you're running Mylyn 3.2 or later. Otherwise you can manually add the update site at http://mylyn-mantis.sourceforge.net/eclipse/update/.

The most current version can be found at the Mylyn-Mantis Update Site. This will be the main distribution of all updates. This site includes the stable 3.0.x version of the connector for 3.4 . It is recommended that you use this site.

The unsupported, development version can be found at http://mylyn-mantis.sourceforge.net/eclipse/update-dev/site.xml . Development version uploads are usually announced on the user forum.

SSL Support

Note on Self Signed Certificates: For those that are accessing HTTPS servers with self-signed certificates, you will need to import those certificates into your trusted keystore. One option to do this can be found at the following URL. http://blogs.sun.com/andreas/entry/no_more_unable_to_find
If you don't import the self-signed certificates, you will run into the infamous "Unknown Error" dialog.

Zip download

The most recent version of the connector is uploaded in the files section on the sourceforge.net page.

Local mirror of the update site

If you wish to generate an update site zip for redistribution, you can use the following command, replacing /opt/eclipse/plugins/org.eclipse.equinox.launcher_1.0.201.R35x_v20090715.jar with your eclipse install and launcher jar:

java -jar /opt/eclipse/plugins/org.eclipse.equinox.launcher_1.0.201.R35x_v20090715.jar -application org.eclipse.update.core.standaloneUpdate -command mirror -from http://mylyn-mantis.sourceforge.net/eclipse/update/ -to . -featureId com.itsolut.mantis_feature -version 3.0.5.200908171111

.

More details can be found in the Eclipse update manager guide

Current Release

The current release adds support for:

Version 3.0.6.200910151319 (3.0.6 final)

0000087: [Core] Use Mantis settings for determining resolved status (rombert) - resolved.
0000083: [User Interface] Rich text areas should be collapsed by default if empty (rombert) - resolved.

Version 3.0.5.200908171111 (3.0.5 final)

0000081: [Build] Remove .ui dependency on axis - resolved.
0000082: [Build] Review .core exporting axis dependency - resolved.
0000038: [Core] Cannot attach second screenshot. (rombert) - resolved.
0000050: [Core] Repository Tasks cannot be opened. "update_bug_assign_threshold" returns "Array" instead of eg 55 (rombert) - resolved.
0000069: [User Interface] Provide a filtered list for project selection (rombert) - resolved.
0000074: [User Interface] Comment replaying -- null inserting (rombert) - resolved.
0000080: [Core] Retrieve ETA values (rombert) - resolved.
0000025: [Core] Custom field support (rombert) - resolved.

Version 3.0.4.200908041309 (3.0.4 final)

0000058: [Core] Mylyn contexts are not saved to Mantis - saves 1 byte file (rombert) - resolved.
0000072: [User Interface] Can't create New Task - summary field is absent (rombert) - resolved.
0000042: [User Interface] Enable new subtask action (rombert) - resolved.
0000019: [User Interface] Provide user-friendly error messages on repository validation (rombert) - resolved.

Version 3.0.3.200906181654 (3.0.3 final)

0000071: [User Interface] Use SHORT_RICH_TEXT for summary (rombert) - resolved.
0000066: [User Interface] Query dialog offers no indication on invalid repository settings (rombert) - resolved.
0000068: [Core] Helpful message if the project has no filters (rombert) - resolved.
0000001: [Core] mc_filter_get fails when user is viewer in one project (rombert) - resolved.
0000029: [User Interface] New task - project drop-down is too large (rombert) - resolved.
0000065: [User Interface] Compact new task editor (rombert) - resolved.
0000064: [User Interface] Use transparent icons (rombert) - resolved.
0000060: [User Interface] Shorten predefined repository label (rombert) - resolved.
0000062: [User Interface] Connector not present in 'Features' (rombert) - resolved.
0000061: [User Interface] The P2 update site does not specify any categories (rombert) - resolved.
0000063: [User Interface] Descriptive names for the plug-ins (rombert) - resolved.
0000059: [User Interface] Create new query : Back + Next enables the finish button (rombert) - resolved.

Version 3.0.2.200905032011 (3.0.2 final)

0000024: [User Interface] Add 'Update Repository Configuration' button to query page (rombert) - resolved.
0000027: [Core] Provide a way to refresh repository data if configuration data is incomplete (rombert) - resolved.
0000031: [Core] Include task relations in editor (rombert) - resolved.
0000030: [User Interface] Task relations should be read-only if the task is not new (rombert) - resolved.
0000020: [Core] Migrate to Mylyn 3.1 (rombert) - resolved.
0000022: [Core] Provide repository template for the bug tracker (rombert) - resolved.
0000026: [User Interface] "Target Version" in task editor (rombert) - resolved.
0000012: [Core] Customized limit for query result set (rombert) - resolved.
0000021: [User Interface] Suggest filter name as query title (rombert) - resolved.

Version 3.0.1.200812171848 ( 3.0.1 final )

Fixed_in_version field is no longer set to 'none' if no version is selected
Support for HTTP Auth (thanks to Gregor Anders)
Mantis and Jira Connectors now work together
Allow for connections with 1.2.x Mantis repositories
Allows for usage of proxies configurable through both the global settings and the repository settings

Version 3.0.0.200808060950 ( 3.0 final )

Fixed 'Resolving issue does not set status'
Map priority and severity level (thanks to Jim Allers)
Removed duplicate jar files from core.jar ( thanks to Edward Rudd )
Fixed users with 'reporter' access level appearing in 'assign to' field

Version 3.0.0.200807281102

Fixed NullPointerExceptions on task submission/synchronization
Fixed task data not getting properly retrieved in task list
Fixed context upload/retrieve
Fixed 'Open in Browser'
Re-added sub-task support for the task list

Version 3.0.0.20080618

Initial support for Mylyn 3.x API.
Added Repository Template for Mantis 1.1.x or greater versions.
P2 enabled update site.

Prior Releases

Version 2.0.1.200805130911

New features:

Link to issues via comment ( see http://wiki.eclipse.org/index.php/Mylyn_User_Guide#Hyperlinking ) . Comment format is 'bug 1234' .

Bug fixes:

Open attachment in browser does not work
Update issue sets the version if none is previously set
Custom issue relationships are accepted, but not recognized

Version 2.0.0.v200804211112

New features:

Sub-tasks are now shown properly in the task view
Validate settings verifies the username and password against the repository

Bug fixes:

Validate settings works properly for all 1.0.x and 1.1.x versions of the Mantis connector
'Open with web browser' works
Multiple contexts may be attached to a single task
Repository attributes are updated correctly

Version 2.0.0.v20071110-1000

Task Editor: Fixed Description Box to word wrap the text.
Task Editor: Fixed Steps To Reproduce to word wrap the text.

Version 2.0.0.v20071029-2020

Performance enhancements for query synchronizations. The synchronization no longer retrieves each task one at a time to check to see if it is update, instead it runs each of the queries, and checks the Last Updated Date on the issues returned in the IssueHeader. The net effect is that it does fewer SOAP calls to the server, allowing for faster synchronization. (kingargyle1)
Fixed issue with "Could not determined changed tasks." This could happen if a query returned null or a pointer returned null to a non-existant query that was deleted in a prior connection. (kingargyle1)

Version 2.0.0.v20071017-1300

Fix issue with Resolve and adding comments. You can now add comments and resolve at the same time. (Simon and karelhenk).
Fixed issue with Mylyn dependency. Mantis Connector update site will now work with any 2.x version of Mylyn installed. (kingargyle1)

Version 2.0.0.v20070827-1300

Fix Query Wizard so that invalid queries can not be entered.
Scheduled Synchronization now correctly synchronizes when triggered by Mylyn. Synchronization speed will greatly depend on the number of issues and the network connection speed.
All Apache Commons files are now included with the download.

Known issues

Please note that several limitations in the connector can not be worked around until a fix is provided in the Mantis SOAP API:

Main Page