Browsing Items
This topic describes how to browse items in the StarTeam Web Client.
Defining the Scope of Items to Browse
When you open a view session, a default Folder (root), Item Type, and Filter are selected in the Scope panel on the Browse page. The item records initially listed in the Item Table reflect these default settings.
Note: The default item type is specified in the Client Options dialog box.
To define the scope of items to browse:
- Open a view session.
-
In the
Scope panel, select a view folder from the
Folder () list.
Tip: Make sure the All Descendants () toggle button is selected if you want to include the selected folder's child folders in the scope of items to browse.
- Select an item type from the Item Type list.
-
Optional: Select a public filter from the
Filter () list. The default public filter is selected by default.
If you select a public filter, the item records listed in the
Item Table are sorted by the property values defined in the filter. The filter also defines the default columns available in the
Item Table and the group selections available in the
Refine panel.
Note: Public filters must be defined on the associated StarTeam Server in order for them to be available in the Filter () list box. If there are no public filters, the default Web Client filter simply returns every item in the specified folder that matches the specified type.
Searching for Specific Items
You can further refine the scope of records listed in the Item Table by searching for a specific text value. This search is case-insensitive.
Perform the following steps to search for specific items:
- Define the scope of items to browse.
-
In the
Refine panel, type a text value in the
Search within filter field and press
Enter. The
Item Table lists only the records that contain the specified text value.
Note: Click Reset Filter () to restore the original set of item records listed in the Item Table.
Filtering Items by Grouped Property Values: List Format
If you define the scope of items to browse using a public filter, perform the following steps to use grouped property values to further refine the scope of item records listed in the Item Table.
Note: In this example, change requests are filtered by the properties Status and Responsibility, and the list format of the Refine panel is used to filter the item records listed in the Item Table by grouped property values.
- On the Refine panel title bar, make sure that Toggle chart () is not selected.
- In the Refine panel, click the Down Arrow on the right of the Status list title bar. The Status list opens and shows the distribution information for the property Status, including the number of Item records in the Item Table that match each value. All, the default value for all grouped properties, is always at the top of the list, and its count matches the total number of item records in the Item Table.
- Select a grouping from the Status list. The Item Table lists only those item records with the selected Status value.
- Click the Down Arrow on the right of the Responsibility list title bar. The Responsibility list opens and shows the distribution information for the property Responsibility. The distribution information in the Responsibility list is refined to match the new set of item records in the Item Table.
-
Select a grouping from the
Responsibility list. The
Item Table lists only those item records with both the selected
Status and
Responsibility values.
Note: Click Reset Filter () to restore the original set of item records listed in the Item Table.
Filtering Items by Grouped Property Values: Chart Format
If you define the scope of items to browse using a public filter, perform the following steps to use grouped property values to further refine the scope of item records listed in the Item Table.
Note: In this example, change requests are filtered by the properties Status and Responsibility, and the chart format of the Refine panel is used to filter the item records listed in the Item Table by grouped property values.
- On the Refine panel title bar, make sure that Toggle chart () is selected.
-
In the
Refine panel, select
Status: All from the
Property list. The
Status pie chart shows the graphical distribution information for the property
Status.
Note: Each option in the Property list shows the total number of item records in the Item Table.
- Place the cursor over a Status pie slice. A tool tip shows the property value and the number of item records in the Item Table that match it.
- Click a Status pie slice. The pie slice is highlighted, and the Item Table lists only those records with the selected Status value, and the option Responsibility in the Property list shows the new number of item records in the Item Table.
- Select Responsibility: All from the Property list. The Responsibility pie chart shows the graphical distribution information for the property Responsibility.
- Place the cursor over a Responsibility pie slice. A tool tip shows the property value and the number of item records in the Item Table that match it.
-
Click a
Responsibility pie slice. The pie slice is highlighted, and the Item Table lists only those item records with both the selected Status and
Responsibility values.
Note: Click Reset Filter () to restore the original set of item records listed in the Item Table.