Project

General

Profile

HowTo Mylyn » History » Revision 29

Revision 28 (Felix Schäfer, 2010-07-13 16:01) → Revision 29/58 (Felix Schäfer, 2010-08-05 22:40)

(I got tired of scrubbing spam from this page, please "contact me":/users/3866 with the needed modifications if you spot errors. I don't use Eclipse or Mylyn myself, so all credit goes to the original authors and those that have sent modifications to me.) 

 h1. HowTo connect a Mylyn repository to Redmine 

 {{>TOC}} 

 These instructions should work with redmine 0.9 stable and up. 

 There are 2 options to connect Mylyn to redmine: either install the connector in your redmine install (this obviously needs the ability to install a plugin on the redmine you want to use it with), or use the generic web connector, which scraps the html pages for the information it needs, and thus should work with pretty much every up-to-date enough redmine installation out there. 

 h2. Using specialized Redmine-Mylyn connector 

 The "Redmine-Mylyn Connector":http://sourceforge.net/apps/mediawiki/redmin-mylyncon/index.php?title=Installation is another solution providing better integration with Mylyn. 

 h2. Using the generic web repository connector 

 "Mylyn":http://www.eclipse.org/mylyn is an Eclipse plugin for task management. 
 This HowTo explains how to connect to Redmine using the generic web repository connector. 

 Note that the generic web repository connector is not part of the default Mylyn install. 
 So, you have to install it first from the _incubator_ update site (see http://download.eclipse.org/tools/mylyn/update/incubator). 

 h3. Create a Task Repository 

 # Right-click on the task repositories list and click *Add task repository* 
 # Choose _Web Template (Advanced)_ and click *Next* 
 # Configure the repository: 

 <pre> 
 Server:                   http://www.redmine.org -- Replace it with the URL of your Redmine instance 
 Task URL:                 ${serverUrl}/issues/ 
 New task URL:             ${serverUrl}/projects/foo/issues/new -- Replace foo with the identifier of the project used for new tasks 
 Query request URL:        ${serverUrl}/issues 
 Query pattern:            <td class="subject">.*?<a href="/issues/(\d+)">(.+?)</a></td> 
 Login request URL:        ${serverUrl}/login?username=${userId}&password=${password}&authenticity_token=${loginToken} [POST] 
 Login Form URL:           ${serverUrl}/login 
 Login Token Pattern:      <input name="authenticity_token" type="hidden" value="(.+?)" /> 
 </pre> 

 Example: Example (this screenshot is somewhat outdated, you can "send me":/users/3866 a newer one if you use Mylyn, thanks): 

 p=. !mylyn-repository-properties-2.png! 

 You can replace the _Query request URL_ parameter with the following if you want to get only the issues that are assigned to you: 

   ${serverUrl}/issues?set_filter=1&assigned_to_id=me 

 The following Query pattern value reads Status, Owner and Tracker fields too (Mylyn 3.2.1) : 
 <pre> 
 <td class="tracker">({Type}.+?)</td><td class="status">({Status}.+?)</td>.+?<td class="subject">.*?<a href=".*?/issues/({Id}\d+)">({Description}.+?)</a></td><td class="assigned_to"><a href.+?>({Owner}.+?)</a></td> 
 </pre> 

 Status is read as "uncomplete" or "complete" in Eclipse. 

 h3. Create a Query 

 * On the task list, right-click and choose *New* -> *Query...* 
 * And select your newly created repository 

 p=. !mylyn-task-list.png! 

 h2. Using specialized Redmine-Mylyn connector 

 "Redmine-Mylyn Connector":http://redmin-mylyncon.wiki.sourceforge.net/Installation is another solution providing better integration with Mylyn.