Skip to main content
Matrix42 Self-Service Help Center

Objects Grid Control

Objects Grid Control Defined

An Objects Grid is a control that allows users to select objects in a grid. 

How to Set up Objects Grid Control 

An Objects 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 fields 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 Objects Grid control in Layout Designer.

  • Locate an existing Objects 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 Object Picker Control Descriptor (see PROPERTIES tab and the Inherit Controls field under the GENERAL tab). 

Objects Picker Specific Properties

Object Ids Bound property. Keeps the array of grid records IDs. When something is removed or added to the grid, the value of the property is immediately reflects the changes. Or from other hand, if the value is changed outside, the control immediately show the relevant changes in Grid.
Selected Items Output property. Returns array of data records currently selected.
Entity Class Name Defines the Data Definition (Schema Class) to display in grid
Allowed Types Restricts the set of data displayed in grid to list only objects of the specified types (Configuration Items). E.g. Entity Class "SPSActivityClassBase" is included to multiple CIs. To show onlly incidents in grid, the Allowed Types need to be set to ["SPSActivityTypeIncident"]
Filter

Specify an ASQL filter expression to filter objects in the Objects Grid in run time, if needed. Only objects that satisfy the specified filtering criteria will be available for selection in the Objects Grid. You can set a static value or bind the control with a data model property (from the Model tab).

If the control model property "Object Ids" is not defined, the Control just behave like Grid Control, which just display objects which matching Filter criteria, without possibility to edit them (readonly)

Label Select a Label to appear in the Header of the Objects Grid control in run time. 
Show Label Select the checkbox to display the above specified Label in the Header of the Objects Grid control in run time. 
Multi Selection You can set a static True or False value to allow or forbid mutli selection in the Objects Grid control or bind the control with a data model property (from the Model tab)
Disable Delete Select ‘True’ to disable the ‘Remove’ button in 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. 
Full Height Select the checkbox for the grid to use all the available space. 
Hide Grid Header Select the checkbox to hide the Header of the grid, with all the buttons, etc. 
Disable Add

Select ‘True’ to disable the Add button in 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. 

How to Use Objects Grid in Run Time

Select checkboxes next to the entities in the grid.

  • You can sort the grid by any of the grid columns (A-Z or Z-A).
  • You can add a new object to the grid via the Add button, if available in the Header.
  • You can remove objects from the grid by selecting them and clicking the Delete button in the Header of the grid (provided the Delete button is enabled in the Layout Designer).;
  • Was this article helpful?