Skip to content

Add Helper Text for Data Property Types in Schema Explorer Sidebar #1519

@kmcginnes

Description

@kmcginnes

Problem

The Schema Explorer sidebar displays JavaScript types (e.g., string, number, boolean) for data properties. These are derived from the JSON response and do not map 1:1 to the native database types (e.g., xsd:integer, xsd:dateTime, int, double). Additionally, property types are discovered through sampling, which may not capture all properties or all unique types that exist in the database. There is currently no indication of either of these caveats, which can mislead users into thinking they are seeing an exact representation of their database schema.

Proposed Solution

Add helper or description text in the sidebar that communicates:

  1. Types are approximate — The displayed types are inferred from the JSON response and may not match the exact types in the database.
  2. Sampling limitations — Properties and types are discovered through sampling, so the list may be incomplete.

Acceptance Criteria

  • Helper text is visible in the Schema Explorer sidebar near the property type information.
  • The text clearly communicates that types are derived from the JSON response, not the database.
  • The text clearly communicates that sampling is used and results may be incomplete.

Metadata

Metadata

Assignees

No one assigned

    Labels

    fundamentalusabilityIssues relating to the ease of use of the UI or features

    Projects

    No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions