Developer Portal
Expert Center
API ReferenceConsole

Step 7: Validate

After completing the push process, it’s important to Validate that your enriched knowledge graph is an accurate depiction of the building, and that it meets your expectations. This guide provides GraphQL queries to verify different aspects of your pushed data.

Use these queries to validate entity classifications, derived entities and relationships, and unified entity mappings.

Prerequisites

  • Complete the Push step from Expert Center
  • Access to an Organization's Console and GraphiQL Explorer. Contact [email protected] if you need assistance with access.
  • Building ID from your organization, which you can copy from the Organization Overview

Validation Queries

Replace YOUR_BUILDING_ID with your actual building ID in all queries below.

1. Validate Spaces and Floor Structure

Verify that building spaces and floors are properly structured:

Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
  buildings(filter: {id: {eq: "YOUR_BUILDING_ID"}}) {
    id
    name
    floors {
      id
      name
      spaces {
        id
        name
        description
        exactType
      }
    }
    spaces {
      id
      name
      description
      exactType
      mappingKey
    }
  }
}

2. Validate Equipment and Relationships

Check that Things (equipment) are properly classified and connected:

Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
{
  buildings(filter: {id: {eq: "YOUR_BUILDING_ID"}}) {
    things {
      id
      name
      description
      exactType
      mappingKey
      hasLocation {
        id
        name
        exactType
      }
      hasPart {
        ... on Thing {
          id
          name
          exactType
        }
      }
      isPartOf {
        ... on Thing {
          id
          name
          exactType
        }
      }
      feeds {
        ... on Thing {
          id
          name
          exactType
        }
        ... on Space {
          id
          name
          exactType
        }
        ... on Zone {
          id
          name
          exactType
        }
      }
      isFedBy {
        ... on Thing {
          id
          name
          exactType
        }
      }
    }
  }
}

3. Validate Collections

Check collection and/or system composition:

Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  buildings(filter: {id: {eq: "YOUR_BUILDING_ID"}}) {
    collections {
      id
      name
      description
      exactType
      mappingKey
      hasPart {
        ... on Thing {
          id
          name
          exactType
        }
      }
    }
  }
}

4. Check Zones and HVAC Relationships

Validate zones and their HVAC system connections:

Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
{
  buildings(filter: {id: {eq: "YOUR_BUILDING_ID"}}) {
    zones {
      id
      name
      description
      exactType
      isServedBy {
        id
        name
        exactType
      }
      isFedBy {
        ... on Thing {
          id
          name
          exactType
        }
      }
      hasPart {
        ... on Space {
          id
          name
          exactType
        }
        ... on Zone {
          id
          name
          exactType
        }
      }
    }
  }
}

5. Validate Points

Check that sensor points are properly classified and connected:

Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
  buildings(filter: {id: {eq: "YOUR_BUILDING_ID"}}) {
    points {
      id
      name
      description
      exactType
      unit {
        name
        description
      }
      isPointOf {
        ... on Zone {
          id
          name
        }
        ... on Thing {
          id
          name
        }
      }
    }
  }
}

*** 6. Check Point Data and Latest Values ***

Verify that points have recent data:

Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  buildings(filter: {id: {eq: "YOUR_BUILDING_ID"}}) {
    points {
      id
      name
      exactType
      series(latest: true) {
        timestamp
        value {
          float64Value
        }
      }
    }
  }
}

Validation Checklist

After running these queries, verify the following:

  • ✓Spaces and floors are properly structured
  • ✓ Equipment (Things) have appropriate classifications
  • ✓ Equipment relationships (feeds, isFedBy) reflect system connections
  • ✓ Collections group related equipment appropriately
  • ✓ Points are classified and connected to parent equipment/zones
  • ✓ Recent data is available for active points

Completion

Congratulations! You’ve completed the Expert Center enrichment process. Your building now has a validated, unified knowledge graph ready to power advanced analytics and operations.

Next Steps

Once you’ve validated your knowledge graph data, you can integrate with downstream systems via GraphQL API and monitor data quality and update as needed. For ongoing data management, return to Expert Center to make updates and push changes as required.