Adding an iWidget with asset search results to a Rational Team Concert dashboard

Edit online

You can display a list of assets on the dashboard of an IBM® Jazz™ application, such as IBM Rational® Team Concert™, by adding a widget to the dashboard.

Before you begin

Important: To add a widget to a dashboard on Rational Team Concert, you must use a release of Rational Team Concert that is version 3.0 or later.

The IBM Rational Asset Manager server must be an external friend to the Rational Team Concert server. For more information, see Adding Rational Asset Manager as an external friend to a Jazz server.

If the IBM Rational Asset Manager server is not an external friend, add the IBM Rational Asset Manager root services URL to the whitelist of the Rational Team Concert server. For example: http://servername:port/ram/rootservices. For information about adding IBM Rational Asset Manager to the whitelist of a Jazz server, see Managing the URL whitelist.

You must be able to add viewlets to a dashboard in Rational Team Concert.

Single sign-on must be configured between the IBM Rational Asset Manager server and the Rational Team Concert server. For details, see Setting up single sign-on between two servers. If single sign-on is not configured, you can view only assets from communities that do not require a login to IBM Rational Asset Manager.

About this task

These instructions are for adding widgets to Rational Team Concert. However, these instructions are like the instructions to add widgets to other Jazz products.

Procedure

  1. In the IBM Rational Asset Manager web client, click the Help icon and then Extensions.
  2. In the Widgets section, copy the URL for the Lotus® iWidget. The URL ends with AssetWidget.xml.
  3. Log on to Rational Team Concert.
  4. Open a dashboard that you can modify.
    If you cannot modify a dashboard, ask your Rational Team Concert administrator to grant you the appropriate permissions.
  5. Click the Add Viewlet icon Add Viewlet icon.
  6. Click Add IBM iWidget.
  7. In the URL field, paste the URL for the widget from the IBM Rational Asset Manager web client.
  8. Click Add Widget.
    The widget is displayed on the dashboard.
  9. To modify the list of assets:
    1. On the widget, click Edit contents.
    2. In the Search field, enter keywords to search for. You can use the asterisk (*) as a wildcard.
    3. To limit your search results to assets in a community, from the Community list, select a community.
    4. Click Submit.
    5. Click the Menu icon for the widget, and then click Refresh.
      The search results are updated.