The article describes the Multi-Fragment Grid control available in the Layout Designer, explains the peculiarities of the control compared to other available grid controls.
A multi-fragment is a collection of Data Definitions inside a Configuration Item. The multi-fragment grid control, unlike all the other grid controls available in the Layout Designer, is specifically designed to be used with such a collection of Data Definitions. The data is received in the form of a reference to the multi-fragment of Data Definitions.
How to Set up Multi-Fragment Grid Control
A Multi-Fragment Grid control, just like any other control in Solution Builder, has its own Control Descriptor (located under Administration > User Interface > Control Descriptors), which defines how the control is set up, what properties the control has, and how it behaves.
Users with Admin rights can modify the Control Descriptor, if needed, to suit their specific business needs.
You also need to set up the Multi-Fragment Grid control in Layout Designer:
- Locate an existing Multi-Fragment Grid on the canvas in Layout Designer or add a new one from the Toolbox.
- Click the control on the canvas to open up its properties in the right-hand panel.
Properties that the Objects Grid has in Layout Designer are defined in the Multi Fragment Grid Control Descriptor (see the PROPERTIES tab and the Inherit Controls field under the GENERAL tab).
Multi-Fragment Grid Control Properties
|Data||Select a multi-fragment, or an array of Data Definitions inside a Configuration Item, here.|
|Class name||Select a corresponding class name (Schema Class) for the selected multi-fragment to display in the grid.|
|Column definition||Provide a name of the Column Definition here; this is a reference to a Data Query.|
|Current Item||Output variable to which the current (just clicked) item on a grid is assigned. Bind an object from the Model.|
|Help||Help for the multi-fragment grid to be available from the header of the grid via the ? icon.|
|Label||Label that appears in the header of the multi-fragment grid in run time.|
|Show Label||Select to display the above-specified label in the header of the grid in run time.|
|Edit mode||Select an edit mode for grid objects here from the available options: None, Inline, Form, or Wizard. Inline: inline editing of objects in the grid. To edit an object, a user will double-click it in the grid and make changes to it directly in the text editor that appears. Wizard: a wizard will allow users to edit grid objects. Click + above the grid to open the wizard.|
|Name||Name of the multi-fragment grid.|
|Full Height||Select to use all the available space.|
|Minimal Height, px||Specify the minimal height of the grid in pixels.|
|Hide Grid Header||Select the checkbox to hide the grid’s header with the title (label), buttons, etc.|
|Visibility||Not only the static True or False value can be selected, but also a value from the Data Model.|
|Margin||Set control’s margin offset in CSS format: ‘10px’, ‘1rem’, ‘1rem 2rem’ (top, right, bottom, left).|
|Padding||Set control’s padding in CSS format: ‘10px’, ‘1rem’, ‘1rem 2rem’ (top, right, bottom, left).|
|Flex option||Select flex behavior for the control: Fixed or Flex|
|Disable Add||Select ‘True’ to disable the Add button for the grid. You can not only set a static True or False value here but also bind the control with a data model property (from the Model tab); in this case, the value of the field (True or False) will change dynamically depending on the value/option of the bound field the user selects in run time.|
|Disable Delete||Allows you to disable the Delete button for the grid.|
|Disable Edit||Allows you to disable the Edit button for the grid.|
Device Visibility: Select devices for which the control is visible: Desktop, Tablet, Mobile.