DocsObject referenceView source

Chart Data Source

Chart data sourced from an asset reference, URL, data URI, relative path, or local path such as CSV, TSV, JSON, or XLSX. The source is interpreted as a table; optional columns select or order fields from that…

Metadata

Definition: #/$defs/ChartDataSource
Type: object
Source: spec/schemas/opf.schema.json

Field index

Field	Type	Req.	Description
src	string	yes	Data source. Use 'asset:<id>' to reference the top-level assets registry, or provide an HTTPS URL, data URI, relative path, or local filesystem path.
sheet	string	—	Optional sheet name or table name for spreadsheet-like assets.
range	string	—	Optional A1-style range or engine-defined range selector for spreadsheet-like assets.
columns	array<string>	—	Optional ordered columns or fields to read from the source. When omitted, renderers may use the source's own header row or schema.

`src`

typestringrequiredyesdefault—

Data source. Use 'asset:<id>' to reference the top-level assets registry, or provide an HTTPS URL, data URI, relative path, or local filesystem path.

src.json

{
  "src": "asset:revenue"
}

`sheet`

typestringrequirednodefault—

Optional sheet name or table name for spreadsheet-like assets.

sheet.json

{
  "sheet": "Sheet1"
}

`range`

typestringrequirednodefault—

Optional A1-style range or engine-defined range selector for spreadsheet-like assets.

range.json

{
  "range": "A1:D8"
}

`columns`

typearray<string>requirednodefault—

Optional ordered columns or fields to read from the source. When omitted, renderers may use the source's own header row or schema.

columns.json

{
  "columns": [
    "Quarter",
    "Revenue"
  ]
}