The LinkListAttributeSum business rule calculates the sum
of a Float or Integer attribute for elements that are in a Link, Link
List, or Incoming Links attribute.
The sum is displayed in the business rule container attribute.
When changes occur, the sum is automatically recalculated. Use this
business rule when you want to aggregate data, such as estimates or
cost figures from requirements in a release or projects in a portfolio.
Note: Do
not use the LinkListAttributeSum business rule for Incoming Link attributes
that only display links from views.
Prerequisites
- In the target module, a Link, Link List, or Incoming Links attribute
that lists the elements from which values are gathered
- In the source module, a Float or Integer attribute that contains
the value for the calculation
- In the target module, a business rule container attribute in which
the sum is displayed. The attribute can be of type Text, Float, or
Integer.
Format
In the business rule container attribute,
type the business rule in the following format:
=LinkListAttributeSum("Link Attribute Name","Source Attribute Name","listen_to=Source Attribute Name",'Link Attribute Name',"secure")
Parameters
Table 1. LinkListAttributeSum
parameters
"Link Attribute Name" |
The attribute that contains links to other elements |
"Source Attribute Name" |
The attribute to search for in the listed elements |
"listen_to=Source Attribute Name" |
Detects changes in this attribute |
'Link
Attribute Name' |
The
attribute that contains links to other elements |
"secure" |
If this parameter is set and any of the included attribute
values are 0 or are not set, the sum is 0. |