Monitoring Grid Activity

AdapTable provides a number of ways for Support Teams to monitor user's (and general Grid) activity:

• Listening to Adaptable State Changes

• Subscribing to other Adaptable Events, particularly Cell Changed and Row Changed

• Monitoring Data Changes

• Configuring Alerts to respond to cell and row changes

• Managing AdapTable State

• Using the Grid Info Monitor

AdapTable State Changes

The Adaptable State Changed Event provides a stream of all state changes.

All grid activity - every action, object change, mouse click etc. - can be listened to, and logged, as required.

AdapTable Events

In addition, to State Changed, AdapTable provides a large number of other useful Adaptable Events which can be used to monitor changes in the Grid, most notably:

Event	When Fired
Row Changed Event	A Row has been added, deleted (or even updated)
Layout Changed Event	A Layout changes (ie. columns, filters, sorts, groups, aggregations etc.)
Cell Changed Event	Contents of a cell changes (whether direct edit or ticking data)
Theme Changed	A Theme has been selected or edited
Data Imported	The Data Import wizard has finished

Data Change History

The Data Change History Monitor will track all data changes in AG Grid cells.

The Monitor has many features including:

• track all changes or just edits or ticking data
• ability to add an undo button (or other action buttons)
• option to see all changes, or just last change, for a Cell

State Management Panel

The State Management Panel facilitates monitoring AdapTable State.

It allows the user to

• Clear User State
• Load Initial State
• Export the current State, or the Initial State, to multiple destinations

AdapTable Alerts

As an altenative to subscribing to Events, you can set up Alerts to keep abreast of user activity.

There are 2 Alert types, in particular, which are relevant here:

Alert	When Fired
Data Change	The contents of a Cell has changed
Row Change	Rows have been added or removed from the Grid

Grid Info Panel

The Grid Info Panel offers run-time full oversight of what is happening in AdapTable.

The Grid Info Panel is, typically, the first Panel displayed in the Settings Panel and contains 2 tabs:

• Grid Summary
• Grid State

Grid Summary

The Grid Summary tab provides basic information about the grid. This includes:

• Which Column Filters are applied
• If a Grid Filter is applied
• Which Column Sorts are active
• Row information - including counts of total, visible and selected rows
• Column information - counts of total and visible columns
• Special Column Information - any Calculated or FreeText or Action Columns
• The AdapTable and AG Grid versions being used

Grid State

This section provides information about every Adaptable Object which has been created.

It also contains buttons to edit / delete these Objects via the relevant wizard.

import {AdaptableOptions} from '@adaptabletools/adaptable';
import {WebFramework} from './rowData';

export const adaptableOptions: AdaptableOptions<WebFramework> = {
  primaryKey: 'id',
  adaptableId: 'Grid Info',
  initialState: {
    Theme: {CurrentTheme: 'dark'},
    Layout: {
      CurrentLayout: 'Standard Layout',
      Layouts: [
        {
          TableColumns: [
            'name',
            'language',
            'github_stars',
            'license',
            'has_projects',
            'has_pages',
            'created_at',
            'has_wiki',
            'updated_at',
            'pushed_at',
            'github_watchers',
            'week_issue_change',
          ],
          Name: 'Standard Layout',
          AutoSizeColumns: true,
        },
      ],
    },
  },
};

FAQ

Can I use Grid Info to change the Column's Data Source? No, that is not possible.

AdapTable Resources

• Adaptable State Changed Event
• Row Changed Event
• Layout Changed Event
• Cell Changed Event
• Data Change History Monitor
• State Management Panel
• Data Change
• Row Change