How to Configure a List › Add a Time Scaled Value to a List Portlet

Add a Time Scaled Value to a List Portlet

You can set up a time-scaled value on a list portlet to show a value for a specific period. This 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. Click the Options icon that appears on the portlet toolbar.
2. Open the Options menu, and click Configure.
3. Open the List Column Section menu, and click Fields.
4. Click New.
5. Select Time Scaled Value, and click Next.
6. Complete the requested information in the General section. The following fields require explanation:

   Value Attributes

   Indicates the time scaled values that display in the virtual column. Select the attributes in the Available list box and use the arrows to move the attributes to the Selected list box.

   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 target page of the image link appears 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.

7. Complete the requested information in the Time Scale section. The following fields require explanation:

   Start Date

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

   Note: The Other Date option appears only if you select a start date for a time-scaled value for a subobject. This field lets you 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.
   • Other Time Scale. This option appears only if you select 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 to 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. Enter a Start Date value to use this option.

   Show Group Row Header

   Specifies a timescale 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.

8. Complete the following fields in the Display section. The following term requires explanation:

   Decimal Places

   Defines the number of decimal places to return for the attribute. To specify the attribute as an integer, enter a zero (0).

9. Save your changes.