Skip to content
English
  • There are no suggestions because the search field is empty.

Asset Schema Tab

The Schema tab under the Device view provides a detailed mapping of all telemetry and data fields associated with a specific device. It displays the underlying data model that defines how telemetry values are structured, their types, and their sources.

Purpose

This section helps administrators, support teams, and integrators understand the format and scope of the data being collected from the device. It is particularly useful when:

  • Investigating telemetry issues.

  • Aligning schema mapping with external systems.

  • Reviewing or preparing data for use in workflows and reports.

 


Accessing the Schema Tab

To access this view:

  1. Navigate to Asset Configuration from the main menu.

  2. Select the relevant asset.

  3. Click the Devices tab.

  4. Choose the installed device you want to inspect.

  5. Open the Schema tab from the sub-navigation menu.

 


Interface Overview

The Schema tab displays a structured table with the following columns:

Column Description
Schema ID Identifies the data schema that the property belongs to. Examples include GeotabDevice, DeviceState, or StateBase.
Property Name The internal name used to identify the telemetry property (e.g., engineSpeed, fuelLevelPct).
Property Title A user-friendly title describing the field (e.g., "Engine Speed", "Fuel Level").
Value Type Indicates the format of the data. Common types include number, string, and boolean.

The Search Asset field at the top allows for filtering and quick lookup of specific properties.

 


Use Cases

Troubleshooting and Diagnostics

Locate specific properties (such as ignition, fuel level, or GPS coordinates) to confirm if they are correctly ingested or mapped.

Integration Mapping

Review telemetry fields before integrating with ERP or compliance systems. Understanding the data type and source schema ensures clean mapping and minimal errors.

Custom Reporting

Identify available fields for custom dashboards and reports. Knowing which schema the data belongs to helps when building logic in workflows or calculations.

Schema Validation

Use this tab to confirm that all expected telemetry fields are present after installing a new device or switching providers.

 


Exporting Schema

Click the Export button in the top-right corner to download the full schema for the selected device. This exports a structured .CSV file that can be used for offline review, sharing, or documentation.

 


Schema ID Reference

Some examples of common schema IDs you may encounter:

Schema ID Description
GeotabDevice Telemetry fields directly from Geotab devices
DeviceState Internal state fields derived by the device
StateBase Generic or platform-derived values such as GPS coordinates
FlexibleTwin Values injected from third-party systems or back-end processing
BleTemperature Temperature from the BLE sensor connected to the device.
BleHumidity Humidity from the BLE sensor connected to the device.

 


Notes

  • This tab does not show the current value of each field. To view real-time or most recent values, refer to the Current State tab.

  • Properties listed as N/A in other sections still appear in the Schema view to indicate that the system expects to receive those fields.