Adding and organizing content on a home page

Your home page uses the Jazz™ dashboard. You can add, configure, edit, and manipulate viewlets in the dashboard.

In most cases, newly created dashboards will be pre-populated. The initial content is intended to provide a good starting point and can be changed in a number of ways.

Add a viewlet

You can customize your dashboard by adding viewlets.
To add a viewlet:
  1. Click Add Viewlet in the upper, right corner of the dashboard. The Viewlet Chooser opens, showing the available viewlets grouped in categories in the left column. When a viewlet is selected, a description and a preview image will be shown to the right:
    Viewlet Chooser
  2. After you select the viewlet to add, click Add viewlet. The viewlet is added at the top of the leftmost column.
  3. To close the Viewlet Chooser, click the X in the upper, right corner.

Edit the content of a viewlet

Some viewlets allow you to directly edit the content, for example, the Work Item Queries viewlet.
To edit viewlet content:
  1. Click Edit Contents from the viewlet drop-down menu. The actual editing steps depend on the way a viewlet has been designed.
    Work Item Queries
  2. Make the changes, and then click Save.

Configure viewlet preferences

Most viewlets in the dashboard can be configured using preferences. The actual preferences are viewlet-dependent.
To configure viewlet preferences:
  1. Click Edit Settings from viewlet drop-down menu.
  2. Click the Preferences tab.
    Viewlet preferences
  3. Make the changes, and then click Save.

Changing the appearance of a viewlet

You can change the title, color trim, and background color of a viewlet. Color trims allow you to color-coordinate viewlets based on the content they show and on the intent of your dashboard.
To change these parameters:
  1. Click Edit Settings from the viewlet dropdown menu.
  2. Click the Appearance tab.
    Viewlet appearance
  3. Make the changes, and then click Save.

Moving the viewlet

Viewlets can be repositioned within the dashboard using direct drag and drop.
To move a viewlet:
  1. Move the cursor over the title area until the cursor changes to indicate that you can move the viewlet.
  2. Drag the viewlet, and follow the dotted outline until you find the new location. Other viewlets will move to fill into the vacant spot.
    Note: You can also drag the viewlet into a different page by dragging and dropping it on to the desired page tab. Then, select that page tab, and continue to move the viewlet into the final position.
  3. Release the mouse button to drop the viewlet.

Zooming in the viewlet

Some viewlets can be zoomed to show more detail. Zoomed viewlets will partially overlap their neighbors.
To zoom a viewlet:
  1. If a viewlet can be zoomed, a + will appear when the pointer is over the lower, right corner of the viewlet area. Click the + sign.
    Viewlet zoom
  2. Once zoomed in, the viewlet can be restored (zoomed out) by clicking the icon in the lower, right corner, or clicking anywhere outside the viewlet.

Removing the viewlet

You can remove viewlets from the dashboard.
To remove a viewlet from the dashboard page, click the X in the upper, right corner of the viewlet.

Feedback