How to add QMetry Custom Dashboard Embedded URL in Jira Dashboard ?

The user who has created a custom dashboard can generate an embedded URL and share the link. The embedded URL gives access over live report data in read-only mode to the users who do not have direct access to QMetry application (i.e. Ability to view custom dashboard without any authentication). This link can be used to share the dashboard with other users or for integration with third-party integrations.

Steps to share Dashboard through Embedded URL

  1. Go to the QMetry Custom Dashboard > My Dashboard > select the dashboard that you would like to share

  2. Click on the Share Dashboard icon, the screen opens with two tabs on it: Users and Embedded URL.

  3. Open the Embedded URL tab

  4. Click Generate to generate the embedded URL.


    It is to be noted that the URL remains valid and active unless it is regenerated or deleted.

     

Steps to use Embedded URL in Jira Dashboard through iFrame

You can use the Embedded URL in Jira to view the QMetry dashboard reports on the Jira Dashboard page. This way, users who do not have access over QMetry can view QMetry reports directly in Jira. These reports will be displayed in read-only mode. 

Pre-requisites:

  • QMetry Application and Jira server both should be configured on https or http.

  • There should be connectivity between QMetry and Jira.

Steps to embed an iframe into a Jira Dashboard:

You can use the provided Text-Gadget in which you can enter arbitrary HTML. Do ensure that the Text-Gadget is enabled by your JIRA Administrator.

  1. Go to Settings > Add-ons > Manage-Addons > System Add-ons > Expand.


     

  2. Search for - “Atlassian Jira - Plugins - Gadgets Plugin”.

  3. Expand the Modules and enable 'Text (text-gadget)'.

     

  4. Once the relevant changes are done, go to Jira Dashboard > Create Dashboard > Add gadget (make sure to load all-gadgets).

  5. Search for - “Text” followed by Add gadget.

  6. In the HTML text field, you need to specify the embedded URL (as under “src” tag) with the following format (refer to the attached example).

    • Replace the QMetry Custom Dashboard Embedded URL in the “src” tag (highlighted in the given example).

    • Width of iframe (recommended: 1200)

    • Height of iframe (recommended: 3000)

    • Example :
      <iframe src="https://testmanagement.qmetry.com/#/qmetry-dashboards/A0IqbS1R/embedded?key=6c8ebb03f0e6cac383832e1c34d681af42ea" style="height:3000;width:1200;"></iframe>

  7. Click on Save.

  8. You can see the iframe is added to the page. QMetry report is rendered on the page in read-only mode.