|
This object contains a set of data sources.
When calling $.udb(), you can refer to data sources with arrays or simple strings, using the selection techniques below:
You can select a data source by referring to the value of its ID property. If the data source is on the current page, use
data-source-id
If the data source is on a different page than the current page, use
page-id.data-source-id
|
You can select a data source by its type, using one of the meta selectors listed here. You cannot combine these meta selectors with other ways of selecting data sources.
Meta selector
|
Data sources selected
|
:table
|
All table data sources
|
:variable
|
All variable set data sources
|
:virtual
|
All virtual data sources
|
|
You can select a data source by its name or path. To select a data source on the main page, simply use the data source name. To select a data source on a subpage, you must provide the path to the data source using data source path syntax.
|
To select a data source in a different FrameControl, you can refer to that frame by specifying its ID, followed by two semicolons ("::") and the data source:
frame-id::data-source
where you refer to the data source either by ID or by name/path. To refer to the top-level frame (which has no ID), just start with the two semicolons:
::data-source
|
Functions
The DataSourceContainer object exposes the following functions.
When you call a function, the DataSourceContainer transfers the method to each individual data source that it contains.
The DataSourceContainer object is derived from the DataSourceMetaContainer object, in the sense that practically all DataSourceMetaContainer functions are exposed also by the DataSourceContainer object.
Function
|
Description
|
.clear()
|
Function to clear the datasources' contents.
|
.clearQuery()
|
Function to clear the query conditions of the data sources in the container.
|
.createRowSet()
|
Function to create a new Rowset in the data source for some parent key
|
.each()
|
Function to iterate execution of a function for each matched data source.
|
.executeQuery()
|
Function to (re)query a data source.
|
.gotoDataSet()
|
Function to display or query a set of records given by a data set indicator.
|
.meta()
|
Function that returns the meta data container of the first data source of its collection.
|
.off()
|
Function to remove a handler from an event.
|
.on()
|
Function that binds a handler to an event.
|
.refresh()
|
Function to refresh the current data set.
|
.rowCount()
|
Function that returns the number of records.
|
.rowCreate()
|
Function to create a new record.
|
.rows()
|
Function to get a collection of records.
|
.rowSet()
|
Function to get a rowSet object of the data source for some parent key
|
.searchCols()
|
Function to get a column of columns.
|
.trigger()
|
Function to trigger an event.
|
|
