Skip to main content
Matrix42 Self-Service Help Center

Control Descriptor


Control Descriptors are entities that define how controls are set up, what fields they have, and how they behave. Each control in Solution Builder has its own Control Descriptor located under Administration > User Interface > Control Descriptors. Users with Admin rights can modify control descriptors or create new ones, if needed, to suit their specific business needs.

Control Descriptor dialog, General tab

Name Name of the control descriptor. Only Latin letters without spaces are normally used. The name is localizable.
Title Title of the control descriptor. The title is localizable.
Description Description of the control descriptor for internal use. The description is also localizable.
Inherit Controls Entities from which properties are inherited for (or reused in) the control. All the properties that the control has, both inherited and added to the control directly, are available in the right-hand panel of the Layout Designer.
Hidden If selected, the control is hidden from Toolbox in Layout Designer.
Toolbox icon Icon displayed in Toolbox of Layout Designer.
Category Toolbox category (collapsible panel) where the control is displayed.
Position Position of the control in the category; the larger the number, the lower the control in the category.
Ignore on Dropping Select to ignore the control in Layout Designer when a data model property is being dropped onto the canvas; the control will not be available for selection from  the pop-up list of suggested controls.

Control Descriptor dialog, Advanced tab


Custom Template Select to create a custom template. Read the final Composite Controls section of this article to learn more.
Tag Name Tag for the transformed control; if the field is left empty, the Name value is used: <some-tag-name... >.
Body XSL template Template for xsl transformation.
Properties XSL template This field is automatically filled by the system.
Non-visual control Select for controls that are not displayed in Layout Designer; such controls are used for other purposes, such as hide a page from a wizard.


Model Binding Property

Property used as main when user drags data from Data Model and drops it onto the canvas.

Example: specify a property of type integer here. When you drag some data of type integer from Data Model and drop it onto the canvas in Layout Designer, you will be offered several controls which have the Model Binding Property of type integer to select from.

Supported Widget Types control is available for the selected widget type(s).
Designer View html code snippet defines the look of the control in Layout Designer. Use { { component.**** } } to access the scope of the component, e.g. { { component.label.value.toString() } }, where label is a property; you can call any property this way.

Control Descriptor dialog, Properties tab

These are the properties of the control available for setup in the Toolbox of the Layout Designer. Inherited properties (via the Inherited Controls field located under the General tab) are also available in the Toolbox. You can add new properties to the control descriptor by clicking the +Add icon in the header of the grid and filling out the Add New Property dialog that appears. 

Property dialog, General Info tab

Description tip displayed for the property in Layout Designer when users hover over the question mark icon.
Position position of the property; the larger the number, the lower the property.
Hidden select to hide the property from the right-hand panel of Layout Designer.
Required select to make the property required; required property is highlighted in red in Layout Designer if missing.

Property dialog, Transformation Info tab

Attribute Name: you may specify how the property will appear in html; leave the field empty to use the default value (Name from under the General Info tab); the default value is the most frequently used one. 
Transformation Type: the most frequently used value, Auto, sets the transformation to the Name value. 
Default Value: default value prefilled for the property in Layout Designer. 
Transformation Target: 
XSL Template: you may provide a template for the xsl transformation of the property here; xsl templates are rarely used. 
Render Anyway: select to always add attributes to the control irregardless of their values. 

Property dialog, Designer Info tab

Binding Type:

  • Two Way binding is used for controls data inside which may change and be transferred elsewhere; Two Way binding supports the Editor.
  • One Way option is used for controls data inside which may change but is not transferred anywhere. One Way binding is used, for example, for literals which only display the value and change nothing. The One Way option is better for performance than the Two Way option. 

Editor: select one of the available editors to be able to use in Layout Designer. 

  • Style Editor: select to be able to select style for the control in Layout Designer. 
  • Enumeration Editor: select to be able to pick values for the property from the drop-down list in Layout Designer. 
    • Enumeration: specify the values that will be available for selection from the drop-down in Layout Designer. Format for the values: 

value1:value1 (e.g. left:left)
value2:value2 (e.g. right:right)
value3:value3 (e.g. center:center)
One value per line. 

  • Object Picker Editor: select to be able to select an object; used on Landing Pages. 
    • Schema Class Name: schema class name for the object picker. 
    • Allowed Types: types from the selected class. 
    • Use Object ID: if selected, the Object ID is used; if deselected (default), the ID will be used. Different controls use different IDs. 
    • Use Multi Select: if selected, users will be able to select several objects. 

Composite Controls

It often happens that the Workspace Designer needs to reuse a set of same control with some logic in several places in Layout Designer, for example in Previews, Dialogs, Wizards, or Landing Pages. In this case, we recommend creating a Composite Control once and using it in several places. To do so, you need to select the Custom Template checkbox (Advanced tab) and save the Control Descriptor.

After this, the Customize action will be available for this control and you can use all the benefits of the Layout Designer to build your own complex control with the custom logic.

  • Was this article helpful?