Try Jira Cloud for Outlook: Organize your work without leaving your inbox

125 comments

Maksym Yokha
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
February 24, 2021

Hi @Jing Jin !

Currently, Jira Cloud for Outlook works with Jira Cloud only.

You can vote for API-97 if you want this add-in to support Server/Data Center in the future.

Ed Bean April 6, 2021

Hello, @Maksym Yokha -

My organization is interested in using the JIRA for Outlook Plugin. We are in the healthcare space, so Privacy & Security are major considerations in any new adoption. I am attempting to get a 3-user pilot of the plugin approved, but my Privacy & Security staff have questions about the application capabilities advertised:

Add-in capabilities

When this add-in is used, it

  • Can send data over the Internet
  • This add-in can read or modify the contents of any item in your mailbox, and create new items. It can access personal information -- such as the body, subject, sender, recipients, or attachments -- in any message or calendar item. It may send this data to a third-party service.

They have read these permissions and the assumption, I'm afraid, is that these permissions will be used indiscriminately. I believe that much of what's listed here is boilerplate. Are there members of your team who would be willing to speak to exactly what data the plugin is able to access/create on the user's behalf and clarify concerns over the use of "red flag" words such as "any" or "may"?

This could help me get beyond immediate objections based solely upon this copy and allow us to progress to evaluating the tool.

Thanks very much!

Maksym Yokha
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
April 14, 2021

Hello @Ed Bean!

Thank you for your question.

Re:

They have read these permissions and the assumption, I’m afraid, is that these permissions will be used indiscriminately. I believe that much of what’s listed here is boilerplate. Are there members of your team who would be willing to speak to exactly what data the plugin is able to access/create on the user’s behalf and clarify concerns over the use of “red flag” words such as “any” or “may”?

This text is added by Microsoft depending on what permissions we ask. There are 4 levels of Outlook add-in permissions: Restricted, ReadItem, ReadWriteItem, and ReadWriteMailbox. These levels are cumulative (you can read more about them here).

For most of the functionality, it’s enough for us to request ReadItem permission: this is needed so when the user creates an issue and includes the current email or the user attaches the email to an existing issue, we could retrieve the email body and send it as an attachment to Jira (by the way, the user controls this data and if they decide that they don’t want to disclose the email in Jira anymore, they can open Jira issue page and delete attached email from there).

But the reason we require the higher permission level “ReadWriteMailbox” is because this allows us to add support for shared mailboxes, which is on our roadmap, in the future (here are technical requirements for this).

Unfortunately, we can’t support shared mailboxes with just the ReadItem permission level.

To summarize,

  • we request the higher permission level but we perform only Read operations on currently opened email
  • we do not read any emails which are not opened by the user
  • we do not modify any emails
  • the email body is being sent over the network to Jira as a Jira attachment when the user includes the email while creating a Jira issue or attaching the email to the existing issue
  • only users who have access to the Jira issue can see the email
  • the user still controls the email and the email can be deleted from the Jira UI
Like Vitalii Saienko likes this
davidwashburn April 26, 2021

@Maksym Yokha @Vitalii Saienko will there be any updates to this app? It hasn't been updated since 2019. Thanks!

Edit: I should mention I enjoy the plugin quite a bit. There are just a few features/tweaks I wish it had. For example, see below.

  • I wish the UI/UX utilized Atlassian's new user interface guidelines, similar to how the Yasoon Outlook plugin looks. The current user interface looks quite dated.
  • There was an option to View all issues from this sender so I could see a list of issues the sender has submitted to our service desk in the past.
  • I know this is dumb, but I wish the iconography and images weren't distorted (see below screenshot). In our JSM project the images and icons look sleek and high resolution, but in the Outlook Jira plugin they are shrunk and distorted at odd proportions.

Outlook for Jira request type icons (distorted)

Image.png

 

Request type icons in JSM project (fitted)

Image2.png

Like # people like this
Maksym Yokha
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
April 27, 2021

Hey, @davidwashburn thanks for reaching out and for your feedback.

Things to address here: though there were no major features added to the app in the last few months, we constantly improve stability and performance. Regarding UI/UX, we're probably not going to use Atlassian-style UI elements. Let me explain: The add-in is being run inside of Outlook either web or desktop. And for add-ins to look natural (no matter if these add-ins are running in Outlook, Excel, any other Microsoft app) Microsoft has developed Fluent Design System. And, obviously, we utilize UI elements, fonts, etc. from that system.

As for distorted icons, we fetch "large" sized icons from Jira, so at first, glance looks like the images are being compressed somewhere on the way, or it's just the way raster (.jpg, .png) images are rendered in Outlook. But we'll take a closer look into it.

Regarding "View all issues from this sender": this looks like a great feature suggestion. You can create a public feature request at jira.atlassian.com/proejcts/API and we'll implement that feature as it gains traction.

Like # people like this
David Washburn April 27, 2021

@Maksym Yokha I appreciate the update, thanks for the detailed feedback. I respect the decision to use Microsoft's Fluent design, I'm just a sucker for visual appeal like the Yasoon Outlook integration. But I can understand why you've chosen the native Microsoft user experience.

I will certainly make a suggestion on the feature request project since I believe that feature would elevate the integration in a huge way. It's a solid app, we like the way you've integrated attachments onto Jira issues.

Like # people like this
Adit Shah May 10, 2021

Hi, is this still working ? 
I'm facing issues with this. 
Says - you need an additional application to run this add-in
Capture.JPG

Vitalii Saienko
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
May 12, 2021

Hi @Adit Shah 

I found this answer at answers.microsoft.com (microsoft Edge Error code: STATUS_INVALID_IMAGE_HASH):

Here's the answer itself:

This is a known issue in some situations. There is a detailed explanation with suggested remedies here: https://textslashplain.com/2019/09/27/aw-snap-every-tab-crashes/ (The author is a senior program manager on the Edge team.)

tl;dr

Security software (e.g. third-party anti-virus) is the most likely cause of this error. Update any security software you have to the latest version. 


I would suggest you update Outlook itself and any security software. If this won't help, I'd suggest reaching out to Microsoft support.

Vedavyas Konidena May 13, 2021

 @Maksym Yokha Can you record time tracking fields using this Addin?

Maksym Yokha
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
May 13, 2021

Hi, @Vedavyas Konidena thanks for your question!

If you have time tracking fields set up for issues of a particular issue type, you are able to manage original and remaining estimates from within Jira Cloud for Outlook add-in.

In particular, you can set time tracking fields when creating an issue from the "Create issue" tab:

Screenshot 2021-05-13 at 12.33.29.png

If your workflow includes issue status transition with fields to edit and the list of those fields includes time tracking ones, then you are able to set/edit original and remaining estimates from a transition modal which would pop up in an add-in.

Currently, the limitation is that you're not able to view/edit time tracking fields when viewing an issue from the "View issues" tab. But if that's what you're looking for you can create a public ticket at jira.atlassian.com/projects/API using the 'Jira Cloud for Outlook' component for the team to implement that when public ticket gains some traction.

Vedavyas Konidena May 13, 2021

@Maksym Yokha  Thank you for the quick response.

I have created API-423.

 

Regards,

Vyas

Like Maksym Yokha likes this
Nicole Downes August 15, 2021

I assume you need to be a licenced Jira user to utilise this feature. Not all staff have access to Jira. Is there special setup/policy required to give access from Outlook to only Jira users?  I could not find anything in the documentation.

Please advise.

Maksym Yokha
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
August 16, 2021

Hi @Nicole Downes !

You don't need any additional licenses for Jira Cloud for Outlook to work. If users have access to particular issues in Jira itself they should have access to those issues from within the Jira Cloud for Outlook add-in.

Consider:

  • If users have access to issues in Jira but not in the add-in they need to make sure they've logged into a correct Jira site.
  • Jira Cloud for Outlook works with Jira Cloud (hence the name Jira Cloud for Outlook) but doesn't work with Jira server.
David Bakkers
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
August 26, 2021

I think it needs to be made clearer in this article or the name of the tool that this add-in only works with when the Outlook client application is directly bound to the Outlook 365 online accounts.

The use of the generic word 'Outlook' and the pictures of a ribbon with a button marked 'Jira' give the reader the impression that this is an add-in that is installed in the Outlook client application to enables any email from any source to be turned into a Jira issue or attachment, when that's really not the case.

Maksym Yokha
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
August 27, 2021

Hi, @David Bakkers Jira Cloud for Outlook add-in's usage is not limited by 365 online accounts.

Furthermore, this add-in can be used with using a work/school account as well as a Microsoft account on a variety of platforms (including Outlook web, desktop, and mobile apps).

You can check details on Jira Cloud for Outlook's Microsoft AppSource listing.

If you are not able to use this add-in at work, chances are it's prohibited by your admin.

David Bakkers
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
August 27, 2021

Hello @Maksym Yokha 

Every single time I tried to install it, I get a dialogue box from MSoft saying "Taking you to Microsoft 365 to complete this process", then I authenticate and I am logged into the web based interface for Outlook O365 online, which contains none of my email accounts, because I have never used Outlook O365 online.... ever. I use the Outlook client application exclusively on the desktop to access IMAP and POP accounts that have nothing to do with MSoft or O365 online.

If this tool is not limited to Outlook O365 accounts, can you please detailed provide instructions on HOW to install it directly in an Outlook client application on Windows 10 computer, as there is no information on how to do it via AppSource that I can find or work out.

Maksym Yokha
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
August 27, 2021

@David Bakkers Regardless of Windows/Mac you probably have the "Get add-ins" button in your Outlook desktop app which is going to open Microsoft AppSource in your default browser.

Next, search for "Jira Cloud for Outlook (Official)". It will require some kind of Microsoft account to log in (for me both organization account and `@outlook.com` worked).

Next, you need to "Get it now".  Microsoft will ask you for permission to use your personal data and redirect you to the Outlook web app. And you'll need to "Add" add-in there.

After that add-in will appear in your desktop app.

One of the intermediate steps contains the "Singing into Microsoft 365 account" modal despite what it says, it doesn't require you to have a 365 subscription or anything. For instance, I managed to add an add-in using my `@outlook.com` account which is my personal account and doesn't have any subscriptions attached to it. 

David Bakkers
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
August 27, 2021

@Maksym YokhaI do not have the "Get add-ins" button in my Outlook because it is not joined to my Outlook O365 online account using all that Windows 'Shared Experiences' stuff, so it doesn't matter if I install the tool in Outlook O365 online via AppSource using either method, the add-in will not be pushed up into my desktop Outlook application and therefore the Jira button will never appear on the ribbon.

When a person's Outlook application is not connected to O365 online via Shared Experiences, the Get add-ins button is removed from the ribbon. You can force it to appear on the ribbon, but it is greyed out and does nothing; this is a known 'feature' of Outlook.

Here is the add-in installed via AppSource and working in my Outlook O365 online account:

Annotation 2021-08-27 204014.png

And here is my Outlook client application where I've force enabled the Get add-ins button on the ribbon to show it is deactivated, and that none of my email accounts are the O365 online account, and subsequently, the Jira button doesn't appear on the ribbon:

Annotation 2021-08-28 075858.png

The Atlassian tool makes a wide range of assumptions as to how a user is using their Outlook app in relation to their O365 account and what privacy settings are or are not enabled between the two. Without all these things in place, not much of any value happens for those people, of which I am one.

So, what I am saying is that since none of these very specific requirements are stated in this article and not made apparent in the name of the tool or any of the documentation, people such as myself can easily get the wrong idea as to what the tool really needs to work in the way you are 'advertising' it as working.

Maksym Yokha
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
September 1, 2021

@David Bakkers, there's an Outlook add-in requirements page in Microsoft's dev documentation that states

If the client is configured to connect with POP3 or IMAP, add-ins will not load.

So, if you use POP/IMAP then neither Jira Cloud for Outlook nor any other Outlook add-in will not load in a task pane.

David Bakkers
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
September 1, 2021

@Maksym Yokha 

Excellent! So now that we both know the same thing, that the Jira Cloud for Outlook tool only works when a user's Outlook application is connected to an Exchange server or Microsoft 365 using a direct connection, and does not work with POP or IMAP, then put those words in the original article.

Just tell everyone, upfront, about this requirement and limitation. Don't just leave it to chance that they have to scroll through four pages of comments to get to your comment that discloses that important piece of information.

You are the original author of the article.... you can add to it.

Matt Wilkie September 9, 2021

How to download for install in desktop Outlook 2016? The app store method is broken for me: https://community.atlassian.com/t5/Marketplace-Apps-Integrations/Jira-Cloud-for-Outlook-how-to-download-for-offline-install/qaq-p/1800941

Edit: In January 2020 @Maksym Yokha wrote "Unfortunately we don't support direct installation of this add-in into Outlook desktop (if that's what you're looking for). There's a ticket which you can watch and vote for https://jira.atlassian.com/browse/API-154".

There's only been 15 votes so far, probably in part because it takes a long time to run across. 

Connie Miranda September 14, 2021

Hi, when I tried it is just taking too long and not working

JIRA_Outlook_not working 2021-09-15_8-30-16.jpg

Like Matt Wilkie likes this
Maksym Yokha
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
September 21, 2021

Hi @Connie Miranda!

I hope you're doing well. Here's what I can suggest doing:

  • visit your Atlassian account at id.atlassian.com/manage-profile/appsScreenshot 2021-09-21 at 17.17.33.png
  • check if you have Jira Cloud for Outlook listed there and if so, click "Remove access"
  • go to your Outlook client and open click either of three Jira Cloud for Outlook buttons

Hopefully, you'd find an onboarding piece of UI in there.

Please let us know if you still see the spinner or face any other issues trying to use the add-in.

Like Matt Wilkie likes this
Deleted user November 18, 2021

Hi, can this be used for Jira Service Management Customer Portal accounts as well?

Like # people like this
Vitalii Saienko
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
December 6, 2021

Hi @[deleted]

Thanks for your question.

Unfortunately, it doesn't work with JSM Customer Portal accounts due to the limitation of Jira API. In case it will be supported in the future, we will update this public ticket https://jira.atlassian.com/browse/API-142. Feel free to "watch" it and "vote".

Like # people like this

Comment

Log in or Sign up to comment
TAGS
AUG Leaders

Atlassian Community Events