Configuring risk assessment in the Location Information screen

The Location Information screen displays risk assessment information and a thumbnail map.

Risk assessment information

In Commercial Property, the Location Information screen displays risk assessment information. When the user enters this screen, CPLocationPopup.pcf, the screen checks whether the current location data differs from what was used to generate the existing LocationRiskAssessment, if one exists. If there is a difference, the screen displays a warning indicating that the current risk assessment may be out-of-date, or stale. This warning also appears on the Buildings and Locations screen for any location with a stale risk assessment. The LocationRiskAssessment.isRiskAssessmentStale property indicates whether the risk assessment is stale or not.

To perform this check for stale risk assessments, a non-persisted OutboundLocationRiskAssessmentTempStore is created and populated with the current location data. The spatial point and hash value of this object are calculated and compared with the spatial point and hash value of the latest LocationRiskAssessment. The hash value is available in the LocationRiskAssessment.InputChecksum property.

The hash value is determined by a list of properties on the OutboundLocationRiskAssessmentTempStore. The list of properties is specified in the RiskAssessmentInputDataHasher property in the RiskAssessmentInputDataHasher class. The Location Risk Assessment plugin calls RiskAssessmentInputDataHasher.

The hash value is calculated using the following list of properties:

  • Branch.PeriodStart
  • Branch.PeriodEnd
  • GeocodeableAddress
  • City
  • County
  • PostalCode
  • State
  • Country

You can configure the list of fields in the hash to meet your needs.

Note: Do not include the SpatialPoint among the fields used for hashing. The spatial point on the OutboundLocationRiskAssessmentTempStore does not reflect changes in spatial point that occur while the user is in Spotlight.

Risk assessment thumbnail map

The Location Information screen in PolicyCenter displays a thumbnail map embedded in the CPLocationPopup.pcf. The map is provided by Spotlight and has a pin dropped on the current best-known location. If the location has latitude and longitude, then the pin is placed on that location. Otherwise, the address fields are used to place the pin. You can update the map to reflect changes to coordinates or address by clicking Update Map. As previously mentioned, address-only changes do not affect the map if the location already has coordinates.

The embedded map uses the template panel to link to the Spotlight client and enables PolicyCenter to display the embedded map. The createSpotlightMapURL method in SpotlightConfigParameters.gs creates the URL.

Note: The thumbnail map content returned by Spotlight is licensed and subject to change. You can render the content but do not parse it.