This page tells you how to configure your Atlassian Connector within IntelliJ IDEA. Before following the steps below, please make sure that you have installed the connector, as described in the Installation Guide.
The connector configuration panels display the version number and the SVN repository version of the Atlassian Connector that you are currently using.
The Atlassian Connector for IntelliJ IDEA stores configuration settings at two levels in IntelliJ IDEA:
On this page:
Configuring your General Options
Screenshot: General tab of the connector's IDE Settings panel
The 'General' tab is used to define the upgrade options for your connector, configure an HTTP proxy and set other options as described below.
To access the general options:
- Go to the 'IDE Settings' for the 'Atlassian Connector', by doing one of the following:
- Open the IDEA 'Settings' dialogue, then go to the 'IDE Settings' section and click the 'Atlassian Connector' icon.
- Or you can click the configuration icon on your connector window.
- Click the 'General' tab.
Automatic Upgrade
The connector's auto-upgrade feature, if enabled, will prompt you to install the most recent version of the connector when available.
To configure the connector's auto-upgrade feature:
- Put a tick in the 'Enabled (stable version)' checkbox to enable the connector auto-upgrade feature. The connector will check for the latest available stable (released) version of the connector.
- Put a tick in the 'Check snapshot versions' checkbox if the auto-upgrade should include unstable (development) versions of the connector as well as stable versions.
Manual Upgrade
To check immediately for the latest version of the connector:
- Select one of the radio buttons as follows:
- Stable only — The connector will check for the latest available stable (released) version of the connector.
- Stable + snapshot — The connector will check for the latest version, including unstable (development) versions of the connector as well as stable versions.
- Click the 'Check now' button.
For more details, refer to Upgrading the IntelliJ Connector.
HTTP Proxy
You can configure the connector to use IDEA's proxy settings or to bypass IDEA's proxy settings altogether. If the connector is using IDEA's proxy settings, you can configure the settings here too.
To use IDEA's proxy settings:
- Select the 'Use IDEA proxy settings' radio button.
- Click the 'Edit IDEA proxy settings' button. A dialogue will appear, similar to this screenshot:
- Enter the required settings and click the 'OK' button. If your proxy requires a domain name in addition to username, enter the information in the format
domain\user
. - Restart IDEA for your changes to take effect.
Direct Click Through
When the direct click through option is enabled, you can click through from Crucible to open a review directly at the relevant code line in IDEA.
Direct click through is not yet available
The direct click through feature is currently not supported by any Atlassian applications. The connector supports the feature, and so you will be able to use it as soon as Crucible or another Atlassian application supports it too.
To configure the direct click through feature:
- Check the 'Enable Direct Click Through' checkbox.
- Choose a different TCP/IP port if necessary. Note that if you change this setting, you will need to restart IDEA to apply the change. This will have the effect of starting and stopping the inbuilt HTTP server.
Collection of Statistics
Put a tick in the 'Report anonymous usage statistics' checkbox if you are happy for us to collect anonymous information on the way you use the connector. All the information we collect is anonymous and cannot be used to identify you. We do not collect any private information. We use a randomly generated unique ID to differentiate one installation from another. See Collecting Usage Statistics for the IntelliJ Connector.
Configuring a Default Username and Password
You can define a single username and password as default login credentials. You can then decide to use these default credentials for one or more of the servers that you configure for the connector.
Defining the Default Credentials (Username and Password)
There are two ways to define your default credentials:
- When you supply your credentials for a server, the connector will ask whether you want to use these credentials as the default. Click 'Yes'.
Screenshot: Popup offering to use default credentials
- Otherwise, you can define the default credentials on the 'Defaults' tab of the connector's 'Project Settings' panel:
- Open the IDEA 'Settings' dialogue.
- Go to the 'Project Settings' section and click the 'Atlassian Connector' icon.
- Click the 'Defaults' tab.
Screenshot: Defaults tab with the default credentials at the bottom
Using the Default Credentials (Username and Password)
You can use your default credentials for one or more of the servers that you configure for the connector:
- Still on the connector's 'Project Settings' panel, click the 'Servers' tab.
- Select the relevant server.
- Put a tick in the 'Use Default Credentials' checkbox.
Configuring Servers and Display Options
To configure your JIRA server connection(s): To add a JIRA server: You can add more than one JIRA server. Configuring your JIRA Server Connections
If you choose to remember the password, it is stored in a Base64 encoding, so it is not really secure.
Configuring your JIRA Options
Screenshot: Configuring JIRA server connections
Screenshot: Configuring JIRA IDE options
To configure your Bamboo server connection(s): To add a Bamboo server: You can add more than one Bamboo server. To configure your Crucible server connection(s): To add a Crucible server: You can add more than one Crucible server.Configuring your Bamboo Server Connections
If you choose to remember the password, it is stored in a Base64 encoding, so it is not really secure.Configuring your Bamboo Options
Configuring your Crucible Server Connections
If you choose to remember the password, it is stored in a Base64 encoding, so it is not really secure.
Removing a Server Connection
To remove a server from the list:
- Select the server.
- Click the minus icon on the configuration panel.
Reporting Bugs and Requesting New Features
Click the following links on the Project Settings or IDE Settings panel:
- Report Bug — This will open a bug-creation page in the connector's JIRA issue tracker. It will automatically populate the connector version number and details of the environment (Java version and vendor, OS details, build number of your IDE).
- Request Feature — This will open an issue-creation page of the 'Story' type in the connector's JIRA issue tracker. Use this issue type to request new connector functionality.
Getting Help
Click the 'Help' link on the Project Settings or IDE Settings panel. This will open the online documentation page which tells you how to configure the connector — namely, this page. From here, you can click the links to view other online documentation pages.
If you're looking for support or other help, please take a look at the links on our documentation home page.
RELATED TOPICS
Installation and Upgrade Guide for the IntelliJ Connector
Using Bamboo in the IntelliJ Connector
Using Crucible in the IntelliJ Connector
Using FishEye in the IntelliJ Connector
Using JIRA in the IntelliJ Connector