Adding Jazz viewlets to a JIRA gadget directory

You can use Jazz viewlets as OpenSocial gadgets with your JIRA dashboard. These instructions tell you how to add Jazz viewlets to the JIRA gadget catalog.

About this task

There are two parts to this process. First, you must register your JIRA server as an OAuth consumer of Jazz. Then, select and add gadgets to the JIRA gadget directory.

Procedure

  1. Find the consumer key and the public key for your JIRA server. Open the OAuth Administration page at http://[jira-server]/plugins/servlet/oauth/view-consumer-info, and copy and save the consumer key and public key information.

    The Jazz server OAuth administration page showing the Consumer Info tab including Consumer Key and Public Key information.

  2. Open the Consumers page from the Jazz server admin: [server_context]/admin#action=com.ibm.team.repository.admin.configureOAuth
    1. In the Consumer Key field, type the value of the consumer key for the JIRA server.
    2. In the Consumer Name field, type JIRA.
    3. Click Click here to use a public key instead. and enter the key for the JIRA server.
    4. Click Register.
  3. After your JIRA server is registered as an OAuth consumer of Jazz, you can add Open Social gadgets to your JIRA dashboard with these steps:
    1. Open the Widget Catalog from a Jazz Dashboard. Click a widget to open the details page, and then click OpenSocial gadget.
    2. Select the widget link and copy it.
    3. Go back to the JIRA Dashboard. Click the Add Gadget link to open the Gadget Directory.
    4. Click Add Gadget to Directory.
    5. In the Add Gadget to Directory window, paste in the gadget URL or and click Add Gadget. The gadget should now be available in the Gadget Directory.

      the gadget directory on a JIRA dashboard showing a Jazz gadget


Feedback