Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

AVEVA™ Operations Management Interface

DataGrid widget

  • Last UpdatedOct 09, 2024
  • 4 minute read

The DataGrid widget shows tabular data within a pane of a AVEVA OMI ViewApp during runtime. Data shown in the widget can be filtered by the user. The widget also includes a set of visual properties to customize the appearance of the widget and its displayed tabular data.

Filter data during runtime

Each column of data shown in the grid can be filtered. The Data Grid widget only shows the data from the row whose column item matches the filter criteria when the filter is applied.

The following example shows tabular data before and after applying a filter to the Week column to filter the data to show only Thursday.

Select the filter icon within each column header to display a drop-down pane to specify filter criteria.

Numbar 1 - dark blue

Drop-down list of filter operators. The selected operator performs a comparison to the value entered in the paired data entry field (2). If column data matches the filter statement, the grid shows the data for that row. Unmatched data is removed and not shown in the grid.

The Data Grid widget supports the following filter operators:

  • Is equal to

  • Is not equal to

  • Starts with

  • Contains

  • Does not contain

  • Ends with

  • Is null

  • Is not null

  • Is empty

  • Is not empty

  • Has no value

  • Has value

Number 2 - dark blue

Data entry field to type a filter value that is evaluated by the filter operator selected in (1).

Filters logic to evaluate filter statements 1 and 2 with Boolean operators (AND, OR). If filter statement 2 is blank, no filters logic is applied.

Number 4- dark blue

Same as 1. If the paired data entry field (5) is blank, the filter operator is not evaluated.

Number 5 - dark blue

Same as 2. Can be left blank.

Number 6 - dark blue

Select CLEAR to remove filter criteria and show all data on the grid.

Number 7 - dark blue

Select FILTER to apply the filter criteria.

Properties

The following table lists the properties of the DataGrid widget. All properties are exposed as dynamic runtime properties in which they can be bound to a reference to a ViewApp namespace as an:

  • Attribute

  • Object attribute

  • MyContent attribute

  • Compound expression

    Data Grid Widget Properties

    Descriptions

    Type

    Gets or sets the format of source data strings.

    • csv

    • json

    AllowExport

    Allows the export of the data to a file. The default value is true.

    Datasource

    Gets or sets the string of JSON or CSV data shown by the Data Grid widget.

    ColumnDelimiter

    Gets or sets the delimiter used to separate field values in the selected grid row.

    • Comma for csv strings

    • Vertical pipe (|) for json strings

    SelectedRow

    Gets or sets the string of the selected row field values.

    DateFieldFormat

    Gets or sets the date format of a date. Supports all date format strings.

    BackgroundColor

    Background color of the widget.

    ExportFileName

    If AllowExport = True, specifies the name of the file exported.

    FilterMode

    Gets or sets the filter mode of the grid; either default or checklist.

    ForeColor

    Gets or sets the text color of the widget.

    HeaderBackColor

    Background color of the tabular header in which column names appear.

    HeaderForeColor

    Text color of the header column names.

    SelectionBackColor

    Background color of a selected row within the grid.

    SelectionForeColor

    Text color of the selected row within the grid.

    RowHoverBackColor

    Background color of the row within the grid in which the mouse is hovering.

    RowHoverForeColor

    Text color of the row within the grid in which the mouse is hovering.

    Font Family

    Name of the font family used by the widget to show text.

    FontSize

    Gets or sets the font size in pixels of text shown in the Data Grid widget.

    PageSize

    Gets or sets the number of records to display at a time.

TitleResults for “How to create a CRG?”Also Available in