Configuring the Eclipse Connector

1. On the Eclipse 'Add Task Repository' screen, select the 'JIRA' task repository type and click 'Next'.
2. The 'JIRA Repository Settings' screen appears, as shown below:
   
   
   
3. 以下の情報を入力します：
   • Server — The location (URL) of your JIRA server.
   • Label — A descriptive name for your JIRA server, e.g. 'JAC'.
   • Disconnected — If necessary, you can tick this checkbox to disable a particular server without deleting it. This is useful if your servers are behind a firewall and you do not have access to them at a particular point in time.
   • User ID — The username you use to connect to your JIRA server.
   • Password — Your password on the JIRA server, matching the above username.
   • Save Password — Put a tick in the checkbox if you want to save your password on disk. Leave the checkbox unticked if you want to be asked for a password every time you start your IDE.
     If you choose to save the password, it is stored on your computer in a file that is difficult, but not impossible, for an intruder to read.
4. If necessary, you can change the additional settings. If in doubt, leave these settings as set by default.
   • The 'Task Editor Settings' section is used to configure the markup language used by the task editor when Mylyn's WikiText extension is installed. By default, the Atlassian Connector for Eclipse will set the markup language to 'Confluence', so that WikiText recognizes Confluence wiki markup as used by JIRA. See the Mylyn WikiText User Guide for more information.
5. Click 'Finish' to save the changes.
6. Eclipse Mylyn will prompt you to add a new query for the new JIRA repository. This is where you will choose your JIRA filter, to determine which issues appear in your task list. You can do this now or skip this step and do it later. You can also add more queries later.
7. The new task repository appears in your Eclipse 'Task Repositories' view. Your JIRA issues will appear in your 'Task List' view.

You can configure one or more JIRA repositories, i.e. you can connect to more than one JIRA server.

If Validate Settings fails, please make sure Remote API is ON on the JIRA side.

1. On the Eclipse 'Add Task Repository' screen, select the 'Bamboo' task repository type and click 'Next'.
2. The 'Bamboo Repository Settings' screen appears, as shown below:
   
   
   
3. 以下の情報を入力します：
   • Server — The location (URL) of your Bamboo server.
   • Label — A descriptive name for your Bamboo server, e.g. 'Bamboo Extranet'.
   • Disconnected — If necessary, you can tick this checkbox to disable a particular server without deleting it. This is useful if your servers are behind a firewall and you do not have access to them at a particular point in time.
   • User ID — The username you use to connect to your Bamboo server.
   • Password — Your password on the Bamboo server, matching the above username.
   • Save Password — Put a tick in the checkbox if you want to save your password on disk. Leave the checkbox unticked if you want to be asked for a password every time you start your IDE.
     If you choose to save the password, it is stored on your computer in a file that is difficult, but not impossible, for an intruder to read.
4. Click the 'Refresh' button to verify the information you have entered. The connector will attempt to connect to the Bamboo server. It will also retrieve the latest list of build plans from the Bamboo server.
5. Select the plans that you want the connector to watch. You can either select the plans individually or you can click the 'Favorites' button to choose your favorite plans as defined on the Bamboo server.
6. Click 'Finish' to save the changes.
7. The new task repository appears in your Eclipse 'Task Repositories' view.
8. If necessary, you can now you can adjust the Bamboo settings.
   • Select 'Window', 'Preferences' then open the Bamboo settings panel as shown below:
     
     
     
   • Enter the 'Auto Refresh Interval Rate'. This is the number of minutes that the connector will wait between calls to fetch new information from your Bamboo server, when the connector is set to refresh automatically.
   • Tick or untick the 'Refresh Automatically' checkbox. Untick this option if you do not want the connector to poll the server automatically. In that case, you will need to refresh you Bamboo information manually by synchronizing the Bamboo task repository.
9. Next step: To see your Bamboo builds, open the 'Bamboo' view. (Select 'Window', 'Show View', 'Other', then open the 'Atlassian' folder.)

You can configure one or more Bamboo repositories, i.e. you can connect to more than one Bamboo server.

1. On the Eclipse 'Add Task Repository' screen, select the 'Crucible' task repository type and click 'Next'.
2. The 'Crucible Repository Settings' screen appears, as shown below:
   
   
   
3. 以下の情報を入力します：
   • Server — The location (URL) of your Crucible server.
   • Label — A descriptive name for your Crucible server, e.g. 'Extranet Crucible'.
   • Disconnected — If necessary, you can tick this checkbox to disable a particular server without deleting it. This is useful if your servers are behind a firewall and you do not have access to them at a particular point in time.
   • User ID — The username you use to connect to your Crucible server.
   • Password — Your password on the Crucible server, matching the above username.
   • Save Password — Put a tick in the checkbox if you want to save your password on disk. Leave the checkbox unticked if you want to be asked for a password every time you start your IDE.
     If you choose to save the password, it is stored on your computer in a file that is difficult, but not impossible, for an intruder to read.
4. Click the 'Validate Settings' button to verify the information you have entered.
5. Choose a 'Review Activation' setting. These settings determine what happens when you open a source code file from within the Crucible review editor in Eclipse. For example, you may open a Crucible review within Eclipse. The review will open in an Eclipse editor view, and its 'Review Files' section will show the files in the review. You can then click a file to open it in an Eclipse editor. The options are as follows:
   • 'Always' — The Crucible review will be automatically activated if you open a file from the Crucible review editor.
   • 'Never' — The Crucible review will never be automatically activated.
   • 'Prompt' (default) — When you open a file from the Crucible review editor, the connector will ask you whether you want to activate the Crucible review. This is the default setting.
6. If your Crucible server is linked to a FishEye server:
   • Put a tick in the checkbox labeled 'Crucible Server Contains FishEye Instance'.
   • Set up your FishEye mappings, as described in the FishEye section of this documentation.
7. Click 'Finish' to save the changes.
8. Eclipse Mylyn will prompt you to add a new query for the new Crucible repository. This is where you will choose your Crucible filter, to determine which reviews appear in your task list. You can do this now or skip this step and do it later. You can also add more queries later.
9. The new task repository appears in your Eclipse 'Task Repositories' view. Your Crucible reviews will appear in your 'Task List' view.

You can configure one or more Crucible repositories, i.e. you can connect to more than one Crucible server.

If you do not have a Crucible server, you can hook up your FishEye server as an Eclipse task repository without the additional Crucible functionality.

1. On the Eclipse 'Add Task Repository' screen, select the 'FishEye' task repository type and click 'Next'.
2. The 'FishEye Repository Settings' screen appears, as shown below:
   
   
   
3. 以下の情報を入力します：
   • Server — The location (URL) of your FishEye server.
   • Label — A descriptive name for your FishEye server, e.g. 'FishEye Atlassian Developer'.
   • Disconnected — If necessary, you can tick this checkbox to disable a particular server without deleting it. This is useful if your servers are behind a firewall and you do not have access to them at a particular point in time.
   • User ID — The username you use to connect to your FishEye server.
   • Password — Your password on the FishEye server, matching the above username.
   • Save Password — Put a tick in the checkbox if you want to save your password on disk. Leave the checkbox unticked if you want to be asked for a password every time you start your IDE.
     If you choose to save the password, it is stored on your computer in a file that is difficult, but not impossible, for an intruder to read.
4. Click the 'Validate Settings' button to verify the information you have entered.
5. Click 'Finish' to save the changes.
6. The new task repository appears in your Eclipse 'Task Repositories' view.
7. Now you need to map your source code to your FishEye repository and FishEye project.
   • Select 'Window', 'Preferences' then open the 'Repository Mappings' panel as shown below:
     
     
     
   • Click the 'Add' button to add a new mapping. The 'Add Mapping' screen appears, as shown below:
     
     
     
   • Enter the 'SCM Path' — Supply the path to your source code as used locally by the project.
   • Select the FishEye/Crucible 'Server' as configured in your task repositories. (See instructions above.)
   • The connector will retrieve a list of FishEye repositories from the server you have supplied. Select the appropriate 'Source Repository' to map your local project to the FishEye repository.

Some notes about the FishEye integration:

• You can configure one or more FishEye repositories, i.e. you can connect to more than one FishEye server.
• We have chosen to configure FishEye servers as standard Mylyn task repositories. They are not really regular repositories like JIRA or Crucible, because there are no tasks associated with a FishEye task repository. We are using the task repository concept to take advantage of various infrastructural facilities available in Mylyn and to make user experience more consistent with the rest of the Atlassian products. See More about Configuring FishEye Repositories in Eclipse.