Dynamic Tables

BPS dynamic tables — customizable data based on variables and periods.

Fetch Dynamic Table

import { useDynamicTables, DataLanguage } from 'stadata-js'

const { fetchDynamicTableList } = useDynamicTables()

const result = await fetchDynamicTableList({
  domain: '7200',
  lang: DataLanguage.EN,
  variableId: 529,
  periodId: '117',
})

Parameters

Parameter	Type	Required	Description
domain	string	✅	BPS domain code
lang	DataLanguage	❌	Response language
variableId	number	✅	Variable ID
periodId	string	✅	Period ID. Single ("117"), range ("117:123"), or multiple ("117;123")
derivedVariableId	number	❌	Derived variable ID
verticalVariableId	number	❌	Vertical variable ID
derivedPeriodId	string	❌	Derived period ID. Same format as periodId
page	number	❌	Page number
perPage	number	❌	Items per page
cancelToken	CancelToken	❌	Request cancellation token

TIP

Use usePeriods() and useVariables() to get valid IDs for querying dynamic tables.

Helpers

After fetching dynamic table data, you can use these helpers:

import { DynamicTableHtmlGenerator } from 'stadata-js'

const structured = table.toStructuredData()
const html = DynamicTableHtmlGenerator.generate(table)

• table.toStructuredData() → converts the data into a nested structure that is easier to use for UI / export
• DynamicTableHtmlGenerator.generate(table) → returns a ready-to-render HTML <table> string

See also: Dynamic Table Helpers

Data Type

class DynamicTable {
  id: string;
  title: string;
  subjectId: number;
  size: string;
  updatedAt: Date | null;
}