DocsObject referenceEdit on GitHub

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

Fields

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

Type: string · Required · Default: —

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

Type: string · Optional · Default: —

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

sheet.json

{
  "sheet": "Sheet1"
}

range

Type: string · Optional · Default: —

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

range.json

{
  "range": "A1:D8"
}

columns

Type: array<string> · Optional · Default: —

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"
  ]
}