This integration requires
- A subscription to Jira Service Desk
- A subscription to EZOfficeInventory
- EZOfficeInventory App from Atlassian Marketplace
This guide outlines the setup and workflows for our new EZOfficeInventory for Jira App. If you’re using an older version, read this quick guide for setup instructions and troubleshooting.
How does this integration complement EZOfficeInventory?
This integration provides support and ticketing capabilities that sync directly with the EZOfficeInventory asset tracking app.
1. Need for the integration
Companies using an IT service desk have to track dozens of tickets simultaneously to fend off delays in company tasks. Most IT service desks aren’t equipped to handle asset details in a comprehensive manner and thus, cross-referencing items with issues becomes a burden that keeps on stacking.
But imagine being able to extract all relevant asset details needed to resolve an issue without having to even switch between browser windows! EZOfficeInventory’s integration with the Jira Service Desk Cloud Instance ensures that all asset-related issues are resolved promptly. With quick issue resolution, you lower equipment downtime so your company’s productivity never falters.
2. Complete issue overview
Integrating EZOfficeInventory with Jira enables teams to quickly identify tasks at hand, issues associated with each item, and useful details such as item location and AINs.
With this integration, you can:
- Directly view the Assets and reporter linked with an issue in Jira. This helps employees quickly view relevant Asset details to understand the problem areas in depth. They can also associate additional items as per the requirements of the issue. Consequently, this enables more precise and thorough issue management.
- Track all Jira Issues related to an item directly from the Item Details Page in your EZOfficeInventory Account. A Jira Issues tab on the page references all the issues for the item so EZOfficeInventory users can easily view all relevant issues.
With a complete overview of issues, users can record equipment details,
Use our new integration to iron out operational workflows and cut down on repair time for a more productive office environment.
3. Common workflows
- An employee notices a broken printer and creates an issue for it. EZOfficeInventory tracks Asset details for the printer and Jira tracks the issue workflow.
- An on-field technician requires help with operating a forklift. The current user quickly views the issue on Jira and pulls the Asset details for the user.
- A customer requests memory extension for their laptop. The IT Helpdesk looks up the issue on Jira, pulls up the Asset details for the said laptop from EZOfficeInventory and identifies the upgrade required. All prior issues related to the laptop are also visible.
- An engineer wants to understand the maintenance requirements for your HVAC unit. He quickly pulls all the relevant issues for the unit from your EZOfficeInventory Account.
- An IT manager wants to update a software solution on all company laptops. She creates the issue on Jira and links all company machines to it. Employees in charge will pull up Asset details for all laptops from the service desk and carry out the updates. The issue will be tracked via Jira.
4. Installation process
Follow these steps to install and integrate Jira with EZOfficeInventory.
Note: For the integration to work, ensure that the Account Owner in EZOfficeInventory is present as an Admin in Jira. Ensure this is the case before you try integrating the two applications.
4.1. Install EZOfficeInventory For Jira Service Desk
First, set up the EZOfficeInventory App from your Jira Account.
1. Get EZOfficeInventory For Jira Service Desk from the Atlassian Marketplace and install it.
2. From your Jira Account, head to Settings –> Apps –> Manage Apps. You’ll find EZOfficeInventory under User-installed Apps.
3. Hit the configure button and fill in the data fields with the following:
- Your EZOfficeInventory Subdomain with the host i.e. “businessxyz.ezofficeinventory.com”.
- Your ‘Secret key’. Get it from EZOfficeInventory Settings → Add Ons → API Integration. It will look like “de2fce1ad683976d2f515d0876027994”.
Click ‘Save’. Now, a new Asset Container should be accessible in your Jira Service Desk. This will indicate that all your Asset and Asset Stock Items have synced to Jira (we don’t sync Inventory).
If you don’t see the Asset Container in your issues, learn how to add an asset field manually to Jira.
4.2. Enable the Jira integration
Next, enable Jira from EZOfficeInventory. Note that only Account Owners in EZOfficeInventory have permission to do this.
2. This action will require integration permissions that need to be provided by Atlassian. You will be redirected to Atlassian.
3. Select your Atlassian Account from the ‘Authorize for’ dropdown. Click ‘Accept’ and allow access to EZOfficeInventory.
That’s it! The integration is complete. You’ll now be taken back to EZOfficeInventory.
4.3. Choose Asset Attributes
When connecting Jira from EZOfficeInventory, you can also choose which Asset Attributes to display in Jira. From Settings –> Add Ons –> Integrate Jira, click on ‘Choose Attributes’.
A new dialog will prompt you to make your attribute selections. Once done, click on ‘Save this view’ to save the changes.
5. How the Integration Works
If you’ve successfully integrated the two applications, you’ll be able to see an Asset Container against your issues in Jira.
If no Assets are linked with the issue, the Asset Container will only display the ‘Link asset’ button. On the other hand, if Assets are linked with the issue, they’ll be visible under the Asset Container.
5.1. Link Assets with an issue
To link Assets with an issue, click on ‘Link asset’ and search your concerned Asset by name, number or AIN.
The search will also indicate the Asset type with the letters ‘F’ and ‘S’:
- F represents Fixed Assets
- S represents Asset Stock items.
Additionally, you can link however many Assets with an issue as you like. Once linked, expand the Asset to view its details and verify linkages.
5.2. Navigate to the Item Details Page from Jira
If you’d like to see an Asset in EZOfficeInventory, expand its view in the concerned issue in your service desk and click on its Asset name.
This will open EZOfficeInventory in your browser. Scroll down the Item Details Page to see all the Jira Issues linked with the said Asset.
5.3. View maintenance records in Jira
Maintenance records created in EZOfficeInventory sync to Jira. Let’s look at one such service in Jira.
This issue synced to Jira from EZOfficeInventory. The record title displays the Service Type of the records (in this case, Maintenance) and the serial numbers of Assets to be maintained (in the case, Asset #986 and #1069).
The Asset Container will list these items and also enable you to link new ones. This comes in handy when users forget to log Assets maintained during a service session in EZOfficeInventory.
Moreover, you can also examine updates recorded against a service in EZOfficeInventory in Jira. These appear under the Activity section. For instance, if the service is marked complete in EZOfficeInventory, a comment will appear under Activity indicating so.
6. Troubleshooting Errors
Unable to display Asset details as you’ve provided an invalid EZOfficeInventory Subdomain or Token. To update, go to Settings –> Apps –> Manage Apps. From here, find the installed EZOfficeInventory App and hit ‘Configure’.
Solution: This usually happens when the subdomain for Jira is changed in EZOfficeInventory or a custom domain is added. To fix, go to your Jira Account and update the settings in the EZOfficeInventory App.
Note: Existing data will NOT be impacted by the resetting of the connection.
Unable to display Asset details as this user does not exist in EZOfficeInventory. Add them to your EZOfficeInventory account and assign them the same email address as in Jira.
Solution: This happens when a user in Jira doesn’t exist in EZOfficeInventory. To remedy this, create this user in EZOfficeInventory and assign them the same email address as they have in Jira.
Error 3: Access Control
Unable to display Asset details since you aren’t authorized to view them as per your EZOfficeInventory Settings. Contact the Account Owner for authorization.
Solution: Your user role in EZOfficeInventory does not allow you access to the concerned Asset. Contact the Account Owner for permission to view.
Error 4: Unknown Errors
There was a problem accessing the data. Please try again later. If the problem persists, email us at email@example.com.
Solution: This can happen for two reasons:
1. While installing the EZOfficeInventory app from Jira, you’ve provided an invalid Access Token or EZOfficeInventory subdomain. To troubleshoot, define your app configurations again from Jira.
2. When the subdomain for the account is changed in EZOfficeInventory or a custom domain is added. To fix, provide the updated subdomain in your Jira app configurations.
Have queries or feedback for us?
If you have any comments or questions regarding our integration, drop us an email at firstname.lastname@example.org.
To learn more about our integrations, view the complete list of our third-party integrations.