Variable (Dynamic Layout Definition)

VariableIcon Description

This node defines a variable in a Dynamic Layout’s metadata. When a variable is included a control will be added to the object’s form, initially in the “Unused Items” section. It will also generate a variable in the variables part.

Usage

The developer may move or copy the control included in the “Unused Items” section to the “User Region”, where it will be taken into account when generating panels based on the layout.

The “User Region” may include more than one copy of this variable. To do this, simply add an “Attribute/Variable” control from the Toolbar and select the corresponding variable (whose name is “&Variable_{Name}”).

When using the dynamic layout, all occurences of the variable in the layout will be replaced with its final value. Only the “Attribute” and “Label Caption” properties will be updated. All other properties will remain as defined in the layout object, so the developer can choose any value for them.

Properties

Category Name Value
General Name (Id) Identifier for this variable. Must be unique inside the layout’s metadata.
Optional Indicates if this variable will be optional in the final panel. If so, the developer may choose to set the “Do not include” property to true, and the corresponding controls will be deleted from the panel.
Grid Use In Grid Navigation Included only when the layout corresponds to a Grid (see Dynamic Layout Root Node). Indicates if this variable should be considered a part of the grid when calculating its navigation. Generally, variables with this property set to “True” should be included in the grid’s contents, while variables with this property set to “False” will be placed outside the grid.
Data Source Inference Prefer Primary Key Indicates if a Primary Key attribute should be inferred for this variable when using this layout. This is used mainly when creating Grids or Attributes from transactions, and the inferred attribute may be changed by the developer.
Prefer Description Attribute Indicates if a Description Attribute should be inferred for this variable when using this layout. This is used mainly when creating Grids or Attributes from transactions, and the inferred attribute may be changed by the developer.
Prefer Image Attribute Indicates if an Image Attribute should be inferred for this variable when using this layout. This is used mainly when creating Grids or Attributes from transactions, and the inferred attribute may be changed by the developer.
Prefer Attributes Based On Domain Indicates if an Attribute/Field based on this domain should be inferred for this variable when using this layout. The inferred attribute may be changed by the developer.