Adding a viewlet from a remote repository

A variety of viewlets can be added to a dashboard from one or more remote repositories.

About this task

Jazz™ Foundation supplies a number of general viewlets that you can add to a dashboard. Products that are built on Jazz can contribute an additional set of viewlets that are specific to that product's functionality. All available viewlets in a repository are displayed together in the viewlet chooser. In addition to adding viewlets from the repository on the dashboard's host server, you can also add viewlets from remote repositories on friendly Jazz servers. Viewlets from local and remote repositories can be added to the same dashboard.

Procedure

  1. Select the Add Viewlet link Add Viewlet icon in the upper right corner of the dashboard. A viewlet chooser opens displaying the available viewlets grouped in categories. If the current server has any friendly servers configured, a drop-down menu listing the current and friendly Jazz servers is displayed in the viewlet chooser.
    Server menu displaying the local server and one remote server
  2. To add viewlets from a repository on a friendly server, select the server in the menu. If you are authenticated to the server, the viewlet menu is updated with the list of viewlets that are available in that repository. If you are not authenticated, you are prompted to do so.
    Note: Popup blockers might prevent the authentication prompts from opening. If this occurs, a message is displayed on the dashboard indicating that you should disable your popup blocker.
  3. Browse the available viewlets by clicking on the viewlet name. When a viewlet is selected, a description and a preview image are shown.
  4. Once you find the viewlet that you want to add, click Add viewlet. The viewlet is added at the top of the leftmost content column.

    Viewlet chooser

What to do next

After you add a viewlet, you can modify its content, scope (if applicable), appearance, and location on the dashboard. Save all changes before closing the dashboard.

When you are logged in to the Jazz server that hosts the remote repository, all viewlets that you have added from that repository display their contents. Once you are no longer logged in to the server, the viewlets do not display their contents. Instead, each viewlet displays a Log In link, which you can click to open a login window for the associated server.

Untitled viewlet window displaying a message indicating that the user must log in to the remote server
Once you are logged in, the contents of all viewlets associated with that remote repository are refreshed and displayed.


Feedback