spBB / cBB
Inherits from spObject.
component: cBBBlock
class: spBB
The building block is a wrapper for embedding a block component. It has several use like embedding headers and footers (although the template mechanism is preferred), but this component is very helpful to create lookup forms, master-detail forms or in nested grids.
Properties
|
Description |
BuildingBlock |
Specifies the pre defined detail building block to be inserted (detail) |
DetailDataSource |
The datasource to connect to from the master |
ExternalDataSource |
For future development, do not use. |
KeyFields |
Key field mapping between master and detail |
MasterDataSource |
Reference to the master data source |
Methods
No exported methods
PHP Events
Event |
Trigger |
onCreate |
Occurs when a component gets created |
onActivate |
Occurs when a component enters the Activation state |
onDestroy |
Occurs when a component gets destroyed |
JavaScript Events
No additional events
Samples
Use of building-block in a master-detail relationship
To set it a master-detail relationship, you must apply the building block that will be used as the detail. Also you must provide the database connection the detail block needs to use, and setup a valid master-detail key relationship. In sequence:
- define the building block to be used
- define the master datasource
- define the detail datasource
- setup key field mapping
- setup the connection to be used by the detail (the connection used to design the detail is only used to access the database metadata. All connections used must be setup by the main master)
With this information the read-only fields 'detail data source' and 'keyfields' of the master datasouce will be filled automatically.
Use of menu
You can use headers, footers and side menu's. Building blocks are very useful as you only have to specify the menu once. Then, in the layout property you assign the block to the template: