Configuring Lists, Charts, and Filters › How to Configure a List › Add a Time-Scaled Value to a List Portlet

Add a Time-Scaled Value to a List Portlet

A time-scaled value field is one that you can set up on a list portlet that shows a value for a specific period of time. A time-scaled value is based on a time-varying attribute for which a user enters values in CA Clarity PPM. As a user you cannot create a time-varying attribute. Only an administrator with the appropriate rights can create a time-varying attribute.

You can display multiple time-scaled values in a list portlet. The data for the attributes displays as stacked on the page, with the information for each time-scaled value appearing in the same virtual column. The data that displays can be in units of money, numbers, or percentages.

New virtual attributes such as a time-scaled value are automatically displayed in the far right column of the list. You can move the virtual attribute to a different position in the List Column layout.

Follow these steps:

1. Open the List Column Section menu, and click Fields.

   The list column fields page appears.

2. Click New.

   The create page appears.

3. Select Time Scaled Value, and click Save and Continue.

   The column settings page appears.

4. Complete the following fields in the General section:

   Value Attributes

   Indicates the time-scaled values that are to display in the virtual column. In the Available list box, select the attributes you want to list in the column and use the arrow buttons to move the attributes to the Selected list box.

   Column Label

   Defines the name that appears at the top of the list column.

   Display Type

   Specifies how the time-scaled value is to display: as a number, a column graph, or a bar graph.

   Secondary Value

   Specifies an additional (second) value for a time-scaled value virtual column that displays as a tooltip when you mouse over the value in the column.

   Link

   Specifies a page link that appears as a secondary value that the user can select.

   Open as Pop-up

   Indicates whether the page appears as a pop-up. Select the check box to have the page appear as a pop-up.

   Show Legend Label

   Indicates whether the field label appears next to the time-scaled value in the virtual column. Select the check box to display the field label.

   Show Column Label

   Indicates whether the column label appears at the top of the column list. Select the check box to have the column label appear.

5. Complete the following fields in the Time Scale section:

   Start Date

   Indicates the start date for time period for the virtual-scaled value.

   Values:

   • Specific Date. Click the Datepicker icon to select a date.
   • Rolling Date. Click the down arrow to select a relative date.
   • Other Date. This option appears only if you are selecting a start date for a time-scaled value for a subobject. This field allows you to select a field from the master object on which to base the start date. This option only appears when a subobject has time-scaled value attributes.

   Time Scale

   Specifies the length of time the time-scaled value covers.

   Values:

   • Specific Time Scale. Indicates by naming a specific length of time what the period for the time-scaled value is. Click the down arrow to select a specific period of time.
   • Other Time Scale. This option appears only if you are selecting a time scale for a time-scaled value for a subobject. The field lets you select a field from the master object on which to base the time scale.

   Number of Time Periods

   Defines the number of time periods that will be reported in the virtual column.

   Time Period Offset

   Defines the number of time periods you want to shift the beginning of the time-scaled value relative to the Start Date. You must enter a Start Date value to use this option.

   Show Group Row Header

   Specifies a timescale is to be displayed above the virtual column. Select the check box to display a timescale and select the period type you want from the drop-down list.

6. Complete the following fields in the Display section:

   Decimal Places

   Defines the number of decimal places for data to be returned by the attribute. Enter a zero (0) to make the attribute an integer.

   Alignment

   Specifies the text alignment in grid cells.

   Allow Word Wrapping in Column Header

   Indicates whether the text in the column label can wrap within the column. Select the check box to allow wrapping.

   Allow Word Wrapping in Column

   Indicates whether the text in the column can wrap within the column. Select the check box to allow wrapping.

7. Save the changes.

More information:

How to Configure a List

Set List Column Layout

Set List Options

View and Edit List Portlet Fields