View results

After a session completes, use the following to understand the validation results.

Data Objects

Each data object represents a record (viewed as a row) from the dataset that was validated.

{

dataValidation {

session {

list(filters : {handle : {eq : 12345}}) {

dataObjects(

pagination

: {skip : 0, take : 50} orderBy

: [ {name : "numberOfIssuesTotalSource", direction : DESC} ]) {

handle objectName objectIntent objectContext uniqueIdentifier

sourceClassIdentifier transformedClassIdentifier breakdownClassIdentifier

classConceptIdentifier classConceptName maturityLevelIdentifier

maturityLevelName objectConformance objectRule sourceIndex

numberOfAttributes numberOfIssuesTotalSource

numberOfIssuesErrorsSource numberOfIssuesWarningsSource

numberOfIssuesSuggestionsSource numberOfIssuesHintsSource

completenessNominalSource completenessPreferredSource

completenessRequiredSource

inferredSourceMaturityLevelIdentifier

inferredSourceMaturityLevelName

inferredValidMaturityLevelIdentifier inferredValidMaturityLevelName

}

}

}

}

}

Data Object Entity Structure

Completeness metrics explained

• Nominal: Percentage of all defined attributes that have values

• Preferred: Percentage of preferred attributes that have values

• Required: Percentage of mandatory attributes that have values

• Source vs Valid: Source measures data as uploaded; Valid measures after transformation/correction

• Maturity levels: The system infers maturity levels based on data completeness and quality. Source maturity reflects the uploaded data quality; valid maturity reflects achievable quality after applying corrections.

Data Attributes

Each data attribute represents a column/property value for a specific data object.

{

dataValidation {

session {

list(filters : {handle : {eq : 12345}}) {

dataObjects(pagination

: {take : 5} filters

: {numberOfIssuesTotalSource : {gt : 0}}) {

objectName attributes(pagination : {take : 20}) {

handle attributeIdentifier attributeName attributeDescription

sourceValue transformedValue validValue valueIsArray sourceUoM

transformedUoM validUoM numberOfIssuesTotalSource

numberOfIssuesErrorsSource numberOfIssuesWarningsSource

}

}

}

}

}

}

Data Attribute Entity Structure

Key pattern: Compare sourceValue, transformedValue, and validValue to understand what was uploaded, how it was interpreted, and what the standard expects.

Validation Issues

Issues are specific problems found during validation, linked to data objects and attributes.

{

dataValidation {

sessionIssue {

list(

filters: { sessionHandle: { eq: 12345 } }

pagination: { skip: 0, take: 100 }

orderBy: [{ name: "severity", direction: ASC }]

) {

handle

severity

validationRuleName

validationRuleDescription

message

subject

}

}

}

}

Issue Entity Structure

Severity levels

• ERROR: Data fails a required standard — must be fixed

• WARNING: Data may cause problems — should be reviewed

• SUGGESTION: Improvement recommendation — optional to address

• HINT: Informational note — no action required

Validation rules

Validation rules define the checks applied during a session. Each rule has a default severity that can be overridden.

{

dataValidation {

validationRule {

list(pagination : {take : 50}) {

handle identifier name description messageTemplate defaultSeverity

severityIsFixed target category

}

}

}

}

Validation rule entity structure

Policy Rules (Severity Overrides)

Session policy rules represent per-session severity overrides applied to validation rules.

{

dataValidation {

sessionPolicyRule {

list(filters : {sessionHandle : {eq : 12345}}) {

handle severity sessionHandle validationRuleHandle etag

}

}

}

}

Update a severity override

mutation {

dataValidation {

sessionPolicyRule {

update(input

: {handle : 600 etag : "current-etag..." severity : "WARNING"}) {

handle severity etag

}

}

}

}

Note: Only rules where severityIsFixed is false can be overridden

Class Breakdowns and Metric Hierarchy

Class breakdowns provide hierarchical analytics across the validation results grouped by class structure.

Get metric hierarchy for a breakdown

{

dataValidation {

classBreakdown {

metricHierarchy(classBreakdownHandle : 50 sessionHandle : 12345 metricType

: ISSUE_COUNT)

}

}

}

Available metric types

{ dataValidation { classBreakdown { metricHierarchyMetricTypes } } }

Metric types include: issue counts, completeness measures, and inferred maturity levels across the class hierarchy.

Filter by file section

{

dataValidation {

classBreakdown {

metricHierarchy(classBreakdownHandle : 50 sessionHandle : 12345 metricType

: COMPLETENESS_REQUIRED filters

: {fileSectionHandle : {eq : 300}})

}

}

}

Notifications

Notifications track asynchronous processing events (exports, long-running operations).

{

dataValidation {

notification {

list {

handle name description resourceHandle resourceType resourceName status

statusReason retainUntil createdAt lastUpdatedAt

}

}

}

}