PrecisionValues

This business rule controls the number of digits to the right of the decimal point when displaying or calculating unit values or units. This rule is a system rule that follows a Policy context. It may also be attached to transactions to impact unit precisions for the Benefit Split feature's Accumulation and Benefit levels. This follows the Activity Policy context. As an attached business rule, the values are ultimately stored as units in AsValuation and AsBenefitSplit tables. When this business rule is not defined within the scope of these contexts, the system reverts to its default setting of 10 decimal places.

As of the v9.5.0.0 release, this business rule has absorbed the UnitValuePrecision rule functionality.

PrecisionValues Elements and Attributes
Elements Attributes Parent Element Description Element / Attribute Values
<PrecisionValues>     This is the root element of the rule.  
<PrecisionValue>   <PrecisionValues>

Optional, Repeatable:

This element defines a definition structure for the value that is being controlled and when it is being controlled.

  
  TYPE <PrecisionValue>

Required:

This attribute identifies the value whose precision to control.

  • Units

    • The number of units is controlled by the element's definition

  • UnitValue

    • The fund's unit value is controlled by the element's definition
<Precision>   <PrecisionValue>

Required, Repeatable:

This element is a structure that indicates when the value is controlled and if the precision is truncated.

  • integer

    • Valid value must be an integer
  TYPE <Precision>

Required:

This attribute indicates when the precision of the value is controlled during calculation or display.  For the same value, the precision of the calculated value can be different than the precision of the displayed.  In practice, displayed values may carry less or equal precision than calculated values.

  • Calculation

    • Only valid when <PrecisionValue TYPE="Units">, otherwise ignored

  • Display

    • Valid for any <PrecisionValue>
  METHOD <Precision>

Optional:

This attribute describes how the value is determined at the defined precision.

  • Truncate

    • Valid only when <PrecisionValue TYPE="UnitValue"> and <Precision TYPE="Display">

    • The value is truncated at the precision defined

    • This is the only value for the attribute

XML Schema

<PrecisionValues>
    <PrecisionValue TYPE="Units">
        <Precision TYPE="[Calculation | Display]">[integer]</Precision>
        <Precision>...</Precision>
    </PrecisionValue>
    <PrecisionValue TYPE="UnitValue">
        <Precision TYPE="Display" METHOD="Truncate">[integer]</Precision>
    </PrecisionValue>
</PrecisionValues>

XML Example

<PrecisionValues>
    <PrecisionValue TYPE="UnitValue">
        <Precision TYPE="Display">4</Precision>
    </PrecisionValue>
    <PrecisionValue TYPE="Units">
        <Precision TYPE="Calculation">6</Precision>
        <Precision TYPE="Display">3</Precision>
    </PrecisionValue>
</PrecisionValues>