Jump to: navigation, search

Difference between revisions of "Mylyn/JIRA Connector"

Line 1: Line 1:
 
[[Category:Mylyn]]  
 
[[Category:Mylyn]]  
  
== Info ==
+
The [http://tasktop.com/blog/eclipse/mylyn-jira-connector-moving Mylyn JIRA Connector has moved] to Atlassian. The Atlassian JIRA connector can be installed from the update site below.
* [[Mylar FAQ#JIRA_Connector | JIRA Connector FAQ]]
+
* [https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&classification=Tools&product=Mylyn&component=Jira&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&cmdtype=doit  Open Bugs]
+
  
== Themes ==
+
If the Mylyn JIRA connector is already installed it will be disabled and replaced by the Atlassian JIRA connector during the installation. It is not necessary to uninstall the Mylyn JIRA connector.
  
Themes for the [[Mylyn 3.0 Plan | Mylyn 3.0]] and Eclipse Ganyemede release cycle.  Listed in order of priority.
+
* Update Site: http://update.atlassian.com/atlassian-eclipse-plugin/
 +
* Documentation: [http://confluence.atlassian.com/display/IDEPLUGIN/Atlassian+Connector+for+Eclipse User Guide]
  
* '''Support the user community''': Maintain responsiveness to and prioritization of the [https://bugs.eclipse.org/bugs/buglist.cgi?short_desc_type=allwordssubstr&short_desc=&product=Mylar&component=Jira&long_desc_type=allwordssubstr&long_desc=&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailtype1=substring&email1=&order=Importance open bugs].
+
* Bug Reports: [https://studio.atlassian.com/browse/PLE https://studio.atlassian.com/browse/PLE]
 +
* Support: [https://support.atlassian.com/https://support.atlassian.com/]
  
* '''Improve Test Suite''':  Unit test coverage is currently inadequate and should match that of the Bugzilla and Trac connectors.
+
== Development ==
  
* '''Extend Rich UI''': Need support for additional features such as custom attributes, issue history, votes and watches.
+
* Source Code: [https://studio.atlassian.com/svn/PLE/ https://studio.atlassian.com/svn/PLE]
  
* '''Integrate time tracking''':  Mylyn provides task timing values and these should be integrated with JIRA time and scheduling ({{bug|173880}}).
+
== Integrating ==
  
* '''Enhance workflow integration''':  Support workflows beyond comment/attribute/attachment submission.
+
The Atlassian update site distributes a feature and plug-in that with the same bundle ids as the Mylyn JIRA Connector (org.eclipse.mylyn.jira_feature) but with a higher version (3.4.0) than the latest available release of the Mylyn JIRA Connector. The stubs do not contain classes or extension points and effectively disable the Mylyn JIRA Connector.
  
* '''Improve comment display and editing''': Support for HTML display, editing, and visibility.
+
In order to integrate with the Mylyn JIRA Connector the following version constraints needs to be specified in the manifest:
  
* '''Improve representation of subtasks and dependencies'''Associations between tasks should be visible and navigable from the task editor.
+
Require-Bundleorg.eclipse.mylyn.jira.core;bundle-version="[3.3.2,3.4.0)",
 +
  org.eclipse.mylyn.jira.ui;bundle-version="[3.3.2,3.4.0)"
  
* '''Improve documentation''':  User guide and FAQ should be updated and include screenshots.
+
Features should specify an equivalent version match:
  
 
+
<import feature="org.eclipse.mylyn_feature" version="3.3.2" match="equivalent"/>
== JIRA Remote API Needs ==
+
  
=== Critical ===
+
* Archive update site of last Eclipse.org relase: download.eclipse.org/tools/mylyn/update-archive/3.3.2/v20100222-0100/extras
 
+
The following are needed for the completeness or correctness of connector behavior.
+
 
+
<s>
+
* Retrieve available workflow actions and operations for issue (based on issue type, status, current user etc).
+
** JonathanNolen: IssueServiceImpl.getAvailableActions() already exists, according to the docs. Will this work?
+
** SteffenPingel: That has been implemented and works.
+
</s>
+
 
+
* Retrieve all details about custom fields from the project configuration, including values of select/multi-select/radio fields and mandatory fields required for creating new issue.
+
** JonathanNolen: Can't find this in the docs, may need to be developed.
+
** EK: we also need to know if field is not supposed to be shown and/or edited in the UI
+
 
+
* Retrieve available actions for each comment (edit, delete, change visibility etc) and required metadata (i.e. list of values for selecting who can see comment).
+
** JonathanNolen: Getting available actions on the comments doesn't seem to be available, may need to be developed. On the other hand, the JIRA API will only return to you comments that are visible by the user making the request. It shouldn't be something that Mylar needs to determine on its own.
+
** EK: yes, but when we are adding comment we need to set visibility and for those visible comments it would be a good idea to show to whom that comment is addressed to.
+
 
+
* Investigate if the performance of queries can be improved. It seems that results in XML format are delivered much slower than query results in the web interface ({{bug|196288}})
+
 
+
* Investigate the overhead/performance of the XML-RPC vs. SOAP interface ({{bug|205963}}) to reduce the load on JIRA repositories.
+
 
+
=== High Priority ===
+
 
+
The following are needed for the completeness of the rich UI.
+
 
+
* Retrieve and update dependencies, links and subtasks (links, etc should be present on the Issue object)
+
 
+
* Retrieve and update votes (number of votes and whether or not the current user has voted should be present on the Issue object)
+
 
+
* Update watch/CC status of the issue given the current user (should be present on the Issue object)
+
 
+
* Update watch/unwatch status of an issue during an update by setting/unsetting the watched flag on the issue (allows us to reassign an issue, but continue to watch it with one call)
+
 
+
* Retrieve issue history
+
 
+
* Update time tracking info
+
 
+
* Retrieve and update attachments
+
 
+
=== Low Priority ===
+
 
+
The following will enhance the user experience or connector implementation.
+
 
+
* Service to get wiki macro details (for rich text editing and autocompletion)
+
** Is it a block macro
+
** Does it have parameters, if so, what values are possible
+
 
+
* Service to get RPC api version (need to call this before calling anything else) - could be added to the existing getServerInfo service
+
** We actually need to support RPC plugin versions, not Jira versions.  Currently we just guess the rpc version based on the Jira version
+
 
+
* Retrieving screen layouts given issue type, project and action (for editing custom fields on workflow transition)
+
 
+
* Submitting query/filter and only getting keys back (not issues+comments).
+
 
+
* Service to get issue summaries (everything but the comments) given a set of issue keys (for populating search results page at a time)
+
 
+
* Service to get all server configuration at once (Projects/Components/Versions)
+
 
+
* Service to get server "customization" settings (is voting enabled, attachments allowed, etc...) - currently admin only
+
** This is needed to disable operations that are not enabled on the server
+
 
+
* Service to get all 'meta' information at once (issue types, issue statuses, ProjectCategory, etc) - any configurable objects that apply across projects
+
 
+
* Project object should say what category it belongs to (if any)
+
 
+
* Service to search for issues - model this after the core services search method? ie. object based query
+
 
+
** Allow searching by voting and watch status (I don't think these are currently stored in the GenericValue object, so aren't indexed by Lucene)
+
** Allow searches to be saved as named queries
+
 
+
* Service to search for users - like the issue search, just return IDs and let the caller get the details
+
 
+
* Service to search for groups
+
 
+
* Provide all services in wrapped doc/literal format to be WS-I compliant.  Some toolkits such as XFire only support Doc/Literal web services
+

Revision as of 08:22, 23 February 2010


The Mylyn JIRA Connector has moved to Atlassian. The Atlassian JIRA connector can be installed from the update site below.

If the Mylyn JIRA connector is already installed it will be disabled and replaced by the Atlassian JIRA connector during the installation. It is not necessary to uninstall the Mylyn JIRA connector.

Development

Integrating

The Atlassian update site distributes a feature and plug-in that with the same bundle ids as the Mylyn JIRA Connector (org.eclipse.mylyn.jira_feature) but with a higher version (3.4.0) than the latest available release of the Mylyn JIRA Connector. The stubs do not contain classes or extension points and effectively disable the Mylyn JIRA Connector.

In order to integrate with the Mylyn JIRA Connector the following version constraints needs to be specified in the manifest:

Require-Bundle:  org.eclipse.mylyn.jira.core;bundle-version="[3.3.2,3.4.0)",
 org.eclipse.mylyn.jira.ui;bundle-version="[3.3.2,3.4.0)"

Features should specify an equivalent version match:

<import feature="org.eclipse.mylyn_feature" version="3.3.2" match="equivalent"/>
  • Archive update site of last Eclipse.org relase: download.eclipse.org/tools/mylyn/update-archive/3.3.2/v20100222-0100/extras