OpenFin Technical Reference

View as Markdown

OpenFin Plugin Options

OpenFinPluginOptions

Options required for when using the OpenFin plugin

notificationTimeout?

number | false

Timeout (in ms) for OpenFin Notifications to expire; set false for notifications not to auto-dismiss

Default

5000

onNotificationAction?

(event: { notification: any; type: string; trigger: string; result: { task: string; }; }) => any

Function which is invoked when a button in OpenFin notification is clicked

onShowNotification?

(notification: any, alert?:AdaptableAlert) => any

Updates OpenFin Notification object before it's displayed (just add/remove properties); return false to stop Notification showing

onValidationFailureInExcel?

'override' | 'show-notification' | 'show-undo-notification'

Action to perform when a data change in Live Excel report triggers Prevent Edit Alert failure

Converts AdapTable Alerts configured to display in popup as OpenFin Notifications

Default

true

Icon to show in Notification - uses the value supplied in UserInterfaceOptions

Default

true

How long (in ms) AdapTable throttles when sending data update to OpenFin

Default

2000


OpenFin API

Caution

Some of these methods are intended for internal use only - and have been marked as such

OpenFinApi

The OpenFin plugin: notifications, and starting or stopping live data.

Retrieves the OpenFin currently sending live data to Excel

Retrieves the OpenFin section of System State

getOpenFinThrottleTime()
returns

number | undefined

Retrieves the Throttle time for live updates

Retrieves the OpenFinPlugOptions provided in OpenFin Plugin

isOpenFinAvailable()
returns

boolean

Whether OpenFin is available

isOpenFinRunning()
returns

boolean

Whether OpenFin is currently running

Shows a notification in OpenFin

Displays Alert as an OpenFin Notification

Runs Report in Excel as Live Report (so updates as AdapTable ticks)

stopLiveData()
returns

void

Stops live data; data will no longer be sent from AdapTable to Excel

Accessing the API

Because OpenFin is available via a Plugin, the easiest way to access the Api is as follows:

const openFinApi = adaptableApi.pluginsApi.getOpenFinPluginApi();