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

The following attributes are applicable:

AttributeTypeMandatoryDescription
canCreateBooleanN

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

canReadBooleanN

If you set the attribute equal to 'false', the referred dictionary will not be available. 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.
isMandatoryBooleanNMake the field mandatory. For this, set the attribute equal to 'true'.
isVisibleBooleanNDisable the widget displaying. This attribute is equal to 'true' by default.
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

Make the field read-only. For this, 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.

value

StringN

Specify the default value for the field.


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