Resolve a reference a document writes
folio_embedRead-onlyIdempotent
Resolve a document's data reference from its folder and return the table, value, or figure it shows; use it to verify a reference before writing it into a document.
Instructions
Resolve one data reference as a document writes it in {table: ...}, {value: ...}, a figure or a chart, from that document's folder, and return what it shows there. Use it to check a reference before writing it into a document, or to read the value a page shows; for a question of your own over the data use folio_query. Answers {version, grid: {columns, rows, total, partial} for a table, value: for a reference naming one value, error: why the reference resolves to nothing}. A list cut to fit one answer adds omitted, the entries each list left out, and narrow, how to ask for less.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | The document whose folder the reference resolves from, relative to the served folder or absolute under it, such as reports/weekly.md | |
| reference | Yes | The reference as written: a data file relative to the document (data/daily.csv) or absolute under the served folder, a part of it after # (data/daily.csv#0.rain_mm, archive.sqlite#readings), a .sql file, or #name for a query fenced in the document (#totals, #totals#0.rain_mm) |