Property Spec

A property specification represents the properties that are required at agreement level. Property specs should only be created for objects of type productrequest spec and role spec.

General tab

The General tab contains all the main information about a property spec:

Name:

  • The name expresses its purpose; for example insured amount
  • Use the known business term to name the property spec.
  • Prefix the name with the name of the object to which the property spec is attached. This rule is applied to insure that all property spec names are unique within the product model.

Type:

  • The type of the property spec e.g. date, number, percentage, enumeration, string, text and Boolean. The type can be selected from the domain values defined in the Design Model Datatypes (DMD).
  • However this field may not be filled in if a mapping is done to the Business Model for the property spec.
  • When a mapping can be done for the property spec, then the type should be the same as the attribute in the Business Model to which that mapping points.

Default Value:

  • The value that is assigned to the properties when they are created.

Multiplicity:

  • The field allows to provide an indication to indicate whether there can be multiple occurrences of the property spec for the object type to which the property spec is attached.
  • It indicates whether the property is mandatory (default value) or optional (value if flagged).
Table 1. Multiplicity
Cardinality Optional Multiple occurrence
1..1 No No
0..1 Yes No
1..n No Yes
0..n Yes Yes
Documentation:
  • The definition should be seen as an additional description to complement the name.
  • The definition, or part thereof, can be appended from the mapping to the Business Model attribute (see chapter about mapping later on).
  • Allowed values and calculated values for a property spec are entered as example. This is the value that is allowed to be assigned to the properties. It imposes conditions on the value of the properties and these conditions have to be valid at all times.
  • Allowed values are handled by defining a constant specification that lists the values, in combination with a validity rule or data capture rule that checks that the selected value is in the list.
  • Calculated values are calculated internally for an agreement. For example, the deductible amount of a liability agreement can be calculated based on the value of the insured car.
  • The PSD does not explicitly associate the property specifications with a calculation. The link is indirect, through a product or a role specification.

The default for visibility is public and should not be modified.

Stereotypes tab

The object type should be set to property spec.

Mapping to other models

  • Kind mapping to the Business Model
    • The property specs can be mapped to the Business Model using the Abstraction type with the prefix of BOM in the name.
    • The mapping indicates the attribute in the Business Model that models the informational requirement represented by the property spec.
    • It is often relevant to append the definition of the source property to the property spec definition.
    • The data type should always be the same; it constitutes the conformance type of the property spec.
    • In case no proper attribute can be found for the property spec to be mapped to, then the property spec is a candidate to extend Business Model.

Assigned to Terms tab

The property specs can be mapped to the Business Terms or Scopes from the Insurance Business Glossary in Information Governance Catalog (IGC).

The mapping is done to a Business Term that represents the informational requirement that is implied by the property spec.

The definition of the Business Term can be appended if it is applicable to the property spec.

The mapping is done from the Products Model to the Business Term.

Note that reuse of property specs is not possible within the product model because the property specs are specified as properties of one type. Where same property specs are used multiple times in different types, the reuse is indicated on the Business Terms by mapping the multiple property specs to a same term in the Business Terms where that is applicable.