GetDataQualityAnalysisScoringResultSummary Method

Retrieves a Touchstone® Data Quality Analysis Scoring Results Summary that contains a summary of Data Quality Scoring results, organized by Data Quality Category.

The Score Data diagnostic calculates a Data Quality Score and an Overall Risk Score for individual Locations and for entire portfolios. The scores help you identify high-value exposures that warrant further investigation and augmentation (enhancement). The scores are peril-specific. The impact that missing exposure data has on modeled losses depends on the Location and characteristics of the risk and the peril under consideration. For example, missing construction characteristics have a greater impact on modeled losses in areas in which there is a lot of heterogeneity in the types of construction used and when the scoring methodology is considering a peril for which construction is a key variable.

The Data Quality Score measures the completeness of the exposure data. It quantifies inaccurate and missing primary risk characteristics in the exposure data that can contribute to uncertainty in modeled losses. Ranging from 0-100, a higher data quality score indicates better relative data quality, which can lead to reduced uncertainty. Touchstone calculates data quality scores for each Location in the analysis target and then combines them to produce various aggregate scores, such as for the entire portfolio and for each state. Portfolio-level Data Quality Scores are particularly valuable because they can help you to accomplish the following tasks:

Communicate portfolio-level data quality to underwriters, brokers, reinsurers, and rating agencies
Compare exposure data quality in portfolios
Assess the impact of a Data Quality augmentation
Monitor data quality enhancement of a portfolio over time

When calculating Data Quality Scores for individual locations, Touchstone considers the availability of known data for the following primary risk characteristics:

Geocode match level (Relaxed Address or better indicates good quality address information.)
Building construction code
Occupancy code
Year built
Number of stories

Syntax

Visual Basic (Declaration)
Visual Basic (Usage)
C#

Public Function GetDataQualityAnalysisScoringResultSummary( _
   ByVal request As GetDataQualityAnalysisScoringResultSummaryRequest _
) As GetDataQualityAnalysisScoringResultSummaryResponse

Dim instance As DataQualityAnalysisServiceClient
Dim request As GetDataQualityAnalysisScoringResultSummaryRequest
Dim value As GetDataQualityAnalysisScoringResultSummaryResponse
 
value = instance.GetDataQualityAnalysisScoringResultSummary(request)

public GetDataQualityAnalysisScoringResultSummaryResponse GetDataQualityAnalysisScoringResultSummary( 
   GetDataQualityAnalysisScoringResultSummaryRequest request
)

Parameters

request: Contains a GetDataQualityAnalysisScoringResultSummaryRequest that identifies the Touchstone-generated Analysis Sequential Identifier (SID) of the Data Quality Analysis Scoring Results Summary that you want to retrieve, along with the associated Business Unit SID and SQL Instance SID.

Return Value

A GetDataQualityAnalysisScoringResultSummaryResponse containing the Data Quality Analysis Scoring Results Summary that you have requested.

Remarks

To find the Business Unit SID to pass into this method, call the GetBusinessUnits() method.

To find the SQL Instance SID to pass into this method, call the GetSqlInstances() method.

To find the Analysis SID to pass into this method, call the GetDataQualityAnalyses() method. Alternately, you can call the GetActivity() method. The Analysis SID is stored in the GetActivityResponse.Activity.AnalysisSid property.

Example

The following example shows how to retrieve a Touchstone Data Quality Analysis Scoring Results Summary using the GetDataQualityAnalysisScoringResultSummary() method:

using System;
using AIR.Services.Common.Data;
using AIR.Services.DataQualityAnalysis.Api;
using AIR.Services.DataQualityAnalysis.Data;
            
class SnippetGetDataQualityAnalysisScoringResultSummaryRequest
{
    private static void GetAnalysisScoringResultSummary(int businessUnitSid, int sqlInstanceSid, int analysisSid)
    {
        DataQualityAnalysisServiceClient client = new DataQualityAnalysisServiceClient();
        GetDataQualityAnalysisScoringResultSummaryRequest request = new GetDataQualityAnalysisScoringResultSummaryRequest();
        request.BusinessUnitSid = businessUnitSid;
        request.SqlInstanceSid = sqlInstanceSid;
        request.AnalysisSid = analysisSid;
        GetDataQualityAnalysisScoringResultSummaryResponse response = client.GetDataQualityAnalysisScoringResultSummary(request);
        if (response.Status.Code == StatusCode.Success)
        {
            foreach (ScoringSummaryByDataQuality score in response.ScoringResultSummary.SummariesByDataQuality)
            {
                Console.WriteLine("DataQualityCategory: " + score.DataQualityCategory);
                Console.WriteLine("LocationCount: " + score.LocationCount);
                Console.WriteLine("PercentOfPortfolioLocations: " + score.PercentOfPortfolioLocations);
                Console.WriteLine("PercentOfTotalReplacementValue: " + score.PercentOfTotalReplacementValue);
                Console.WriteLine("TotalReplacementValue: " + score.TotalReplacementValue);
                Console.WriteLine("PercentOfQualityGeocode: " + score.PercentOfQualityGeocode);
                Console.WriteLine("PercentOfKnownConstruction: " + score.PercentOfKnownConstruction);
                Console.WriteLine("PercentOfKnownOccupancy: " + score.PercentOfKnownOccupancy);
                Console.WriteLine("PercentOfKnownStories: " + score.PercentOfKnownStories);
                Console.WriteLine("PercentOfKnownYearBuilt: " + score.PercentOfKnownYearBuilt);
            }
        }
    }
}

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

DataQualityAnalysisServiceClient Class
DataQualityAnalysisServiceClient Members