Jira Federated Search Connector

This article outlines what the Jira Federated Search Connector is, and includes steps on how to install and authorize the Search Connector.

What is it?

Jira is an issue-tracking tool created by Atlassian that enables agile project management and bug monitoring.

Jira Federated Search Connector allows you to search content in Jira from your Happeo Search Bar.

The features of the Search Connector include:

• Jira results show in your Search Suggestions
• Adds a new Search Tab for Jira results
• Allows you to use specific Jira filters 
• Clicking on a Search Result will open Jira in your browser

Scope of permissions

With access to your Atlassian (Jira) account, Happeo’s Jira Search Connector can:

• View user information in Jira that you have access to, including usernames, email addresses, and avatars
• Read Jira project and issue data, search for issues, and objects associated with issues like attachments and work logs

How to install

To install the Jira Federated Search Connector, as an Admin, you can:

1. Navigate to the Admin Settings by clicking your Happeo avatar and selecting Admin Settings
2. Click Apps
3. Select (or search for) the Jira Search Connector
4. Click Add to Happeo
5. Once you’ve clicked Add to Happeo, you will receive a notification stating that you’ve installed the Search Connector successfully. To finalize this process, you will need to enable the Search App in the Search Settings. You can click Take me there within the notification to complete this process
1. If you don’t receive a notification, you can also select the Search tab within the Admin Settings
6. Within the Search tab, find the Jira Search Connector and toggle the options you wish to have enabled. You can choose between / both:
1. Show in search (full search overview)
2. Show in search predictions (search bar autocomplete)

How to uninstall

Uninstalling the Jira Federated Search Connector is simple! 

As an Admin, you can navigate to the:

1. Admin Settings (by clicking your avatar)
2. App
3. Click the Jira Search Connector
4. Select Uninstall
5. Click Yes, uninstall

How to authenticate

Once the Jira Search Connector has been successfully installed, regular users must authenticate the app. 

As a regular user, to authenticate the app, you can:

1. Type in what you are looking for in Happeo’s Search Bar and hit Enter
2. On the left side of the page, you will see a list of apps enabled by your platform admin. Click Jira
3. A message will appear indicating that you have not authorized the app. Click Authorize and follow the instructions
4. Once you have logged in and authorized the app, you can go to Happeo and refresh the page. You should now be able to view Search Results in both the Search Predictions and the Search Overview for Jira (depending on what the platform Admin has enabled in terms of the Search App Settings)

Now, you can search for any query in Happeo’s search menu, showing the results from all the available and authorized applications. By clicking the Jira icon when searching for something in the Search Bar, the auto-suggestions from this app will be displayed.

Filtering options

You can narrow down the search results by different filter options such as:

• Issue Status
• Issue Type
• Issue Label
• Issue Priority
• Project

Video tutorial on how to install, manage and uninstall