Integrating The Older Version Of The EZO App With Your Jira Service Desk

EZO integrates with the Jira Service Desk so you can streamline issue tracking and lower administrative burdens.

This post demonstrates the setup for an older version. We recommend using the newer EZO for Jira App; read the download guide here.

1. Installation Process

For the integration to work, ensure that the Account Owner in EZO is also an Admin in your Jira Service Desk. 

1. Install the EZO App from the Atlassian Marketplace.
2. Traverse to an issue in your Jira Account. The EZO App will be displayed in the pane on the right. You will see a settings page that will ask for the following:
   – Your EZO Subdomain with the host i.e. “business.ezofficeinventory.com”.
   – Your ‘Secret key’; get it from Settings → Add Ons → API Integration from your EZO Account. It will look like ““de2fce1ad683976d2f515d0876027994””.
3. Next, log in to your EZO Account to enable the Jira Integration Add On. Go to Settings → Add Ons → Integrate Jira. Press the ‘Connect to Jira’ button. 
4. This action will require integration permissions that are provided via Atlassian. For this purpose, you will be redirected to Atlassian.
5. Select your Atlassian Account from the dropdown and allow the permissions. Click ‘Accept’.
6. That’s it! The integration is complete. You will be taken back to EZO.

2. Choosing Asset Attributes

You can also choose the Asset Attributes to show over Jira. In order to do this, go to Settings –> Add Ons –> Integrate Jira from your EZO Account. Click ‘Choose Attributes’.

A new dialog will prompt you to make your attribute selections. Once done, click on ‘Save this view’ to save the changes.

3. How the Integration Works

For every issue in Jira, you’ll find the EZO App on the right-side pane. Click on ‘Open EZO’ to expand the app window. With every issue, you will see:

• The reporter and a link to their EZO profile
• A link to the assets checkout out to said reporter
• A link to the assets reserved by the said reporter
• All items checked out to the reporter with their attributes.

3.1. Linking Assets with issues

Use the app to link issues with assets. Items checked out to the concerned reporter will be displayed in the app window. Based on the issue description, the current user will scroll through their list and link relevant items to the issue.

You can also link other items with the issue that aren’t checked out to the reporter. At the bottom of the app window, there’s a ‘Link other assets to this issue’ button.

Additionally, you can look up items by asset name, asset# or AIN.

3.2. Navigating to EZO’s Item Details Page

All assets on this right-side pane are clickable. Clicking on the asset name in Jira will open a tab in EZO – the Items Detail Page.

From the Item Details Page in EZO, scroll down and you’ll see a tab for all the relevant Jira Issues.

4. Troubleshooting

Error 1: The reporter <your email address> doesn’t exist under Members in EZO. Make sure EZO has the correct email address

Solution: You must be the Account Owner in EZO and an administrator in Jira. Ensure that you’re using the same email in both the applications.

Error 2: We couldn’t find your profile <your email address>. Make sure you have the correct email address under members in EZO.

Solution: Jira users should exist as members in EZO for them to be able to report an issue.

Error 3: There was a problem accessing data.

Solution: To fix, go to your Jira Account and update the settings in the EZO App.

Note: Existing data will NOT be impacted by the resetting of the connection.