The <reference> tag adds a reference field to widgets, establishing connections to data tables via a custom reference.

Available attributes:

AttributeTypeMandatoryDescription
canCreateBooleanN

Set the attribute equal to 'true' to add the button  for creating a new record. The default value is 'false'.

canReadBooleanN

Set the attribute equal to 'false', to make the referred dictionary unavailable. The default value is 'true'.

classStringNSpecify the CSS class name defined in the CSS field.
conditionStringN

Specify a condition query.

This attribute takes a decoded condition as a value. To decode a query condition, use server methods as recommended.


isFixedBooleanNSet this attribute to 'true' so the condition value cannot be changed.
isMandatoryBooleanNTo make a field mandatory, set the attribute equal to 'true'.
isVisibleBooleanNThis attribute is equal to 'true' by default. To disable the widget displaying, set the 'false' value.
labelStringNDescribe the field content by giving a field label with text information.
modelStringYSpecify this attribute to point to the client controller data object. When the model data changes, it is automatically transferred to the data of the client script.

readOnly

BooleanN

To make a field read-only, set the attribute equal to 'true'.

styleStringN

Specify the display settings (size, font, color, etc.) of the widget elements using the CSS syntax.

tableNameStringYSpecify the name of the table to which this tag will be bound.


<reference label="Configuration Item" model="data.element" tableName="cmdb" isMandatory="true" condition="{data.condition}"></reference>