Notes Technical Reference

Summary

  • Notes are provided in Note section of Initial Adaptable State
  • Note Options allows developers to configure which Cells can receive Notes
  • Note API provides run time access to Notes

Note State

The Note State of Initial Adaptable State contains a collection of AdaptableNotes:

PropertyTypeDescription
NotesAdaptableNotesCollection of AdapTable Notes

Adaptable Note

The full contents of the AdaptableNote object is as follows:

PropertyTypeDescription
ColumnIdstringId of Column containing the Note
PrimaryKeyValueanyValue in Grid's Primary Key Column
TextstringContent of the Note
TimestampnumberWhen Note was made
IsReadOnlybooleanSets Entity to ReadOnly (overwriting a Strategy Entitlement of 'Full')

Note Options

The Note Options section of Adaptable Options contains options to configure Note behaviour:

PropertyTypeDescriptionDefault
dateFormatstring | (() => string)Date Format string for Notes timestamp'dd-MM-yyyy HH:mm:ss'
isCellNotable(context:NotableCellContext) => booleanWhether a cell can contain Notes
showNoteAction'hover' | 'menu'Whether to show Notes by hovering (default) or via context menu'hover'
showPopupCloseButtonbooleanShow the Close Button in the Notes Popuptrue

Note API

Full programmatic access to Notes is available in Note API section of Adaptable API .

This enables Notes to be retrieved, created, edited and deleted programmatically.

MethodReturnsDescription
addNote(text, primaryKeyValue, columnId)voidAdds a new Note
deleteNote(note)voidDeletes a Note
editNote(note)voidEdits a Note
getAllNotes()AdaptableNotesGets all Notes
getNoteByUuid(uuid)AdaptableNote | undefinedReturns a Note by uuid
getNoteForCell(cellAddress)AdaptableNoteGets all Notes for a cell
getNoteState()NoteStateGets the Note State
updateNoteText(text, note)voidEdits text of a Note