Skip to end of metadata
Go to start of metadata

eazyBI reports and dashboards can be published as OpenSocial gadgets. Currently, eazyBI gadgets are tested on Atlassian applications JIRA and Confluence as well as on Google Sites.

The main benefit of eazyBI gadgets compared to embedded <iframe> eazyBI reports is that one eazyBI user can authorize access to eazyBI using OAuth authorization and then publish selected reports or dashboards to other users who are not eazyBI users.

eazyBI gadgets are supported just for STANDARD and PLUS subscription plans as well as in Private eazyBI.

These instructions are for eazybi.com hosted service and not for installable eazyBI plugin for JIRA. For the installable eazyBI plugin please see eazyBI gadgets in JIRA dashboards and Confluence pages in the eazyBI for JIRA documentation space.

On this page:

Here are the steps how to publish an eazyBI report in a JIRA dashboard or Confluence page or in a Google Sites page.

Atlassian JIRA and Confluence

Increase gadget data request timeout

By default, data requests from gadgets in Confluence pages will time out after 15 seconds. If you have longer running eazyBI reports then please specify -Dhttp.socket.timeout=TIMEOUT_IN_MILLISECONDS Java property in Confluence startup scripts. E.g. in bin/setenv.sh add to JAVA_OPTS

JAVA_OPTS="... -Dhttp.socket.timeout=60000"

to increase gadget data request timeout to 60 seconds.

Register OAuth client application

At first, you need to register JIRA or Confluence as OAuth client application in eazyBI. Go to your accounts administration page and click on Users. If you have STANDARD or PLUS subscription plan then you should see OAuth Client Applications section.

Register your JIRA or Confluence application with Custom application type and specify just Main Application URL (it is used just for information purposes), do not specify callback URL (as it will be provided by JIRA or Confluence dynamically).

After registering application you will see OAuth details information that you will need when registering the eazyBI application in JIRA or Confluence.

Configure application link in JIRA or Confluence

Go to your JIRA or Confluence administration pages and register new eazyBI application and configure Outgoing Authentication for it:

  • In Service Provider Name enter eazyBI
    If you would like to publish data from several eazyBI accounts then use unique service provider name for each eazyBI account (for example, eazyBI account name)
  • Input previously generated OAuth details values in Consumer KeyShared SecretRequest Token URLAccess Token URL,Authorize URL fields.

Add eazyBI report and dashboard gadget to gadget directory

As a JIRA or Confluence administrator, add eazyBI gadgets to directory using report gadget URL https://eazybi.com/gadgets/report.xml and dashboard gadget URL https://eazybi.com/gadgets/dashboard.xml

If you used non-default service provider name then specify its name with the service_name parameter. For example, if service provider name is eazyBI account name then report gadget URL should be https://eazybi.com/gadgets/report.xml?service_name=eazyBI+account+name

Add eazyBI report or dashboard gadget to JIRA dashboard or Confluence page

Now you can add eazyBI report or dashboard gadget to either JIRA dashboard or Confluence page.

  • If previous configuration steps were done correctly then at first added report should show the Authorize access to eazyBI link.
  • After clicking this link new browser page should open where you will need to authorize access to your eazyBI account.
  • Then authorization window should close and report gadget should show selection list with available eazyBI reports. Select necessary report and click Save.
  • After that, you should see your eazyBI report.

Report height and width modification

In report gadget parameters you can modify Report height parameter and specify report height in pixels.

In JIRA dashboards report width is resized automatically based on dashboard layout. In the Confluence page you can specify width parameter in gadget parameters – specify auto for full-width reports or specify width in pixels.

Google Sites

Register OAuth client application

At first, you need to add Google Sites as OAuth client application in eazyBI. Go to your accounts administration page and click on Users. If you have STANDARD or PREMIUM subscription plan then you should see OAuth Client Applications section.

Register new client application and select Google Sites type.

Get eazyBI report gadget URL

Open eazyBI report which you would like to insert in Google Sites page and click on <> (Embed report in another HTML page) toolbar button and copy Google Gadget URL.

Add eazyBI report gadget to Google Sites page

When editing Google Sites page select Insert and then … More gadgets… and then Add gadget by URL and then paste URL from the previous step.

If necessary you can change eazyBI Report height parameter (by default it is the same report height as it was in eazyBI) as well as personalize standard gadget preferences (like Include border around gadget or Display title on gadget). After that press OK button and then Save your page.

  • If previous configuration steps were done correctly then at first added report should show the Authorize access to eazyBI link.
  • After clicking this link new browser page should open where you will need to authorize access to your eazyBI account.
  • Then authorization window should close and report gadget should show selection list with available eazyBI reports. Select necessary report and click Save
  • After that, you should see your eazyBI report.

Sometimes after included report is not resized with specified height. Then you should reload Google Sites page to see correctly resized eazyBI report.

Report sharing with other users

Atlassian JIRA and Confluence

Currently, if you share JIRA dashboards or Confluence pages with other JIRA or Confluence users then each user will need to make at first eazyBI report authorization using their eazyBI user credentials.

It is planned to improve this solution to enable eazyBI report sharing with other JIRA or Confluence users without a need to do additional authorization for each user (like Google Sites solution which is described below).

Google Sites

If you create Google Sites page and include eazyBI report gadget in it and also authorize access to eazyBI then all other Google Sites users who have access to this page will see eazyBI report results without additional authorization needs. This solution can be used to share some eazyBI reports to other users who have not direct access to eazyBI.

  • No labels