Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Mylyn/JIRA Connector"

(Critical WS API needs)
 
(13 intermediate revisions by 7 users not shown)
Line 1: Line 1:
[[Category:Mylar]]  
+
[[Category:Mylyn]]  
  
== Info ==
+
Atlassian has ended support for the Atlassian JIRA connector See [https://developer.atlassian.com/blog/2015/06/discontinuing-ide-connectors-support/ this blog post] for more details.
* [[Mylar FAQ#JIRA_Connector | JIRA Connector FAQ]]
+
* [https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&classification=Technology&product=Mylar&component=Jira&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&cmdtype=doit  Open task in Bugzilla]
+
  
== Critical WS API needs ==
+
== Information for Integrators ==
  
The following are needed for the completeness or correctness of connector behavior.
+
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.
  
* Retrieve available workflow actions and operations for issue (based on issue type, status, current user etc).
+
Extensions that integrate with the Mylyn JIRA Connector need to specifiy the following version constraints in the manifest:
** JonathanNolen: IssueServiceImpl.getAvailableActions() already exists, according to the docs. Will this work?
+
* Retrieve all details about custom fields from the project configuration, including values of select/multiselect/radio fields and mandatory fields required for creating new issue.
+
** JonathanNolen: Can't find this in the docs, may need to be developed.
+
* 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.
+
  
== High Priority WS API needs ==
+
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)"
  
The following are needed for the completeness of the rich UI.
+
Features should specify an equivalent version match:
  
* Retrieve and update dependencies, links and subtasks (links, etc should be present on the Issue object)
+
<import feature="org.eclipse.mylyn_feature" version="3.3.2" match="equivalent"/>
  
* Retrieve and update votes (number of votes and whether or not the current user has voted should be present on the Issue object)
+
The latest release of the Mylyn JIRA Connector is available from this archive update site: archive.eclipse.org/mylyn/drops/3.3.2/v20100222-0100/extras
 
+
* 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
+
 
+
== Lower Priority WS API needs ==
+
 
+
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
+
 
+
== Tasks ==
+
 
+
* key JIRA Connector [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 bugs fixes]
+
* unit test suite to match that of Bugzilla & Trac
+
* <s>attachment and context sharing support (may need WS enhancement)</s>
+
* jira-specific comment management. i.e. delete, specify who can see it (may need WS..)
+
* show issue dependencies/linking/subtasks in task editor and Task List
+
* documentation and articles
+
 
+
* support for custom attributes (need WS enhancements)
+
* workflow enhancements, time tracking integration
+
* vote and watch support (may need WS enhancements)
+
* support display of issue change history (may need WS enhancement)
+

Latest revision as of 01:04, 21 February 2018


Atlassian has ended support for the Atlassian JIRA connector See this blog post for more details.

Information for Integrators

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.

Extensions that integrate with the Mylyn JIRA Connector need to specifiy the following version constraints 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"/>

The latest release of the Mylyn JIRA Connector is available from this archive update site: archive.eclipse.org/mylyn/drops/3.3.2/v20100222-0100/extras

Back to the top