Data Change History Technical Reference
Summary
- Data Change History Options contains properties enabling Data Change History to be configured
- Data Change History API Section of Adaptable API provides run-time accesss
Data Change History Options
The DataChangeHistoryOptions section of Adaptable Options contains these properties:
| Property | Type | Description | Default |
|---|---|---|---|
| activeByDefault | boolean | Make Data Change History active by default | false |
| changeHistoryButton | DataChangeHistoryButton<TData> |DataChangeHistoryButton<TData>[] | Action button definition; can be used to implement undo functionality | undefined |
| showDataChange | (cellDataChangedInfo:CellDataChangedInfo<TData>) => boolean | Function specifying which data changes to include in Data Change History | undefined (all data changes are logged) |
| showLastDataChangeOnly | boolean | Show all changes for a Cell or just the last one | true |
Data Change History API
The DataChangeHistoryAPI section of Adaptable API contains these functions:
| Method | Returns | Description |
|---|---|---|
| activateDataChangeHistory(forceReset) | void | Activates Data Change History tracking (or resumes it, if it is currently suspended) |
| addDataChangeHistoryEntry(dataChangeInfo) | void | Adds item to Data Change History log |
| clearDataChangeHistoryEntry(dataChangeInfo) | void | Clears a Row in Data Change Grid |
| deactivateDataChangeHistory() | void | Deactivates Data Change History tracking and flushes the cache |
| getDataChangeForGridCell(gridCell) | CellDataChangedInfo | undefined | Retrieves last data change for a given Cell |
| getDataChangeHistoryLog() | CellDataChangedInfo[] | Retrieves all data changes which are currently available |
| getDataChangeHistoryMode() | 'ACTIVE' | 'INACTIVE' | 'SUSPENDED' | Retrieves current Data Change History mode: 'ACTIVE', 'INACTIVE', 'SUSPENDED' |
| openDataChangeHistorySettingsPanel() | void | Opens Data Change History panel |
| suspendDataChangeHistory() | void | Suspends data change history tracking |
| undoAllDataChangeHistoryEntries() | GridCell[] | Reverts all data changes to previous values and returns GridCells that were undone |
| undoDataChangeHistoryEntry(dataChangeInfo) | GridCell | undefined | Reverts provided data change to its previous value and returns GridCell that was undone |