It is common for organizations today to use some kind of document management system, either on-premise or on the cloud, such as Google Drive, Box, and Dropbox.
In this recipe, we will integrate JIRA with Google Drive, so users will be able to search, link, preview, and download files stored in Google from JIRA.
For this recipe, we need to have the Google Drive in the Atlassian JIRA add-on installed. You can download it from the following link and install it with the UPM:
Perform the following steps to set up an integration between JIRA and Google Drive:
- Navigate to Administration | Add-ons | Google Configuration.
- Fill in the configuration details for Google. The most important information here is the consumer key and secret.
- Click on Save to complete the configuration setup.
- To get your Google consumer key and secret, you need to be the domain administrator for your Google account, and navigate to Security | Advanced Settings | Manage OAuth domain key.
The following table summarizes the fields on the Google Configuration page:
|
Field |
Description |
|---|---|
|
Name |
The name of the application, that is, JIRA. |
|
Description |
A short description of the application. |
|
Domain |
This is an optional parameter. By setting the domain value, such as |
|
Consumer Key |
The Google consumer key. |
|
Consumer Secret |
The Google consumer secret. |
The Google Configuration page is displayed in the following screenshot:
The Google Drive in JIRA integration uses OAuth, where each user needs to first authorize JIRA to access Google Drive on their behalf; this process is called the OAuth dance.
Once the add-on is installed and configured, there will be a new Link Google Document field under the More menu that can be seen while viewing issues. Clicking on that field will present you with a dialog to either browse or search for files stored in Google. You can then select the files you want to link by ticking the appropriate checkboxes:
After you have selected and linked the files you want, the selected files will be listed under the Issue Links section. Depending on the file type, you will be able to view, edit, and download the native Google Drive files, if you have permission.
There are many other third-party integration add-ons available that support popular cloud vendors, including the following:
- Salesforce.com: The URL is https://marketplace.atlassian.com/plugins/com.atlassian.jira.plugin.customfield.crm
- Box: The URL is http://www.appfusions.com/display/BOXJIRA/Home