GetDataQualityAnalysisValidationResultSummary Method

Retrieves a Touchstone® Data Quality Analysis Validation Result Summary that contains information about construction, occupancy, height, age, Location count, failed Location count, primary risk characteristics, secondary risk characteristics, limits, and deductibles.

The Data Validation analysis enables you to assess the quality of your exposure data by evaluating your portfolio against a set of completeness rules and reasonability rules. Completeness rules enable you to learn about where information is missing in your exposure data. Reasonability rules help you to determine if the exposure data contains combinations of attributes that typically are not found together. For example, it is not reasonable for a wood frame building to be 10 stories high. It is not reasonable for a reinforced masonry building to have been built prior to 1950. It is not reasonable for a residential family home to be built of light metal.

Syntax

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

Public Function GetDataQualityAnalysisValidationResultSummary( _
   ByVal request As GetDataQualityAnalysisValidationResultSummaryRequest _
) As GetDataQualityAnalysisValidationResultSummaryResponse

Dim instance As DataQualityAnalysisServiceClient
Dim request As GetDataQualityAnalysisValidationResultSummaryRequest
Dim value As GetDataQualityAnalysisValidationResultSummaryResponse
 
value = instance.GetDataQualityAnalysisValidationResultSummary(request)

public GetDataQualityAnalysisValidationResultSummaryResponse GetDataQualityAnalysisValidationResultSummary( 
   GetDataQualityAnalysisValidationResultSummaryRequest request
)

Parameters

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

Return Value

A GetDataQualityAnalysisValidationResultSummaryResponse containing the Data Quality Analysis Validation Result Summary that you have requested.

The Validation Result Summary includes the rule type, rule category, Location count, failed Location count, and construction and occupancy information.

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 Validation Result Summary using the GetDataQualityAnalysisValidationResultSummary() method:

using System;
using AIR.Services.Common.Data;
using AIR.Services.DataQualityAnalysis.Api;
using AIR.Services.DataQualityAnalysis.Data;
            
class SnippetGetDataQualityAnalysisValidationResultSummaryRequest
{
    private static void GetAnalysisValidationResultSummary(int businessUnitSid, int sqlInstanceSid, int analysisSid)
    {
        DataQualityAnalysisServiceClient client = new DataQualityAnalysisServiceClient();
        GetDataQualityAnalysisValidationResultSummaryRequest request = new GetDataQualityAnalysisValidationResultSummaryRequest();
        request.BusinessUnitSid = businessUnitSid;
        request.SqlInstanceSid = sqlInstanceSid;
        request.AnalysisSid = analysisSid;
        GetDataQualityAnalysisValidationResultSummaryResponse response = client.GetDataQualityAnalysisValidationResultSummary(request);
        if (response.Status.Code == StatusCode.Success)
        {
            foreach (ValidationSummary validation in response.ValidationResultSummary)
            {
                Console.WriteLine("RuleSetType: " + validation.RuleSetType);
                Console.WriteLine("RuleSubType: " + validation.RuleSubType);
                Console.WriteLine("LocationCount: " + validation.LocationCount);
                Console.WriteLine("LocationFailedCount: " + validation.LocationFailedCount);
            }
        }
    }
}

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