Adaptable State Changed Event

An Adaptable Event which fires whenever anything changes in Adaptable State.

This is a very useful event as it can be used to listen to pretty much any change in AdapTable.

AdaptableStateChangedInfo

The AdaptableStateChangedInfo object is very extensive, providing full details of the Action that caused the change, and copies of both before and after State. The full definition is:

PropertyDescription
actionThe Redux Action that was invoked
actionNameName of the Action
adaptableIdCurrent AdapTableId
adaptableStateKeyCurrent Adaptable State Key
clientTimestampTime on user's computer when message was sent
newStateAdaptable State after the Action
oldStateAdaptable State before the Action
userNameName of current AdapTable user

Actions

Each State Change is triggered by a Redux Action (the technical solution Adaptable uses to manage state)

Each Action contains useful objects pertaining to that particular change.

For instance the 'GRID_DATA_CHANGED' and 'GRID_DATA_EDITED' actions both contain a DataChangedInfo object that provides full details of the the column, row, and new and old values.

Action Names

For ease of use the name property in the Action is also provided as a full level property.

It is generally very descriptive and explains what the Action does.

But for completeness sake, we provide here a full list of all actionName properties, together with what the Action does:

NameDescription
ALERT_DEFINITION_ADDAn Alert Definition has been added
ALERT_DEFINITION_DELETEAn Alert Definition has been deleted
ALERT_DEFINITION_EDITAn Alert Definition has been edited
ALERT_READYAlert Module is ready
APPLICATION_DATA_ENTRY_ADDAn Application Data Entry has been added
APPLICATION_DATA_ENTRY_DELETEAn Application Data Entry has been deleted
APPLICATION_DATA_ENTRY_EDITAn Application Data Entry has been edited
BULK_UPDATE_APPLYBulk Update is being applied
BULK_UPDATE_COMPLETEBulk Update has been completed
BULK_UPDATE_READYBulk Update Module is ready
CALCULATED_COLUMN_ADDA Calculated Column has been added
CALCULATED_COLUMN_DELETEA Calculated Column has been deleted
CALCULATED_COLUMN_EDITA Calculated Column has been edited
CALCULATED_COLUMN_READYCalculated Column Module is ready
COLUMN_FILTER_ADDA Column Filter has been added
COLUMN_FILTER_CLEARA Column Filter has been cleared
COLUMN_FILTER_CLEAR_ALLAll Column Filters have been cleared
COLUMN_FILTER_EDITA Column Filter has been edited
COLUMN_FILTER_SETColumn Filters have been set
CONDITIONAL_STYLE_ADDA Conditional Style has been added
CONDITIONAL_STYLE_DELETEA Conditional Style has been deleted
CONDITIONAL_STYLE_EDITA Conditional Style has been edited
CONDITIONAL_STYLE_READYConditional Style Module is ready
CUSTOM_SORT_ADDA Custom Sort has been added
CUSTOM_SORT_DELETEA Custom Sort has been deleted
CUSTOM_SORT_EDITA Custom Sort has been edited
CUSTOM_SORT_READYCustom Sort Module is ready
DASHBOARD_ACTIVE_TAB_INDEX_CHANGEActive tab has changed
DASHBOARD_CLOSE_TOOLBARA Toolbar has been closed
DASHBOARD_CREATE_DEFAULT_TABA default Tab has been created
DASHBOARD_READYDashboard is ready
DASHBOARD_SET_FLOATING_POSITIONFloating position has changed
DASHBOARD_SET_IS_COLLAPSEDCollapsed Mode has changed
DASHBOARD_SET_IS_FLOATINGFloating Mode has changed
DASHBOARD_SET_IS_HIDDENVisibility has changed
DASHBOARD_SET_IS_INLINEInline Mode has changed
DASHBOARD_SET_MODULE_BUTTONSThe Module Buttons have been set in the Dashboard
DASHBOARD_SET_TABSNew Dashboard Tabs have been set
DASHBOARD_SET_TITLEDashboard Title has been set
DATA_SOURCE_ADDA Data Source has been added
DATA_SOURCE_DELETEA Data Source has been deleted
DATA_SOURCE_EDITA Data Source has been edited
DATA_SOURCE_READYData Source Module is ready
DATA_SOURCE_SELECTA Data Source has been selected
DESTINATION_SELECTA report Destination has been selected
EXPORT_APPLYExport has been applied
EXPORT_READYExport Module is ready
FILTER_FORM_HIDEThe Filter Form has been hidden
FILTER_READYFilter Module is ready
FLASHING_ALERT_DEFINITION_ADDA Flashing Alert Definition has been added
FLASHING_ALERT_DEFINITION_DELETEA Flashing Alert Definition has been deleted
FLASHING_ALERT_DEFINITION_EDITA Flashing Alert Definition has been edited
FORMAT_COLUMN_ADDA Format Column has been added
FORMAT_COLUMN_DELETEA Format Column has been deleted
FORMAT_COLUMN_EDITA Format Column has been edited
FORMAT_COLUMN_READYFormatColumn Module is ready
FREE_TEXT_COLUMN_ADDA Free Text Column has been added
FREE_TEXT_COLUMN_ADD_EDIT_STORED_VALUEA Free Text Column's stored values have changed
FREE_TEXT_COLUMN_DELETEA Free Text Column has been deleted
FREE_TEXT_COLUMN_EDITA Free Text Column has been edited
FREE_TEXT_COLUMN_READYFreeTextColumn Module is ready
GLUE42_LIVE_REPORT_CLEARA Glue42 live report has stopped
GLUE42_LIVE_REPORT_SETA Glue42 live report has started
GLUE42_LOGINLogged in to Glue42
GLUE42_SCHEDULE_ADDA Glue42 Schedule has been added
GLUE42_SCHEDULE_DELETEA Glue42 Schedule has been deleted
GLUE42_SCHEDULE_EDITA Glue42 Schedule has been edited
GLUE42_SEND_SNAPSHOTA snapshot report has been sent
GLUE42_SET_LOGIN_ERROR_MESSAGEError message set from failed login
GLUE42_SET_THROTTLE_TIMEThrottle time for live reports has been set
GLUE42_START_LIVE_DATALive data has been sent to Glue42
GLUE42_STOP_LIVE_DATALive data is not longer sent to Glue42
GRID_ADD_COLUMNA Column has been added to the Grid
GRID_ADD_COLUMNSColumns have been added to the Grid
GRID_CREATE_CELLS_SUMMARYCell Summary Information has been created
GRID_DATA_CHANGEDGrid data has changed but not as the result of user edit
GRID_DATA_EDITEDA cell has been edited by the user
GRID_EDIT_COLUMNA Column has been edited in the Grid
GRID_REFRESH_CELLSGrid cells have been refreshed
GRID_REMOVE_COLUMNA Column has been removed from the Grid
GRID_SET_CELLS_SUMMARYGrid Cell summary is set
GRID_SET_COLUMNSColumns have been set in the Grid
GRID_SET_MODULE_BUTTON_MENUITEMSModule Button menu items have been set
GRID_SET_MODULE_DROPDOWN_MENUITEMSModule Dropdown menu items have been set
GRID_SET_PIVOT_MODE_OFFGrid is taken out of pivot mode
GRID_SET_PIVOT_MODE_ONGrid is put in pivot mode
GRID_SET_SELECTED_CELLSCells have been selected in the Grid
GRID_SET_SELECTED_ROWSRows have been selected in the Grid
GRID_SET_SORTSorting has been in the Grid
GRID_SET_TREE_MODE_OFFGrid is taken out of tree mode
GRID_SET_TREE_MODE_ONGrid is put in tree mode
IPUSHPULL_ADD_PAGEA new ipushpull page has been added
IPUSHPULL_DOMAIN_PAGES_CLEARipushpull domain pages have been cleared
IPUSHPULL_DOMAIN_PAGES_SETipushpull domain pages have been set
IPUSHPULL_LIVE_REPORT_CLEARThe live report to ipuspull has been cleared
IPUSHPULL_LIVE_REPORT_SETA live report to ipuspull has been set
IPUSHPULL_LOGINLogged in to ipushpull
IPUSHPULL_LOGOUTLogged out from ipushpull
IPUSHPULL_REPORT_SELECTAn ipushpull report has been selected
IPUSHPULL_SCHEDULE_ADDAn ipushpull Schedule has been added
IPUSHPULL_SCHEDULE_DELETEAn ipushpull Schedule has been deleted
IPUSHPULL_SCHEDULE_EDITAn ipushpull Schedule has been edited
IPUSHPULL_SEND_SNAPSHOTA snapshot report has been sent
IPUSHPULL_SET_AVAILABLE_OFFipushpull has been made unavailable
IPUSHPULL_SET_AVAILABLE_ONipushpull has been made available
IPUSHPULL_SET_LOGIN_DETAILSLogin details to ipushpull have been set
IPUSHPULL_SET_LOGIN_ERROR_MESSAGEError message set from failed login
IPUSHPULL_SET_RUNNING_OFFipushpull is no longer running
IPUSHPULL_SET_RUNNING_ONipushpull is now running
IPUSHPULL_SET_THROTTLE_TIMEThrottle time for live reports has been set
IPUSHPULL_START_LIVE_DATALive data has been sent to ipushpull
IPUSHPULL_STOP_LIVE_DATALive data to ipushpull has been stopped
LAYOUT_ADDA Layout has been added
LAYOUT_DELETEA Layout has been deleted
LAYOUT_EDITA Layout has been edited
LAYOUT_READYLayout Module is ready
LAYOUT_SAVEA Layout has been (auto)saved
LAYOUT_SELECTA Layout has been selected
NAMED_QUERY_ADDA Named Query has been added
NAMED_QUERY_DELETEA Named Query has been deleted
NAMED_QUERY_EDITA Named Query has been edited
OPENFIN_LIVE_REPORT_CLEARAn OpenFin live report has stopped
OPENFIN_LIVE_REPORT_SETAn OpenFin live report has started
OPENFIN_SCHEDULE_ADDAn OpenFin Schedule has been added
OPENFIN_SCHEDULE_DELETEAn OpenFin Schedule has been deleted
OPENFIN_SCHEDULE_EDITAn OpenFin Schedule has been edited
OPENFIN_SET_AVAILABLE_OFFOpenFin is no longer available
OPENFIN_SET_AVAILABLE_ONOpenFin is now available
OPENFIN_SET_RUNNING_OFFOpenFin is no longer running
OPENFIN_SET_RUNNING_ONOpenFin is now running
OPENFIN_START_LIVE_DATALive data has been sent to OpenFin
OPENFIN_STOP_LIVE_DATALive data is not longer sent to OpenFin
PLUGINS_SET_PLUGIN_STATEPlugins have been instantiated
PLUS_MINUS_APPLYA Plus Minus Rule has been applied
PLUS_MINUS_READYPlusMinus Module is ready
PLUS_MINUS_RULE_ADDA Plus Minus Rule has been added
PLUS_MINUS_RULE_DELETEA Plus Minus Rule has been deleted
PLUS_MINUS_RULE_EDITA Plus Minus Rule has been edited
QUERY_READYQuery Module is ready
QUERY_RUNA Query has been run
QUICK_FILTER_BAR_HIDEQuick Filter Bar has been hidden
QUICK_FILTER_BAR_SHOWQuick Filter Bar has been made visible
QUICK_SEARCH_READYQuick Search Module is ready
QUICK_SEARCH_RUNRuns Quick Search
QUICK_SEARCH_SET_STYLESets Quick Search style
REMINDER_SCHEDULE_ADDA Reminder Schedule has been added
REMINDER_SCHEDULE_DELETEA Reminder Schedule has been deleted
REMINDER_SCHEDULE_EDITA Reminder Schedule has been edited
REPORT_ADDA Report has been added
REPORT_DELETEA Report has been deleted
REPORT_EDITA Report has been edited
REPORT_SCHEDULE_ADDA Report Schedule has been added
REPORT_SCHEDULE_DELETEA Report Schedule has been deleted
REPORT_SCHEDULE_EDITA Report Schedule has been edited
REPORT_SELECTA Report has been selected
SCHEDULE_JOB_RUNRuns a Scheduled job
SCHEDULE_READYSchedule Module is ready
SET_GLUE42_AVAILABLE_OFFGlue43 is no longer available
SET_GLUE42_AVAILABLE_ONGlue43 is now available
SET_GLUE42_RUNNING_OFFGlue43 is no longer running
SET_GLUE42_RUNNING_ONGlue43 is now running
SHORTCUT_ADDA Shortcut has been added
SHORTCUT_DELETEA Shortcut has been deleted
SHORTCUT_EDITA Shortcut has been edited
SHORTCUT_READYShortcut Module is ready
SMART_EDIT_APPLYSmart Editis being applied
SMART_EDIT_COMPLETESmart Edit has been completed
SMART_EDIT_READYSmartEdit Module is ready
SPARKLINE_COLUMNS_ADDA Sparkline Column has been added
SPARKLINE_COLUMNS_DELETEA Sparkline Column has been deleted
SPARKLINE_COLUMNS_EDITA Sparkline Column has been edited
SPARKLINE_COLUMNS_SETSparkline Columns have been set
SYSTEM_STATUS_MESSAGE_SETA System Status Message is set
SYSTEM_STATUS_READYSystemStatus Module is ready
THEME_READYTheme Module is ready
THEME_SELECTA theme has been selected
THEME_SET_SYSTEM_THEMESSystem Themes have been set
THEME_SET_USER_THEMESUser Themes have been set
TOOLPANEL_HIDE_TOOLPANELA Tool Panel has been hidden
TOOLPANEL_READYToolPanel Module is ready
TOOLPANEL_SET_MODULE_BUTTONSModule Buttons have set in Tool Panel header
TOOLPANEL_SET_TOOLPANELSTool Panels have been set in Adaptable Tool Panel
TOOLPANEL_SHOW_TOOLPANELA Tool Panel has been made visible
UI_CHECKBOX_COLUMN_ADDA Checkbox Column has been added
UI_CHECKBOX_COLUMN_DELETEA Checkbox Column has been deleted

Event Subscription

Subscribing to the Event is done the same as with all Adaptable Events:

api.eventApi.on('AdaptableState', (eventInfo: AdaptableStateChangedInfo) => {
// do something with the info
});

More Information