The DataLayer.Definition List element programmatically provides developers with information about the definitions used in their application. This data can be used to create report menus and report management systems.
- Work with DataLayer.Definition List
The DataLayer.Definition List element has the following attributes:
(Required through v10.1.46) Unique element ID.
|Definition List Folder|
Enter a file system folder name here to restrict the results returned to definitions within a single folder. The folder named is assumed to be within the _Definitions folder of the application's project folder. Examples: _Processes, _Reports, _Templates, _Widgets
Default: Returns data for all definitions
The datalayer reads the definition data for the current project and caches it as rows and columns, with one row per definition file. Data retrieved into the datalayer is cached in XML format.
The data retrieved with a datalayer is available using @Data tokens, in the format @Data.ColumnName~. The spelling of the column name is case-sensitive. The data is only available within the scope of the parent element of the datalayer, not throughout the entire report definition. The DataLayer.Linked element can be used to make the data reusable in another datalayer outside this scope.
Valid "column names" available through the @Data token are:
The definition name, as it appears in the Application panel, e.g. Default
The definition type, e.g. Report, Process, Template, or Widget
|Caption||The Caption attribute value (for Report definitions).|
|EngineVersion||The build number of the version of the Logi Server Engine used, e.g. 9.0.30|
The fully-qualified filename of the definition file, e.g.
For easier organization, Logi definition files can be named using period-separated prefixes, such as Accounting.ProfitLoss.lgx. The prefixes are referred to as folders, though they don't exist in the file system as such. This column returns the nth prefix or folder name for each definition. Examples:
For Accounting.Profits.lgx, the Folder1 column returns "Accounting"
Due to the optional nature of these prefixes, the AutoColumns element may not detect all instances of this column in the datalayer.
The Report ID from the report definition's root node, ID attribute.
The timestamp indicating when the definition was last saved, e.g. 3/8/2008 2:25 PM
|SavedBy||User name of the person who last saved the definition.|
If the Alternative Definition Folder attribute is set in the _Settings definition's Path element, the datalayer also includes definition objects from that folder.
The data retrieved into the datalayer can be viewed by turning on the Debugging Link in the _Settings definition (General element) and using the resulting link at the bottom of the report page to view the Application Trace page. A link on the Trace page will display the retrieved data.