JIRA Integration
Here you will find the necessary steps to integrate JIRA into your AnswerHub community and interact with JIRA as a community user.
As an Administrator
Steps 1 - 12 explain how to integrate JIRA into your community.
1. Log in to AnswerHub
First, you will need to log in to your instance of AnswerHub.
![AH_Login_Filled[1].png 1888](https://files.readme.io/2ef01ad-AH_Login_Filled1.png)
2. Navigate to the Administration Dashboard
Navigate to your Avatar and select Administration in the drop-down.
![AH_Administration_Avatar_Dropdown 2018-07-19 at 3.40.10 PM.png 1886](https://files.readme.io/e94d8ad-AH_Administration_Avatar_Dropdown_2018-07-19_at_3.40.10_PM.png)
3. Setup to View "Manage Plugins" Page
To view the Manage Plugins page, you need to make sure you are part of the Network Administrators group, otherwise, you will get a permissions error showing “Access Denied.” A Super User who grants permissions and selects groups for users can approach this in three ways: "Manage Your Site" box from the center Dashboard, "Manage: Groups" from the tree, "Manage: Users" from the tree.
![AH_Access_Denied.png 1888](https://files.readme.io/28ecc90-AH_Access_Denied.png)
If you see this screen, you are not in the Network Administrators group.
First Approach (Pick "Group" or "Users" from the center Dashboard box displaying "Manage Your Site: [Users, Groups, or Spaces]):
a. Navigate to the “Manage Your Site” box on the dashboard (highlighted in a red box in the screenshot below).
b. Select either Groups or Users. From this step, you will go the second step (step b) in the second or third approach, based on whether you chose to Groups or Users.
![AH_Dashboard_Manage_Your_Site.png 1888](https://files.readme.io/ba56d8c-AH_Dashboard_Manage_Your_Site.png)
The first approach to select Users or Groups from the Manage Your Site box.
Second Approach ("Manage: Groups" from the tree):
a. Navigate to Users & Groups > Manage > Groups in the tree, and click th Network Administrators link.
b. Check the list for your name.
c. If you are not on the list, add a new member by typing the name in the Find user field next to "Add a New Member."
d. Select the member name and it should appear in the list of members.
![AH_Manage_Groups.png 1888](https://files.readme.io/ea50d3e-AH_Manage_Groups.png)
The second approach to manage by Groups.
![AH_Manage_Group_Network_Administrators.png 1888](https://files.readme.io/07baf60-AH_Manage_Group_Network_Administrators.png)
Typing in a username to search through the Network Administrators group.
Third Approach ("Manage: Users" from the tree):
a. Navigate to Users & Groups > Manage > Users in the tree.
b. Select the user to see which groups they are a part of, or search for and then select in the drop-down.
c. Click on the Group Memberships tab once you’re looking at the user.
d. You can add a new group for the user to become a part of.
e. Type Network Administrators in the Add to a New Group field and then press Enter to make the change.
![ah-manageusers.png 1888](https://files.readme.io/ed57310-ah-manageusers.png)
The third approach to manage by Users; select a user by scrolling through the names or by searching for a user.
![AH_Manage_Users_Search.png 1888](https://files.readme.io/13ec87a-AH_Manage_Users_Search.png)
Searching for a user on the Manage Users page.
![manageUserReputation.png 1888](https://files.readme.io/04b4ce8-manageUserReputation.png)
Adding a specific user to the Network Administrators group.
![AH_User_Added_Group_Memberships.png 1888](https://files.readme.io/535837e-AH_User_Added_Group_Memberships.png)
Successful addition of the user to the Network Administrators group.
4. Navigate to "Disabled Plugins" in the Manage Plugins Page
a. Navigate to Plugins > Manage Plugins, listed below the Users & Groups category in the left-hand side tree.
If you get the “Access Denied” message, you are not part of the "Network Administration Group," which is required to view the Manage Plugins page. To become part of the "Network Administration Group," go back to step 3.
b. On the Manage Plugins page, go to the Disabled Plugins tab to see the list of disabled plugins.
![AH_Manage_Plugins_Page.png 1888](https://files.readme.io/ee90a20-AH_Manage_Plugins_Page.png)
Disabled plugins page.
5. Find "Jira API Integration Plugin" and Enable
Find the "Jira API Integration Plugin" in the list and select it, then press Enable.
![AH_Manage_Plugins_Page_Enable_JIRA_Integration.png.png 1888](https://files.readme.io/1cc41ba-AH_Manage_Plugins_Page_Enable_JIRA_Integration.png.png)
Opening a disabled plugin drop-down to see the ENABLE button.
6. Successful "Jira API Integration Plugin" Enabled
Once you enable the “Jira API Integration Plugin” you should see it in the Enabled Plugins tab.
![AH_Manage_Plugins_Page_Enabled_JIRA_Integration_Successful.png 1888](https://files.readme.io/94c59d3-AH_Manage_Plugins_Page_Enabled_JIRA_Integration_Successful.png)
The plugin you selected to enable from the disabled plugins page should now show up in the Enabled Plugins tab.
7. Refresh Themes
a. Once you have enabled the plugin, navigate to Site > Layout > Manage Themes.
b. On the Manage Themes page, press the Refresh Themes in the “Current Theme” box on the left-hand side.
![AH_Site_Layout_Manage_Themes2018-07-20 at 10.17.49 AM.png 1884](https://files.readme.io/2d5fe0a-AH_Site_Layout_Manage_Themes2018-07-20_at_10.17.49_AM.png)
Manage Themes page.
8. JIRA API Integration link available now
You should now see the JIRA API Integration link under the Site > General menu.
![AH_Succesful_Themes_Refresh2018-07-20 at 10.18.33 AM.png 1884](https://files.readme.io/a787d19-AH_Succesful_Themes_Refresh2018-07-20_at_10.18.33_AM.png)
Screenshot displaying the new JIRA API Integration menu under the Site > General menu.
9. Provide Admin User Credentials in JIRA API Integration Form
a. Navigate to Site > General > JIRA API Integration.
b. Fill in the JIRA Host URL field with your host URL and provide your JIRA username and password.
NOTE ON USERNAME AND PASSWORD:
- The Username and Password added to the admin panel for the JIRA integration must be JIRA site admin credentials.
- The Username and Password credentials that get added to the admin configuration page, is the user that DISPLAYS as the "reporter" in the JIRA ticket, for all submitted JIRA tickets from AnswerHub. On this first iteration of the plugin, we suggest using a system/general user instead of a specific user.
c. The Project Key and Issue Type fields autofill, based on the JIRA host with all existing project keys and issue types.
![JIRA API Integration 2018-07-10 at 10.10.02 AM.png 1428](https://files.readme.io/2112950-JIRA_API_Integration_2018-07-10_at_10.10.02_AM.png)
JIRA API Integration form.
NOTE:
Some project keys and issue types that auto-populate will result in an error message stating, "Your ticket was unable to be submitted, please try again or contact an administrator."
You will need to select a different project key and/or issue type for the ticket to send through. We cannot provide a list of project keys and issue types that won't work due to it depending on the JIRA Host URL provided.
10. Create the Custom Role (Only for versions prior to 2.x.x)
For AnswerHub Version 2.x and later, the Jira control role already exists, so skip ahead to step 11.
To show Submit to Jira option on the menu gear icon for any question body page, you need to provide a custom role in your admin dashboard.
a. 1.6.5, 1.6.6: Navigate to Admin Dashboard > Users & Groups > Custom Roles, then add the custom role.
- Must add "ROLE_SUBMIT_JIRA_TICKET" for the Name field and "Submit Jira Ticket" for the Label field. (only required for the first time making the custom role).
b. 1.8.x / 1.9 versions : Navigate to Admin Dashboard > Users & Groups > Manage > Custom Roles, then add the custom role if the role is not already found in the custom roles section. - Must add "ROLE_SUBMIT_JIRA_TICKET" for the Name field and "Submit Jira Ticket" for the Label field. (only required for the first time making the custom role).
![AH_Add_Custom_Role.png 1888](https://files.readme.io/7b51558-AH_Add_Custom_Role.png)
Creating your custom role under "Add Custom Role" on the right-hand side of the page.
![AH-custom-role-new-type-added.png 1888](https://files.readme.io/85cbd7c-AH-custom-role-new-type-added.png)
Successful creation of the custom role, "ROLE_SUBMIT_JIRA_TICKET."
11. Grant Access or Grant by Reputation for the New Custom Role
a. After creating the Custom Role, navigate to Users & Groups > Manage > Users.
b. Navigate to the specific user.
c. Navigate to the wrench and select Permissions.
d. Navigate to "Site Permissions" and click on the wrench.
e. Select Advanced and then select the Custom Roles drop-down.
f. You can either grant this custom role or set it by reputation:
- Grant Access: Select Grant from the drop-down to the Submit JIRA Ticket custom role you created earlier.
NOTE:
Once you create the custom role, you don't need to create it again, you just need to grant access to it for other users who want to use the JIRA Integration.
- Grant by reputation: Select By reputation and insert a numerical value to serve as the threshold that would unlock the ability to submit JIRA tickets.
![AH_Manage_Users_Search.png 1888](https://files.readme.io/cdcc355-AH_Manage_Users_Search.png)
Searching for a user to grant them the custom role permission.
![JIRA_Admin_Advanced_Site_Permissions_Grant_Custom_Role 2018-08-21 at 4.56.40 PM.png 1865](https://files.readme.io/606fbf2-JIRA_Admin_Advanced_Site_Permissions_Grant_Custom_Role_2018-08-21_at_4.56.40_PM.png)
Granting the custom role permission for the user you selected.
![JIRA_Admin_Custom_Role_Granted 2018-08-21 at 4.57.01 PM.png 1868](https://files.readme.io/0baf008-JIRA_Admin_Custom_Role_Granted_2018-08-21_at_4.57.01_PM.png)
Custom role permission granted and saved successfully.
12. Receive Status Updates by Setting Up Your WebHook
To receive status updates from JIRA for your linked tickets, you will need to set up the WebHook.
For the URL, enter https:///jira/webhook/notifications.
As a Community User
To use the new JIRA integration as a community user, follow the steps below.
How to Submit a JIRA Ticket from a Question
We added a new AnswerHub command, called “Send To JIRA,” for questions.
a. You can access the new option from an AnswerHub question by pressing the menu gear icon.
![JIRA_UI_Send_To_JIRA 2018-08-21 at 4.07.05 PM.png 1920](https://files.readme.io/27566c5-JIRA_UI_Send_To_JIRA_2018-08-21_at_4.07.05_PM.png)
User Community Interface view of the new "Send to Jira" option.
b. A modal window with a form to fill out pops up to "Submit a ticket to JIRA."
![JIRA_UI_Submit_Ticket_Modal 2018-08-21 at 4.07.23 PM.png 1920](https://files.readme.io/1edfe88-JIRA_UI_Submit_Ticket_Modal_2018-08-21_at_4.07.23_PM.png)
Form to fill out to submit a ticket to JIRA.
![JIRA_Submission_Notice_Modal 2018-08-21 at 4.07.30 PM.png 1920](https://files.readme.io/abf247e-JIRA_Submission_Notice_Modal_2018-08-21_at_4.07.30_PM.png)
Successful submission of the form to send to JIRA and create a ticket.
c. A successful JIRA submission will result in a new link to the right of the question box.
![JIRA_View_UI_Linked_Ticket_Submitted 2018-08-21 at 4.07.43 PM.png 1920](https://files.readme.io/83f7e21-JIRA_View_UI_Linked_Ticket_Submitted_2018-08-21_at_4.07.43_PM.png)
Community User Interface view of the "JIRA Ticket Information" and link to the submitted ticket. The User can see the status of the ticket, here it is "Submitted."
![JIRA_View_UI_Linked_Ticket_In_Progress 2018-08-21 at 4.08.24 PM.png 1920](https://files.readme.io/cf853a9-JIRA_View_UI_Linked_Ticket_In_Progress_2018-08-21_at_4.08.24_PM.png)
The status has updated to "In Progress" and the user can see this status change in the Community User Interface.
Updated over 3 years ago