Edit

Share via


Explore data on a grid page

In model-driven apps, the default control that's used to show data in tabular form is the read-only grid. When a subarea contains a table, the subarea's default layout in the app sitemap is called the grid page.

A screenshot of a grid page in a model-driven app.

Legend:

  1. Command bar: The commands available for the page
  2. View selector: Select to change views
  3. Edit columns: Select to add, remove, or reorder columns
  4. Edit filters: Select to filter the view with advanced queries
  5. Filter by keyword or Quick find: Show only the rows in the current view that match your search criteria
  6. Row counter: Shows total number of rows

Command bar

The command bar provides quick access to various commands and actions within an application.

View selector

The view selector lists the views that are available for the table. By default, the list is divided into two groups:

  • My Views: Personal views that you created
  • System Views: Views that your administrator created and shared with you

A screenshot of the view selector on a grid page.

Personal views are listed before system views by default. Both lists are sorted alphabetically. You can change the order the views are listed in.

Note

If your administrator has turned on the modern advanced find experience, the list of views isn't divided. To easily tell which kind of view you're looking at, personal views have a user icon Personal view icon.. You can also hover over the information icon Information icon. to see the view type.

To quickly find a view in a long list, use the search box at the top of the view selector.

A screenshot of the view selector on a grid page, showing the search box and personal view icons.

Every table in your app has a default view that's set by your administrator. The Default label in the view selector identifies which view is the default for the table.

Column editor

Use the column editor to add, remove, or reorder columns.

Filter editor

Use the filter editor to see or modify the query that selected the records in the view.

Grid search enables you to filter the current view based on a keyword. When you choose the search box, an information tooltip appears to indicate the list of columns on which a begins-with match is applied.

Information tooltip that indicates the list of columns on which a begins-with match is applied.

The search box can offer two different experiences, depending on how your administrator has configured search.

Note

If your app is configured to be offline by default, the search box will utilize Quick find regardless of the grid search configuration in place.

Filter by keyword

Filter by keyword is the default experience. When you enter text in the Filter by keyword box, the system filters the current view. It displays the results in the same columns that are used in the current view.

Quick find

If your administrator has turned on quick find, then the search box shows Quick find. When you enter text in the Quick find box, the system filters the table's quick find view. It displays the results in the columns of the quick find view rather than the current view.

Note

Grid search keywords that begin with an asterisk (*) will display a warning informing you that the search might be slower. If your administrator has turned on the Prevent slow keyword filter for quick find terms on view pages setting, then you cannot perform a search on keywords that begin with an asterisk (*).

Searching for keywords that begin with an asterisk will display a warning message.

Smart grid (preview)

[This article is prerelease documentation and is subject to change.]

Smart Grids are now in preview in model-driven views, allowing users to find, filter, and sort their data quickly with natural language, bypassing complicated advanced filters. If your administrator has turned on Natural Language Grid and View Search, then the natural language search box will be visible.

Using smart grid natural language search, you can ask data-related questions with natural language. For instance, requesting “cases with high priority with overdue follow-up by date” will filter your view to display only those relevant cases.

A screenshot of the natural language search box on grid page

Important

  • This is a preview feature.
  • Preview features aren’t meant for production use and might have restricted functionality. These features are subject to supplemental terms of use, and are available before an official release so that customers can get early access and provide feedback.

Supported features

  • Filtering of record
  • Sorting
  • Text search

Known limitations

The following capabilities aren't supported:

  • Query aggregation
  • Query grouping
  • Adding columns

Considerations

  • After executing a query, review the generated filter tags to ensure that the filter conditions were correctly interpreted from your natural language query. If any part of your query is missing from the filter tags, the results weren't filtered by that condition.
  • If Copilot doesn't produce the desired results, consider modifying your query by:
    • Referring to data columns by their names as they appear in the grid header
    • Separating multiple conditions with commas or periods
  • Search strings with two words or fewer will do a text search (previous functionality). To do a Copilot search, use more than two words. To perform a text search for more than two words, enclose the search term in single or double quotes.

Row counter

Row counter displays the total number of rows and indicates infinite scrolling on the page. This is the default view available.

Record counter

Record counter shows the position of the current page of records within the total number of records in the view. This is typically shown as a record counter, such as "Records 21-40 of 100". To view the record counter, your administrator must enable the settings.

Page navigation allows you to move forward or backward by page in the set of records shown in the view and see the position of each page within the total dataset. To view the page navigation, your administrator must enable the settings.

Jump bar

The jump bar is a quick way to filter out records based on letters of the alphabet. To see only records that start with the letter S, for instance, select S in the jump bar.

The jump bar acts on the first sorted column. If the sort order hasn't changed, the jump bar uses the primary column. To view the jump bar, your administrator must enable the settings.

A screenshot of the jump bar that's used to filter records by letter.

Column header actions

Dropdown column headers provide various options to let you modify the data shown in the grid.

Sorting

You can modify the order of records in the grid using the sorting actions in the dropdown column headers. By default, selecting to sort by a column replaces any existing sorting criteria on the grid.

Note

Multi-column sorting can be accomplished by holding the Shift key when you select a sort on a different column. This adds the sort condition to the existing sorting criteria on the grid, instead of replacing the sorting criteria.

Filtering

To focus on records that meet particular criteria, you can filter a view by one or more columns. The type of data in the column determines the available filter options.

Important

In Unified Interface, grids don't pre-populate column filters based on the current view definition.

Note

Filtering isn't supported on virtual entities. The grid filter's look-up list is limited to 100 results.

Filtering on a lookup column

When you filter data on a lookup column, you can select from a list of values, rather than typing. For example, to filter a view by Primary Contact, you can select a name from the list that appears when you select the filter text box.

If you start typing, the filter suggests matching results to help you complete the search. The results include all rows that aren't otherwise filtered out.

A screenshot of the Primary Contact column filter that shows search completion.

Filtering on a date column

When you filter on a date column, you can select from many different ways to specify a date or a time frame. For example, you can search On or after an exact date, Next fiscal year, or Last week.

Filtering activities

Use the activity type filter to show only the activities you're interested in, such as appointments or email.

A screenshot of the activity type filter that shows several types of activities selected.

Grouping

When configured, the dropdown column headers surface a Group by option. This allows you to group the data in the grid by values in the selected group.

  • Grouping is available for most kinds of columns. This notably doesn't include lookup columns.
  • When grouping on date fields, you need to choose a timeframe to on which to group. This includes day, week, month, quarter, and year.
  • You can only group by one column at a time; selecting Group by on a different column replaces any existing grouping criteria.
  • You can remove the grouping by selecting Ungroup from the same dropdown column header to remove the grouping.

Note

Grouping criteria isn't saved to a view. Grouping is not supported when paging on the grid is allowed.

Aggregation

When configured, the dropdown column headers surface a Totals option in numeric columns. This allows you to surface an aggregate calculation in the grid footer for the data in this column. You can choose between showing a sum, the maximum value, the minimum value, or the average value. If the data in the grid has been grouped, the aggregate is calculated and displayed for each group.

Note

Aggregations aren't saved to a view.

Show as

While the default read-only grid is initially used to show data, if multiple dataset controls are configured for the table view, you can switch between these controls using the Show as menu in the command bar, which is typically found under the More commands action. Once you've switched to a different display of the data, that control is remembered for future sessions on that device.

A screenshot of the Show as button in the command bar.