Customizing Items Views

Introduction

This application note will describe how users can customize the Items Views according to the user's preference. Items views are completely configurable where additional columns can be added. The window size of the Items Grid Panel, Properties Panel and Items Description Panel are also configurable by the user.

Items Views

The Items Views menu shows a variety of views depending on what project is currently open.

Items Views Menu

The default views are:

  • Predetermined: Opens the predetermined items view.

  • Items Views management: Opens the dialog box to manage items views.

  • Default: Opens the items default view. Initially, this is also the predetermined view.

Each Items View shows the attributes and characteristics of the items that are stored in the current database. These items will be displayed in the Items Grid Panel. The Grid Panel is broken up into three panels:

  • Grid panel: By default, columns for code and name of the item are displayed.

  • Description panel: Shows the description of the item selected on the grid panel.

  • Properties panel: Shows certain tabs specific to Items.

The user can customize the Grid Panel to add or remove columns, order the items, resize windows, and specify filters. This customized view can be saved for future use.

Column Inclusion and Exclusion

The items views show at least the code and name columns, which are mandatory. To include new columns, the Configure option must be chosen by clicking the button on the toolbar located directly above the grid panel. The following menu appears:

Client GUI Grid Panel: Column Configuration

There are several types of fields that may be included as columns in the grid panel:

  • Predefined attributes. These are pre-created attributes linked to items (date of creation of the item, last user who checked it out, active version, description, description of the change in the active version, discussion, etc.).

  • Organization items. These are project organization items (domains, blocks, baselines, etc) to which the items belong.

  • Reusability items. These are items related to the reusability function that only take values for items that are reused from other projects.

    • Source item: Code of the source item in the source project.

    • Source item version: Version of the source item.

    • Component: Name of the reused component to which the source item belongs.

    • Component version: Version of the reused component to which the source item belongs.

    • Reuse mode: Mode in which the version of the component is reused in the project (share, copy and link).

      NOTE: This group of items appears only if the repository supports reusability.

  • Related Items. Displays the items related to the items displayed in the list. The relation motive for each column of this type must be selected.

  • Related Files. Displays files related to the items included in the list.

  • Metrics. Provides a display of the project complexity metrics related to items. These are a number of linked items.

  • Attributes. The list of fields to select shows all the user attributes defined in the project.

To include a column in the panel, the user must select the attribute, related item, metric, or motive from the list on the left and then click . Likewise, to eliminate a column from the panel, the name must be selected from the list on the right and click . Columns can also be added or removed from the panel by selecting and double-clicking them. If an enumerated attribute, or an item associated with multiple possible values (for example, domains or blocks) is selected, the Show all option can be selected to show all of the possible values in all of the rows and not just the ones associated with each item. If a text attribute is selected, the Show multiline option can be checked, which will show the complete text of the attribute on several lines, if the width of the column does not allow it to be displayed on a single line. This function is available for both user attributes as well as predefined text attributes, such as Name or Comments in the Discussion tab. If the Description or Change Description fields are shown in the grid panel, they will always be displayed in multiline mode. Once the columns are included, it is possible to select the order in which they will appear on the panel using the buttons and .

Ordering items

In the panel configuration dialog box it may be decided what criteria is to be used to order the items on the list to be shown. By default, code is the only sorting criteria. The available order criteria are all attributes, organization items, or metrics that appear in any column included in the grid view. To use any of them, they must be selected in the list of columns and then the button must be clicked. Several order criteria may be combined. For each one, it can be decided whether the order taken will be ascending or descending, by selecting the sorting criteria and the corresponding option in the menu behind the criteria list. The order of importance assigned to the selected criteria can also be specified. They can be reordered using the buttons and on the right side of the list.

Window Sizing

The distribution of columns in the window available for the grid view depends on the option Settings | Fit Columns Size to Window Size:

  • If this option is activated, the columns are distributed so that all of them are visible and fit the width of the window.

  • If this option is deactivated, only the first columns are shown and a horizontal scroll bar appears.

If users want to save a particular window size within the GUI, i.e. the Grid Panel in the center of the screen as shown below, users can save that configuration so when Spec-TRACER is opened in the future, this can be the default view. Users will need to position the window(s) manually before saving the window configuration.

Filter selection

It is possible to apply a filter to the items list. To do this, the user must click the button in the dialog box for the grid panel configuration. The following window will be shown:

Client GUI Grid Panel: Filters

This window may be used to create the desired filter and select it so the items list shows only items that fulfill a certain condition.

Users can add a new filter by selecting the New button. This will open the Filter Editor window. Users will need to enter the Name of the filter, and apply the desired criteria. For example, the criterion can be Block with the condition: is in, and the values: FPGA and Test Scenarios.

Creating a New Filter

NOTE: To add the value, users will need to select the icon and select from the available options.

Once the columns, filter, and order are selected, the button is clicked, and the grid panel is modified with the data. Filters can also be activated selecting a filter in the drop down menu, clicking on the arrow beside the Filter icon The list of available filter will display the filter name, or filter criteria if there is no name.

Client GUI Grid Panel: Filter Menu

The filters applied are listed in a toolbar placed on the top of the grid view.

Client GUI Grid Panel: Filters Displayed In Heading

In order to deactivate a filter, the user may select the “No active filter” option from the list.

Save the Configuration

After the user has configured the Grid Panel to the desired appearance, the user needs to click on the save button on the Configuration Bar. The following dialog box then appears:

Client GUI Items: New Configuration

If an existing configuration is selected, it is modified with the new parameters. The tool does not allow to modify a view configuration whose owner is not the user connected to the project. The configuration saved consists of the following parameters:

  • Configuration of the grid panel: columns included and their order, filter, order criteria of items in rows. In the case of elements with enumerated values, the configuration also includes the possibility of selecting Show all possible values. In the case of text attributes, the configuration also includes the possibility of selecting Show multiline.

  • Column width (only if the Fit Columns Size to Window Size option is deactivated).

  • First and second level of row ordering.

  • Collapsed or expanded trees and branches.

  • Visible or hidden tab panel.

  • Minimized or open tab panel.

  • Visible or hidden description panel.

  • Minimized or open description panel.

  • Positions of the three panels on the screen.

  • Size of the screen and the three panels.

The new configuration created may be established as the predetermined view by marking the appropriate option in the dialog box. If the box is not marked, the configuration can be seen from the Items Views menu.

Client Customized Items View

Saving the Workspace

Users can save the window layout, which can comprise of multiple windows, by going to the Window menu and selecting User Desktops. By clicking on Save Current Workspace users can name the current configuration.

Saving the Workspace

Saved Workspace Layout

Ask Us a Question
x

Ask Us a Question

x
Captcha ImageReload Captcha
Incorrect data entered.
Thank you! Your question has been submitted. Please allow 1-3 business days for someone to respond to your question.
Internal error occurred. Your question was not submitted. Please contact us using Feedback form.