Underwriting rules object model

The following illustration shows the relationship between some of the entities for underwriting rules.

The following table describes some of the entities associated with underwriting issues.

Entity or object	Description
`PolicyPeriod`	Stores information for a specific period of a policy. The `UWIssuesIncludingSoftDeleted` array provides access to all issues on this policy, including those marked inactive.
`UWIssue`	These are the issues that evaluator classes create. The issues link to issue types and can contain an approval. These entities can vary in effective time and are copied from branch-to-branch, just like any other effective-dated entity. Some fields on this entity are: `IssueKey` and `IssueType` – These two fields uniquely identify the issue. `ShortDescription` – Description of the issue that appears in the user interface. `LongDescription` – Long description of the issue that appears in the user interface. Some users may have permission to view the short description but not the long description. `Value` – The value, if any, associated with this issue. If present, the value is compared with authority grants to determine if the user can approve this issue. The value is also compared with approvals to determine if the approval still applies.
`UWIssueHistory`	This entity represents a history of issues and approvals on the policy. The `IssueKey` field is a reference to the `UWIssue` with that `IssueKey`. PolicyCenter maintains the history in a set of non-effdated entities on the policy and outside of the context of any particular job or policy period. PolicyCenter maintains this history for the following reasons: The entity captures events that happen on branches that do not end up binding. The entity persists after issues are removed or approvals expire. The entity persists even if the related periods are archived. Since this entity attaches directly to the policy, it is retireable rather than effdated.
`Rule`	A rule defined in Administration > Business Settings > Business Rules.
`UWRule`	This entity defines an underwriting rule as defined in Business Rules > Underwriting Rules. Has a foreign key to `UWIssueType`.
`UWIssueType`	This entity defines the characteristics of an underwriting issue type. Contains the `Name` and `Code` that are defined in Underwriting Rules.
`UWReferralReason`	This entity is similar to the UWIssue entity but is accessible from the policy rather than the policy period. This entity is used for marking a policy issue outside of a job. It identifies the details of a corresponding `UWIssue` that will be generated the next time the application checks for `UWIssues`. Because of the close relationship between a `UWReferralReason` and the associated `UWIssue`, the default user interface displays them in a similar way. For more information, see Working With Add underwriting referral reasons and Configuring underwriting referral reasons.

The actual link between User and UWAuthorityProfile is through the array key from User to UserAuthorityProfile then through the foreign key from that entity to UWAuthorityProfile. For convenience, there is a derived array from User to UWAuthorityProfile.