Data model designs for risk units and incidents
Damageables are not relevant to every type of risk unit and incident. A damageable is needed only if the item that can be damaged could be listed on the policy, but also could not be listed on the policy. Consequently, risk units and incidents typically use one of two different data model designs.
Design 1: Risk units and incidents with no damageable
Damageable entities are typically not used when the damaged item must always be listed on the policy.
For example, a Travel policy only covers losses related to trips listed on the
policy. A Travel claim typically has trip incidents. But a claim's trip must always
be listed on the policy. Therefore, there is no separate "Trip" damageable. Every
TripIncident
is directly associated with the appropriate
TripRU
.
The following diagram shows the data model design for this case.
![Risk units and incidents with no damageable](../../../graphics/IRU01_Risk-units-and-incidents-with-no-damageable.png)
Note the following:
- The incident has a foreign key to the risk unit.
- The risk unit has a
PolicySystemId
field. This field can be used in Cloud API to identify a risk unit by itspolicySystemId
.
Design 2: Risk units and incidents with damageables
Damageable entities are typically used when the damaged item could be listed on the policy, but also could not be listed on the policy.
For example, a Personal Auto claim has vehicle incidents and
vehicle risk units. A vehicle could be owned by the insured and listed on the
policy. In this case, it is referenced by the VehicleRU
entity. (If the vehicle was involved in the claim, it is also referenced by the
VehicleIncident
entity.) However, a claim vehicle could also be
owned by a third party and therefore not listed on the policy. In this case, it is
referenced only by the VehicleIncident
entity. Thus, there is a
separate damageable entity for Vehicle
.
The following diagram shows the data model design for this case.
![Risk units and incidents with damageable](../../../graphics/IRU02_Risk-units-and-incidents-with-damageable.png)
Note the following:
- Both the incident and the risk unit have foreign keys to the damageable
(
Vehicle
). - The risk unit has a
PolicySystemId
field. This field can be used in Cloud API to identify a risk unit by itspolicySystemId
. - The damageable includes the following fields:
PolicyVehicle
- This is a Boolean field that identifies whether the vehicle is listed on the policy (such as for an incident for the insured's vehicle) or not (such as for an incident for a third party's vehicle).PolicySystemId
- This can be used in Cloud API to identify a vehicle by itspolicySystemId
.