SplitPercentageApply
The SplitPercentageApply assignment type, configured in transaction XML, is used to apply money removed from a contract by the SplitPercentageRemoval assignment type. The money removed is applied to a different contract as that from which money was removed using the SplitPercentageRemoval assignment. SplitPercentageApply can apply the money to either the same group of funds or a different group of funds as used by SplitPercentageRemoval.
The valuation records for the corresponding SplitPercentageRemoval assignment are used as the data source for the SplitPercentageApply assignment–the user configures SplitPercentageApply's attributes to link back to the valuation records created by SplitPercentageRemoval.
Data Storage
For both inception and Point-in-Time valuation, valuation records are created for each SplitPercentageApply with effective dates equal to the activity's effective date. However, these valuation records are stored differently depending on the valuation type:
- For Inception valuation, SplitPercentageApply will create new AsValuation records upon processing, with values obtained from the corresponding SplitPercentageRemoval's Activity GUID.
- For Point-in-Time valuation, processing works the same as with Inception valuation, except in the way that data is stored in the valuation tables. If deposit-level tracking is set to "Fund," Point-in-Time valuation records are created in the following tables, reflecting the amount applied by the SplitPercentageApply assignment:
- AsDepositValue
- Beginning and End Value records are created for each deposit of each fund.
- If the Apply is occurring on the same funds as the Removal, the Original Deposit Date is captured in the new column OriginalDepositDate. The values in this column are equal to the Effective Dates of the original deposits.
- The Effective Date of the AsDepositValue is equal to the effective date of the activity that initiated the SplitPercentage Removal
- AsDepositValueField
- AsDepositValuationEffect
- AsFundValueField
- AsFundValuationEffect
- AsPolicyValue
- Beginning and End Value records are created for each SplitPercentageRemoval processed.
- AsPolicyValueField
- AsPolicyValuationEffect
- AsPolicyValuesCalculation
- AsPolicyValuesCalculationField
- AsDepositValue
- For PIT valuation with fund-level tracking, the AsDeposit tables above are not populated, but the applicable percentage is deducted from each fund value.
Type = SplitPercentageApply | ||
---|---|---|
Attributes |
SPLITPERCENTAGEREMOVALGUID |
Required: This attribute's value should be a math variable that resolves to an Activity GUID of the corresponding removal. |
SPLITPERCENTAGEREMOVALMONEYTYPE |
Required: This attribute's value should be a typecode defined in AsCodeMoneyType. This typecode identifies the MoneyType of the corresponding removal valuation records. The MoneyType is needed to help identify the portion of the removal that needs to be applied to the new policy. |
|
SPLITPERCENTAGEAPPLYMONEYTYPE |
Required: This attribute's value should be a typecode defined in AsCodeMoneyType. This type identifies the MoneyType of the source of the funds. |
|
CURRENTALLOCATIONCOLLECTION |
Optional: This attribute's value should be a Collection math variable. The keys used are the GUIDs of the source funds from which money was removed with SplitPercentageRemoval, and the associated values are the GUIDs of the funds to which the money is being applied. This attribute only needs to be used if the Removal and Apply assignments use different funds. Note: If the Collection resolves to NULL, the system will attempt to process the Apply activity's assignment using the same funds that were used in the corresponding Removal. If any of the funds are not available to the Apply activity's plan, a system error will occur. |
|
Element Value |
None |
|
Note: Unlike other assignment types, the SplitPercentageApply assignment's MoneyType is defined in the SPLITPERCENTAGEAPPLYMONEYTYPE attribute, rather than in the <MoneyType> element. |
||
Used when |
To apply money removed from a contract by the SplitPercentageRemoval assignment type. |
XML Example
<Assignment TYPE=”SplitPercentageApply” SPLITPERCENTAGEREMOVALGUID="TransferAssetsOutActvitivyGUID" SPLITPERCENTAGEAPPLYMONEYTYPE=”100” CURRENTALLOCATIONCOLLECTION=”FundList”>
</Assignment>