1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
|
<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>Mylyn FAQ - JIRA Connector</title>
<link type="text/css" rel="stylesheet" href="../../book.css"/>
</head>
<body>
<table class="navigation" style="width: 100%;" border="0" summary="navigation">
<tr>
<th style="width: 100%" align="center" colspan="3">JIRA Connector</th>
</tr>
<tr>
<td style="width: 20%" align="left">
<a href="Bugzilla-Connector.html" title="Bugzilla Connector">
<img alt="Previous" border="0" src="../../images/prev.gif"/>
</a>
</td>
<td style="width: 60%" align="center"></td>
<td style="width: 20%" align="right">
<a href="Trac-Connector.html" title="Trac Connector">
<img alt="Next" border="0" src="../../images/next.gif"/>
</a>
</td>
</tr>
<tr>
<td style="width: 20%" align="left" valign="top">Bugzilla Connector</td>
<td style="width: 60%" align="center"></td>
<td style="width: 20%" align="right" valign="top">Trac Connector</td>
</tr>
</table><hr/>
<h1 id="JIRA_Connector">JIRA Connector</h1>
<p>If you see errors like the following, work around this by opening repository
<i>Properties Page</i> and clicking OK (bug
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=169102" target="mylyn_external">169102</a>).
</p>
<pre> org.tigris.jira.core.service.exceptions.AuthenticationException
at org.tigris.jira.internal.core.service.soap.SoapJiraService.getProjectsNoSchemes(SoapJiraService.java:204)
</pre>
<h2 id="Why_does_the_installation_fail_with_a_long_error_message.3F">Why does the installation fail with a long error message?</h2>
<p>If the error message indicates unsatisfied dependencies on Mylyn plug-ins, make sure that you have the main Mylyn update site enabled as well as the extras update site for the JIRA connector. The error message would look similar to this:</p>
<pre style="overflow:scroll">
…
Cannot find a solution where both Match[requiredCapability: org.eclipse.equinox.p2.iu/org.eclipse.swt/[3.4.1.v3449c,3.4.1.v3449c]] and Match[requiredCapability: org.eclipse.equinox.p2.iu/org.eclipse.swt/[3.4.0.v3448f,3.4.0.v3448f]] can be satisfied.
Unsatisfied dependency: [org.eclipse.mylyn.commons.soap 3.1.0.I20090109-0100-e3x] requiredCapability: osgi.bundle/org.eclipse.mylyn.commons.net/[3.1.0,4.0.0)
</pre>
<p>The update sites are listed on the
<a href="http://www.eclipse.org/mylyn/downloads/" target="mylyn_external">download page</a>.
</p>
<h2 id="What_are_the_server_requirements.3F">What are the server requirements?</h2>
<ul>
<li>JIRA 3.3.3 or higher (3.7 or higher for attachment support)</li>
<li>JIRA RPC plugin 1.4.3 or higher</li>
</ul>
<p>The
<b>JIRA SOAP/RPC services have to be running on the JIRA server</b> (set Administration → General Configuration → Accept remote API calls to ON in the JIRA web interface).
</p>
<p>Related Resources:</p>
<ul>
<li>
<a href="http://confluence.atlassian.com/display/JIRA/JIRA+Development+Hub" target="mylyn_external">Jira Development Wiki</a>
</li>
<li>
<a href="http://confluence.atlassian.com/pages/viewpage.action?pageId=1035" target="mylyn_external">Jira RPC Plugin Overview</a>
</li>
</ul>
<h2 id="Why_can.E2.80.99t_I_connect.3F">Why can’t I connect?</h2>
<ul>
<li>If you get a <code>org.tigris.jira.core.service.exceptions.ServiceUnavailableException</code> you need to turn on the JIRA SOAP/RPC services on the server.</li>
<li>Similarly, if you get a “Processing instructions are not allowed within SOAP messages” message, ensure that SOAP/RPC services are on.</li>
<li>If you get a
<b>503</b> error code verify that the SOAP/RPC interface is enabled.
</li>
<li>If you get a
<b>403</b> error code verify that the SOAP/RPC interface is enabled, and also check your authentication mechanism. If the server is using NTLM authentication, see
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=156397" target="mylyn_external">bug 156937</a> for diagnosis steps.
</li>
<li>If you see an
<b>“unrecognized priority” message</b> in the
<i>Error Log</i>, the problem is that the JIRA Connector does not support customized priorities so the priority value specified in that message will not correspond to the priority icons visible in the Task List.
</li>
<li>If you are being
<b>prompted for your log-in credentials</b> by the Browser tab of the task editor or the new task editor, this is because without rich editor support the connector is using the web-based UI instead of logging in on your behalf as is done with a rich task editor (
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=142869" target="mylyn_external">bug 142869</a>).
</li>
<li>If you get a <code>AuthenticationException</code> and a query won’t synchronize, use Task Repositories (view) → Properties (on the repository) → Validate Settings. This will clear the connection if it died.</li>
</ul>
<h2 id="Why_do_I_get_a_.E2.80.9CJIRA_connector_requires_server_3.3.3_or_later.E2.80.9D_message.3F">Why do I get a “JIRA connector requires server 3.3.3 or later” message?</h2>
<p>Version 2.0 of the JIRA connector misinterprets version 3.10 as being lower than version 3.3.3. This is fixed in version 2.1 of the connector (see below for installation instructions on Eclipse 3.2).</p>
<h2 id="What_is_the_latest_version_of_the_JIRA_connector_that_supports_Eclipse_3.2_.28IBM_Rational_Application_Developer_7.29.3F">What is the latest version of the JIRA connector that supports Eclipse 3.2 (IBM Rational Application Developer 7)?</h2>
<p>The most recent version that works on Eclipse 3.2 is Mylyn 2.0.0 and version
<i>2.1.0</i> of the JIRA connector. See
<a href="http://confluence.atlassian.com/display/JIRAEXT/Mylyn#Mylyn-e3.2" target="mylyn_external">this page for instructions</a>.
</p>
<h2 id="Why_are_attachments_missing_in_the_task_editor_although_they_are_displayed_in_the_web_interface.3F">Why are attachments missing in the task editor although they are displayed in the web interface?</h2>
<p>Attachment retrieval including retrieval of task contexts and attachment lists in the task editor requires JIRA 3.7 or above.</p>
<h2 id="Are_custom_fields_supported_by_the_JIRA_connector.3F">Are custom fields supported by the JIRA connector?</h2>
<p>Custom fields are supported with the following limitations, see {{bug|249057}} and its subtasks for additional details:</p>
<ul>
<li>Custom fields are not displayed in the task editor when creating new issues. This can cause issue creation to fail if custom fields are mandatory.</li>
<li>Custom fields that are specific to a workflow state, e.g. are only displayed when resolving an issue, are not displayed in the task editor. This can cause a workflow transition to fail if custom fields are mandatory.</li>
<li>If a value is not set for a custom field it will not be displayed in the task editor.</li>
<li>Single-select and multi-select fields are not editable and options for these fields are not displayed in the task editor.</li>
</ul>
<h2 id="Known_limitations_2">Known limitations</h2>
<ul>
<li>Attachment retrieval (including retrieval of the task context and attachment list in the task editor) require JIRA 3.7 or above (
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=169757" target="mylyn_external">bug 169757</a>)
</li>
</ul>
<p><!-- * NTLM authentication is not supported (
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=172395" target="mylyn_external">bug 172395</a>) -->
</p>
<ul>
<li>Customized priorities are not currently supported, so all issues with a customized priority will have the default priority level (
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=165518" target="mylyn_external">bug 165518</a>).
</li>
<li>blank but editable custom fields doesn’t appear in the RSS data, and as result we can’t show them for editing</li>
<li>because of JIRA api limitations, we can support custom fields in the task editor, but not in the new custom task editor</li>
</ul>
<p><!-- * On JIRA 3.6.x private filters saved on the server can fail to retrieve results (
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=174328" target="mylyn_external">bug 174328</a>). The work-around is to create a custom query in Mylyn using the form-based query designer or to share the filter in JIRA. -->
</p>
<ul>
<li>Mylyn only allows the usage of US-ASCII characters in the filename when uploading an attachment ({{bug|203663}})</li>
</ul>
<h2 id="How_can_I_enable_compression_for_SOAP_messages.3F">How can I enable compression for SOAP messages?</h2>
<p>If your repository has lots of projects and components you can speed up the download of the repository configuration by enabling compression. </p>
<ul>
<li>Add a filter-mapping to your JIRA server configuration:
<a href="http://jira.atlassian.com/browse/JRA-10353" target="mylyn_external">http://jira.atlassian.com/browse/JRA-10353</a>.
</li>
<li>Enable compression in your global JIRA configuration.</li>
<li>Check the compression setting for your task repository in Mylyn versions 2.0M2 and later.</li>
</ul>
<h2 id="Reporting_issues">Reporting issues</h2>
<p>Since JIRA can be heavily customized there is a chance that some particular customizations may not work, so if you can’t connect to your proprietary repository it is a good idea to try the following public repositories to make sure you have working configuration:</p>
<ul>
<li>
<a href="http://jira.codehaus.org" target="mylyn_external">http://jira.codehaus.org</a>
</li>
<li>
<a href="http://issues.apache.org/jira/" target="mylyn_external">http://issues.apache.org/jira/</a>
</li>
<li>
<a href="http://opensource.atlassian.com/projects/spring" target="mylyn_external">http://opensource.atlassian.com/projects/spring</a>
</li>
</ul>
<p>If you can’t get query results, you could try to call “Open with Browser” on query node in the Task List view and then save link “Current view: XML” and attach it to the bug report.</p>
<p>Even if query don’t work you could try “Open Repository Task” from your JIRA repository node on the Task Repositories view and check if you can open JIRA task editor for that issue. Same for the Task search (Ctrl-H, Task Search)</p>
<p>To investigate various error you may need to enable debug tracing. To do that you need to create the <code>.options</code> file with the following content:</p>
<pre>
org.eclipse.mylyn.jira.ui/connector=true
org.eclipse.mylyn.jira.ui/dataHandler=true
</pre>
<p>and then add the following options to the Eclipse command line (or eclipse.ini file):</p>
<pre>
-debug <path to the .options file>/.options
</pre>
<p>The additional logging will go into the regular Eclipse log and the Error Log view</p>
<h2 id="Why_do_I_get_errors_about_an_unexpected_redirect_when_submitting_an_issue.3F">Why do I get errors about an unexpected redirect when submitting an issue?</h2>
<p>Please go to the repository properties and validate the repository. If errors about circular redirects are logged in your Eclipse error log your JIRA server or proxy might be misconfigured. </p>
<p>In some cases unexpected redirects can be caused by a JIRA server accessed via Apache and mod_jk (using the AJP/1.3 Tomcat connector). Some server configurations may benefit from the ‘proxyHost’, ‘proxyPort’, ‘scheme’ and ‘secure’ settings on the AJP Connector in the Tomcat server configuration.</p>
<p>Please see {{bug|202834}} for a more details.</p>
<h2 id="What_does_.3Ccode.3EError_parsing_server_response:_No_project_with_key_.E2.80.98xyz.E2.80.99_found.3C.2Fcode.3E.3F">What does <code>Error parsing server response: No project with key ‘xyz’ found</code>?</h2>
<p>This error is caused by Mylyn not having an up-to-date copy of the repository configuration for that repository. The corresponding report to automate updating of the repository configuration is {{bug|189689}}.</p>
<p>As a work-around right-click on the query and select
<b>Repository → Update Attributes</b>. That will download and store a fresh copy of the repository configuration.
</p>
<h2 id="Why_does_the_estimated_time_displayed_in_the_task_editor_differ_from_the_web_interface.3F">Why does the estimated time displayed in the task editor differ from the web interface?</h2>
<p>Mylyn defaults to a day having 24 working hours and a week having 7 work days. If your JIRA repository uses different settings time tracking information will not show correctly when converted between Mylyn and JIRA. In order to fix this change the time tracking settings in Mylyn in the Additional Settings section of the repository properties (Window → Show View → Task Repositories) to match the server configuration. Your JIRA administrator will be able to tell you the correct settings which can be located under Administration → Time Tracking in the JIRA web interface.</p>
<p>
<img border="0" src="images/Time-tracking-jira-admin.png"/>
<br/>
<b>JIRA Web Interface</b>
</p>
<p>
<img border="0" src="images/Time-tracking-jira-mylyn.png"/>
<br/>
<b>Mylyn Task Repository Settings</b>
</p>
<h2 id="Why_am_I_getting_the_message_.E2.80.9CYou_did_not_enter_a_valid_date.E2.80.9D_when_I_try_to_submit_a_JIRA_issue.3F">Why am I getting the message “You did not enter a valid date” when I try to submit a JIRA issue?</h2>
<p>Your server may be configured to use a custom date format or a non English locale. You can change the date format settings in the Advanced Configuration section under the Additional Settings section of the repository properties (Window → Show View → Task Repositories) to match the server configuration.</p>
<p>
<img border="0" src="images/Jira-advanced-configuration.png"/>
</p>
<h2 id="How_can_I_make_issue_dependencies_visible_in_the_Task_List.3F">How can I make issue dependencies visible in the Task List?</h2>
<p>By default only subtask relationships are displayed in the Task List. You can enable
<i>Show linked tasks</i> in the Additional Settings section of the repository properties (Window → Show View → Task Repositories) to also show issue links in the Task List. After enabling the setting
<i>Synchronize All Tasks</i> from the popup menu of the task repository in the Task Repositories view needs to be selected to update all tasks. More discussion is on {{bug|255680}}.
</p><hr/>
<table class="navigation" style="width: 100%;" border="0" summary="navigation">
<tr>
<td style="width: 20%" align="left">
<a href="Bugzilla-Connector.html" title="Bugzilla Connector">
<img alt="Previous" border="0" src="../../images/prev.gif"/>
</a>
</td>
<td style="width: 60%" align="center">
<a href="FAQ.html" title="Mylyn FAQ">
<img alt="Mylyn FAQ" border="0" src="../../images/home.gif"/>
</a>
</td>
<td style="width: 20%" align="right">
<a href="Trac-Connector.html" title="Trac Connector">
<img alt="Next" border="0" src="../../images/next.gif"/>
</a>
</td>
</tr>
<tr>
<td style="width: 20%" align="left" valign="top">Bugzilla Connector</td>
<td style="width: 60%" align="center"></td>
<td style="width: 20%" align="right" valign="top">Trac Connector</td>
</tr>
</table>
</body>
</html>
|
