Data fields overview

Data fields (fields) define the data that may be collected to rate a risk. The provided values are used for collecting data; creating underwriting rules; and determining the premium, limit, and deductible values.

On a quote, field values are collected in the following ways:

  1. User input.
  2. Business rules.
  3. Third-party partner integrations.

Field values are required when:

  1. Items on a quote reference them.

    Note: To determine an item’s premium, the field must contain a value (answer).

  2. In the Field Settings section, the Always show this field setting is set to Yes.

Field types

When adding a data field to a risk type, you can choose from several different types. Your use case will determine the type you should choose.

Table 1: Types of data fields.

TypeDescriptionUI Format
BooleanA field that stores as either true or false.A Yes/No switch widget.
NumberAn arithmetical value.A text box that allows only numbers.
StringA string of text-based characters.A standard text box.
Option SelectionA selection from a list of options. For more information, see the Open Selection fields section below.A select box that allows a single choice.
DateA standard date stored in ISO format.A date-picker widget that formats the date as MM/DD/YYYY.
ComputedA field with a value determined by a calculation.

Computed fields are:
  • Evaluated before rating the risk.
  • Displayed as a value to the user but isn't part of the premium calculation.
Note: Since computed fields can’t be manually edited, they are always optional.
A disabled input.

Option Selection source

Option Selection fields can use risks from other risk types as their data source.

Example: If you have a Driver Risk Type as a child of the Policy Risk Type, you can give a Vehicle Risk Type a Principal Driver.

Note: To set up this example, see Use a risk type as an Option Selection source.

Optional fields

To require the data fields that are displayed even when not required for rating:

  • In the Fields Settings section, under Required, select Yes.

Note: This is only for fields not used in rating. The fields that are used will become required unless wrapped in [bc.optional](rating.md#bcoptional).

Default values

Many field types support default values for data fields. When a user creates a risk, BriteCore assigns the field’s default value.