Skip to main content

Value

A typed scalar attached to an entity via a property. Each Value carries data in exactly one of the typed scalar fields (text, integer, float, boolean, date, datetime, etc.) — which one depends on the property's declared dataType.

type Value implements Node {
  nodeId: ID!
  id: String!
  propertyId: UUID!
  entityId: UUID!
  spaceId: UUID!
  text: String
  language: LanguageTag
  unit: String
  boolean: Boolean
  decimal: BigFloat
  point: GeoPoint
  time: TimeString
  integer: BigInt
  float: Float
  bytes: Bytes
  date: DateString
  datetime: DateTimeString
  schedule: JSON
  embedding: JSON
  timeUtc: Time
  datetimeUtc: Datetime
  rect: GeoRect
  propertyEntity: Entity
  entity: Entity
  space: Space
  property: PropertyInfo
}

Fields​

Value.nodeId ● ID! non-null scalar​

A globally unique identifier. Can be used in various places throughout the system to identify this single value.

Value.id ● String! non-null scalar​

The value's stable UUID. Useful for diffing across edits and for delete operations.

Value.propertyId ● UUID! non-null scalar​

The property this value is attached to (e.g., a126ca530c8e48d5b88882c734c38935 for Name). Cross-reference with propertyEntity to get the human-readable property name.

Value.entityId ● UUID! non-null scalar​

The entity this value is attached to.

Value.spaceId ● UUID! non-null scalar​

The space this value was published in. The same logical entity can carry different values in different spaces.

Value.text ● String scalar​

The text payload (only set when the property's dataType is TEXT or URL).

Value.language ● LanguageTag scalar​

BCP-47 language tag for text values, e.g., en-US. Null when the value isn't language-tagged.

Value.unit ● String scalar​

Unit hint for numeric values, e.g., "USD", "meters". Free-form string. Null when no unit applies.

Value.boolean ● Boolean scalar​

The boolean payload (only set for BOOLEAN properties).

Value.decimal ● BigFloat scalar​

The arbitrary-precision decimal payload (only set for DECIMAL properties).

Value.point ● GeoPoint scalar​

The geographic point payload (only set for POINT properties), in (lon, lat) form.

Value.time ● TimeString scalar​

The time-of-day payload as an unanchored time string (only set for TIME properties).

Value.integer ● BigInt scalar​

The 64-bit integer payload (only set for INTEGER properties). Returned as string-encoded BigInt.

Value.float ● Float scalar​

The 64-bit float payload (only set for FLOAT properties).

Value.bytes ● Bytes scalar​

The opaque byte-array payload (only set for BYTES properties), base64-encoded.

Value.date ● DateString scalar​

The calendar date payload (only set for DATE properties), as YYYY-MM-DD. Partial dates are not allowed.

Value.datetime ● DateTimeString scalar​

The timestamp payload (only set for DATETIME properties), as ISO 8601 with timezone.

Value.schedule ● JSON scalar​

The schedule payload (only set for SCHEDULE properties). RFC 5545/7953 schedule object encoded as JSON.

Value.embedding ● JSON scalar​

The dense-vector embedding payload (only set for EMBEDDING properties), as a JSON array of floats.

Value.timeUtc ● Time scalar​

Time payload normalized to UTC (computed from time + timezone hints). Convenience for time-series queries.

Value.datetimeUtc ● Datetime scalar​

Datetime payload normalized to UTC. Convenience for time-series queries.

Value.rect ● GeoRect scalar​

The bounding-rectangle payload (only set for RECT properties), as two corners.

Value.propertyEntity ● Entity object​

Reads a single Entity that is related to this Value.

Value.entity ● Entity object​

Reads a single Entity that is related to this Value.

Value.space ● Space object​

Reads a single Space that is related to this Value.

Value.property ● PropertyInfo object​

Joined PropertyInfo record for this value's property. Lighter than fetching the full property entity.

Interfaces​

Node interface​

An object with a globally unique ID.

Returned By​

value query ● valueByNodeId query ● values query

Member Of​

Entity object ● Space object ● ValuesConnection object ● ValuesEdge object

:::tip See also

Cookbook recipes that use this:

:::