#sji

The Morning Ferry

There are several options to insert a Smart Jira issue view macro on your Confluence page.

Method #1: shortcuts

The easiest and fastest way of doing so is to type /jj directing in the editor:

You can think of it as /jira-jira shortcut. Hit <enter> once you see pink unicorn icon (as seen above).

Alternatively, you can also start typing /smart to achieve the same result.

Method #2: menu

Less efficient, but stil valid way is menu.

On a Confluence page, in edit mode, hit + icon in menu:

Then click ...view more option from the drop-down list:

Finally in the Select macro dialog, type either jira or better to find Smart Jira Issue view:

Here is a step by step tutorial on how to authorise BJI. It’s worth mentioning, the only thing that user has to perform is to follow an easy “press blue button” wizard and refresh a Confluence at the end.

#1 Click “authorize to see the issue”

#2 On the modal, click “Authorize!”

#3 Grant access

On the consent screen grant an access to Smart issue view. Remember to pick up your cloud instance from the drop-down list on the bottom of the page.

#4 Confirmation screen

On the following screen you will see the permission granting confirmation screen. You can close it.

#5 Refresh the Confluence page

You are done!

Box view feature allows a single Jira issue to be rendered as a fully configurable box on a Confluence page.

It is especially useful while working on a Confluence page linked to an issue. Such as decision making overview page linked to a Jira Task or feature request overview page linked to a Jira Epic.

Built-in macro scenario

These pages tends to have this kind of table on top of the document:

Imagine you want to change a status of an issue. Steps you need to perform are:

Press ‘edit’ and wait for the Confluence editor to fully load;

Click NOT STARTED status badge, replace it’s text with IN PROGRESS and manually change the colour to blue;

Save your changes and wait for Confluence to load;

Click linked issue and wait for Jira to load;

Transition issue’s status to in progress;

Realise that the owner in Jira is set to a different person;

Go back to Confluence and refresh the page then press edit again and wait for the heavy editor to load;

Fix the owner field in the table and finally saves the page.

This takes time and can be really frustrating if you have to update several pages in a row.

Smart Jira issue view scenario

Once you insert a Smart Jira issue macro on a Confluence page, you have all the information needed right on the page:

All the data presented is up to date. There is no need to manually sync them between Jira and Confluence.

Let’s repeat the above scenario:

Click box header and wait for lightweight modal to open;

Transition issue’s status to in progress;

Hit escape or x sign in the modal;