Customizing Items Views


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:

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:

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:

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 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:

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

Printed version of site: