Step 3:  Configure the PolicyValues Rule

This rule is configured at the plan level.  It is used by the ValueScreen rule and by transactions that perform valuation.  This business rule is the ONLY configurable portion of the ValuationXML that stores valuation values.  The rest of the ValuationXML is hard coded by the system.  Review the OIPA Valuation Mechanism for a description of the ValuationXML.

When this rule is used in conjunction with the ValueScreen rule, it feeds the values that are displayed for a policy on the OIPA Value screen.  This rule specifies the MathVariables that are to be used for calculating the policy value and then determines what can be displayed on the Values screen.  The Value screen rule is configured to control the format of how to display the values pulled from the results of PolicyValues rule as well.  Please refer to the Value screen section to learn how to configure the Value screen.

When this rule is used in conjunction with a transaction, the transaction’s XML must contain the <Valuation> element as well as the attribute POLICYVALUES=”Yes".  The transaction must contain <Valuation POLICYVALUES=”Yes”> for this rule to be invoked.  The POLICYVALUES attribute controls the value processing as follows:

• When the attribute is set to Yes, policy values will be calculated.

• When the attribute is set to No, calculation of policy values will be turned off and the PolicyValue information in the Valuation XML will be empty.

• When no attribute is present, it is treated as if POLICYVALUES is set to Yes, hence policy values will be calculated.

PolicyValues XML Schema

<PolicyValues>

    <MathVariables>

        <MathVariable VARIABLENAME="" TYPE="" DATATYPE=""></MathVariable>  

        <MathVariable VARIABLENAME="" TYPE="" DATATYPE=""></MathVariable>  

        <MathVariable VARIABLENAME="" TYPE="" DATATYPE=""></MathVariable>  

        <MathVariable VARIABLENAME="" TYPE="" DATATYPE=""></MathVariable>      

    </MathVariables>

</PolicyValues>

Steps to Configure the PolicyValues Business Rule

1. Navigate to the Plan folder via the Main Explorer.

2. Expand the Plan Rules | PolicyValues folder.

3. Check-out the PolicyValues.xml file.

4. Configure the business rule.

5. Check-in the rule to save your changes to the database.

Each MathVariable will be listed in the ValuationXML for a policy value.  The valuation structure has a special section where policy values are stored, which begins and ends with the <PolicyValuesXML> element.   An example of the policy values XML is illustrated below.