Risk entity

The RIRisk entity represents a reinsurable risk on policy period. If a policy period qualifies for reinsurance coverage, each reinsurable risk has a list of RIRisk instances.

Effective dates on risk instances

The RIRisk entity has effective dates. All RIRisk instances have EffectiveDate and ExpirationDate properties, because the RIRisk entity is an implementation of a SimpleEffDated entity. An RIRisk instance represents the details of one reinsurable risk for one interval of effective time on a policy period. Multiple RIRisk instances can represent the same reinsurable risk on a policy period for different, non-overlapping intervals.

RIRisk instances for the same reinsurable risk have the same value for their RiskNumber properties. Each instance one represents the details of the reinsurable risk during different effective date ranges. Effective date ranges must abut and not overlap. Together, the instances represent a timeline of changes to the reinsurable risk, during the policy period. When the details of a reinsurable risk change, PolicyCenter splits the active RIRisk in two. The original and new RIRisk instances have different effective date ranges that abut and do not overlap.

Reasons other than changes to a reinsurable risk cause PolicyCenter to split RIRisk entities in two. For example, an instance of reinsurance entity that links to an instance of an RIRisk changes. As a result, PolicyCenter splits all related reinsurance instances in two that are in effect on the effective date of the change, including the RIRisk.

Multiple RIRisk instances with the same RiskNumber represent one reinsurable risk on a policy period. RIRisk instances with the same RiskNumber must have effective date intervals that abut and do not overlap.

Properties of risk instances

The RIRisk entity has a number of properties. The important properties for the reinsurance plugins and web service are listed below.

Method	Description
`Agreements`	Array of `ReinsuranceAgreement` instances associated with this risk.
`Attachments`	Array of `ReinsuranceAttachment` instances associated with this risk.
`Reinsurable`	Foreign key to the reinsurable risk (a subtype of `Reinsurable`) that this `RIRisk` describes.

Methods on risk instances

The RIRisk entity has a number of methods. The methods for the reinsurance plugins and web service are described below.

Method	Description
`attach`	Attaches this `RIRisk` to a reinsurance agreement. The attach method takes a reinsurance agreement (`RIAgreement`) and a reinsurance program (`RIProgram`). A reinsurance agreement can be belong to several reinsurance programs.
`canAttach`	Determines whether you can attach a given `ReinsuranceAgreement` to this `RIRisk`. If errors that prevent attachment are not found, then the canAttach method returns an empty list, not `null`. If errors that prevent attachment are found, then the canAttach method returns a list of the errors as human-readable `String` values.
`detach`	Detaches a risk or policy attachment from an agreement. The detach method has two signatures. One takes an `RIRisk`, and the other takes an `RIPolicyAttachment`.
`makeActive`	Makes this `RIRisk` of the reinsurable risk the active version. The active version is the `RIRisk` is the one that is in effect today.