Risk version list entity

The RIRiskVersionList entity helps manage multiple versions of a single reinsurable risk on a policy period. An RIRiskVersionList holds all the RIRisk instances for a single reinsurable risk, in an array called AllVersions. RIRisk instances have a foreign key called VersionList that links them back to the RIRiskVersionList instance that holds them. An RIRiskVersionList has the same value for its RiskNumber property as the RIRisk instances that it manages.

An RIRisk instance relates to its policy period through the RIRiskVersionList instance that manages it. An RIRiskVersionList has a foreign key to its policy period, called PolicyPeriod. A PolicyPeriod instance has a derived array of its reinsurable risks, called AllRIRisks. If a PolicyPeriod has any related RIRiskVersionList instances in its AllRIRisks array, its ValidReinsurance property is true.

Properties of risk version lists

The RIRiskVersionList entity has a number of properties. The properties related to the reinsurance plugins and web service are described in the following table.

Property

Description

RiskNumber

Unique identifier of a reinsurable risk.

AllVersions

Array of RIRisk instances that represent different versions of the same reinsurable risk.

AttachmentInclusions

PolicyCenter creates an RIAttachmentInclusion if the inclusion status of the attachment differs from the default, Included. Therefore, only attachments that are excluded or have special acceptance have an attachment inclusion row. When you exclude an attachment, PolicyCenter creates an RIAttachmentInclusion with the status set to Excluded.

PolicyPeriod

Policy period to which all versions of a reinsurable risk provide reinsurance coverage. Each version covers a different effective date range that does not overlap with the others. Only of one version is active at a time, though sometimes none are active.

Methods on risk version lists

The RIRiskVersionList entity has a number of methods. The methods related to the reinsurance plugins and web service are described in the following table.

Method

Description

addToAttachmentInclusions

Adds an RIRisk to the array of RIAttachmentInclusion instances on this RIRiskVersionList. The array name is AttachmentInclusions. An RIAttachmentInclusion relates an RIRisk on a policy period to a reinsurance agreement.

addVersion

Adds an RIRisk to the array of RIRisks on this RIRiskVersionList. The array name is AllVersions.

endDate

Splits the active RIRisk by doing all of the following operations.

  • Sets ExpirationDate to today on the current RIRisk.
  • Creates a new RIRisk instance with the same RiskNumber as the original.
  • Sets the EffectiveDate on the new instance to today.
  • Replaces all remaining fields except ExpirationDate from the original.
  • Adds the new instance to the same RIRiskVersionList as the original.

getRIRisk

Gets the RIRisk that is active today.

getVersionAsOfDate

Gets the RIRisk that is active for a specified date.

removeFromAttachmentInclusions

Removes an RIRisk from the array of RIAttachmentInclusion instances on this RIRiskVersionList. The array name is AttachmentInclusions. An RIAttachmentInclusion relates an RIRisk on a policy period to a reinsurance agreement.